Codex config.toml: eigener Provider, Base URL und API Key

Direkte Antwort

Um einen eigenen Provider in Codex CLI zu verwenden, bearbeite die ~/.codex/config.toml auf Nutzerebene. Setze model_provider = "custom", definiere [model_providers.custom], verwende https://www.bettertoken.ai/v1 als Base URL und setze wire_api = "responses". Lies den BetterToken API Key über env_key und kopiere die Model ID vom GPT-Provider.

Die richtige Konfigurationsdatei finden

Umgebung	Konfiguration auf Nutzerebene
macOS / Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`
Windows + WSL	`~/.codex/config.toml` innerhalb von WSL

Klicke in der Codex-Erweiterung für VS Code auf das Zahnradsymbol und wähle Codex Settings → Open config.toml. Die CLI und IDE-Erweiterung teilen dieselben Konfigurationsebenen.

Provider- und Authentifizierungseinstellungen gehören in die ~/.codex/config.toml auf Nutzerebene. Projektdateien .codex/config.toml können Projektüberschreibungen enthalten, doch Codex ignoriert dort model_provider und model_providers. Lege Projektanweisungen in AGENTS.md ab.

Minimale funktionsfähige Konfiguration

API-Key-Umgebungsvariable setzen

macOS, Linux oder WSL:

export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

Windows PowerShell:

[Environment]::SetEnvironmentVariable("MODEL_PROVIDER_API_KEY", "YOUR_API_KEY", "User")
$env:MODEL_PROVIDER_API_KEY = "YOUR_API_KEY"

Ersetze YOUR_API_KEY durch deinen BetterToken API Key. Speichere ihn für dauerhafte Nutzung in einer geschützten Betriebssystemumgebung, nicht im Projekt-Repository.

config.toml bearbeiten

model_provider = "custom"
model = "gpt-5.5"

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

model ist ein Beispiel. Kopiere eine aktuell verfügbare Model ID vom GPT-Provider in der model plaza.

Neu starten und testen

Beende Codex vollständig, öffne ein neues Terminal und führe Folgendes aus:

codex

Sende einen einfachen Prompt. Eine normale Antwort bestätigt, dass Provider, Authentifizierung und Model ID aktiv sind.

Empfohlene vollständige Konfiguration

Verwende diese Version, wenn du ein Review-Modell und einen längeren Stream-Timeout benötigst:

model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

Führe vorhandene Felder der obersten Ebene und Inhalte von [model_providers.custom] zusammen. Deklariere dieselbe TOML-Tabelle nicht zweimal.

Wie die Felder zusammenwirken

Feld	Zweck	BetterToken-Wert
`model_provider`	Wählt eine Provider-ID aus	`"custom"`
`[model_providers.custom]`	Definiert diesen Provider	Muss zu `model_provider` passen
`base_url`	Modell-Request-Endpunkt	`https://www.bettertoken.ai/v1`
`env_key`	Benennt die Umgebungsvariable mit dem API Key	`MODEL_PROVIDER_API_KEY`
`wire_api`	Provider-Protokoll	`"responses"`
`requires_openai_auth`	Verwendet offizielle OpenAI-Authentifizierung	`false` für die normale Drittanbieter-API-Einrichtung
`model`	Standard-Model-ID	Eine aktuelle GPT-Provider-ID

Um die offizielle Codex-App-Anmeldung, Plugins und Remote Control bei Nutzung einer Drittanbieter-API beizubehalten, verwende statt dieses normalen Authentifizierungsbeispiels die spezielle Einrichtung für offizielle Anmeldung und einheitliche Sitzung.

Häufige Fehler

Symptom	Ursache	Lösung
Provider nicht gefunden	`model_provider` stimmt nicht mit dem Tabellennamen überein	Verwende an beiden Stellen `custom`
API Key beim Start fehlt	Umgebungsvariable fehlt oder Terminal hat sie nicht neu geladen	Setze `MODEL_PROVIDER_API_KEY` und öffne ein neues Terminal
`401` oder `403`	Falscher Key oder gemischte Authentifizierungsmethoden	Kopiere den Key erneut; halte den Namen von `env_key` gleich und `requires_openai_auth = false`
`404`	Der Base URL fehlt `/v1` oder nutzt das falsche Protokoll	Verwende `https://www.bettertoken.ai/v1`
Modell nicht gefunden	Model ID ist nicht verfügbar oder nicht im GPT-Provider	Kopiere eine aktuelle ID aus der model plaza
Änderungen werden nicht übernommen	Falsche Konfigurationsebene, falscher Pfad oder WSL-Umgebung	Bearbeite die Nutzerkonfiguration in der Umgebung, die Codex ausführt, und starte Codex neu
TOML-Analysefehler	Doppelte Tabelle, Anführungszeichen- oder Verschachtelungsfehler	Entferne doppelte `[model_providers.custom]`-Tabellen und prüfe String-Anführungszeichen

Claude Code

Claude Desktop

Codex

Cursor

Cline

Modellaufrufe

Dienst und Sicherheit

Kosten und Tokens

Grundlagen

Codex config.toml: eigener Provider, Base URL und API Key

Direkte Antwort

Die richtige Konfigurationsdatei finden

Minimale funktionsfähige Konfiguration

Empfohlene vollständige Konfiguration

Wie die Felder zusammenwirken

Häufige Fehler

Verwandte Dokumentation

Referenzen

​Direkte Antwort

​Die richtige Konfigurationsdatei finden

​Minimale funktionsfähige Konfiguration

​Empfohlene vollständige Konfiguration

​Wie die Felder zusammenwirken

​Häufige Fehler

​Verwandte Dokumentation

​Referenzen

Direkte Antwort

Die richtige Konfigurationsdatei finden

Minimale funktionsfähige Konfiguration

Empfohlene vollständige Konfiguration

Wie die Felder zusammenwirken

Häufige Fehler

Verwandte Dokumentation

Referenzen