Startseite → Ratgeber → Codex mit eigener API: config.toml für Codex CLI und Codex Desktop

Codex mit eigener API: config.toml für Codex CLI und Codex Desktop

Codex liest seinen Anbieter aus einer Datei. Fünf Zeilen Konfiguration und eine Umgebungsvariable stellen das Kommandozeilen-Tool und die Desktop-App gleichzeitig um – und die meisten Fehler liegen an der Umgebungsvariable, nicht an der Konfiguration.

Die Konfiguration

Fügen Sie in config.toml einen Anbieter hinzu und machen Sie ihn zum Standard:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Drei Details zählen. base_url endet auf /v1, weil Codex /responses selbst anhängt. wire_api = "responses" lässt Codex die Responses-API nutzen, die dieses Gateway bedient. Und env_key ist der Name einer Umgebungsvariable, nicht der Schlüssel selbst.

Wo die Datei liegt

macOS / Linux: ~/.codex/config.toml
Windows: %USERPROFILE%\.codex\config.toml

Legen Sie Ordner und Datei an, falls sie fehlen. Die Codex-Desktop-App liest dieselbe Datei wie das Kommandozeilen-Tool – eine Änderung gilt für beide. Wer TOML nicht von Hand bearbeiten will, lässt CC Switch die Datei schreiben – siehe den Ratgeber zu Desktop-Apps.

Den Schlüssel so setzen, dass Codex ihn sieht

macOS / Linux – in Ihr Shell-Profil eintragen:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows – für Ihr Benutzerkonto speichern:

setx APICLAN_API_KEY "sk-your-key"

Hier scheitern die meisten Einrichtungen. Eine mit export oder $env: gesetzte Variable existiert nur in diesem Terminal; die Desktop-App, gestartet über Dock oder Startmenü, sieht sie nie. setx unter Windows speichert sie dauerhaft, aber nur danach gestartete Programme übernehmen sie – beenden Sie Codex vollständig und öffnen Sie es neu.

Modell und Denkaufwand wählen

Ändern Sie model in der Konfiguration oder wechseln Sie in einer Sitzung mit /model:

Modell	Geeignet für
`gpt-6.1-sol`, `gpt-5.6-terra`	Alltägliches Programmieren, Änderungen, Tests – am günstigsten pro Aufruf
`gpt-5.6-sol`	Wenn Ihre Prompts auf GPT-5.6 abgestimmt sind
`gpt-6-astra`	Schwere Probleme, bei denen eine bessere Antwort den fünffachen Preis wert ist

model_reasoning_effort akzeptiert low, medium, high und xhigh. Mehr Aufwand schreibt mehr: Bei gpt-5.6-sol lieferte der mittlere Aufruf hier mit high 373 Output-Tokens, mit medium 139 – das 2,7-Fache, alles als Output berechnet. Beginnen Sie mit medium. Preise stehen im Ratgeber zu OpenAI-API-Preisen.

Wie Codex-Verkehr hier aussieht

In den letzten 30 Tagen kamen 87 % aller GPT-Aufrufe auf diesem Gateway von Codex, jeder davon über /v1/responses mit Streaming. Der mittlere Aufruf:

trug rund 67.000 Tokens Kontext, 86 % davon aus dem Cache
dauerte insgesamt 14 Sekunden, das erste Token nach 10
lieferte 214 Output-Tokens

Die vier häufigsten Fehler

401 Unauthorized → Codex sieht APICLAN_API_KEY nicht. Wie oben setzen und Codex vollständig neu starten. echo $APICLAN_API_KEY in derselben Umgebung sollte den Schlüssel ausgeben.
404 oder eine HTML-Seite → base_url fehlt /v1, oder es steht doppelt da.
model not found → der Modellname ist falsch geschrieben, oder Ihr Schlüssel gehört zu einer Gruppe ohne dieses Modell. Maßgeblich ist GET https://apiclan.us/v1/models.
stream disconnected oder Timeout bei langen Aufgaben → sehr langes Nachdenken übersteigt die Geduld eines Proxys. Ändern Sie base_url auf https://api.apiclan.us/v1, das umgeht das 100-Sekunden-Limit.

Claude Code folgt der umgekehrten Konvention – ohne /v1 –, beschrieben im Ratgeber zur Claude-Code-Base-URL.

Loslegen

Kein Abo, kein monatlicher Mindestumsatz, kein Vertriebsgespräch. Lade mit USDT auf und zahle, was du verbrauchst — 1 USDT ergibt 2 Guthaben an API-Kontostand.

Den 30-Sekunden-Schnellstart lesen

Sprache: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Die Preise auf dieser Seite werden automatisch aus echten Abrechnungsdaten übernommen. Bedingungen Dritter sind aus deren eigener Dokumentation zitiert.