Einrichtungsleitfaden

Provider-Einrichtungsleitfaden

Einrichtungsschritte und Fehlerbehebung nach Tool durchsuchen.

Provider-Einrichtungsleitfaden/CC-Switch-CLI Anleitung

CC-Switch-CLI Anleitung

CC-Switch-CLI ist ein Provider-Umschaltwerkzeug für die Befehlszeile, geeignet für Server ohne grafische Benutzeroberfläche, SSH-Umgebungen oder für alle, die schnell zwischen Claude Code, Codex, Gemini CLI, OpenCode und OpenClaw den Provider wechseln müssen.

Offizielle Informationen Downloads und Dokumentation richten sich nach der offiziellen Website.
GitHub Offizielles Repository von CC-Switch-CLI, Befehlsübersicht und Releases Releases Version für Windows / macOS / Linux herunterladen Homebrew macOS kann über Homebrew installiert werden

Für wen ist es geeignet

Wenn Sie ein normaler Desktop-Nutzer sind, empfiehlt sich vorrangig die grafische Oberfläche von CC Switch. Wenn Sie bereits an das Terminal gewöhnt sind oder Konfigurationen im Batch verwalten müssen, schauen Sie sich diese Seite an. Die folgenden Codeblöcke enthalten nur Befehle; Erklärungen stehen außerhalb der Codeblöcke, um zu verhindern, dass Erläuterungen versehentlich mitkopiert werden.

Installation und Start

macOS- / Linux-Nutzer können der offiziellen Dokumentation folgen, um das Installationsskript oder die Release-Pakete zu nutzen. Windows-Nutzern wird empfohlen, das entsprechende Archiv aus den Releases herunterzuladen und nach dem Entpacken im Programmverzeichnis auszuführen.

Offizielles Installationsskript
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash cc-switch

Die direkte Eingabe von cc-switch öffnet die interaktive Oberfläche, die sich für Einsteiger eignet, um zunächst das Menü kennenzulernen. Die nachfolgenden Befehle eignen sich, wenn Sie bereits wissen, was Sie tun möchten, und diese direkt ausführen wollen.

Überprüfung der Umgebung

Zu prüfender PunktVorgehensweiseGrund
CC Switch oder CLI-Version ist installiertDas Terminal erkennt den entsprechenden BefehlJeder Konfigurationsbefehl schlägt fehl, wenn das Tool nicht installiert ist.
Ziel-CLI ist installiertClaude Code, Codex und Gemini CLI lassen sich zumindest einzeln startenCC-Switch-CLI installiert die Zielwerkzeuge nicht für Sie
Provider-Informationen sind vollständigBase URL, API-Key und Modellname bereithaltenDie Befehlszeilenkonfiguration bietet keine visuellen Hinweise; ein fehlendes Feld führt schnell zu Fehlern.
Zuerst im Testverzeichnis verifizierenNicht direkt im Produktivprojekt in großem Umfang umschaltenErleichtert das Rollback bei Fehlkonfigurationen
Zuerst die lokale Umgebung prüfen Die folgenden Befehle dienen dazu, zu bestätigen, welche Werkzeuge CC-Switch-CLI erkennt, welcher Provider aktuell aktiv ist und ob der Proxy-Status in Ordnung ist.
Befehle zur Umgebungsprüfung
cc-switch env tools cc-switch env check cc-switch provider current cc-switch --app codex provider current

Provider-Befehle

Ein Provider entspricht einer Relay-Konfiguration. Bevor Sie einen Provider hinzufügen, halten Sie Base URL, API-Key und Modellnamen aus dem Backend des Providers bereit. Nutzen Sie beim Bearbeiten oder Wechseln zunächst den Listenbefehl, um die Kennung (ID) zu bestätigen.

Provider anzeigen, hinzufügen und bearbeiten
cc-switch provider list cc-switch provider add cc-switch provider edit <id> cc-switch provider fetch-models <id>
Provider wechseln und Verbindung testen
cc-switch provider switch <id> cc-switch provider stream-check <id> cc-switch provider fetch-models <id>
<id> muss durch die Nummer ersetzt werden, die in der Ausgabe von cc-switch provider list angezeigt wird. Führen Sie <id> nicht unmodifiziert aus.

