Codex CLI mit Drittanbieter-API einrichten
Stand 2026-10-07 binden Sie Codex CLI an einen Drittanbieter- oder eigenen API-Endpunkt an, indem Sie in ~/.codex/config.toml unter model_providers eine eigene Tabelle mit base_url, wire_api und env_key (dem Namen der Umgebungsvariable, die Ihren Key enthält) anlegen und das Top-Level-Feld model_provider darauf verweisen lassen; laut offizieller Konfigurationsreferenz ist responses der einzige unterstützte Wert für wire_api. Für QCode lautet base_url https://api.qcode.cc/openai und env_key ist der Name der Umgebungsvariable, die Sie selbst für Ihren QCode-Key festlegen. Diese Seite erklärt jeden Schlüssel, die häufigsten Fehler und welche Modelle sich eignen.
Aktualisiert 2026-10-07
Vier Werte, auf die es ankommt
Einziger Wert für wire_api
Die offizielle Konfigurationsreferenz nennt responses als einzigen unterstützten Wert, der auch gilt, wenn das Feld fehlt. Die QCode-Dokumentation setzt wire_api ebenfalls auf responses; das entspricht dem Pfad /openai/v1/responses.
Umgebungsvariable mit dem Key
In env_key steht der Name einer Umgebungsvariable, nicht der Key selbst; offiziell ist es die Umgebungsvariable, die den API-Key des Providers liefert. QCode-Keys beginnen mit cr_. Den Variablennamen können Sie frei wählen; das Beispiel in der QCode-Dokumentation verwendet CRS_OAI_KEY.
So endet die base_url bei QCode
Laut QCode-Dokumentation muss die base_url für Codex https://api.qcode.cc/openai lauten; Codex nutzt das Responses-Protokoll, die Anfragen landen also auf /openai/v1/responses.
Neueste CLI im offiziellen Changelog
Im offiziellen Changelog erscheint Codex CLI 0.160.1 am 2026-10-05; seit 0.159.1 (2026-09-29) verwendet der mitgelieferte Modellkatalog GPT-6.1 Sol als Standardmodell.
Wie Codex den Endpunkt bestimmt
Stand 2026-10-07 entscheidet Codex CLI über model_provider in der config.toml, wohin Anfragen gehen: Der Wert ist die id einer Tabelle unter model_providers, ohne Angabe gilt openai. Laut offizieller Dokumentation legt ein Model Provider fest, wie Codex sich mit einem Modell verbindet – Basis-URL, Wire-API, Authentifizierung und optionale HTTP-Header –, und eigene Provider dürfen die reservierten eingebauten ids openai, ollama und lmstudio nicht verwenden. Die Benutzerkonfiguration liegt in ~/.codex/config.toml (unter Windows in %USERPROFILE%\.codex\); eine .codex/config.toml im Projekt wird erst geladen, wenn Sie dem Projekt vertrauen, und model_provider sowie model_providers werden auf dieser Ebene ignoriert. Die QCode-Dokumentation nennt den Provider crs und nutzt das OpenAI-Responses-Protokoll; derselbe Key funktioniert unter api.qcode.cc, us.qcode.cc und asia.qcode.cc.
Neuere Releases mit Bezug zu Providern
Laut offiziellem Changelog werden GPT-6 Sol und GPT-6 Luna seit 2026-09-22 schrittweise in Codex eingeführt; in der CLI wählen Sie sie mit /model oder codex --model gpt-6-sol. Am 2026-09-29 machte Codex CLI 0.159.1 GPT-6.1 Sol zum Standardmodell im mitgelieferten Katalog. Version 0.160.0 vom 2026-10-01 präzisierte in der Dokumentation, wie env_key die Umgebungsvariable für den API-Key bestimmt, mischt in explizit angegebene Provider-Modellkataloge keine nicht unterstützten mitgelieferten Modelle mehr und lässt die Terminal-Oberfläche serverseitige Provider-Einstellungen beibehalten. Am 2026-10-05 folgte 0.160.1. Außerdem wird GPT-5.5 laut einer offiziellen Mitteilung vom 2026-09-14 am 2026-10-14 aus ChatGPT, ChatGPT Work und Codex zurückgezogen (für die OpenAI-API gilt das nicht); OpenAI bittet, gespeicherte Modelleinstellungen, eigene Agents und Skripte zu aktualisieren, die noch gpt-5.5 auswählen. Ihre lokale Version zeigt codex --version.
Chronologie
GPT-6 Sol und GPT-6 Luna werden schrittweise in Codex eingeführt; OpenAI empfiehlt Sol für komplexes Programmieren und agentische Workflows, in der CLI wechseln Sie mit /model oder codex --model gpt-6-sol.
GPT-6.1 Sol kommt zu Codex; am selben Tag macht Codex CLI 0.159.1 es zum Standardmodell im mitgelieferten Katalog. Die QCode-Dokumentation führt gpt-6.1-sol als aktualisierte Version von GPT-6 Sol.
Codex CLI 0.160.1 erscheint – bei der Prüfung am 2026-10-07 die neueste CLI-Version im offiziellen Changelog; zuvor hatte 0.160.0 am 2026-10-01 die Beschreibung von env_key präzisiert.
Bestätigt vs. nicht verifiziert
Bestätigt (wörtlich auf offiziellen Seiten und in der QCode-Dokumentation)
Offizielle Codex-Dokumentation: model_provider ist standardmäßig openai; openai, ollama und lmstudio sind reservierte ids und lassen sich nicht überschreiben; responses ist der einzige unterstützte Wert für wire_api und gilt auch ohne Angabe; env_key ist die Umgebungsvariable mit dem API-Key; requires_openai_auth ist standardmäßig false; ein direkter Token in experimental_bearer_token wird nicht empfohlen; model und model_provider gehören vor die erste TOML-Tabelle. Offizielles Changelog: Seit 0.159.1 ist GPT-6.1 Sol das Standardmodell im mitgelieferten Katalog, 0.160.1 erschien am 2026-10-05. QCode-Dokumentation: base_url ist https://api.qcode.cc/openai, wire_api ist responses, requires_openai_auth ist true, env_key ist CRS_OAI_KEY, Keys beginnen mit cr_, und sind auth.json und Umgebungsvariable beide vorhanden, hat auth.json Vorrang.
Nicht verifiziert oder nicht dokumentiert
Vier Punkte sind nicht verifiziert, bauen Sie also nicht darauf: Erstens enthält das QCode-Beispiel eine Zeile preferred_auth_method, die in der für diese Seite am 2026-10-07 abgerufenen offiziellen Konfigurationsreferenz nicht vorkommt; welche Wirkung sie in aktuellen Versionen hat, ist ungeprüft. Zweitens bietet die offizielle Referenz auch eine auth-Tabelle für Tokens per Befehl, http_headers, supports_websockets und mehr; die QCode-Dokumentation beschreibt sie nicht, und diese Seite verspricht nicht, dass sie mit QCode funktionieren. Drittens wurde nicht geprüft, ob Codex-Versionen vor 0.159.1 den Namen gpt-6.1-sol kennen; das offizielle Gateway-Dokument rät nur, ohne eigenen Modellkatalog vorab sicherzustellen, dass Ihre Codex-Version das Modell erkennt. Viertens sagt OpenAI, GPT-6.1 Sol biete nahezu Astra-Leistung zu geringeren Kosten als Astra – eine Eigenangabe des Anbieters ohne Messung durch Dritte.
Zwei Entscheidungen
Eigener Provider vs. openai_base_url
Die offizielle Dokumentation nennt zwei Wege: Wollen Sie nur den eingebauten openai-Provider auf einen Proxy oder Router umleiten, setzen Sie openai_base_url, ohne einen neuen Provider anzulegen; brauchen Sie eine eigene Key-Variable und eigene Protokolleinstellungen, legen Sie unter model_providers eine Tabelle an. Eine Tabelle namens openai ist nicht möglich, weil eingebaute ids nicht überschrieben werden können. Die QCode-Dokumentation nutzt den zweiten Weg (Provider crs) und beschreibt keine Anbindung über openai_base_url, daher empfiehlt diese Seite ihn für QCode nicht.
auth.json vs. Umgebungsvariable
Die QCode-Dokumentation sagt: eines von beiden. Entweder tragen Sie OPENAI_API_KEY in ~/.codex/auth.json ein, oder Sie setzen die Umgebungsvariable CRS_OAI_KEY. Gibt es beides, hat auth.json Vorrang; wenn Sie auf die Variable umsteigen, setzen Sie OPENAI_API_KEY in auth.json daher auf null. OpenAI rät, Zugangsdaten nicht in TOML-Dateien oder Repositories abzulegen, und weist darauf hin, dass eine im Terminal gesetzte Variable einer vom Desktop gestarteten App womöglich nicht zur Verfügung steht.
QCode in fünf Schritten anbinden
Nach der QCode-Dokumentation: ① Legen Sie den Konfigurationsordner ~/.codex an (unter Windows %USERPROFILE%\.codex). ② Schreiben Sie die Top-Level-Schlüssel an den Anfang der config.toml: model_provider auf crs, model auf gpt-6-sol oder gpt-6.1-sol, optional model_reasoning_effort; sie müssen vor der ersten Tabellenüberschrift stehen, sonst werden sie dieser Tabelle zugeordnet. ③ Legen Sie die Tabelle model_providers.crs an mit name crs, base_url https://api.qcode.cc/openai, wire_api responses, requires_openai_auth true und env_key CRS_OAI_KEY (aus Nordamerika und Europa können Sie den Host durch us.qcode.cc ersetzen). ④ Stellen Sie den Key bereit: entweder per export CRS_OAI_KEY mit Ihrem Key, der mit cr_ beginnt, oder als OPENAI_API_KEY in ~/.codex/auth.json – nur eines von beiden. ⑤ Starten Sie codex und prüfen Sie mit /status das aktive model und den provider; codex doctor prüft zusätzlich die Konfiguration.
Codex auf QCode
Kopieren Sie in der QCode-Konsole einen Key, der mit cr_ beginnt, und folgen Sie den fünf Schritten oben; alternativ installiert das Ein-Klick-Einrichtungsskript aus der QCode-Dokumentation die CLI, schreibt die Konfiguration nach ~/.codex und prüft die Verbindung. Codex nutzt das OpenAI-Responses-Protokoll, deshalb läuft es bei QCode mit der GPT-Familie: gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol, gpt-5.6-terra, gpt-6-astra und gpt-6-luna sind aufrufbar, gewechselt wird nur über model; Claude sowie GLM-, Kimi-, DeepSeek- und Qwen-Modelle laufen nicht über dieses Protokoll. Derselbe Key funktioniert auch in Claude Code. Abgerechnet wird pro Token, die Preise je Modell stehen unter /models.
Häufig gestellte Fragen
Was muss ich ändern, um Codex CLI mit einer Drittanbieter-API zu nutzen?
Zwei Dinge in ~/.codex/config.toml: Das Top-Level-Feld model_provider zeigt auf die id Ihres Providers, und für diese id legen Sie unter model_providers eine Tabelle mit base_url, wire_api und env_key an. Laut offizieller Konfigurationsreferenz ist responses der einzige unterstützte Wert für wire_api, und env_key nennt die Umgebungsvariable mit dem API-Key; requires_openai_auth kennzeichnet einen Provider mit OpenAI-Authentifizierung, ist standardmäßig false und steht in der QCode-Dokumentation auf true.
Was gehört in base_url? Mit /v1?
Für QCode https://api.qcode.cc/openai, ohne /v1 und ohne abschließenden Schrägstrich. Laut QCode-Dokumentation muss die base_url für Codex genau so lauten, Codex nutzt dann den Pfad /openai/v1/responses. Die allgemeine Regel der Endpunkt-Dokumentation: kein abschließender Schrägstrich, sonst entsteht ein Pfad mit doppeltem Schrägstrich und ein 404; ein 404 bedeutet meist ein falsches Pfadpräfix. Die asiatische Ausweichadresse ist https://asia.qcode.cc/openai, für Nordamerika und Europa gibt es us.qcode.cc.
Was tun bei 401 oder API key not found?
Prüfen Sie drei Dinge: ob der Key mit cr_ beginnt und der Key in auth.json keine überflüssigen Leerzeichen oder Zeilenumbrüche enthält; bei einer Umgebungsvariable, ob ihr Name genau dem Wert von env_key in der config.toml entspricht (laut QCode-Dokumentation CRS_OAI_KEY) und ob sie in der aktuellen Shell wirklich gesetzt ist; zuletzt den Status des Keys in der QCode-Konsole. Denken Sie daran: Sind auth.json und Variable beide vorhanden, hat auth.json Vorrang – wenn Sie die Variable nutzen, setzen Sie OPENAI_API_KEY in auth.json auf null.
Ich habe die config.toml geändert – warum greift mein Provider nicht?
Meist steht ein Top-Level-Schlüssel an der falschen Stelle: Die offizielle Dokumentation verlangt model und model_provider vor der ersten TOML-Tabelle, denn Schlüssel nach einer Tabellenüberschrift gehören zu dieser Tabelle. Außerdem ignoriert eine .codex/config.toml im Projekt model_provider und model_providers; der Provider muss in Ihre Benutzerkonfiguration ~/.codex/config.toml, und die Tabelle darf nicht openai heißen. Laut QCode-Dokumentation ist seit Codex 0.134.0 zudem die alte profiles-Schreibweise in der config.toml abgeschafft; wer die alten Tabellen stehen lässt und --profile nutzt, bekommt einen harten Fehler. Nach dem Start zeigt /status das aktive model und den provider.
Kann ich Claude-Modelle in Codex nutzen? Was bedeutet model_not_available_on_endpoint?
Bei QCode nicht. Laut QCode-Dokumentation nutzt Codex das OpenAI-Responses-Protokoll, das nur die GPT-Familie bedient, nicht Claude und nicht GLM, Kimi, DeepSeek oder Qwen; Claude-Modelle laufen nur über das Anthropic-Protokoll. Das Beispiel aus der Dokumentation: Schicken Sie ein Claude-Modell an /openai/v1/chat/completions, kommt model_not_available_on_endpoint zurück, und diese Prüfung findet vor der Authentifizierung statt – der Fehler bedeutet also ein falsches Protokoll, keinen falschen Key. Für Claude nutzen Sie Claude Code mit demselben Key.
Welches Modell empfiehlt sich für Codex auf QCode?
Stand 2026-10-07 empfiehlt die QCode-Dokumentation standardmäßig gpt-6-sol (1.05M Kontext, allgemeine und komplexe Aufgaben); gpt-6.1-sol ist das GPT-6-Sol-Update vom 2026-09-29, ebenfalls mit 1.05M Kontext und laut Dokumentation günstigeren Cache-Lesezugriffen, und im offiziellen Codex seit 0.159.1 das Standardmodell im mitgelieferten Katalog; gpt-5.6-sol gehört zur GPT-5.6-Flaggschiffreihe, gpt-5.6-terra ist auf Code optimiert, gpt-6-astra ist die stärkste Stufe zu einem hohen Preis, und gpt-6-luna positioniert OpenAI für fokussierte Aufgaben mit hohem Volumen, den Preis finden Sie unter /models. Alle sind bei QCode aufrufbar; Sie wechseln über model oder mit codex --model.
Quellen
Codex-Konfigurationsschlüssel: OpenAIs offizielle Codex-Konfigurationsreferenz und die Dokumentation zur erweiterten Konfiguration (learn.chatgpt.com, abgerufen am 2026-10-07) mit dem Standardwert von model_provider, den reservierten ids, dem Wert für wire_api, der Beschreibung von env_key und requires_openai_auth, openai_base_url und den auf Projektebene ignorierten Schlüsseln. Position der Top-Level-Schlüssel, Umgang mit Zugangsdaten und die Prüfung mit /status: das offizielle Dokument Connect to a gateway, am selben Tag abgerufen. Versionen und Modelle: das offizielle Changelog von ChatGPT und Codex, am selben Tag abgerufen (0.159.1, 0.160.0, 0.160.1 die Ankündigungen zu GPT-6 Sol und GPT-6.1 Sol sowie die Mitteilung zum Rückzug von GPT-5.5). Anbindung an QCode, base_url, Name von env_key, Key-Präfix und Modellliste: die drei Seiten Codex-Komplettanleitung, Codex-Schnellstart sowie Zugangspunkte und API-Formate auf docs.qcode.cc, abgerufen am 2026-10-07.
Codex mit einem Key anbinden
base_url auf https://api.qcode.cc/openai setzen und gpt-6.1-sol, gpt-6-sol oder gpt-5.6-sol wählen, abgerechnet pro Token, direkt nach der Registrierung einsatzbereit.
Weiterführende Lektüre
Codex CLI – Vollständiger Leitfaden
OpenAI Codex CLI: Installation, Konfiguration und Vergleich mit Claude Code.
GPT-5.6 in Codex CLI verwenden
Vier Schritte, um gpt-5.6-sol und gpt-5.6-terra in Codex CLI über QCode auszuführen.
Leitfaden zum 5-Stunden-Rolling-Limit von Codex
Wie das 5-Stunden-Rolling-Limit funktioniert, wie es dazu kam und was Sie tun können, wenn Sie es erreichen.
Die Konfigurationsschlüssel und Versionsangaben auf dieser Seite wurden am 2026-10-07 anhand der offiziellen Codex-Dokumentation und des Changelogs von OpenAI sowie der QCode-Dokumentation geprüft; maßgeblich sind die offiziellen Seiten, Änderungen beim Anbieter sind ohne Vorankündigung möglich. Über die dokumentierte Kompatibilität hinaus verspricht diese Seite nichts; maßgeblich für die Modellverfügbarkeit ist /models.