Dokumentation/Leitfaden zur Anbindung

Codex über den universellen Anbieter von CC Switch konfigurieren

Über dieses Dokument

Dieses Dokument beschreibt, wie Sie mit der Funktion Universeller Anbieter (Universal Provider) von CC Switch das Befehlszeilentool OpenAI Codex an ein angegebenes API-Gateway anbinden und die Konfiguration wirksam machen.

Gilt für: CC Switch v3.16.x und höher.

Quelle: Benutzerhandbuch und Quellcode des offiziellen CC Switch-Repositorys. Die Software entwickelt sich schnell weiter. Weicht die Produktoberfläche von der Beschreibung in diesem Dokument ab, gilt die tatsächliche Anzeige in der Anwendung.

Erklärung der Begriffe

Begriff Beschreibung
Codex KI-Programmierassistent für die Befehlszeile von OpenAI. Nach der Installation starten Sie ihn im Terminal mit dem Befehl codex.
CC Switch Plattformübergreifendes Desktop-Tool zur Verwaltung von Konfigurationen. Damit verwalten Sie die Endpunkte der Dienste und die Zugangsdaten von Tools wie Codex, Claude Code, Gemini CLI und anderen. CC Switch selbst stellt keine KI-Fähigkeiten bereit, sondern erzeugt und wechselt nur Konfigurationsdateien.
Anbieter (Provider) Dienst, der die Inferenz von Modellen bereitstellt. Das kann der offizielle Dienst eines Modellherstellers sein oder ein selbst aufgebautes oder eingekauftes API-Gateway.
API Key Schlüsselzeichenfolge zur Authentifizierung, beginnt üblicherweise mit sk-.
Universeller Anbieter (Universal Provider) Eine Funktion von CC Switch. Eine Konfiguration lässt sich gleichzeitig auf die drei Tools Claude Code, Codex und Gemini CLI synchronisieren und eignet sich für Gateways, die mehrere API-Protokolle gleichzeitig unterstützen (zum Beispiel NewAPI).
Anbieter für eine Anwendung Anbieterkonfiguration, die nur für ein einzelnes Tool gilt, im Gegensatz zum universellen Anbieter.

Bevor Sie beginnen

Systemvoraussetzungen

Betriebssystem Mindestversion Architektur
Windows Windows 10 x64
macOS macOS 12 (Monterey) Intel (x64) / Apple Silicon (arm64)
Linux Ubuntu 22.04 / Debian 11 / Fedora 34 und gleichwertige Versionen x64 / ARM64

Außerdem benötigen Sie Node.js 18 oder höher. Die Installationsschritte finden Sie unter „Aufgabe 1“.

Angaben, die Sie vorher einholen

Bevor Sie mit der Konfiguration beginnen, holen Sie bitte die folgenden vier Angaben beim Anbieter des API-Dienstes ein. Fehlt eine davon, lässt sich die Konfiguration nicht abschließen.

Punkt Beschreibung Beispiel
API-Adresse (Base URL) Dienstadresse des Gateways https://seedrouter.net
API Key Schlüssel zur Authentifizierung sk-xxxxxxxxxxxx
Modellname Modellkennung auf der Codex-Seite gpt-5.6-sol
Protokollunterstützung Ob das Gateway das Protokoll OpenAI Responses unterstützt Unterstützt / Nicht unterstützt

Kernpunkt: Der vierte Punkt entscheidet, ob dieses Dokument anwendbar ist. In der Konfiguration, die der einheitliche Anbieter für Codex erzeugt, ist das Kommunikationsprotokoll fest auf wire_api = "responses" gesetzt und kann nicht geändert werden. Wenn das Gateway das Protokoll Responses nicht unterstützt und nur das Protokoll Chat Completions unterstützt, können Sie den einheitlichen Anbieter nicht verwenden. Verwenden Sie stattdessen Lösung F im Abschnitt „Fehlerdiagnose“.

Terminal öffnen

