Codex · Relay

Codex Relay: Zugriff auf die Codex-API aus China

Codex CLI, die VS-Code-Erweiterung und die Desktop-App unterstützen alle benutzerdefinierte Modellanbieter. Richte base_url auf AICodeWith aus, lege deinen Key in auth.json ab, und du kannst Codex direkt aus Netzwerken in China nutzen. Die Abrechnung erfolgt pro Token aus deinem Prepaid-Guthaben, ohne ChatGPT-Tarif.

Zuletzt geprüft 2026-10-14

API-Key holen Codex herunterladen

So funktioniert Codex Relay

Standardmäßig verwendet Codex einen ChatGPT-Konto-Login oder einen OpenAI-API-Key. Außerdem kannst du in config.toml einen model_provider deklarieren: Codex sendet Anfragen an die base_url dieses Anbieters und authentifiziert sich mit dem Key in auth.json. Das Relay stellt eine kompatible Schnittstelle bereit, sodass Codex selbst nicht geändert werden muss.

Dieser Ansatz wird nach API-Nutzung abgerechnet und läuft nicht über einen kostenpflichtigen ChatGPT-Tarif.

Einrichtungsschritte (CLI, VS Code, Desktop)

1. Codex installieren
Installiere @openai/codex über die Kommandozeile mit npm; für die VS-Code-Erweiterung und die Desktop-App siehe die Download-Seite.
Terminal
```
npm install -g @openai/codex
```
2. Key erstellen
Erstelle einen Key auf der API-Keys-Seite in der AICodeWith-Konsole.
3. auth.json schreiben
Lege den Key in ~/.codex/auth.json ab (unter Windows: %USERPROFILE%\.codex\auth.json).
~/.codex/auth.json
```
{
  "OPENAI_API_KEY": "你的_API_KEY"
}
```
4. config.toml schreiben und neu starten
Schreibe config.toml anhand des Beispiels im nächsten Abschnitt und starte dann das Terminal, VS Code oder die Desktop-App neu. Alle drei lesen dasselbe Verzeichnis ~/.codex.

Codex herunterladen (CLI / Desktop / VS Code)auth.json-Referenz

config.toml-Beispiel

~/.codex/config.toml

model_provider = "codex"
model = "gpt-5.6-sol"

[model_providers.codex]
name = "codex"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

model kann auf jedes andere Codex-kompatible Modell geändert werden, das auf der Modelle-Seite aufgeführt ist. Speichere die Datei und öffne Codex erneut, damit die Änderung wirksam wird.

Vollständige config.toml-Referenz

Preise und Abrechnung

Eingabe- und Ausgabe-Token werden je nach tatsächlicher Nutzung von deinem Prepaid-Guthaben abgezogen; die Nutzung pro Anfrage ist in der Konsole sichtbar. Das Guthaben ist 12 Monate gültig und wird nicht monatlich zurückgesetzt. Die aktuellen Preise pro Modell findest du auf der Modelle-Seite.

OpenAI-Modelle und Preise Aufladen und Tarife

So wählst du einen Relay-Anbieter

Ob das Relay die von Codex benötigte responses-API unterstützt (wire_api = "responses"); Relays ohne diese Unterstützung geben sofort einen Fehler zurück.
Ob die Abrechnung transparent ist: Siehst du den Token-Verbrauch pro Anfrage, und kannst du für jeden Key ein Ausgabenlimit festlegen?
Ob der Dienst zu Stoßzeiten stabil bleibt und ob du zwischen mehreren Kanälen wechseln kannst.
Ob es eine klare Rückerstattungsrichtlinie gibt. AICodeWith: Nicht genutztes Guthaben kann innerhalb von 90 Tagen erstattet werden, abzüglich einer Bearbeitungsgebühr von 10%. Details findest du in der Rückerstattungsrichtlinie.

Häufige Fehler

Fehler	Häufige Ursache	Lösung
401 Unauthorized	Der Key in auth.json ist falsch oder enthält zusätzliche Leerzeichen, oder eine alte OPENAI_API_KEY ist noch in den Umgebungsvariablen vorhanden	Kopiere den Key erneut, prüfe die Umgebungsvariablen und starte Codex neu
429 Too Many Requests	Die Parallelität oder die Anfrage-Rate ist zu hoch, oder dein Guthaben/Ausgabenlimit reicht nicht aus	Reduziere die Parallelität, versuche es später erneut und prüfe das Guthaben sowie das Ausgabenlimit des Keys
Verbindungs-Timeout	base_url ist falsch oder ein lokaler Proxy stört	Prüfe base_url, deaktiviere den Proxy vorübergehend und versuche es erneut

Codex-401-Fehlerbehebung Codex-429-Fehlerbehebung

FAQ

Wie verwende ich ein Codex-Relay?

Erstelle einen Key in der Konsole, lege ihn in ~/.codex/auth.json ab, setze die base_url für model_provider in ~/.codex/config.toml auf AICodeWith und starte Codex neu.

Kann ich einen anderen Key als einen ChatGPT-Konto-Key verwenden?

Ja. Codex unterstützt benutzerdefinierte Modellanbieter; du kannst stattdessen einen Relay-API-Key verwenden, ohne ChatGPT-Konto oder kostenpflichtigen Tarif.

Welche Modelle werden unterstützt?

Unterstützt werden die GPT-Modelle, die Codex verwenden kann. Die genaue Liste und aktuelle Preise findest du auf der OpenAI-Modelle-Seite; wechsle über das Feld model in config.toml.

Was soll ich tun, wenn ich 401 / 429 erhalte?

401 bedeutet meist, dass der Key falsch ist oder eine alte Umgebungsvariable vorhanden ist; kopiere den Key erneut und starte neu. 429 bedeutet zu viel Parallelität oder ein unzureichendes Guthaben/Limit; reduziere die Parallelität und prüfe dein Guthaben.

Wie kaufe ich Guthaben?

Nach der Registrierung kannst du auf der Aufladen-Seite mit lokalen Zahlungsmethoden in China Guthaben aufladen oder einen Prepaid-Tarif kaufen. Die Abrechnung erfolgt nach Nutzung, und das Guthaben ist 12 Monate gültig, ohne monatliche Zurücksetzung.

Bereit zum Ausprobieren?

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben. Es gelten Limits für Rate und Parallelität, und du kannst für jeden API-Schlüssel tägliche, monatliche oder gesamte Ausgabenlimits festlegen.

API-Key holen Modellpreise ansehen