Skip to main content
Codex CLI und Codex App teilen sich config.toml und auth.json für lokale Aufgaben. Diese Einrichtung nutzt einen BetterToken API Key über OpenAI Responses.

​
Wichtige Einstellungen

​
Voraussetzungen

​
Installation

​
Dateien finden und sichern

Wenn du ein eigenes CODEX_HOME festgelegt hast, bearbeite dort config.toml und auth.json. Andernfalls nutze ~/.codex unter macOS / Linux oder %USERPROFILE%\.codex unter Windows. CLI und App müssen dasselbe Verzeichnis nutzen. WSL hat ein eigenes Benutzerverzeichnis. Beende Codex vor dem Bearbeiten vollständig. Sichere beide Dateien an einem privaten Ort. Lege fehlende Dateien an. Ersetze bestehende Einstellungen, ohne Schlüssel oder Tabellen zu duplizieren; behalte andere Einstellungen bei.
Diese Konfiguration wechselt von der ChatGPT-Anmeldung zur API-Key-Authentifizierung. Sie erhält den Zugriff auf das offizielle Konto nicht. Schütze auth.json und seine Sicherungen; teile sie nicht und nimm sie nicht ins Repository auf.

​
Konfiguration über die Befehlszeile

Das automatische BetterToken-Konfigurationsskript schreibt die Anbieter-Konfiguration für Codex. Es benötigt Node.js und fragt nach API Key oder Modell-ID, wenn sie nicht als Argumente übergeben wurden.
Vergleiche nach der Installation beide Dateien mit der manuellen Konfiguration unten und korrigiere Abweichungen vor dem Start von Codex.

​
Manuelle Konfiguration

​
config.toml bearbeiten

Setze model_provider, model und cli_auth_credentials_store auf die oberste Ebene vor allen TOML-Tabellen, nicht in ein Profil. Die Provider-ID muss zum Tabellennamen passen. Entferne für diese Dateiauthentifizierung env_key und experimental_bearer_token aus dem gewählten Provider.
Das Beispiel nutzt GPT-6 Astra (gpt-6-astra). Kopiere für ein anderes Modell die vollständige ID aus der model plaza und ersetze model. GPT, Kimi und GLM nutzen dieselbe Dateiauthentifizierung; die automatische Einrichtung ist für GPT verfügbar.

​
auth.json bearbeiten

auth.json befindet sich im selben Verzeichnis wie config.toml. Falls auth.json nicht existiert, erstelle die Datei in diesem Verzeichnis. Trage das folgende JSON als Dateiinhalt ein, ersetze YOUR_API_KEY durch deinen BetterToken API Key und speichere die Datei.

​
Verbindung prüfen

Speichere beide Dateien. Starte eine neue Codex-CLI-Sitzung direkt im Terminal:
Beende Codex App einschließlich der Hintergrundprozesse vollständig. Öffne die App erneut und erstelle eine neue lokale Aufgabe. Sende in jedem verwendeten Client eine kurze Anfrage. Eine normale Antwort bestätigt die Verbindung dieses Clients.

​
Modelle wechseln

Ändere model und optional review_model. Speichere die Datei, beende den aktuellen Codex-Prozess und starte ihn neu. Verwende die Modell-ID aus dem Setup-Dialog oder model plaza.

​
Häufige Fehler

Prüfe bei 401, 403 oder einer Anmeldeaufforderung das aktive Verzeichnis, den Key in auth.json, auth_mode = apikey, cli_auth_credentials_store = file und requires_openai_auth = true. Prüfe bei Provider- oder Modellfehlern die passende Provider-ID, https://bettertoken.ai/v1, wire_api = responses und die Modellverfügbarkeit. Wenn Änderungen nicht greifen, prüfe Konfigurationsüberschreibungen und stelle sicher, dass CLI und App dasselbe CODEX_HOME nutzen.

​
Erweiterte Konfiguration

​
Unterstützte Provider

Die Statusangaben gelten für die auf dieser Seite beschriebene BetterToken-Konfiguration.
  • Befehlszeile + manuelle Konfiguration: Nutze einen generierten Befehl oder führe alle manuellen Schritte aus.
  • Manuelle Konfiguration: Gib API Key, Base URL und Model ein.
  • Nicht unterstützt: Derzeit gibt es keine verifizierte Methode für die direkte Verbindung.

​
Codex-Erweiterung

Die Codex-Erweiterung für VS Code verwendet dieselbe config.toml. Um die offizielle Anmeldung beizubehalten, ist jedoch eine andere Authentifizierungskonfiguration erforderlich. Siehe Anleitung für die Codex-Erweiterung.

​
Verwandte Fragen

​
Offizielle Referenz

​
Technische Details

Codex verwendet OpenAI Responses. Setze base_url auf https://bettertoken.ai/v1 und behalte wire_api = "responses" bei. Codex hängt /responses an.