Source: https://aiprimetech.io/de/learn/use-claude-api-with-codex/ [Startseite](/de/) / [Lernen](/de/learn/) / Codex CLI mit einem benutzerdefinierten Anbieter: config.toml, GPT- und Claude-Modelle, IDE-Erweiterung und Fehlerbehebung # 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 TerminalKopieren ``` # 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 ``` Windows PowerShellKopieren ``` 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. ~/.bashrc oder ~/.zshrcKopieren ``` export AIPRIME_CODEX_KEY=key_from_the_codex_group # GPT models export AIPRIME_CLAUDE_KEY=key_from_a_claude_group # Claude models ``` WindowsKopieren ``` 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 ~/.codex/config.tomlKopieren ``` 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 ``` | Die Einstellung | Warum | [model_providers.aiprime] | Eine beliebige ID außer der reservierten openai, ollama und lmstudio | base_url = "https://aiprimetech.io/v1" | Codex hängt /responses daran an | env_key | Der **Name** der Umgebungsvariablen, die den Schlüssel enthält, nicht der Schlüssel selbst | wire_api = "responses" | Der einzige Wert, den aktuelle Codex-Versionen akzeptieren | supports_websockets = false | Sorgt dafür, dass Codex einfaches HTTP-Streaming verwendet, das über jeden Proxy oder jedes VPN funktioniert Fügen Sie requires_openai_auth = true oder experimental_bearer_token diesem Anbieter nicht hinzu. Mit requires_openai_auth = true ignoriert Codex env_key und sendet stattdessen Ihre ChatGPT- oder OpenAI-Anmeldedaten, die das Gateway ablehnt. ## 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. ~/.codex/config.toml (unterhalb des ersten Anbieters hinzufügen)Kopieren ``` [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 ``` ~/.codex/claude.config.tomlKopieren ``` model_provider = "aiprime_claude" model = "claude-sonnet-5" model_reasoning_effort = "high" ``` TerminalKopieren ``` 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/.config.toml, deren Schlüssel auf oberster Ebene stehen; [profiles.] 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 | Modell-ID | Anbieter | Einsatzbereich | gpt-6-astra | Schlüssel der Codex-Gruppe | Das leistungsstärkste GPT-Modell auf dem Gateway; lange Agentenaufgaben | gpt-6-sol | Schlüssel der Codex-Gruppe | Schnelleres und günstigeres GPT für routinemäßige Programmieraufgaben | gpt-5.6-terra | Schlüssel der Codex-Gruppe | Einfache Aufgaben und schnelle Änderungen | claude-sonnet-5 | Claude-Schlüssel | Standard-Claude für Programmierarbeiten | claude-opus-5-5 | Claude-Schlüssel | Anspruchsvollere Denkaufgaben und umfangreiche Refactorings | claude-fable-5-1 | Claude-Schlüssel | Am leistungsfähigsten und am teuersten 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: TerminalKopieren ``` 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. ~/.codex/config.tomlKopieren ``` [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. | Was Sie sehen | Ursache | Lösung | 403 No active subscription found for this group | Der Schlüssel gehört zu einer Unlimited-Gruppe ohne aktiven Tarif | Verwenden Sie einen Schlüssel aus einer Gruppe mit nutzungsabhängiger Abrechnung (Codex für GPT), oder kaufen Sie einen Tarif | 401 Invalid API key | Die Variable ist im Prozess, der Codex ausführt (häufig die IDE), leer, oder requires_openai_auth = true hat Codex dazu veranlasst, andere Anmeldedaten zu senden | echo $AIPRIME_CODEX_KEY; entfernen Sie requires_openai_auth; starten Sie den Editor neu | 404 Model "..." is not supported by any configured account in this group | Das Modell gehört nicht zur Gruppe des Schlüssels, z. B. ein Claude-Modell mit einem GPT-Schlüssel | Wechseln Sie den Anbieter oder das Profil, damit der Schlüssel zum Modell passt | 426 WebSocket upgrade required | Der WebSocket-Transport ist aktiviert, aber die Verbindung wurde nicht hochgestuft | supports_websockets = false, und entfernen Sie responses_websockets_v2 aus [features] | 403 Your API key has expired | Der Schlüssel wurde mit einem Ablaufdatum erstellt | Erstellen Sie im Dashboard einen neuen Schlüssel | 'none' is not supported | Denkaufwand eingestellt auf none | Verwenden Sie low oder höher | 404 page not found | base_url enthält /v1 zweimal | Verwenden Sie genau https://aiprimetech.io/v1 | Konfigurationsfehler bezüglich wire_api nach einem Upgrade | A wire_api = "chat" Zeile aus einer alten Anleitung | Setzen Sie wire_api = "responses" | Your balance is used up | Das Guthaben ist aufgebraucht | [Guthaben aufladen](/de/topup/) | Concurrency limit exceeded for user | Mehrere Codex-Agenten oder -Fenster laufen gleichzeitig | Führen Sie weniger parallel aus oder bitten Sie den Support um eine höhere Parallelitätsgrenze Sie vergleichen Codex mit Claude Code, bevor Sie sich entscheiden? Siehe [Claude Code im Vergleich zu Codex](/de/claude-code/vs-codex/). ## Häufig gestellte Fragen Wo befindet sich die Codex-Konfigurationsdatei? ~/.codex/config.toml (oder $CODEX_HOME/config.toml). Die CLI, codex exec und die IDE-Erweiterung lesen alle diese Datei. In der .codex/config.toml eines Projekts können keine Provider festgelegt werden. Kann die Codex CLI Claude-Modelle verwenden? Ja, über ein Gateway, das Responses API-Anfragen für Claude-Modelle akzeptiert. Fügen Sie einen Provider mit einem Claude-Schlüssel hinzu und setzen Sie model auf eine ID wie claude-sonnet-5. Funktioniert wire_api = "chat" in Codex noch? Nein. Die Codex-Konfigurationsreferenz nennt responses als einzigen unterstützten Wert. Wird die Angabe weggelassen, ist dies der Standardwert. Warum meldet die Codex-Erweiterung für VS Code einen ungültigen API-Schlüssel, obwohl die CLI funktioniert? env_key wird aus der Umgebung des Editors gelesen. Setzen Sie die Variable systemweit oder starten Sie den Editor aus einem Terminal, in dem sie exportiert ist. Was bedeutet „Für diese Gruppe wurde kein aktives Abonnement gefunden“ in Codex? Der Schlüssel gehört zu einer Abonnementgruppe (Unlimited) ohne aktiven Tarif. Verwenden Sie einen Schlüssel aus einer Gruppe mit nutzungsbasierter Abrechnung oder kaufen Sie einen Tarif. Claude in wenigen Minuten nutzen Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) 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. Anleitungen zu Codex und der GPT API: [Codex API-Schlüssel und Zugriff](/de/codex-api/) · [OpenAI-kompatible API](/de/openai-api/) · [Codex CLI einrichten](/de/docs/guides/codex-cli/) · [Modellvergleich für GPT-6](/de/blog/gpt-6-models-for-codex/) ## Weitere Anleitungen zur Claude API [So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude über eine OpenAI-kompatible API nutzen](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler](/de/learn/use-claude-api-with-opencode/)[Einen unbegrenzten Hermes-Agenten mit Claude betreiben](/de/learn/run-hermes-agent-with-claude-api/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[Claude in GitHub Copilot integrieren](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)