Eigener Codex-Provider: model_provider, Base URL und wire_api

Kurzantwort

model_provider teilt Codex CLI mit, welchen Provider es verwenden soll. Sein Wert muss mit einer unter [model_providers.<id>] definierten Provider-ID übereinstimmen. base_url ist der API-Endpunkt, an den Modell-Requests gesendet werden. Für einen OpenAI-kompatiblen Provider verweist er normalerweise auf einen Endpunkt im /v1-Stil. wire_api teilt Codex mit, welches Protokollformat bei der Kommunikation mit diesem Provider verwendet werden soll. In der Codex-Konfigurationsreferenz ist responses ein unterstützter Wert für das Provider-Protokoll.

Wann das wichtig ist

Du konfigurierst einen eigenen OpenAI-kompatiblen Provider
Codex meldet, dass der Provider nicht gefunden wird, oder Modell-Requests schlagen fehl
Du bist nicht sicher, worin sich model_provider von model unterscheidet
Du setzt BetterToken, OpenAI oder einen anderen Provider in einer config.toml ein
Du musst Base URL, API Key und Model ID voneinander trennen

Beziehungen der Felder

Feld	Zweck
`model_provider`	Wählt die aktive Provider-ID aus
`[model_providers.<id>]`	Definiert die detaillierte Konfiguration eines Providers
`name`	Anzeigename für den Provider
`base_url`	API-Stammendpunkt
`wire_api`	Provider-Protokoll, üblicherweise `responses`
`model`	Standard-Model-ID für das Hauptmodell
`review_model`	Modell für Code-Review-Abläufe wie `/review`

Empfohlenes Muster

Halte die Provider-ID konsistent:

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

Das bedeutet, dass Codex den Provider namens custom verwendet, Modell-Requests an https://www.bettertoken.ai/v1 sendet und über das Responses-API-Format kommuniziert. Lege den API Key nicht direkt in config.toml ab. Setze ihn im Terminal, das Codex startet:

export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

In Windows PowerShell:

$env:MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

Einrichtung überprüfen

Bestätige, dass model_provider = "custom" genau mit [model_providers.custom] übereinstimmt.
Bestätige, dass die Base URL https://www.bettertoken.ai/v1 einschließlich /v1 ist.
Kopiere eine aktuelle Model ID vom GPT-Provider in der model plaza.
Beende Codex vollständig und starte es über ein neues Terminal, in dem die Umgebungsvariable gesetzt ist.
Sende eine kleine Aufgabe zur Code-Erklärung und bestätige, dass Codex eine vollständige Antwort zurückgibt.

Fehlerbehebung

Symptom	Ursache	Lösung
Provider nicht gefunden	Provider-ID und Konfigurationstabelle stimmen nicht überein	Verwende an beiden Stellen `custom`
API Key beim Start fehlt	Die durch `env_key` benannte Variable ist nicht verfügbar	Setze `MODEL_PROVIDER_API_KEY` und öffne dann ein neues Terminal
`401` oder `403`	Ungültiger API Key oder gemischte OpenAI-Authentifizierung	Kopiere den Key erneut und setze `requires_openai_auth = false`
`404`	Der Base URL fehlt `/v1` oder verweist auf einen Anthropic-Endpunkt	Verwende `https://www.bettertoken.ai/v1`
Modell nicht gefunden	Der Wert ist ein Anzeigename, ausgemustertes Modell oder Nicht-GPT-Modell	Kopiere eine aktuelle Model ID aus der model plaza
Responses-Protokollfehler	`wire_api` fehlt oder ist falsch	Setze `wire_api = "responses"`

Claude Code

Claude Desktop

Codex

Cursor

Cline

Modellaufrufe

Dienst und Sicherheit

Kosten und Tokens

Grundlagen

Eigener Codex-Provider: model_provider, Base URL und wire_api

Kurzantwort

Wann das wichtig ist

Beziehungen der Felder

Empfohlenes Muster

Einrichtung überprüfen

Fehlerbehebung

Verwandte Dokumentation

Referenzen

​Kurzantwort

​Wann das wichtig ist

​Beziehungen der Felder

​Empfohlenes Muster

​Einrichtung überprüfen

​Fehlerbehebung

​Verwandte Dokumentation

​Referenzen

Kurzantwort

Wann das wichtig ist

Beziehungen der Felder

Empfohlenes Muster

Einrichtung überprüfen

Fehlerbehebung

Verwandte Dokumentation

Referenzen