Start / Open Source / cc-switch

cc-switch

Eine plattformübergreifende Desktop-App, die Provider-, MCP-, Prompt- und Skill-Konfiguration für acht KI-Coding-Tools wie Claude Code und Codex vereinheitlicht.

RustMITApplication
⭐ GitHubhttps://github.com/farion1231/cc-switch
126,499
Stars
+0
Star-Wachstum
11. Aug. 2026
Zuletzt aktualisiert
1
Klicks

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

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.