Verwaltung nach Anwendung

Wenn Sie nur die Konfiguration eines bestimmten Zielwerkzeugs einsehen möchten, können Sie --app anhängen. Das ist sehr nützlich, um Claude Code, Codex und Gemini CLI getrennt zu analysieren.

Provider nach Anwendung anzeigen
cc-switch --app claude provider list cc-switch --app codex provider list cc-switch --app gemini provider list cc-switch --app opencode provider list cc-switch --app openclaw provider list
Aktuellen Provider nach Anwendung bestätigen
cc-switch --app claude provider current cc-switch --app codex provider current cc-switch --app gemini provider current

Führen Sie den Wechsel erst durch, wenn Sie bestätigt haben, dass die Zielanwendung und der aktuelle Provider passen. Starten Sie nach dem Umschalten das Terminal neu und senden Sie mit dem Zielwerkzeug eine minimale Testanfrage.

Minimaler Test nach dem Umschalten
claude "Please reply only: Claude Code is active" codex "Please reply only: Codex is active" gemini "Please reply only: Gemini is active"

MCP-Synchronisierung

MCP ist nicht für jeden Einsteiger erforderlich. Beschäftigen Sie sich erst damit, wenn Sie MCP bereits in Claude Code, Codex oder Gemini CLI nutzen und eine werkzeugübergreifende Synchronisierung benötigen. Beim ersten Mal empfiehlt es sich, das TUI-Menü aufzurufen, um den MCP-Bereich zu prüfen, anstatt erweiterte Befehle aus alten Anleitungen direkt zu kopieren.

Einstieg in die MCP-Verwaltung aufrufen
cc-switch cc-switch --app codex

Konfigurationsablauf

  1. Bestätigen Sie zunächst das Zielwerkzeug, das Sie umschalten möchten: Claude Code, Codex, Gemini CLI oder ein anderes CLI.
  2. Bereiten Sie Base URL, API-Key und Modellnamen aus dem Provider-Backend vor.
  3. Fügen Sie in CC-Switch-CLI einen Provider hinzu oder wählen Sie einen vorhandenen aus.
  4. Wenden Sie den Provider auf das Zielwerkzeug an.
  5. Öffnen Sie das Terminal neu und testen Sie das Ziel-CLI mit einer minimalen Testfrage.
  6. Nach erfolgreicher Bestätigung können Sie denselben Provider auf weitere Zielwerkzeuge anwenden.
SzenarienEmpfehlungen
Lokale Desktop-NutzungGrafische CC Switch-Oberfläche bevorzugen; Eingabefelder und Status sind übersichtlicher
Remote-Server / SSHCC-Switch-CLI verwenden; vorab die Befehle der aktuellen Version prüfen
Umschaltung von Batch-KonfigurationenZuerst den Erfolg in einem Testprojekt verifizieren, dann auf Produktivprojekte anwenden
Mehrere Personen auf einem RechnerTragen Sie Ihren Key nicht in die globale/öffentliche Konfiguration ein; prüfen Sie vorab den Geltungsbereich der Konfigurationsdatei

Fehlerbehebung für Einsteiger

ProblemVorrangige PrüfungLösung
Befehl nicht gefunden (Command not found)Prüfen, ob das Tool installiert und zu PATH hinzugefügt wurdeTerminal neu öffnen oder in der offiziellen Installationsanleitung den Installationspfad überprüfen
Zielwerkzeug hat sich nach dem Wechsel nicht geändertWurde das Terminal neu geöffnet und das richtige Zielwerkzeug ausgewählt?Schließen Sie das aktuelle Terminalfenster, öffnen Sie es neu und testen Sie erneut
401 / UnauthorizedIst der Key vollständig und noch gültig?Kopieren Sie den Key erneut und stellen Sie sicher, dass keine überflüssigen Leerzeichen enthalten sind
Modell nicht gefunden (model not found)Wurde der Modellname exakt aus dem Backend kopiert?Entsprechend der Modellliste des Providers neu eintragen
Bei Befehlszeilen-Anleitungen entstehen die meisten Fehler durch das Kopieren veralteter Befehle. Hier werden Konfigurationspfad und Fehlerbehebungslogik beibehalten; richten Sie sich bei spezifischen Befehlen stets nach der aktuellen Version.