An mehreren Stellen dieses Dokuments müssen Sie Befehle im Terminal ausführen. So öffnen Sie das Terminal:

  • Windows: Drücken Sie Win + R, geben Sie powershell ein und drücken Sie die Eingabetaste.
  • macOS: Drücken Sie Command + Leertaste, geben Sie terminal ein und drücken Sie die Eingabetaste.
  • Linux: Verwenden Sie die Terminal-Anwendung Ihrer Distribution.

Aufgabe 1: Node.js installieren

Zu dieser Aufgabe

Codex wird über npm, den Paketmanager von Node.js, verteilt. Auch bei der Installation mit einem Klick über CC Switch benötigen Sie zuerst eine Node.js-Laufzeitumgebung.

Vorgehen

  1. Öffnen Sie die offizielle Node.js-Website.

  2. Laden Sie das Installationspaket herunter, das mit LTS (Langzeitunterstützung) gekennzeichnet ist. Laden Sie nicht die Current-Version herunter.

  3. Führen Sie das Installationsprogramm aus und schließen Sie die Installation mit den Standardoptionen ab. Sie müssen keine Einstellung ändern.

    Wenn Sie macOS nutzen und Homebrew bereits installiert haben, können Sie im Terminal auch brew install node ausführen.

  4. Schließen Sie alle derzeit geöffneten Terminalfenster und öffnen Sie ein neues Terminalfenster.

  5. Führen Sie nacheinander die folgenden Befehle aus, um die Installation zu prüfen:

    node --version
      npm --version

Ergebnis

Beide Befehle geben eine Versionsnummer aus (zum Beispiel v22.14.0 und 10.9.2), und die Node.js-Version liegt nicht unter v18. Damit ist die Installation erfolgreich.

Hinweis: Erscheint „kein interner oder externer Befehl“ oder „command not found“, wurde das Terminalfenster meist nicht neu geöffnet. Neu installierte Befehle gelten nur in einer neu geöffneten Terminalsitzung.

Aufgabe 2: CC Switch installieren

Zu dieser Aufgabe

CC Switch ist kostenlose Open-Source-Software und wird nur über diese beiden Kanäle verteilt:

Warnung: Jede „CC Switch“-Website oder jeder „CC Switch“-Client, der eine Zahlung, eine Aufladung oder die Anmeldedaten eines Kontos verlangt, ist kein offizieller Kanal. Laden Sie solche Angebote nicht herunter und verwenden Sie sie nicht.

Vorgehen

Windows

  1. Öffnen Sie die GitHub-Releases-Seite und suchen Sie im Bereich Assets unter dem Eintrag der neuesten Version die Datei CC-Switch-v3.16.x-Windows.msi.

  2. Laden Sie das Installationsprogramm herunter, doppelklicken Sie darauf und schließen Sie die Installation nach den Anweisungen ab.

    Wenn nach dem Doppelklick nichts geschieht, hat die Sicherheitsrichtlinie des Systems die Datei gesperrt. Klicken Sie mit der rechten Maustaste auf die Datei, wählen Sie Eigenschaften und setzen Sie unten auf der Registerkarte Allgemein im Bereich Sicherheit ein Häkchen bei Zulassen. Klicken Sie auf OK und führen Sie die Datei erneut aus.

    Wenn Sie nicht auf dem System installieren möchten, können Sie auch die installationsfreie Version CC-Switch-v3.16.x-Windows-Portable.zip herunterladen, sie entpacken und CC-Switch.exe direkt starten.

macOS

Verwenden Sie eine der folgenden Varianten:

  • Variante 1 (empfohlen, wenn Homebrew installiert ist): Führen Sie im Terminal aus

    brew install --cask cc-switch

  • Variante 2: Laden Sie CC-Switch-v3.16.x-macOS.dmg herunter, öffnen Sie die Datei per Doppelklick und ziehen Sie das Symbol von CC Switch in den Ordner „Programme“.

    Hinweis: Die macOS-Version wurde von Apple code-signiert und notarisiert. Sie können sie direkt installieren und öffnen. Der Hinweis „Entwickler kann nicht verifiziert werden“ erscheint nicht, und Sie müssen die Quarantäne nicht zusätzlich aufheben.

Linux

