1. Projektübersicht
CC Switch ist eine plattformübergreifende Desktop-Anwendung, die die Verwaltung von Provider-, MCP-, Prompt- und Skill-Konfigurationen für acht gängige KI-Coding-Tools – darunter Claude Code, Claude Desktop und Codex – vereinheitlicht und manuelle, fehleranfällige Bearbeitungen verstreuter Konfigurationsdateien durch eine einzige visuelle Oberfläche ersetzt.
2. Hintergrund & Positionierung
KI-Coding-Assistenten wie Claude Code, Codex und Gemini CLI speichern API-Schlüssel, Modell-Endpunkte und Provider-Einstellungen jeweils in eigenen Konfigurationsdateien und -formaten. Entwickler, die mehrere dieser Tools parallel nutzen oder aus Kosten-, Latenz- oder Verfügbarkeitsgründen zwischen verschiedenen API-Providern wechseln, müssen JSON/TOML-Dateien von Hand bearbeiten und Terminals neu starten, nur um einen Provider zu ändern. CC Switch wurde entwickelt, um diese Reibung zu beseitigen: Es zentralisiert Provider-Voreinstellungen, MCP-Server, Prompts und Skills in einem SQLite-gestützten Speicher und überträgt das jeweilige Format automatisch an jedes Tool.
Im Vergleich zu einfachen Shell-Skript-„Profilwechslern", die nur Umgebungsvariablen oder eine einzelne Konfigurationsdatei austauschen, unterscheidet sich CC Switch dadurch, dass es acht Tools gleichzeitig mit über 50 integrierten Provider-Voreinstellungen abdeckt, eine native GUI mit Schnellwechsel über das System-Tray bietet, eine lokale Proxy-Ebene mit automatischem Failover und Circuit Breaker hinzufügt und eine geräteübergreifende Synchronisierung (Dropbox/OneDrive/iCloud/WebDAV) ermöglicht, sodass eine Provider-Einrichtung dem Entwickler über mehrere Maschinen hinweg folgt.
3. Funktionskategorien
- 🔌 Provider-Verwaltung – Über 50 Voreinstellungen für „8 unterstützte Tools, 50+ Presets"; Import, Drag-and-Drop-Neuanordnung und Ein-Klick-Wechsel von Providern für Claude Code, Codex, Gemini CLI und andere. Zweck: manuelle Bearbeitung der Provider-Konfiguration jedes Tools überflüssig machen.
- 🔄 Einheitliche Konfigurationssynchronisierung – Eine gespeicherte Konfiguration kann gleichzeitig mit Claude Code, Codex und Gemini CLI synchronisiert werden. Zweck: mehrere CLI-Tools konsistent halten und Konfigurationsabweichungen vermeiden.
- 🛡️ Proxy & Failover – Lokaler Proxy mit Anfrageformat-Konvertierung, automatischem Failover, Circuit Breaker und Provider-Health-Checks. Zweck: Coding-Sitzungen auch dann am Laufen halten, wenn ein Provider ausfällt oder langsamer wird.
- 🧩 MCP-/Prompts-/Skills-Verwaltung – Eigene Bereiche für Model-Context-Protocol-Server, Prompt-Bibliotheken und Skills mit anwendungsübergreifender Synchronisierung und Deep-Link-Import. Zweck: Erweiterungen einmal verwalten statt pro Tool.
- 🕘 Sitzungs- und Verlaufsdurchsicht – Konversationsverlauf über unterstützte Sitzungsquellen hinweg durchsuchen, suchen und wiederherstellen. Zweck: Kontinuität beim Wechsel zwischen Tools oder Maschinen bewahren.
- 📊 Nutzungsverfolgung – Dashboard für Ausgaben, Token-Verbrauch und Anfragezahlen mit Trenddiagrammen und detaillierten Protokollen. Zweck: Transparenz über API-Kosten und Nutzungsmuster schaffen.
- ☁️ Cloud-Synchronisierung – Konfigurationssynchronisierung über Dropbox, OneDrive, iCloud oder einen eigenen WebDAV-Server. Zweck: dieselbe Provider-/Tool-Einrichtung auf mehreren Geräten verfügbar halten.
4. Wichtigste Highlights
- Acht Tools, eine Oberfläche – Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw und Hermes werden alle über dieselbe App konfiguriert statt über acht separate Konfigurationsdateien.
- Schnellwechsel über das System-Tray – Provider können über das Tray-Menü gewechselt werden, ohne das vollständige Fenster zu öffnen; Claude Code unterstützt Hot-Switching ohne Neustart.
- Lokaler Proxy mit Failover – Ein integrierter Proxy führt die Formatkonvertierung zwischen Providern durch und wechselt bei einem Providerausfall automatisch mit Circuit-Breaker-Schutz.
- SQLite als zentrale Datenquelle – Provider, MCP-Konfigurationen, Prompts und Skills werden in einer Datenbank (
~/.cc-switch/cc-switch.db) mit atomaren Schreibvorgängen und mutex-geschütztem gleichzeitigem Zugriff gespeichert, wodurch Konfigurationsbeschädigungen vermieden werden. - Automatische Backups – Die App behält die zehn neuesten Datenbank-Backups und bis zu zwanzig Skill-Snapshots vor der Deinstallation, sodass Konfigurationsfehler wiederherstellbar sind.
- Native, codesignierte Builds – Tauri 2 + Rust erzeugen kleine, native Binärdateien; macOS-Builds sind von Apple codesigniert und notarisiert.
5. Anwendungsfälle nach Rolle
- Allgemeine Entwickler – Wer mehr als einen KI-Coding-Assistenten nutzt (z. B. Claude Code plus Codex oder Gemini CLI), kann eine einzige Provider-Liste pflegen und sofort wechseln, statt Konfigurationsdateien pro Tool zu bearbeiten.
- DevOps-/Infrastruktur-orientierte Ingenieure – Die Failover- und Circuit-Breaker-Funktionen des Proxys helfen, KI-gestützte Workflows widerstandsfähig zu halten, wenn ein Provider ausfällt oder Anfragen drosselt.
- Teams, die mehrere LLM-Provider evaluieren – Die über 50 Voreinstellungen und der Ein-Klick-Wechsel erleichtern A/B-Tests von Providern hinsichtlich Kosten, Latenz oder Ausgabequalität, ohne jedes CLI-Tool von Hand neu zu konfigurieren.
- Entwickler, die auf mehreren Maschinen arbeiten – Cloud-Synchronisierung (Dropbox/OneDrive/iCloud/WebDAV) hält Provider- und MCP-Einrichtungen zwischen Laptop und Desktop konsistent.
6. Erste Schritte
Finden, was Sie brauchen – Durchsuchen Sie die integrierten Voreinstellungen und Funktionsbereiche (Provider, MCP, Prompts, Skills, Sitzungen, Nutzung) in der App oder lesen Sie das Benutzerhandbuch im Repository und die README für Funktionsdetails.
Installieren / Integrieren:
# macOS (Homebrew)
brew install --cask cc-switch
# Linux (Arch, über AUR-Helfer)
paru -S cc-switch-bin
Windows-Nutzer und andere Linux-Distributionen können MSI-, portable ZIP-, DEB- oder RPM-Pakete von der Releases-Seite herunterladen.
Mitwirken:
pnpm install
pnpm dev # Entwicklungsmodus mit Hot Reload starten
pnpm typecheck # TypeScript-Validierung
pnpm format:check # Formatierungsprüfung
pnpm test:unit # Frontend-Unit-Tests
cargo fmt && cargo clippy && cargo test # Rust-Backend-Prüfungen
Besprechen Sie Funktionsvorschläge zuerst über GitHub-Issues; Pull Requests müssen vor der Einreichung Typprüfung, Formatierung und Unit-Tests bestehen.
7. Projektstruktur
cc-switch/
├── src/ # React + TypeScript-Frontend (UI, Bereiche, Zustand)
├── src-tauri/ # Rust + Tauri-Backend (IPC-Befehle, Proxy, SQLite-Zugriff)
├── package.json # Frontend-Abhängigkeiten und pnpm-Skripte
└── README.md # Funktionsübersicht und Einrichtungsanleitung
Das Frontend (React 18, Vite, TailwindCSS, shadcn/ui) kommuniziert über IPC mit dem Rust/Tauri-Backend; das Backend verwaltet die SQLite-Datenbank unter ~/.cc-switch/cc-switch.db, die als zentrale Datenquelle für Provider, MCP-Server, Prompts und Skills dient.
8. Verwandtes Ökosystem
CC Switch integriert sich in die KI-Coding-Tools, die es verwaltet, und arbeitet neben ihnen: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw und Hermes sowie das Model-Context-Protocol-Ökosystem (MCP) für externe Tool-Server. Es basiert auf dem Tauri-Framework für native Desktop-Paketierung und auf Cloud-Speicheranbietern (Dropbox, OneDrive, iCloud, WebDAV) für die geräteübergreifende Synchronisierung.
9. Lizenz
- ✅ Nutzung, Modifikation und Verbreitung der Software kommerziell oder privat (MIT-Lizenz)
- ✅ Einbindung in proprietäre Projekte, ohne den eigenen Code quelloffen machen zu müssen
- ❌ Die Autoren haften nicht für Schäden, die aus der Nutzung der Software entstehen
- ℹ️ Der ursprüngliche Copyright-Hinweis und der Lizenztext müssen in Kopien oder wesentlichen Teilen der Software erhalten bleiben
10. FAQ
F: Welche KI-Coding-Tools unterstützt CC Switch?
A: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw und Hermes.
F: Muss ich mein Terminal nach dem Wechsel des Providers neu starten?
A: Die meisten Tools erfordern einen Neustart der CLI, um die neue Konfiguration zu übernehmen, aber Claude Code unterstützt Hot-Switching ohne Neustart.
F: Wo werden meine Konfigurationsdaten gespeichert?
A: In einer lokalen SQLite-Datenbank und JSON-Einstellungsdateien unter ~/.cc-switch/ mit automatischer Backup-Rotation.
F: Kann ich weiterhin meinen offiziellen Claude-/Codex-Login anstelle eines Drittanbieter-Providers verwenden?
A: Ja – fügen Sie die Voreinstellung „Offizieller Login" hinzu, um zur Standard-Authentifizierung des Tools zurückzukehren.
F: Wie installiere ich CC Switch unter Windows oder Linux-Distributionen ohne Paketmanager?
A: Laden Sie das MSI-, portable ZIP-, DEB-, RPM- oder AppImage-Build von der Releases-Seite herunter.
11. Schnellzugriff
- Repository: https://github.com/farion1231/cc-switch
- Offizielle Website: https://ccswitch.io
- Releases: https://github.com/farion1231/cc-switch/releases
- Issues (Fehlerberichte & Funktionsdiskussion): https://github.com/farion1231/cc-switch/issues
12. Zusammenfassung
CC Switch löst ein echtes Problem für Entwickler, die mehrere KI-Coding-Assistenten gleichzeitig nutzen: Statt Konfigurationsdateien über acht verschiedene Tools hinweg von Hand zu bearbeiten, bietet es eine native, plattformübergreifende Oberfläche für Provider, MCP-Server, Prompts, Skills und Nutzungsverfolgung, unterstützt durch einen robusten lokalen Proxy und geräteübergreifende Synchronisierung. Es ist besonders wertvoll für Entwickler und Teams, die regelmäßig zwischen KI-Providern wechseln oder mehr als einen Coding-Assistenten verwenden und eine zuverlässige, gesicherte und überall konsistente Einrichtung wünschen.