Codex CLI mit einem benutzerdefinierten Anbieter: config.toml, GPT- und Claude-Modelle, IDE-Erweiterung und Fehlerbehebungen

Codex liest eine Datei, ~/.codex/config.toml, die von der CLI, codex exec und der IDE-Erweiterung gemeinsam verwendet wird. Ein benutzerdefinierter Anbieter in dieser Datei verbindet Codex mit diesem Gateway, über das dieselbe Konfiguration GPT- und Claude-Modelle ausführt. Aktuelle Codex-Versionen verwenden ausschließlich die Responses API (wire_api = "responses"), daher funktionieren ältere Anleitungen, die wire_api = "chat" verwenden, nicht mehr.

Codex installieren

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# or with a package manager
npm install -g @openai/codex
brew install --cask codex

codex --version

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Die Codex-Erweiterung für VS Code, Cursor und Windsurf wird über den Erweiterungsmarktplatz des Editors installiert und verwendet dieselbe ~/.codex/config.toml wie die CLI, daher gilt alles Folgende für beide.

Einen Schlüssel aus der richtigen Gruppe verwenden

Ein Gateway-Schlüssel gehört zu einer Gruppe, und diese Gruppe bestimmt, welche Modelle der Schlüssel aufrufen kann. Erstellen Sie für GPT-Modelle im Dashboard einen Schlüssel in der Gruppe **Codex**. Für Claude-Modelle funktioniert jeder Claude-Schlüssel mit nutzungsabhängiger Abrechnung. Ein Schlüssel aus einer Unlimited-Gruppe benötigt einen aktiven Tarif; ohne diesen schlägt jede Anfrage fehl mit No active subscription found for this group.

export AIPRIME_CODEX_KEY=key_from_the_codex_group    # GPT models
export AIPRIME_CLAUDE_KEY=key_from_a_claude_group    # Claude models

setx AIPRIME_CODEX_KEY "key_from_the_codex_group"
setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group"
# open a new terminal afterwards

config.toml für GPT-Modelle

model_provider = "aiprime"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.aiprime]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CODEX_KEY"
wire_api = "responses"
supports_websockets = false

Codex mit Claude-Modellen ausführen

Das Gateway akzeptiert Responses API-Anfragen für Claude-Modelle und übersetzt sie, sodass Codex auch Claude nutzen kann. Fügen Sie einen zweiten Anbieter hinzu, der Ihren Claude-Schlüssel verwendet, und anschließend ein Profil, um zu diesem Anbieter zu wechseln.

[model_providers.aiprime_claude]
name = "AI Prime Tech (Claude)"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CLAUDE_KEY"
wire_api = "responses"
supports_websockets = false

model_provider = "aiprime_claude"
model = "claude-sonnet-5"
model_reasoning_effort = "high"

codex --profile claude
codex exec --profile claude "review the last commit for bugs"

Seit Codex 0.134.0 ist ein Profil eine eigene Datei, ~/.codex/<name>.config.toml, deren Schlüssel auf oberster Ebene stehen; [profiles.<name>] Tabellen innerhalb von config.toml werden nicht mehr gelesen. Profile und Anbieter können nur in Ihrer Benutzerkonfiguration festgelegt werden: Die projektbezogene .codex/config.toml ignoriert model_provider und model_providers.

Modelle und Denkaufwand

model_reasoning_effort akzeptiert low, medium, high, xhigh oder max, je nach Modell. Setzen Sie nicht none: Diese Modelle lehnen den Wert ab mit 'none' is not supported. review_model legt ein anderes Modell fest für /review falls Sie eines wünschen. Das Dashboard zeigt alle Modelle an, die die Gruppe Ihres Schlüssels aufrufen kann.

IDE-Erweiterung und codex exec

Die IDE-Erweiterung liest dieselbe config.toml, aber env_key wird aus der eigenen Umgebung des Editors aufgelöst. Ein über das Dock oder das Startmenü gestarteter Editor sieht keine Variablen, die exportiert wurden in .bashrc, und Codex schlägt dann fehl mit Invalid API key während die CLI funktioniert. Legen Sie die Variable systemweit fest (unter Windows erledigt setx dies), oder starten Sie den Editor aus einem Terminal, z. B. code ..

codex exec führt eine Aufgabe ohne interaktive Benutzeroberfläche aus und eignet sich damit für Skripte und CI. Es verwendet dieselbe Konfiguration und dieselben Profile:

codex exec "write unit tests for utils.py"
codex exec --profile claude "summarise the changes on this branch"
codex login status        # which authentication method is active

Wiederholungsversuche und Zeitlimits

Jeder Anbieter hat eigene Einstellungen für Wiederholungsversuche und Streams. Die Standardwerte sind 4 Wiederholungsversuche für Anfragen, 5 erneute Stream-Verbindungen und ein Inaktivitäts-Timeout von 5 Minuten pro Stream. Lange Denkphasen können eine Weile ohne Ausgabe bleiben, daher hilft es bei hohem Denkaufwand, das Inaktivitäts-Timeout zu erhöhen.

[model_providers.aiprime]
# ...settings from above...
request_max_retries = 6
stream_max_retries = 8
stream_idle_timeout_ms = 600000

Fehlerbehebung: Häufige Fehler bei Codex

Die folgenden Fehler werden von Codex-Clients auf diesem Gateway tatsächlich ausgegeben, beginnend mit den häufigsten.

Sie vergleichen Codex mit Claude Code, bevor Sie sich entscheiden? Siehe Claude Code im Vergleich zu Codex.

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.