Wählen Sie je nach Distribution:

  • Debian / Ubuntu: Laden Sie das .deb-Paket herunter und führen Sie aus

    sudo dpkg -i CC-Switch-v3.16.x-Linux-*.deb
      sudo apt-get install -f

  • Arch Linux: paru -S cc-switch-bin

  • Andere Distributionen: Laden Sie die .AppImage herunter, führen Sie chmod +x aus, um Ausführungsrechte zu setzen, und starten Sie die Datei direkt.

Ergebnis

Nach dem Start von CC Switch wird das Hauptfenster normal angezeigt, und im Systemtray (unter Windows unten rechts, unter macOS rechts in der Menüleiste) erscheint das CC Switch-Symbol. Das zeigt eine erfolgreiche Installation an.

Wenn Sie beim ersten Start aufgefordert werden, vorhandene Konfigurationen von CLI-Tools zu importieren, wird empfohlen, den Import zu wählen. Dieser Vorgang speichert die aktuell vorhandene Konfiguration als einen Standardanbieter. Es geht keine Konfiguration verloren.

Aufgabe 3: Codex installieren

Zu dieser Aufgabe

Sie können über die grafische Oberfläche von CC Switch oder über die Kommandozeile installieren. Bei der ersten Nutzung wird Variante A empfohlen.

Vorgehen

Variante A: Über CC Switch installieren (empfohlen)

  1. Starten Sie CC Switch.

  2. Öffnen Sie nacheinander Settings > About.

  3. Prüfen Sie im Bereich Local Environment Check den Status der Zeile Codex.

  4. Wenn „Not detected“ angezeigt wird, klicken Sie rechts in dieser Zeile auf den Button Install.

    Die Installation läuft still im Hintergrund. Auf dem Button wird der Fortschritt angezeigt. Nach Abschluss wird die Versionsnummer automatisch aktualisiert.

Hinweis: Spätere Upgrades erledigen Sie ebenfalls in dieser Oberfläche. Wird eine neue Version erkannt, können Sie einzeln aktualisieren oder mit Upgrade All im Batch verarbeiten.

Variante B: Über die Kommandozeile installieren

  1. Öffnen Sie das Terminal.

  2. Führen Sie den folgenden Befehl aus:

    npm install -g @openai/codex

    Wenn der Download zu langsam ist, können Sie auf einen Mirror wechseln:

    npm install -g @openai/codex --registry=https://registry.npmmirror.com

    Wenn Sie den Mirror dauerhaft nutzen möchten, können Sie vorab einmal den folgenden Befehl ausführen, um die globale Einstellung vorzunehmen:

    npm config set registry https://registry.npmmirror.com

Ergebnis

Schließen Sie das Terminal und öffnen Sie es erneut. Führen Sie danach den folgenden Befehl aus:

codex --version

Die Ausgabe einer Versionsnummer zeigt an, dass die Installation erfolgreich ist.

Hinweis: Die Konfiguration des Anbieters ist zu diesem Zeitpunkt noch nicht abgeschlossen. Starten Sie codex direkt, erscheint ein Fehler, weil gültige Credentials fehlen. Das ist erwartetes Verhalten. Die Konfiguration wird in Aufgabe 4 abgeschlossen.

Aufgabe 4: Unified Provider erstellen

Zu dieser Aufgabe

In dieser Aufgabe erstellen Sie in CC Switch eine Konfiguration für einen Unified Provider und synchronisieren sie in die Anbieterliste von Codex.

