Gültige Versionen: CC Switch 3.16.0 und höher. Dieser Artikel basiert auf Repository-Dokumentation und Code und verwendet DeepSeek als Beispiel für eine OpenAI Chat Completions-kompatible Schnittstelle. Screenshots stammen von der aktuellen Frontend-Oberfläche und wurden mit anonymisierten Beispieldaten erstellt, um die Offenlegung echter API-Schlüssel oder Kontostände zu vermeiden.
Warum lokales Routing erforderlich ist
Die neue Version von Codex CLI ist auf die OpenAI Responses API ausgerichtet, während viele Anbieter wie DeepSeek, Kimi, MiniMax und SiliconFlow tatsächlich das OpenAI Chat Completions-Format verwenden, also /chat/completions. Die Request-Bodies, Streaming-Events und Rückgabestrukturen dieser beiden Protokolle unterscheiden sich. Wenn man eine Chat-Schnittstelle direkt in die Codex-Konfiguration einträgt, führt dies oft zu falschen Modelllisten, 404/400-Fehlern oder Streaming-Antworten, die Codex nicht korrekt verarbeiten kann.
Der Ansatz von CC Switch besteht darin, Codex immer mit einer lokalen Route zu verbinden und weiterhin Requests über die Responses API zu senden. Die Route erkennt intern, ob der aktuelle Anbieter das Chat-Format verwendet, schreibt den Request in Chat Completions um, sendet ihn an den Upstream und wandelt die Chat-Antwort schließlich wieder in das Responses-Format um, um sie an Codex zurückzugeben.
Diese Kette besteht hauptsächlich aus vier Schritten:
- Wenn Codex übernommen wird, wird die lokale Konfiguration als
http://127.0.0.1:15721/v1geschrieben undwire_api = "responses"erzwungen. - Das
meta.apiFormat = "openai_chat"des Providers teilt der Route mit: Der eigentliche Upstream ist Chat Completions. - Die Route schreibt
/responsesoder/v1/responsesin/chat/completionsum und wandelt den Responses-Request-Body in einen Chat-Request-Body um. - Nach der Rückgabe vom Upstream wandelt die Route das Chat-JSON oder SSE wieder in Responses-JSON/SSE um, das Codex verstehen kann.
Vorbereitung
Sie müssen drei Dinge vorbereiten:
- CC Switch installiert und startbereit.
- Codex CLI installiert und mindestens einmal ausgeführt, damit die Verzeichnisstruktur
~/.codex/config.tomlexistiert. - Ein API-Schlüssel für DeepSeek oder einen ähnlichen Chat Completions-Anbieter.
Die offizielle Dokumentation von DeepSeek gibt derzeit die OpenAI-kompatible Basis-URL als https://api.deepseek.com an (andere Anbieter verwenden oft eine Basis-URL mit /v1-Suffix), und der Chat-API-Pfad ist /chat/completions. Das DeepSeek-Preset von CC Switch ist bereits mit diesen Informationen konfiguriert. Bitte verwenden Sie daher vorrangig das Preset, anstatt die Schnittstellenpfade manuell zusammenzusetzen.
Schritt 1: Codex-Provider hinzufügen
Öffnen Sie CC Switch, wechseln Sie zum Tab "Codex" oben und klicken Sie auf das Pluszeichen in der oberen rechten Ecke, um einen Provider hinzuzufügen.
Wählen Sie DeepSeek aus den integrierten Presets; Sie müssen nur zwei Dinge tun:
- Den DeepSeek-API-Schlüssel eingeben.
- Den Provider speichern.
Das Preset enthält bereits die DeepSeek-Request-Adresse, das Standardmodell, das Modellmenü und die Denk-/Reasoning-Parameter und aktiviert automatisch "Erfordert lokales Routing-Mapping". Sie können das Standardmodell oder den Modellanzeigenamen nach Bedarf anpassen; die Protokollkonvertierung wird von der Routing-Ebene übernommen.
Schritt 2: Lokales Routing aktivieren und Codex übernehmen
Gehen Sie zur Seite "Routing" in den Einstellungen, erweitern Sie "Lokales Routing" und führen Sie zwei Umschaltvorgänge durch:
- Schalten Sie den Haupt-Routing-Schalter ein, um den lokalen Dienst zu starten. Die Standardadresse ist
127.0.0.1:15721. - Schalten Sie Codex unter "Routing-Aktivierung" ein. Wenn nur Codex über die Route laufen soll, können Sie Claude und Gemini ausgeschaltet lassen.
Nach der Übernahme zeigt CC Switch die Live-Konfiguration von Codex auf die lokale Route und verwaltet die Authentifizierung mit Platzhaltern. Der echte DeepSeek-Schlüssel wird weiterhin in der CC Switch-Provider-Konfiguration gespeichert und von der lokalen Route während der Weiterleitung injiziert, sodass Sie den Schlüssel nicht in der Codex-Live-Konfiguration offenlegen müssen.
Schritt 3: Provider wechseln und Codex neu starten
Kehren Sie zur Codex-Providerliste zurück und aktivieren Sie den DeepSeek-Provider. Wenn Sie ein "Erfordert Route"-Tag sehen, bedeutet dies, dass dieser Provider nur bei laufender Route verwendet werden kann; wenn die Route nicht gestartet ist, zeigt CC Switch einen Hinweis an: "Routing-Dienst für die normale Nutzung erforderlich."
Nach dem Wechsel wird empfohlen, die aktuelle Codex-Terminalsitzung neu zu starten, weil:
- Der Codex-Prozess möglicherweise bereits die alte
config.tomlgelesen hat. - Nach der Generierung von
modelcatalogjsonerfordert das/model-Menü normalerweise einen neuen Prozess, um aktualisiert zu werden.
Sobald Sie in Codex sind, können Sie mit /model überprüfen, ob das aktuelle Modell aus dem DeepSeek-Preset stammt, z. B. DeepSeek V4 Flash. Derzeit unterstützt die Codex-App keine benutzerdefinierte Multi-Modell-Auswahl und verwendet standardmäßig das erste Modell in der Konfiguration.
Umgang mit anderen Chat-Anbietern
Gängige Chat-Format-Anbieter wie DeepSeek, Kimi, MiniMax und SiliconFlow haben bereits Presets in CC Switch; verwenden Sie diese vorrangig. Nur für Anbieter, die nicht in den Presets enthalten sind, müssen Sie eine benutzerdefinierte Konfiguration wählen; geben Sie in diesem Fall den API-Schlüssel, die Basis-URL und das Modell gemäß deren Dokumentation ein und setzen Sie das API-Format auf "OpenAI Chat Completions (erfordert Routing)".
Wenn der Upstream direkt die OpenAI Responses API unterstützt, müssen Sie "Erfordert lokales Routing-Mapping" nicht aktivieren; in diesem Fall kann CC Switch direkt über Responses verbinden, ohne Chat-Konvertierung.
FAQ
Codex meldet 404 oder findet /responses nicht
Dies liegt normalerweise daran, dass die Codex-Übernahme nicht aktiviert ist oder Sie die Chat-Basis-URL des Upstreams manuell direkt in Codex geschrieben haben. Überprüfen Sie, ob ~/.codex/config.toml auf http://127.0.0.1:15721/v1 zeigt.
DeepSeek-Upstream meldet 404
Wenn Sie das integrierte DeepSeek-Preset verwenden, bestätigen Sie zunächst, dass der aktuelle Provider tatsächlich aus dem Preset stammt und dass das Codex-Routing aktiviert ist. Nur bei Verwendung eines benutzerdefinierten Providers müssen Sie die Basis-URL überprüfen: Sie sollte die Stammadresse des Dienstes sein, nicht der vollständige Schnittstellenpfad mit /chat/completions.
/model zeigt keine DeepSeek-Modelle an
Starten Sie Codex nach dem Speichern des Providers neu. CC Switch generiert cc-switch-model-catalog.json und schreibt den Pfad in modelcatalogjson, aber ein laufender Codex-Prozess lädt das Modellverzeichnis möglicherweise nicht heiß nach.
Derzeit unterstützt die Codex-App keine Multi-Modell-Auswahl und verwendet standardmäßig das erste Modell.
Route ist aktiv, aber Requests gehen trotzdem an den falschen Provider
Stellen Sie sicher, dass drei Zustände übereinstimmen: Der aktuelle Provider unter dem Codex-Tab ist DeepSeek; der lokale Routing-Dienst läuft; und der Codex-Schalter unter "Routing-Aktivierung" ist eingeschaltet.
Kann ich das offizielle OpenAI Codex-Konto über lokales Routing verwenden?
Nicht empfohlen. CC Switch verhindert das Umschalten auf offizielle Provider im lokalen Routing-Übernahmemodus, da die Verwendung eines Proxys für den Zugriff auf die offizielle API Kontorisiken bergen kann. Routing ist hauptsächlich für Drittanbieter-, Aggregations- oder Protokollkonvertierungsszenarien gedacht.
![Yusuke Naritas geniale KI-Nutzungstechniken [Archiv-Edition]](/cdn-cgi/image/width=1920,quality=90,format=auto,metadata=none/https%3A%2F%2Fcms-assets.youmind.com%2Fmedia%2F1784137658627_u4bwry_HNMS89bbsAAUPJI.jpg)
