Eine API für alleNutzungsanleitung
Website ↗
NutzungsanleitungWerkzeuge verbinden

Codex

Verbinde einen bereits installierten lokalen Codex-Client mit deiner API. Unterscheide ihn zuerst von Cloud-Aufgaben.

Diese drei Angaben bereithalten

Öffne bei bereits installierter App den Selbstbedienungsbereich dieser Website und melde dich an. Erstelle oder öffne deinen API-Schlüssel, kopiere die dort angezeigte API-Adresse und eine genaue Modell-ID aus Modelle und Preise. Verwende weder die Startseite noch dein Passwort oder einen Marketingnamen. Prüfe Kontoguthaben und Schlüssellimit.

API_HOST, YOUR_API_KEY und YOUR_MODEL_ID sind Platzhalter: Ersetze alle vor der Nutzung. Beachte die Angaben zu /v1; hänge weder /chat/completions noch /responses an. Die Beispiele verbinden sich nicht automatisch und enthalten keinen echten Schlüssel.

1. Client bestimmen

Diese Dateien gelten für Codex CLI und Clients mit lokaler Konfiguration, nicht für Cloud-Aufgaben im Browser. Für die Einrichtung per Maus nutze den Codex-Zweig der CC-Switch-Anleitung.

2. Konfiguration öffnen

Öffne ~/.codex/config.toml unter macOS/Linux oder %USERPROFILE%\.codex\config.toml unter Windows. Starte Codex einmal, falls die Datei fehlt. Füge das Beispiel passend ein. MY_API_KEY ist ein Variablenname, nicht der Schlüssel.

Feldschema · kein App-Screenshot
Base URL
https://API_HOST/v1
wire_api
responses
model
YOUR_MODEL_ID
env_key
MY_API_KEY
Konfigurationsbeispiel

Sichere zuerst die bestehende Datei. Ändere vorhandene Einträge ohne Duplikate und behalte andere Einstellungen bei. Teile keine Datei oder Aufnahme mit einem echten Schlüssel.

model_provider = "my_api"
model = "YOUR_MODEL_ID"

[model_providers.my_api]
name = "My API"
base_url = "https://API_HOST/v1"
wire_api = "responses"
env_key = "MY_API_KEY"
requires_openai_auth = false

3. Schlüssel setzen und starten

Setze MY_API_KEY wie unten, gehe im selben Terminal in den Testordner und starte codex. Ersetze deine auth.json nicht. Eine über ihr Symbol gestartete Desktop-App übernimmt Terminalvariablen möglicherweise nicht: Nutze dafür CC Switch.

Wenn die Konfiguration MY_API_KEY nutzt, setze die Variable im selben Terminal, aus dem du das Werkzeug startest. Trage deinen Schlüssel nur auf deinem Computer ein. Die Variable gilt bis zum Schließen dieses Terminals.

macOS-/Linux-Terminal
export MY_API_KEY="YOUR_API_KEY"
codex
Windows PowerShell
$env:MY_API_KEY = "YOUR_API_KEY"
codex

4. Modell und Denkstufe wählen

Prüfe das Modell mit /model. Beginne mit dem Standard oder Medium. Alternativ setze model_reasoning_effort = "medium" an den Anfang der config.toml, vor jede [Tabelle]. Nutze nur unterstützte Werte.

5. Format prüfen

Nutze Responses mit wire_api = "responses" und behalte /v1. Übernimm nicht die Chat-Completions-Auswahl aus Harness. Das Modell muss auch Streaming und Werkzeuge des Clients unterstützen.

Prüfung 1: eine Antwort erhalten

Erstelle einen leeren Testordner, wähle ihn als Arbeitsbereich und öffne einen neuen Chat. Prüfe den Anbieter und das Modell und sende die folgende Nachricht. Eine normale Antwort bestätigt die Grundverbindung, nicht alle Agentenfunktionen. Die Tests verursachen regulären API-Verbrauch.

Antworte nur: Verbindung erfolgreich.

Erwartet: „Verbindung erfolgreich“. Bei Anmeldeseite, Fehler oder endlosem Laden zuerst die Hinweise prüfen und nicht wiederholt senden.

Prüfung 2: eine echte Datei lesen

Erstelle im Testordner mit einem Texteditor hello.txt mit dem Inhalt „API connection test 27“. Speichere sie und sende den folgenden Auftrag. Erlaube bei einer Nachfrage nur das Lesen dieses Testordners.

Öffne hello.txt im aktuellen Arbeitsbereich mit dem Dateilesewerkzeug und nenne den Inhalt. Ändere keine Dateien.

Erwartet: ein sichtbarer Werkzeugaufruf zum Lesen von hello.txt und eine Antwort mit API connection test 27. Eine reine Textantwort belegt keinen Werkzeugaufruf. Danach kannst du den Testordner entfernen.

Nach dem Fehlerbild prüfen

401 / Invalid API key

Prüfe, ob Adresse und vollständiger Schlüssel zum selben Dienst gehören und der Schlüssel aktiv ist. Sende dem Support keinen vollständigen Schlüssel.

404 / model not found

Prüfe /v1, die genaue Modell-ID und das Format. Ein gelistetes Modell unterstützt nicht automatisch jedes Format.

429 / quota / balance

Prüfe Guthaben, Schlüssellimit und Anfragerate anhand der Fehlermeldung. Eine höhere Denkstufe löst kein Quotenproblem.

Chat funktioniert, Dateien nicht

Prüfe Modellwerkzeuge, Ordnerrechte und den Ausführungsfehler.

Keine Denkstufenauswahl

Prüfe deklarierte Fähigkeiten, Modell und Clientversion. Denkfähigkeit bedeutet nicht immer einstellbare Denkstufen.

Offizielle Quellen und Geltungsbereich

Konfiguration am 2026-11-08 abgeglichen. Menüs können sich ändern; nutze diese offiziellen Quellen. Maßgeblich sind die aktuellen Verbindungsangaben unserer Plattform.