Vorgehen

  1. Starten Sie CC Switch.

  2. Wechseln Sie oben im App-Umschalter zu Codex.

    Auch wenn Sie zum Panel Claude oder Gemini wechseln, erreichen Sie den Einstieg zum Unified Provider. Alle drei teilen sich dieselbe Konfiguration.

  3. Klicken Sie oben rechts auf den Button ＋, um das Panel zum Hinzufügen eines Anbieters zu öffnen.

  4. Wählen Sie oben im Panel den Tab Unified Provider.

    Einschränkung: Die Panels OpenCode, OpenClaw, Hermes und Claude Desktop unterstützen den Unified Provider nicht. Unter diesen Panels wird der Tab nicht angezeigt. Wenn Sie den Tab nicht sehen, wechseln Sie zuerst zum Panel Claude, Codex oder Gemini.

  5. Klicken Sie auf Add Unified Provider.

  6. Füllen Sie die Formularfelder wie in der folgenden Tabelle aus:

    Feld Ausfüllhinweis
    Select Preset Type Ist das Gateway NewAPI, wählen Sie NewAPI. In anderen Fällen oder bei Unsicherheit wählen Sie Custom Gateway. Die Felder sind bei beiden identisch, nur die Standardwerte unterscheiden sich.
    Name Ein eigener Name zur Kennzeichnung, zum Beispiel NewAPI Gateway. Dieser Name wird auf der Anbieterkarte von Codex angezeigt.
    API Address Tragen Sie die zuvor erhaltene Base URL ein. Die Regeln zum Ausfüllen stehen weiter unten im Abschnitt „Regeln zur Verarbeitung der API-Adresse“.
    API Key Tragen Sie den zuvor erhaltenen Schlüssel ein. Sie können rechts auf das Augensymbol klicken, um die Klartextanzeige umzuschalten.
    Official Website Optional. Nach dem Ausfüllen können Sie von der Anbieterkarte direkt dorthin wechseln.
    Notes Optional. Es wird empfohlen, Herkunft und Gültigkeitsdauer des Schlüssels sowie weitere Angaben festzuhalten.
    Enabled Apps Enthält drei Schalter: Claude Code, OpenAI Codex und Gemini. OpenAI Codex muss eingeschaltet sein. Wenn das Gateway zugleich für die beiden anderen Tools genutzt wird, können Sie diese ebenfalls einschalten.
    Model Configuration > Codex > Model Tragen Sie den zuvor erhaltenen Modellnamen ein, zum Beispiel gpt-5.6-sol.
    Model Configuration > Codex > Reasoning Effort Intensität des Reasoning. Der Wert ist low, medium oder high. Liegen keine besonderen Anforderungen vor, tragen Sie high ein.

    Hinweis: Das Formular für den einheitlichen Anbieter bietet keine Schaltfläche „Get Models“. Den Modellnamen müssen Sie manuell eintragen; die Groß- und Kleinschreibung wird unterschieden.

  7. Klicken Sie auf Add.

Ergebnis

Die Oberfläche meldet „Unified provider added and synced“. CC Switch hat dann in der Anbieterliste von Codex eine Karte mit demselben Namen erzeugt. Haben Sie weitere Anwendungen ausgewählt, wird die Karte auch in den jeweiligen Listen erzeugt.

Wichtig: Synchronisieren ist nicht Aktivieren. Die Konfiguration ist noch nicht in die Konfigurationsdatei von Codex für die Laufzeit geschrieben. Fahren Sie mit Aufgabe 5 fort.

Regeln für die API-Adresse

Wenn CC Switch die Konfiguration für Codex erzeugt, verarbeitet es die eingegebene API-Adresse wie folgt:

Eingegebene Adressform Ergebnis
Nur die Domain, ohne Pfad, z. B. https://seedrouter.net Wird automatisch zu https://seedrouter.net/v1 ergänzt
Endet bereits mit /v1, z. B. https://seedrouter.net/v1 Wird unverändert verwendet
Enthält einen anderen Pfad, z. B. https://api.example.com/openai Wird unverändert verwendet, /v1 wird nicht ergänzt

Kriterium: Die verarbeitete Adresse plus /responses muss ein API-Pfad sein, den das Gateway tatsächlich bereitstellt. Vor dem Ausfüllen sollten Sie die vollständige API-Adresse beim Dienstanbieter bestätigen und anhand der Tabelle oben erschließen, was Sie eintragen. Eine falsche Adresse führt dazu, dass die Anfrage 404 zurückgibt.

Aufgabe 5: Anbieter aktivieren und Konfiguration wirksam machen

Zu dieser Aufgabe

Nachdem die Anbieterkarte erzeugt wurde, müssen Sie sie manuell aktivieren. Erst dann wird die Konfiguration in die Konfigurationsdatei von Codex geschrieben. Codex unterstützt kein Hot-Reload der Konfiguration. Nach dem Aktivieren müssen Sie das Terminal neu starten.

