Coding Agents einrichten

Codex VS Code Extension: eigene API und offizielle Anmeldung

Richte config.toml für die Codex VS Code Extension mit BetterToken Responses ein. Behalte offizielle Anmeldung, Plugins und Remote Control bei.

Die Codex VS Code Extension teilt ~/.codex/config.toml mit Codex CLI/App. Verwende diese Seite, wenn du die offizielle Anmeldung, Plugins oder Remote Control beibehalten musst.

Wichtige Einstellungen

Feld	Wert
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

Voraussetzungen

Installiere die neueste Codex VS Code Extension
Schließe die offizielle Anmeldung in der Extension oder Codex App ab
Erstelle einen BetterToken API Key
Kopiere eine Model ID aus der model plaza oder dem Key-Dialog Setup

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Installation

Installiere die Extension aus dem VS Code Marketplace und starte VS Code neu.

Manuelle Einrichtung

Wenn du ein eigenes CODEX_HOME festgelegt hast, bearbeite dort config.toml. Andernfalls nutze ~/.codex/config.toml unter macOS / Linux oder %USERPROFILE%\.codex\config.toml unter Windows.

Beende Codex vollständig und sichere die vorhandenen Dateien config.toml und auth.json. Aktualisiere die bestehenden Provider-Einstellungen, ohne eine doppelte Provider-Tabelle hinzuzufügen.

Extension konfigurieren

Bearbeite ~/.codex/config.toml:

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

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

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.
`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.
`experimental_bearer_token`	Provider-Tabelle; Bearer Key für Drittanbieteranfragen.	BetterToken API Key eintragen. Der offizielle Anmeldecache bleibt unverändert. Wird im Klartext gespeichert; OpenAI rät von diesem Feld ab.
`supports_websockets`	Provider-Tabelle; Unterstützung für Responses WebSocket.	Standard: `false`; hier bleibt HTTP/SSE aktiv.

Die beim offiziellen Login erzeugten Anmeldedaten behalten, nicht durch API-Key-JSON ersetzen. requires_openai_auth = true verwendet den offiziellen Authentifizierungsablauf; experimental_bearer_token des aktuellen Providers liefert den Drittanbieter-Key für Modellanfragen. Mit ersterem ignoriert Codex env_key; diesen deshalb nicht direkt anstelle des Bearer Keys einsetzen. Konfigurationsdateien mit Keys nicht teilen.

Als alternative Zugangsdaten-Konfiguration siehe OpenAIs Hinweise zu Umgebungsvariablen und befehlsbasierter Authentifizierung. Dies sind getrennte Authentifizierungsmodi: Füge keine Provider-Tabelle auth neben env_key, experimental_bearer_token oder requires_openai_auth hinzu. Verwende in diesem Beispiel, das die Anmeldung beibehält, auch nicht env_key anstelle des Bearer Keys.

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.

Speichere die Datei, führe Developer: Reload Window in VS Code aus und öffne das Codex-Panel erneut.

Verbindung überprüfen

Erstelle eine neue Extension-Sitzung und sende eine kurze Aufgabe. Eine Antwort von gpt-6-astra, während Plugins und Remote Control verfügbar bleiben, bestätigt die Einrichtung.

Modelle wechseln

Ändere model und optional review_model, führe dann Developer: Reload Window aus. Verwende eine Model ID aus dem Setup-Dialog oder der model plaza.

Häufige Fehler

Fehler	Lösung
Extension fordert erneute Anmeldung	Stelle die offizielle Anmeldung wieder her und behalte `requires_openai_auth = true`.
`401` oder `403`	Kopiere `experimental_bearer_token` erneut; überschreibe `auth.json` nicht.
Doppelte Tabelle	Entferne die andere Tabelle `[model_providers.bettertoken]` und behalte einen Authentifizierungsmodus.
Modell nicht gefunden	Ersetze `gpt-6-astra` durch eine aktuelle vollständige Model ID.
Konfiguration nicht angewendet	Speichere die Datei und führe Developer: Reload Window aus.