Wie konfiguriere ich GPT-6 Astra im API-Modus von Codex?

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.

Aktualisiere Codex, bevor du gpt-6-astra nutzt.

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.

config.toml bearbeiten

Diese Anleitung verwendet die benutzerweite config.toml. Oberste Schlüssel stehen vor allen TOML-Tabellen, nicht in [projects."<path>"]; diese Tabelle enthält den trust_level des Projekts. Provider-ID und Tabellenname müssen übereinstimmen. Bei Dateiauthentifizierung env_key und experimental_bearer_token aus dem ausgewählten Provider entfernen.

model_provider = "bettertoken"
model = "gpt-6-astra"
cli_auth_credentials_store = "file"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

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.

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

Konfigurationsparameter

Parameter	Zweck und Position	Standardwerte und Beispiele
model_provider	Benutzerkonfiguration, oberste Ebene; wählt die unten definierte ID.	Standard: openai; hier bettertoken.
model	Oberste Ebene; vollständige Model ID aus dem Modellplatz.	Beispiel: gpt-6-astra; bei Bedarf ersetzen.
cli_auth_credentials_store	Oberste Ebene; Speicher für Anmeldedaten.	Hier file: liest auth.json im selben Verzeichnis.
name	Provider-Tabelle; nur der Anzeigename.	BetterToken ist keine Model ID.
base_url	Provider-Tabelle; Base URL der Modell-API.	https://bettertoken.ai/v1 verwenden; Codex ergänzt /responses.
wire_api	Provider-Tabelle; Anfrageprotokoll.	Nur responses wird aktuell unterstützt und ist der Standard.
requires_openai_auth	Provider-Tabelle; OpenAI-Authentifizierung und Anmeldespeicher.	Standard: false; hier true. Kein Schalter zum Erhalten von Anmeldedateien.
supports_websockets	Provider-Tabelle; Unterstützung für Responses WebSocket.	Standard: false; hier bleibt HTTP/SSE aktiv.
auth_mode	In auth.json; Authentifizierungsmodus.	Hier apikey; ersetzt die offizielle ChatGPT-Authentifizierung.
OPENAI_API_KEY	In auth.json; Schlüssel für API-Authentifizierung.	YOUR_API_KEY durch den BetterToken API Key ersetzen.

Die Dateiauthentifizierung hier wechselt in den API-Key-Modus. Für den offiziellen Account verwende Anmeldung beibehalten; die Modi nicht mischen. Entscheidend ist das Authentifizierungsziel, nicht CLI, App oder Extension.

Optionale Anpassungen

Diese drei Einstellungen sind optional und für die Verbindung nicht erforderlich. Bei Bedarf in die vorhandene Tabelle [model_providers.bettertoken] einfügen; keine doppelte Tabelle erstellen.

request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000

Parameter	Zweck und Position	Standardwerte und Beispiele
request_max_retries	Provider-Tabelle; maximale Wiederholungen einer HTTP-Anfrage.	Standard: 4; je nach Verbindung anpassen.
stream_max_retries	Provider-Tabelle; Verbindungswiederholungen nach Stream-Abbruch.	Standard: 5; 8 ist ein optionaler benutzerdefinierter Wert.
stream_idle_timeout_ms	Provider-Tabelle; Stream-Inaktivitätslimit in Millisekunden.	Standard: 300000; keine Gesamtdauer für die Aufgabe.

Konfigurationsebenen und alte Schlüssel

Modell- und Denkeinstellungen gehören nicht in [projects."<path>"]. Ein projektspezifisches Modell kann auf oberster Ebene der .codex/config.toml eines vertrauenswürdigen Projekts stehen; Provider und Authentifizierung bleiben in der Benutzerkonfiguration. Aktuelle Profile verwenden NAME.config.toml unter CODEX_HOME, ausgewählt mit codex --profile NAME, statt alter [profiles.NAME]-Tabellen oder des obersten profile-Schlüssels.

Neu starten und prüfen

Speichere beide Dateien. Starte eine neue Codex-CLI-Sitzung direkt im Terminal:

codex

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.

Fehlerbehebung

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.

Verwandte Anleitungen

• Einrichtungsanleitung für Codex CLI/App
• Offizielle Authentifizierungsreferenz