Ablauf

  1. Schließen Sie das Panel zum Hinzufügen eines Anbieters.

  2. Wechseln Sie oben im App-Umschalter zu Codex.

  3. Suchen Sie in der Anbieterliste die Karte mit demselben Namen, die Sie in Aufgabe 4 erstellt haben.

  4. Klicken Sie auf der Karte auf die Schaltfläche Enable.

    Die Karte erscheint mit blauem Rahmen und dem Label „Currently enabled“. Das zeigt an, dass die Konfiguration geschrieben wurde.

  5. Schließen Sie das aktuelle Terminalfenster vollständig und öffnen Sie danach ein neues Terminalfenster.

    Wichtig: Gemeint ist, das gesamte Terminalfenster zu schließen, nicht den Prozess codex zu beenden und danach den Befehl codex erneut auszuführen. So wird der Wechsel bei den einzelnen Tools wirksam:

    Tool Wirksam nach dem Wechsel
    Claude Code Sofort wirksam, Hot-Reload wird unterstützt
    Gemini CLI Sofort wirksam, die Konfiguration wird bei jeder Anfrage neu gelesen
    Codex Terminal schließen und neu öffnen
    OpenCode / OpenClaw Terminal schließen und neu öffnen

  6. Führen Sie im neuen Terminal aus:

    codex

  7. Geben Sie nach dem Start einen Testsatz ein, zum Beispiel „Hallo, stell dich bitte kurz vor“.

Ergebnis

Das Modell antwortet normal. Das zeigt an, dass die Konfiguration abgeschlossen ist und Codex mit dem angegebenen Gateway verbunden ist.

Referenz: Erzeugte Konfigurationsdateien

CC Switch folgt dem Prinzip minimaler Eingriffe. Nach dem Aktivieren des Anbieters wird die Konfiguration direkt in die eigene Konfigurationsdatei von Codex geschrieben. Auch nach der Deinstallation von CC Switch kann Codex weiterhin normal arbeiten.

Die folgenden Dateien sind betroffen. ~ im Pfad steht für das Verzeichnis des aktuellen Benutzers, unter Windows ist das C:\Users\<Benutzername>\, unter macOS und Linux /Users/<Benutzername>/ oder /home/<Benutzername>/.

~/.codex/auth.json — speichert die Zugangsdaten:

{
        "OPENAI_API_KEY": "<API Key>"
      }

~/.codex/config.toml — speichert die Konfiguration für Modell und Endpoint:

model_provider = "cliproxyapi"
      model = "gpt-5.6-sol"
      model_reasoning_effort = "max"
      sandbox_mode = "workspace-write"
      model_context_window = 372000
      model_auto_compact_token_limit = 334800
      model_auto_compact_token_limit_scope = "total"
      service_tier = "priority"
      
      [model_providers.cliproxyapi]
      name = "SeedRouter"
      base_url = "https://seedrouter.net/v1"
      wire_api = "responses"
      requires_openai_auth = true
      experimental_bearer_token = "sk-xxxxxxxxxx"

CC Switch speichert seine eigenen Daten im Verzeichnis ~/.cc-switch/. Die Datenbankdatei ist cc-switch.db, automatische Backups liegen im Unterverzeichnis backups/, aufbewahrt werden die letzten 10 Kopien.

Wartung

Konfiguration ändern

Wenn Sie den API Key, den Modellnamen oder die Dienstadresse ändern:

  1. Klicken Sie auf die Schaltfläche ＋ und wechseln Sie zum Tab Unified Provider.

  2. Klicken Sie auf der Zielkarte auf das Bearbeiten-Symbol.

  3. Ändern Sie die entsprechenden Felder.

    Im Bearbeitungsmodus bietet das Formular unten den Bereich Config JSON Preview. Dort können Sie vor dem Synchronisieren prüfen, welcher Inhalt tatsächlich in die einzelnen Anwendungen geschrieben wird.

  4. Klicken Sie auf Save and Sync.

  5. Bestätigen Sie den Vorgang im Bestätigungsdialog. Dieser Vorgang überschreibt die verknüpften Anbieterkonfigurationen in Claude, Codex und Gemini.

  6. Schließen Sie das Terminal und öffnen Sie es erneut.

