Codex CLI auf Prepaid-Guthaben, über einen Provider-Block

Codex CLI ist der Coding-Agent von OpenAI für die Kommandozeile. Seine Konfiguration hat die Einstellung model_provider mit dem Standardwert openai, Requests gehen also an die Schnittstelle von OpenAI selbst. Diese Einstellung lässt sich ändern: Definieren Sie in config.toml einen eigenen Provider mit der Endpoint-Adresse und dem Namen der Umgebungsvariable, in der der Key liegt, und zeigen Sie mit model_provider darauf. Befehle und Bedienung von Codex bleiben gleich; es wechselt nur, wer abrechnet.

Codex spricht genau ein Protokoll, die Responses API von OpenAI: Die Konfigurationsreferenz nennt für wire_api nur den Wert responses. Bei einem Gateway ist deshalb zuerst zu klären, ob es /v1/responses anbietet und nicht nur /v1/chat/completions. Hier gibt es beide Routen, und Codex nutzt die erste.

Der Block unten hat vier Zeilen, und der API-Key steht nicht in der Datei. Die Bedeutung der einzelnen Einstellungen:

• model_provider wählt den Block über den Namen seiner Tabelle aus. Den Namen legen Sie selbst fest, aber openai, ollama, lmstudio, amazon-bedrock, amazon-bedrock-runtime und gcp sind eingebaute Codex-IDs, die sich nicht überschreiben lassen.
• base_url erhält https://api.relayswitch.io/v1, mit /v1; Codex hängt /responses an.
• env_key ist der Name der Umgebungsvariable, in der der Key liegt, nicht der Key selbst. Da der Key in der Umgebungsvariable bleibt, kann die Konfigurationsdatei gefahrlos committet oder synchronisiert werden.
• wire_api hat nur einen gültigen Wert, responses, und das ist auch der Standardwert; die Zeile darf also entfallen.
• requires_openai_auth hat den Standardwert false und muss nicht geschrieben werden: Ein eigener Provider verwendet den Key aus env_key, nicht den Login eines OpenAI-Kontos.

Schreiben Sie den Block in ~/.codex/config.toml. Das Verzeichnis wird durch die Umgebungsvariable CODEX_HOME bestimmt und ist standardmäßig ~/.codex; der Provider muss in dieser Datei auf Benutzerebene stehen. Exportieren Sie danach den Key in dem Terminal, in dem Codex läuft, und starten Sie. Tragen Sie die export-Zeile in die Konfigurationsdatei Ihrer Shell ein, damit auch neue Terminals sie mitbringen.

Schicken Sie vor dem Start von Codex einen kleinen Responses-Request, um Key und Adresse zu prüfen. Die Option -i zeigt die Statuszeile und die Antwort-Header, darunter die Request-ID.

Kommt 200 zurück, starten Sie codex und geben Sie die erste Anweisung. Der Request erscheint innerhalb von Sekunden auf der Usage-Seite der Console, mit Token und Kosten. Um das Modell vorübergehend zu wechseln, verwenden Sie codex --model gefolgt von der ID.

Diese Tabelle zeigt die GPT-Modelle im Katalog in USD pro Million Token, mit getrennten Preisen für Input, Cached Input und Output. Codex ist für GPT-Modelle und die Responses-Route gebaut; stellen Sie also sicher, dass die ID, die Sie in config.toml schreiben, auf den curl-Test oben antwortet.

Codex sendet bei jedem Turn die Unterhaltung und die Tool-Ausgaben erneut. Diese Token werden zum Preis für Cached Input abgerechnet, wenn sie den Cache treffen, und die Antwort meldet die Zahl der gecachten Token; ob der Cache greift, hängt vom Modell und vom Request selbst ab. Damit wird Sparen konkret: ein günstigeres Modell für alltägliche Änderungen und das teurere nur für schwierige Reviews und Refactorings, eine neue Sitzung nach jeder abgeschlossenen Aufgabe, damit der Kontext nicht immer länger wird, und ein eigener Key für Codex mit Dollar-Budget und täglichem Ausgabenlimit. Ist das Limit erreicht, antwortet das Gateway mit 402 und nur dieser Key stoppt; das übrige Guthaben des Kontos bleibt unberührt.

Ein Profil ist eine Datei namens ~/.codex/<name>.config.toml, die nur die Zeilen enthält, die von config.toml abweichen, und darübergelegt wird, wenn Codex mit codex --profile <name> gestartet wird. Seit Codex 0.134.0 werden Tabellen [profiles.<name>] in config.toml nicht mehr gelesen, und der Selektor profile = auf oberster Ebene wurde entfernt; Tutorials von davor verwenden noch die alte Form und funktionieren nicht, wenn man sie kopiert. Der Wert von model_reasoning_effort richtet sich nach den Stufen, die das gewählte Modell unterstützt; Codex sendet ihn mit jedem Request, und das Gateway reicht ihn unverändert an das Modell weiter.

Mit einem eigenen Provider zeigt das Menü /model in Codex weiterhin die eingebauten OpenAI-Modelle, nicht die Modelle Ihres Providers. Eine Auswahl dort schreibt die aktive Profildatei um: Das Modell wechselt, der Provider nicht. Steht die eingetragene ID im Katalog, läuft Codex zum Preis dieses Modells; wenn nicht, lautet die Antwort 404. Zum Modellwechsel verwenden Sie --profile oder --model.

Die Status 401 bis 404 werden zurückgegeben, bevor der Request das Modell erreicht, und 429, 502 und 503 enthalten keine Antwort; nichts davon wird abgerechnet. Die vollständige Tabelle pro Status steht auf der Seite zur OpenAI API. Für Coding mit Claude im Terminal verwenden Sie Claude Code; beide laufen mit demselben Key und demselben Guthaben, und wie Sie einen Key erstellen, steht auf der Seite zum Claude API Key.