CC-Switch: Allgemeine Schritte
CC Switch ist ein quelloffenes, vereinheitlichtes Verwaltungstool für KI-Programmier-CLIs. Es löst vor allem ein Problem: Wenn Sie Claude Code, Codex, Gemini CLI, OpenCode und andere Tools gleichzeitig nutzen, müssen Sie Key, Base URL, Modellname und MCP-Konfiguration nicht mehr für jedes Tool einzeln anpassen.
Offizielle Informationen Downloads und Dokumentation richten sich nach der offiziellen Website.
Worum es sich bei diesem Tool handelt und wofür es verwendet wird
Es eignet sich für alle, die bereits mehrere KI-Programmiertools auf der Befehlszeile installiert haben. Gewöhnliche Einsteiger, die nur ein einzelnes Chat-Programm nutzen, müssen CC Switch nicht vorab erlernen; wenn Sie jedoch Claude Code, Codex CLI und Gemini CLI gleichzeitig verwenden, lohnt es sich, Ihre Provider damit einheitlich zu verwalten.
Für welche Szenarien eignet es sich?
Gemeinsame Provider für mehrere CLIsDerselbe AI-Provider oder dieselbe offizielle API soll gleichzeitig für Claude Code, Codex und Gemini CLI verwendet werden.
Häufiger Wechsel von ProvidernZum Beispiel tagsüber das offizielle Konto nutzen, beim Testen auf den AI-Provider wechseln oder in verschiedenen Projekten unterschiedliche Modelle einsetzen.
Einheitliche MCPs / SkillsDie offizielle Dokumentation von CC Switch umfasst auch toolübergreifende Verwaltungsfunktionen wie MCP und Skills. Einsteiger sollten zunächst lernen, Provider zu wechseln.
Herunterladen, installieren und zum ersten Mal öffnen
Zunächst die Hauptoberfläche prüfen Öffnen Sie nach der Installation zunächst das Hauptprogramm und vergewissern Sie sich, dass links Einträge wie Provider, MCP und Skills zu sehen sind. Einsteiger sollten sich zunächst nur mit Providern befassen und nicht gleichzeitig MCP und Prompts anpassen.
- Rufen Sie die offizielle Website von CC Switch oder die GitHub-Releases auf, um die aktuelle Version herunterzuladen.
- Windows-Nutzer wählen das für ihr System passende Installationspaket; macOS- / Linux-Nutzer folgen der offiziellen Installationsanleitung.
- Öffnen Sie nach der Installation zunächst das Hauptprogramm und prüfen Sie, ob die Oberfläche korrekt geladen wird.
- Falls das System den Start blockiert, vergewissern Sie sich zunächst, dass die Quelle das offizielle Repository oder die offizielle Website ist, und erlauben Sie die Ausführung gemäß den Systemhinweisen.
Provider hinzufügen
Referenz zum Hinzufügen von Providern Prüfen Sie hier zunächst den Einstiegspunkt und die Feldpositionen zum Hinzufügen eines neuen Providers; die Felder für verschiedene Ziel-CLIs können sich je nach Version im Detail unterscheiden.
- Vergewissern Sie sich zunächst separat, dass Claude Code, Codex CLI und Gemini CLI eigenständig starten können. CC Switch ist ein Verwaltungstool und installiert die CLIs nicht automatisch für Sie.
- Laden Sie das Installationspaket aus dem offiziellen CC Switch Repository oder von der offiziellen Website herunter. Vermeiden Sie Downloads aus unbekannten Cloud-Speichern.
- Öffnen Sie CC Switch und navigieren Sie zur Seite für die Provider-Verwaltung.
- Fügen Sie einen neuen Provider hinzu und benennen Sie ihn nach dem Anbieter, zum Beispiel „Ein AI-Provider“.
- Geben Sie die Base URL, den API Key und den Modellnamen ein, die Sie im Backend des Providers finden. Die Felder können je nach Ziel-Tool variieren; füllen Sie sie entsprechend den Hinweisen auf der aktuellen Seite von CC Switch aus.
- Wählen Sie nach dem Speichern das Ziel-Tool aus, auf das die Konfiguration angewendet werden soll, z. B. Claude Code, Codex oder Gemini CLI.
- Starten Sie nach Ausführung von Switch / Apply das entsprechende Terminal oder die CLI gemäß der Aufforderung neu. Laut offizieller Dokumentation erfordern die meisten Tools nach dem Umschalten einen Neustart, während Claude Code derzeit Hot-Switching unterstützt.
| Konfigurationselement | Ausfüllhinweis | Wichtig für Einsteiger |
|---|---|---|
| Provider-Name | Anbieter oder Verwendungszweck eintragen | Zum Beispiel „Haupt-AI-Provider“ und „Backup Offizieller Key“, nicht einfach 1, 2, 3 |
| Base URL | API-Link aus dem Provider-Backend kopieren | Anhand der Backend-Beispiele prüfen, ob /v1 enthalten sein muss |
| API Key | Vollständigen Key kopieren | Keine Screenshots davon veröffentlichen, nicht den Bemerkungsnamen als Key verwenden |
| Modellname | Modellliste kopieren | Claude Code, Codex und Gemini CLI erfordern möglicherweise unterschiedliche Modellnamen |
| Ziel-Tool | Zu synchronisierende CLI auswählen | Nicht jeder Provider funktioniert mit jedem Tool. Testen Sie bei Fehlern zunächst nur ein einzelnes Tool. |
Separat nach Ziel-CLI überprüfen
| Ziel-Tool | Was sollte zuerst geprüft werden? | Detailseite |
|---|---|---|
| Claude Code | Claude- / Anthropic-Schnittstellenadresse, Key, Claude-Modellname | CC-Switch Claude Code |
| Codex CLI | OpenAI- / Codex-kompatible Adresse, Key, verfügbare Codex-Modellnamen | CC-Switch Codex |
| Gemini CLI | Authentifizierungsmethoden für Google / Gemini oder Vertex | CC-Switch Gemini |
| CC-Switch-CLI | Konfigurationsmethode über die Befehlszeile ohne grafische Oberfläche | CC-Switch-CLI Nutzung |
CC Switch ist der zentrale Verwaltungseinstieg und bedeutet nicht, dass ein Provider wahllos auf alle CLIs angewendet werden kann. Claude, Codex und Gemini nutzen unterschiedliche Schnittstellenprotokolle; testen Sie bei Fehlern zunächst nur ein einzelnes Ziel-Tool.
So testen Sie nach dem Umschalten
Bearbeiten Sie nach dem Umschalten nicht sofort echte Projekte. Senden Sie zunächst in einem leeren Verzeichnis oder Testprojekt eine kurze Testanfrage, um zu bestätigen, dass die Anfrage tatsächlich an den ausgewählten Provider gesendet wird.
Minimaler Testbefehl nach dem Umschalten
claude "Please reply only: Configuration successful" codex "Please reply only: Configuration successful" gemini "Please reply only: Configuration successful"Falls eine CLI weiterhin die alte Konfiguration verwendet, schließen Sie zunächst das aktuelle Terminalfenster und öffnen Sie das Terminal erneut. Ändern Sie nicht gleichzeitig Konfigurationsdateien manuell und denselben Eintrag über CC Switch.