Aktionen auf Anbieterkarten

Aktion Beschreibung
Sync Aktuelle Konfiguration manuell erneut an alle verknüpften Anwendungen übertragen, zur Behebung, wenn die Konfigurationen nicht übereinstimmen
Copy Aus der aktuellen Konfiguration eine Kopie anlegen, um einen Ersatzschlüssel einzurichten
Edit Inhalt der Konfiguration ändern
Delete Den Unified Provider löschen und zugleich die zugehörigen Anbieterkarten löschen, die in Claude, Codex und Gemini erzeugt wurden

Schnellwechsel

Klicken Sie mit der rechten Maustaste auf das Symbol von CC Switch im System Tray und klicken Sie im Untermenü Codex direkt auf den Namen des Zielanbieters. Die Hauptoberfläche muss dafür nicht geöffnet werden. Nach dem Wechsel muss das Terminal ebenfalls neu gestartet werden.

Fehlersuche

A. Antwort 401 oder 403, Authentifizierung fehlgeschlagen

Mögliche Ursache Lösung
Beim Kopieren des API Keys wurden überzählige Leerzeichen oder Zeilenumbrüche übernommen Erneut kopieren und einfügen, auf die Auswahl achten
Der API Key ist abgelaufen oder das Kontingent ist aufgebraucht Schlüsselstatus beim Anbieter bestätigen
API Key und API-Adresse passen nicht zusammen Prüfen, ob beide vom selben Dienst stammen

B. Antwort 404 oder Hinweis, dass die Schnittstelle nicht existiert

In den meisten Fällen ist die API-Adresse nach der Verarbeitung nicht korrekt. Prüfen Sie sie erneut anhand von „Aufgabe 4 > Regeln zur Verarbeitung der API-Adresse“ und lassen Sie sich vom Anbieter die vollständige Adresse der Schnittstelle bestätigen.

C. Nach dem Ändern der Konfiguration keinerlei Änderung

Das Terminal wurde nicht neu gestartet. Schließen Sie das Terminalfenster vollständig und öffnen Sie es erneut. Das ist das häufigste Problem bei der Nutzung von Codex.

D. Oben in der Oberfläche erscheint eine Warnung zu Konflikten bei Umgebungsvariablen

Im System sind Umgebungsvariablen wie OPENAI_API_KEY gesetzt. Umgebungsvariablen haben Vorrang vor der Konfigurationsdatei und überschreiben die von CC Switch geschriebene Konfiguration. Anfragen gehen dadurch an den falschen Endpoint oder verwenden den falschen Schlüssel.

Schritte:

  1. Klicken Sie im Warnbanner auf Expand, um Name, Wert und Herkunft der kollidierenden Variablen zu sehen.
  2. Markieren Sie die zu löschenden Variablen oder klicken Sie auf Select All.
  3. Klicken Sie auf Delete Selected und bestätigen Sie.

CC Switch sichert vor dem Löschen automatisch nach ~/.cc-switch/env-backups/. Zur Wiederherstellung können Sie den Stand manuell aus den JSON-Dateien in diesem Verzeichnis zurückholen.

E. Das Terminal meldet, dass der Befehl codex nicht existiert

Mögliche Ursache Lösung
Das Terminal wurde nach der Installation nicht erneut geöffnet Alle Terminalfenster schließen und erneut öffnen
Node.js ist nicht korrekt installiert Zurück zu Aufgabe 1, prüfen, ob npm --version normal ausgibt
Das globale Verzeichnis von npm liegt nicht im PATH Über Settings > About > Local Environment Check in CC Switch erneut installieren

F. Das Gateway unterstützt nur das Protokoll Chat Completions

