Einrichtungsleitfaden

Provider-Einrichtungsleitfaden

Einrichtungsschritte und Fehlerbehebung nach Tool durchsuchen.

CC-Switch Codex

Diese Seite beschreibt die Verwaltung von Codex-Providern über CC Switch. Dies unterscheidet sich von der direkten Konfiguration im Codex-Client oder der Codex-CLI: Der Schwerpunkt liegt hier darauf, die Provider zuerst in CC Switch zu pflegen und sie anschließend auf Codex anzuwenden.

Was diese Seite erklärt

Codex arbeitet normalerweise über OpenAI- oder OpenAI-kompatible Schnittstellen. Konzentrieren Sie sich daher auf die Überprüfung von drei Punkten: Base URL, Key und Modellname. Ob die Base URL /v1 enthalten muss, hängt davon ab, was im Backend des Providers angegeben ist.

Vorab-Prüfung vor dem Start

Zu prüfender PunktPrüfmethodeWarum wichtig
Codex lässt sich normal öffnenPrüfen Sie zuerst, ob die Codex-CLI oder der entsprechende Client selbst lauffähig istCC Switch installiert Codex nicht für Sie
Der Provider unterstützt OpenAI-kompatible SchnittstellenIm Backend werden API-Adresse, Base URL, OpenAI-Kompatibilität und andere Hinweise angezeigtCodex muss Anfragen an die kompatible Schnittstelle senden können
Das Modell ist für Codex-Szenarien nutzbarDer verfügbare Modellname ist in der Modellliste des Backends ersichtlichTragen Sie keine Modellnamen von Claude/Gemini in Codex ein
Key-Status ist normalDas Backend-Token ist weder abgelaufen noch deaktiviert, und das Guthaben reicht ausDie meisten 401-Fehler erfordern zunächst eine Überprüfung des Keys

Ausfüllen der Felder

EinstellungEingabemethodeHinweis für Einsteiger
Provider NameNamen des Providers oder den Verwendungszweck eintragenZum Beispiel „Hauptanbieter OpenAI-kompatibel“
Target Tool / PresetCodex oder OpenAI/Codex-bezogene Vorlagen auswählenWählen Sie nicht Claude Code oder Gemini
Base URLVom Backend des Providers bereitgestellten API-Link kopierenIn der Regel die vom Provider angegebene API-Adresse; ob /v1 enthalten sein muss, richtet sich nach dem Backend-Beispiel
API KeyVollständigen Key kopierenKeine zusätzlichen Leerzeichen davor oder danach einfügen, nicht mit dem Notiznamen verwechseln
Model NameModellliste aus dem Backend exakt übernehmenFalls das Abrufen der Modellliste fehlschlägt, manuell hinzufügen – weiterhin den Backend-Namen exakt kopieren

Auf Codex anwenden

  1. Öffnen Sie CC Switch und navigieren Sie zum Bereich für die Provider-Verwaltung.
  2. Fügen Sie einen neuen Provider hinzu oder wählen Sie einen bestehenden OpenAI-kompatiblen Provider aus.
  3. Wählen Sie Codex oder OpenAI/Codex-bezogene Vorlagen als Zieltool aus.
  4. Tragen Sie Base URL, API Key und Modellname ein und speichern Sie.
  5. Führen Sie Apply / Switch aus, um diesen Provider auf Codex anzuwenden.
  6. Schließen Sie das aktuelle Terminalfenster, öffnen Sie es erneut und führen Sie einen Test durch.

Funktionstest

Testen Sie die Anfrage zunächst mit einer möglichst kurzen Eingabe, um zu prüfen, ob die Verbindung funktioniert. Nach erfolgreichem Test können Sie die Konfiguration in Ihrem eigentlichen Projekt verwenden.

Codex-Minimaltest
codex "Please reply only: CC-Switch Codex is active"
Wird gemeldet, dass das Modell nicht existiert, prüfen Sie zuerst den Modellnamen; wird gemeldet, dass der Zugriff nicht autorisiert ist, prüfen Sie zuerst den Key; kommt es zu einer Zeitüberschreitung (Timeout), prüfen Sie zuerst die Base URL und Ihre Netzwerkverbindung.