Codex aus China nutzen: config.toml, Modelle und Alipay
Stand 2026-10-13 hängt die Arbeit mit Codex CLI in Festland-China an zwei Punkten. Der erste ist der Unterstützungsumfang: auf der Länderliste der API-unterstützten Länder und Gebiete bei developers.openai.com steht Festland-China nicht, und im help.openai.com-Artikel zum selben Thema (hier als Archivkopie vom 2026-10-07 abgerufen) sagt OpenAI, dass keine separate Liste nicht unterstützter Länder und Gebiete veröffentlicht wird, und dass die API an einem Ort nicht unterstützt wird, wenn er in der Liste fehlt. Der zweite Punkt ist die Zahlung. Auf Seiten der Codex CLI ist der offizielle Weg ein eigener model provider: In ~/.codex/config.toml zeigt der Schlüssel model_provider auf eine Tabelle, die Sie unter model_providers selbst anlegen, mit base_url, wire_api und env_key. Für QCode tragen Sie als base_url https://api.qcode.cc/openai ein und wählen als model gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol oder gpt-5.6-terra; alle vier sind auf QCode aufrufbar. Aufgeladen wird per Alipay, WeChat Pay oder Visa / Mastercard / AMEX. Bezahlung nach Tokens; die Preise je Modell stehen auf /models.
Aktualisiert 2026-10-13
Sie wollen selbst verkaufen? Prüfen Sie zuerst den kompletten Ablauf mit einem Key — White-Label und Wiederverkauf kommen danach.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Diese vier Werte zählen zuerst
Der Wert von wire_api
Die offizielle Konfigurationsreferenz hält fest, dass responses der einzige unterstützte Wert ist und auch gilt, wenn der Parameter fehlt; im Codex-Leitfaden von QCode steht ebenfalls wire_api = "responses".
Die base_url für Codex
Die QCode-Dokumentation verlangt für Codex exakt https://api.qcode.cc/openai, ohne /v1 und ohne abschließenden Schrägstrich; Codex läuft über den Pfad des Responses-Protokolls.
So beginnen QCode-Schlüssel
Die QCode-Dokumentation sagt, dass der Schlüssel mit cr_ beginnt, und der erste Prüfpunkt bei Fehlern ist genau das; env_key nennt den Namen der Umgebungsvariable, in der der Schlüssel liegt, und offiziell steht dort, dass dieser Name keine feste Codex-Variable ist.
Mindestaufladung in Yuan
Die Übersicht der Zahlarten nennt die auf dem Aufladescreen stehenden Grenzen: Yuan ab ¥100, US-Dollar zwischen $1 und $2,000; auf der Alipay-Seite ergänzt QCode, dass Alipay bis ¥2,000 pro Zahlung annimmt und WeChat Pay rund ¥900.
Wo es bei Codex aus China hakt
Stand 2026-10-13: Auf der OpenAI-Seite sind zwei offizielle Texte zu trennen. Die Seite zu den unterstützten Ländern und Gebieten auf developers.openai.com trägt die Überschrift "Countries and territories that currently support access to our API services", und Festland-China kommt in dieser Liste nicht vor. Im help.openai.com-Artikel zum selben Thema stehen in der Archivkopie vom 2026-10-07 zwei weitere Sätze: "We do not publish a separate list of countries and territories that we do not support" und "If a location is not included in the list below, our API is not supported there". Hier stehen genau diese Formulierungen, ohne eigene Schlüsse daraus. Der zweite Punkt ist die Zahlung: In Festland-China sind Alipay und WeChat Pay üblich, und QCode akzeptiert beide, dazu Karten, Apple Pay, Google Pay und Kryptowährungen. Die CLI-Seite ist in den offiziellen Dokumenten beschrieben: Ein model provider legt fest, wie Codex eine Verbindung zu einem Modell herstellt (Basis-URL, Wire-API, Authentifizierung und optionale HTTP-Header), und model_provider zeigt auf die Tabelle, die Sie selbst anlegen. Üblich ist deshalb, die offizielle CLI zu behalten und den provider auf einen Endpunkt zu richten, der OpenAI Responses spricht und den Sie selbst bezahlen können: Bei QCode ist die base_url für Codex https://api.qcode.cc/openai, bezahlt wird nach Tokens, die Preise je Modell stehen auf /models.
Was die offiziellen Dokumente und die QCode-Dokumentation sagen (abgerufen am 2026-10-13)
In den Codex-Dokumenten von OpenAI dürfen eigene provider die reservierten eingebauten IDs openai, ollama und lmstudio nicht wiederverwenden; im Abschnitt zur Authentifizierung steht, dass requires_openai_auth = true die OpenAI-Authentifizierung nutzt, dass Codex dann env_key ignoriert, und dass diese Option nützlich ist, wenn Sie über einen LLM-Proxy auf OpenAI-Modelle zugreifen; als eine Anmeldeart wird auch die Anmeldung mit API-Schlüssel für die nutzungsabhängige Bezahlung genannt. In der offiziellen Beispielkonfiguration steht zu requires_openai_auth der Hinweis, sie nur für provider zu verwenden, die auf OpenAI-Authentifizierung setzen. Im Abschnitt zu den Umgebungsvariablen steht, dass der von dieser Einstellung genannte Variablenname keine feste Codex-Variable ist. Auf der QCode-Seite wurde der vollständige Codex-Leitfaden am 2026-10-08 aktualisiert und die Zahlarten-Übersicht am 2026-10-01; die Beschreibungen auf /models nennen gpt-6-sol das am 2026-09-22 von OpenAI veröffentlichte neue Flaggschiff und gpt-6.1-sol die Aktualisierung von GPT-6 Sol vom 2026-09-29.
Die drei Daten, auf denen diese Seite steht
Im offiziellen Changelog von OpenAI steht der Eintrag "Released GPT-6 Sol (gpt-6-sol)" mit dem Datum Sep 22 im Abschnitt September, 2026; die Zeile auf /models beschreibt es als das am 2026-09-22 von OpenAI veröffentlichte neue Flaggschiff.
Im offiziellen Changelog von OpenAI steht der Eintrag "Released GPT-6.1 Sol (gpt-6.1-sol)"; die Zeile auf /models und der Codex-Leitfaden von QCode bezeichnen es als GPT-6 Sol Aktualisierung vom 2026-09-29.
Der vollständige Codex-Leitfaden von QCode wurde am 2026-10-08 aktualisiert, die Zahlarten-Übersicht am 2026-10-01.
Bestätigt vs. nicht verifiziert
Bestätigt (wörtlich auf den offiziellen Seiten und in der QCode-Dokumentation)
Wörtlich auf den OpenAI-Seiten: der Titeltext der Länderliste auf developers.openai.com, "Countries and territories that currently support access to our API services"; in der help.openai.com-Archivkopie vom 2026-10-07 die Sätze "We do not publish a separate list of countries and territories that we do not support" und "If a location is not included in the list below, our API is not supported there"; dass ein model provider festlegt, wie Codex sich mit einem Modell verbindet (Basis-URL, Wire-API, Authentifizierung und optionale HTTP-Header); dass eigene provider openai, ollama und lmstudio nicht nutzen dürfen; dass responses der einzige unterstützte wire_api-Wert und der Standard bei fehlender Angabe ist; dass requires_openai_auth standardmäßig false ist und Codex bei true env_key ignoriert; dass Ihre persönlichen Vorgaben in ~/.codex/config.toml stehen und die Projekt-Schicht .codex/ nur bei vertrauenswürdigen Projekten geladen wird. Wörtlich in der QCode-Dokumentation: Die base_url für Codex muss https://api.qcode.cc/openai sein; Schlüssel beginnen mit cr_; wenn auth.json und Umgebungsvariable existieren, gewinnt auth.json, und beim Wechsel auf die Umgebungsvariable setzen Sie OPENAI_API_KEY in auth.json auf null; der Responses-Pfad bedient die chinesischen Modellfamilien nicht; gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol, gpt-5.6-terra und gpt-6-astra sind auf QCode aufrufbar; als Zahlarten stehen Alipay, WeChat Pay, Karten, Apple Pay / Google Pay und Kryptowährungen bereit, Yuan-Aufladungen ab ¥100; derselbe Schlüssel funktioniert auch für Claude Code, und die Kosten werden nach dem tatsächlichen Tokenverbrauch berechnet, nicht pro Werkzeug.
Unbestätigt und nicht veröffentlicht
Zwei Punkte sind hier nicht bestätigt. Erstens: OpenAI erklärt, dass keine separate Liste nicht unterstützter Länder und Gebiete veröffentlicht wird, es gibt also keine „Negativliste“, die man zitieren könnte; diese Seite hält nur fest, dass die abgerufene Liste keinen Eintrag für Festland-China hat, und gibt den Satz wieder, dass Orte außerhalb der Liste nicht unterstützt werden. Zweitens: Ab welcher Codex-CLI-Version diese provider-Schreibweise trägt, ist nicht Version für Version geprüft; die QCode-Dokumentation selbst rät, die Zahlen im Text nicht als aktuell zu nehmen, GitHub Releases und npm als Maßstab zu sehen und die eigene Fassung mit codex --version zu prüfen.
Die zwei Entscheidungen, die leicht verwechselt werden
Eigener provider statt nur openai_base_url
Die offiziellen Dokumente nennen zwei Wege: Wenn Sie nur den eingebauten provider openai auf einen LLM-Proxy, ein Routing oder ein Projekt mit aktiver Datenresidenz lenken wollen, können Sie laut OpenAI in config.toml einfach openai_base_url setzen, ohne einen neuen provider anzulegen; wenn Sie eine eigene Schlüssel-Variable und eigene Protokolleinstellungen brauchen, legen Sie eine Tabelle unter model_providers an. Die QCode-Dokumentation nutzt die zweite Variante und schreibt über openai_base_url nichts, deshalb folgt auch diese Seite der zweiten Variante. Offiziell steht außerdem, dass sich die eingebauten IDs nicht überschreiben lassen — Ihre Tabelle darf also nicht openai heißen.
Codex über Responses und Claude Code über Anthropic
Die beiden Protokolle sind nicht austauschbar, und die QCode-Dokumentation sagt es klar: Das Protokoll ergibt sich aus dem Anfragepfad, aber nicht jede Modellfamilie kann jeden Pfad nutzen. Der Responses-Pfad, den Codex verwendet, bedient die GPT-Familie und nicht die chinesischen Modellfamilien; Claude-Modelle laufen nur über das Anthropic-Protokoll, und GPT-Modelle können den Anthropic-Endpunkt nicht nutzen. In Codex wählen Sie deshalb gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol oder gpt-5.6-terra, und für Claude wechseln Sie zu Claude Code: Die QCode-Dokumentation hält fest, dass derselbe Schlüssel auch für Claude Code funktioniert, und die Kosten nach dem tatsächlichen Tokenverbrauch berechnet werden, nicht pro Werkzeug.
In fünf Schritten zur funktionierenden Einrichtung
① CLI installieren: npm install -g @openai/codex; bei den Versionen gelten GitHub Releases und npm als Maßstab, die eigene Fassung prüfen Sie mit codex --version. ② Verzeichnis ~/.codex anlegen (unter Windows %USERPROFILE%\.codex); die offiziellen Dokumente sagen, dass Ihre persönlichen Standards in ~/.codex/config.toml stehen. ③ config.toml schreiben: Im offiziellen Beispiel stehen zuerst model und model_provider auf oberster Ebene, danach legen Sie unter model_providers eine Tabelle für diese id an, mit den Feldern name, base_url, wire_api, env_key und requires_openai_auth; für QCode setzen Sie base_url auf https://api.qcode.cc/openai und wire_api auf responses, im QCode-Beispiel steht requires_openai_auth auf true. Den Tabellenamen und den Variablennamen hinter env_key wählen Sie frei (hier qcode und QCODE_API_KEY), nur darf die Tabelle nicht openai, ollama oder lmstudio heißen. ④ Schlüssel hinterlegen: Schreiben Sie den mit cr_ beginnenden Schlüssel in OPENAI_API_KEY der Datei ~/.codex/auth.json – das ist die erste Variante in der QCode-Dokumentation; wer lieber eine Umgebungsvariable nutzt, setzt sie laut QCode-Dokumentation unter dem in env_key gewählten Namen und setzt OPENAI_API_KEY in auth.json auf null, weil auth.json Vorrang hat, wenn beide vorhanden sind. ⑤ Eine Aufgabe zur Probe starten; bei Fehlern prüfen Sie zuerst die zwei Punkte aus der QCode-Dokumentation: Ist die base_url exakt https://api.qcode.cc/openai, und beginnt der Schlüssel mit cr_? Den Tokenverbrauch einer Sitzung zeigen Sie sich mit /cost an.
Codex auf QCode
Holen Sie sich in der Konsole einen Schlüssel, der mit cr_ beginnt, setzen Sie in config.toml base_url auf https://api.qcode.cc/openai und wire_api auf responses, und tragen Sie als model gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol oder gpt-5.6-terra ein; alle vier sind auf QCode aufrufbar, der Wechsel ändert nur model. Der Responses-Pfad von Codex bedient die chinesischen Modellfamilien nicht, und Claude-Modelle laufen nur über das Anthropic-Protokoll — für Claude nehmen Sie Claude Code mit demselben Schlüssel. Zahlen: Für Festland-China und Yuan leitet die Zahlarten-Übersicht Sie an Alipay weiter, die Gebühr wird nicht an Sie durchgereicht, WeChat Pay ist die Alternative, und beide laden das Yuan-Guthaben auf; zusätzlich gibt es Visa / Mastercard / AMEX, Apple Pay / Google Pay und Kryptowährungen mit vielen Coins und Netzwerken, wo die On-Chain-Überweisung persönlich geprüft wird, deshalb ist ein kleiner Erstbetrag empfohlen. Yuan-Aufladungen beginnen bei ¥100, Dollar-Aufladungen zwischen $1 und $2,000; nach dem Aufladen läuft die Freischaltung selbstbedient und ist sofort wirksam. Bezahlung nach Tokens; die Preise je Modell stehen auf /models.
Häufig gestellte Fragen
Kann ich Codex aus China nutzen, und was sagt die offizielle Liste?
Die offiziellen Aussagen von OpenAI stehen auf zwei verschiedenen Seiten. Auf der Länderliste der API-unterstützten Länder und Gebiete bei developers.openai.com gibt es keinen Eintrag für Festland-China. Im help.openai.com-Artikel zum selben Thema steht in der Archivkopie vom 2026-10-07, dass die API an einem Ort nicht unterstützt wird, wenn er in der Liste fehlt, und dass keine separate Liste nicht unterstützter Gebiete veröffentlicht wird. Diese Seite gibt diese Sätze wieder und zieht daraus keine weiteren Schlüsse. Die Einrichtung ist ein eigener Punkt: Die offiziellen Dokumente zeigen, wie model_provider auf eine selbst angelegte provider-Tabelle zeigt und Codex mit jedem Endpunkt verbunden wird, der Responses spricht.
Welche Einträge in config.toml ändern sich?
Zwei Stellen: Der obere Schlüssel model_provider zeigt auf Ihre eigene provider id, und unter model_providers legen Sie die Tabelle dieser id mit base_url, wire_api und env_key an. Die offizielle Referenz hält fest, dass responses der einzige unterstützte wire_api-Wert ist und auch der Standard, wenn er fehlt; env_key ist die Umgebungsvariable, die den API-Schlüssel des provider liefert; requires_openai_auth bedeutet, dass der provider OpenAI-Authentifizierung nutzt, ist standardmäßig false, und bei true ignoriert Codex env_key. Den Tabellennamen wählen Sie frei, nur nicht openai, ollama oder lmstudio — diese eingebauten IDs lassen sich laut den Dokumenten nicht überschreiben.
Was gehört in die base_url, und braucht sie /v1?
Für QCode ist es https://api.qcode.cc/openai, ohne /v1 und ohne Schrägstrich am Ende. Die QCode-Dokumentation verlangt für Codex genau diesen Wert, und Codex nutzt das Responses-Protokoll. Das Endpunkt-Dokument ergänzt, dass /api und /openai/v1 Pfad-Präfixe sind und keine eigenständigen Endpunkte, und dass SDKs /v1/messages, /chat/completions oder /responses selbst anhängen. In den offiziellen Dokumenten bedeutet base_url die API-Basis-URL für diesen model provider.
Kann Codex auf QCode Claude oder die chinesischen Modelle aufrufen?
Nein. Die QCode-Dokumentation sagt, dass das Protokoll vom Anfragepfad bestimmt wird und nicht jede Modellfamilie jeden Pfad nutzen kann: Der Responses-Pfad von Codex bedient die GPT-Familie und ausdrücklich nicht die chinesischen Modellfamilien; Claude-Modelle laufen nur über das Anthropic-Protokoll, und GPT-Modelle können den Anthropic-Endpunkt nicht nutzen. In Codex bleiben damit gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol und gpt-5.6-terra, und für Claude wechseln Sie zu einem Client, der Anthropic versteht. Die QCode-Dokumentation hält fest, dass derselbe Schlüssel auch für Claude Code funktioniert und der Schlüssel selbst die Protokolle nicht unterscheidet.
Wie bezahle und aktiviere ich den Dienst aus China?
Yuan-Guthaben laden Sie per Alipay oder WeChat Pay auf, danach läuft die Aktivierung selbstbedient und ist sofort wirksam. Die Zahlarten-Übersicht verteilt das so: Festland-China und Yuan gehen an Alipay, die Gebühr wird nicht durchgereicht, WeChat Pay ist die Alternative, und beide laden das Yuan-Guthaben auf. Die gedruckten Grenzen sind Yuan ab ¥100 und Dollar zwischen $1 und $2,000; auf der Aufladeseite stehen zusätzlich Alipay bis ¥2,000 pro Zahlung, WeChat Pay rund ¥900, und auf derselben Kasse gehen auch Karten. Weitere Optionen: Visa / Mastercard / AMEX über die internationale Kasse mit sofortiger Gutschrift, Apple Pay oder Google Pay mit der im Wallet hinterlegten Karte, oder Kryptowährung mit manueller Prüfung der On-Chain-Überweisung, weshalb ein kleiner Erstbetrag empfohlen wird.
Wie wird bezahlt?
Bezahlung nach Tokens; die Preise je Modell stehen auf /models. Die QCode-Dokumentation hält fest, dass die Kosten aus dem tatsächlichen Tokenverbrauch berechnet werden und nicht pro Werkzeug, und dass derselbe Schlüssel auch für Claude Code funktioniert; welche Modelle im Angebot sind und was sie kosten, steht auf /models. Den Verbrauch einer Sitzung zeigen Sie mit /cost, das Gesamtguthaben in der Konsole.
Quellen
Alle Sätze auf dieser Seite wurden am 2026-10-13 neu abgerufen und Wort für Wort nachgeprüft. OpenAI-Seite: die Länderliste der API-unterstützten Länder und Gebiete auf developers.openai.com, die Archivkopie desselben help.openai.com-Artikels vom 2026-10-07, das OpenAI-API-Changelog und sechs Codex-Dokumente auf learn.chatgpt.com (Configuration Reference, Advanced Configuration, Config basics, Environment variables, Authentication, Sample Configuration). QCode-Seite: der Codex-Leitfaden, das Dokument zu Endpunkten und API-Pfaden sowie die Zahlarten-Übersicht auf docs.qcode.cc, dazu fünf Seiten auf qcode.cc: Startseite, /models, /claude-code-china-guide, /codex-cli-third-party-api-setup und /alipay-wechat-pay-ai-api.
Ein Schlüssel für Codex, in Yuan aufgeladen
Setzen Sie base_url auf https://api.qcode.cc/openai und model auf gpt-6.1-sol oder gpt-6-sol, laden Sie per Alipay oder WeChat Pay auf und aktivieren Sie sich selbstbedient. Bezahlung nach Tokens; die Preise je Modell stehen auf /models.
Weiterführende Lektüre
Claude Code in China (Okt. 2026): Alipay und WeChat Pay
Dieselbe Auflade- und Aktivierungsroute für Claude Code: ANTHROPIC_BASE_URL auf QCode, bezahlt mit Alipay oder WeChat Pay.
Codex CLI an eine externe API anbinden
model_provider, model_providers, base_url, wire_api und env_key in config.toml, Feld für Feld, plus die häufigen Fehler.
AI-Coding-API mit Alipay und WeChat bezahlen
Betragsgrenzen und Gutschrift: Alipay bis ¥2,000 pro Zahlung, WeChat Pay rund ¥900, Yuan-Aufladung ab ¥100.
Gegengeprüft am 2026-10-13. Die Liste der unterstützten Länder von OpenAI, die Felder der Codex-Konfiguration und die Protokollangaben folgen immer dem aktuellen Inhalt der offiziellen Seiten; OpenAI erklärt dort auch, dass keine Liste nicht unterstützter Gebiete veröffentlicht wird. Die Einrichtung, die Zahlarten und die gedruckten Betragsgrenzen von QCode folgen docs.qcode.cc und den Aufladeseiten, Verfügbarkeit und Preise je Modell folgen /models und können ohne gesonderte Ankündigung geändert werden. Diese Seite ist keine Zusage zu Kosten oder Verfügbarkeit für Ihre konkrete Last.