Das Kommunikationsprotokoll von Unified Provider ist fest auf Responses eingestellt. In diesem Fall ist das nicht anwendbar; verwenden Sie einen anwendungsspezifischen Anbieter.

  1. Wechseln Sie in CC Switch zum Panel Codex und klicken Sie auf die Schaltfläche ＋.
  2. Bleiben Sie auf dem linken Tab Codex Provider und wechseln Sie nicht zu Unified Provider.
  3. Wählen Sie im Preset-Dropdown den passenden Dienstanbieter. DeepSeek, Zhipu GLM, Kimi, MiniMax, StepFun, Bailian, ModelScope, SiliconFlow, Doubao Seed, Xiaomi MiMo, Novita AI und weitere gehören zu den Presets vom Typ Chat Completions.
  4. Nach der Auswahl eines solchen Presets schaltet CC Switch den Schalter „Requires local route mapping“ automatisch ein und richtet die Modellzuordnung ein. Der lokale Proxy übernimmt die Protokollumsetzung, eine manuelle Einstellung ist nicht nötig.
  5. Tragen Sie den API Key ein, klicken Sie auf Add, aktivieren Sie anschließend diesen Anbieter und starten Sie das Terminal neu.

G. Anmeldung mit dem offiziellen Konto wiederherstellen

  1. Fügen Sie im Panel Codex einen Anbieter mit dem Preset „OpenAI Official“ hinzu.
  2. Aktivieren Sie diesen Anbieter und starten Sie das Terminal neu.
  3. Schließen Sie die Authentifizierung nach dem eigenen Anmeldevorgang von Codex ab.

Danach können Sie frei zwischen der offiziellen Anmeldung und Drittanbietern wechseln.

Auswahlreferenz: Unified Provider und App-specific Provider

Szenario Empfehlung
Ein einziges Gateway bedient gleichzeitig Claude Code, Codex und Gemini CLI und unterstützt das Protokoll Responses Unified Provider
Nur Codex als einziges Tool Beides ist möglich; beim App-specific Provider ist der Konfigurationspfad kürzer
Das Gateway unterstützt nur das Protokoll Chat Completions App-specific Provider, zusammen mit dem eingebauten Preset
Jedes Tool wird an einen anderen Dienst angebunden App-specific Provider, jeweils separat konfigurieren
OpenCode, OpenClaw oder Hermes müssen konfiguriert werden App-specific Provider; diese drei Tools unterstützen Unified Provider nicht

Sicherheitshinweise

  1. Ein API Key ist ebenso sensibel wie die Zugangsdaten des Kontos. Geben Sie ihn nicht in Instant-Messengern weiter, teilen Sie keine Screenshots und bringen Sie ihn nicht in ein Code-Repository ein.
  2. Beziehen Sie das CC Switch-Installationspaket nur über die offizielle CC Switch-Website oder das offizielle GitHub-Repository.
  3. Wechseln Sie den Schlüssel sofort, wenn Sie das Gerät wechseln oder vermuten, dass der Schlüssel offengelegt wurde.
  4. Die Exportfunktion für die Konfiguration von CC Switch schreibt alle Anbieterinformationen im Klartext in eine .sql-Sicherungsdatei. Bewahren Sie die exportierte Datei sicher auf und legen Sie sie nicht in einem gemeinsam genutzten Verzeichnis ab.

Schnellreferenz

1. Node.js installieren                         nodejs.org, LTS-Version wählen
      2. CC Switch installieren                 ccswitch.io oder GitHub Releases
      3. Codex installieren                     CC Switch > Settings > About > Local Environment Check > Install
      4. Unified Provider erstellen             Zum Codex-Panel wechseln > ＋ > Unified Provider > Add Unified Provider
                                                Name, API-Adresse und API Key eintragen
                                                OpenAI Codex-Schalter einschalten, Modellnamen eintragen
      5. Anbieter aktivieren                    Codex-Panel > Zielkarte > Enable
      6. Terminal neu starten                   Terminalfenster vollständig schließen und danach neu öffnen
      7. Prüfen                                 Befehl codex ausführen und eine Testnachricht senden

Wenn Sie ein Problem melden, legen Sie bitte einen vollständigen Screenshot der Fehlerinformationen sowie die in Aufgabe 4 eingetragene API-Adresse bei (Schlüsselteil maskieren), um die Fehlersuche zu verkürzen.

SeedRouter API Key holen Zurück zur Doku-Startseite