CC Switch Ein-Klick-API-Umschaltung

Da KI-Coding-Tools wie Claude Code, OpenAI Codex und Gemini CLI immer beliebter werden, müssen Entwickler häufig zwischen mehreren API-Anbietern wechseln — offizielle APIs, inländische Mirrors, Drittanbieter-Proxys... Das manuelle Bearbeiten der Konfigurationsdateien ist jedes Mal sowohl mühsam als auch fehleranfällig.

CC Switch ist ein Desktop-Tool, das genau dieses Problem löst. Es bietet eine einheitliche grafische Oberfläche, mit der Sie:

Funktionen Beschreibung
🔄 Anbieterwechsel mit einem Klick Mehrere API-Konfigurationen speichern und mit einem einzigen Klick wechseln — kein manuelles Bearbeiten von JSON mehr nötig
🖥️ Einheitliche Verwaltung für mehrere Anwendungen Verwalten Sie fünf Tools gleichzeitig: Claude Code, Codex, Gemini CLI, OpenCode und OpenClaw
🛡️ Lokaler API-Proxy Integrierter Hochleistungs-HTTP-Proxy mit automatischem Failover und Request-Monitoring
🔌 MCP-Server-Verwaltung MCP-Server-Konfigurationen visuell hinzufügen, bearbeiten und synchronisieren
📊 Nutzungsstatistiken Token-Verbrauch und API-Kosten in Echtzeit anzeigen
💾 Backup und Wiederherstellung Konfigurationen automatisch sichern, um Datenverlust durch versehentliche Aktionen zu verhindern

Unterstützte Anwendungen

  • 🤖 Claude Code（Anthropic）
  • ⚡ Codex（OpenAI）
  • ✨ Gemini CLI（Google）
  • 🧩 OpenCode(Open Source)
  • 🦅 OpenClaw(fünfte Anwendung, neu in v3.11.0)

Installation

Gehen Sie zuGitHub Releases: https://github.com/farion1231/cc-switch/releases/latestLaden Sie den Installer für Ihre Plattform herunter.

Scrollen Sie ganz nach unten auf der Seite, zum Abschnitt Ressourcenpaket, und laden Sie den Installer für Ihre Plattform herunter:

Systemanforderungen

System Mindestversion Architektur
Windows Windows 10 und höher x64
macOS macOS 10.15 (Catalina) und höher Intel (x64) / Apple Silicon (arm64)
Linux Siehe Tabelle unten x64 / arm64

Windows

Datei Beschreibung
CC-Switch-vX.X.X-Windows.msi ✅ Empfohlen— MSI-Installer, unterstützt automatische Updates
CC-Switch-vX.X.X-Windows-Portable.zip Portable Version, entpacken und ausführen, schreibt nicht in die Registry

Doppelklicken Sie auf die MSI-Datei und folgen Sie dem Assistenten, um die Installation abzuschließen. Suchen Sie dann im Startmenü nach "CC Switch", um es zu starten.

⚠️ Die Funktion "One-Click-Installation" ist in der Windows-Version deaktiviert, um Nebenwirkungen von Protokollhandlern zu vermeiden. Wenn Sie Tools wie Claude Code installieren müssen, installieren Sie sie bitte manuell und verwalten Sie sie anschließend über CC Switch.

macOS

Methode 1: Direkter Download (Empfohlen)

  1. HerunterladenCC-Switch-vX.X.X-macOS.zip
  2. Nach dem Entpacken ziehen SieCC Switch.appin den Ordner "Programme"
  3. Beim ersten Start Rechtsklick → Öffnen, oder gehen Sie zu "Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen"

⚠️ Da der Autor kein Apple-Entwicklerkonto hat, zeigt macOS möglicherweise eine Warnung über einen "nicht identifizierten Entwickler" an. Nachdem Sie die Aufforderung geschlossen haben, gehen Sie zu "Systemeinstellungen → Datenschutz & Sicherheit" und klicken Sie auf "Trotzdem öffnen". Danach startet es jedes Mal normal.

Methode 2: Homebrew

# 添加 tap 并安装
brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch

Linux

Wählen Sie das entsprechende Format basierend auf Ihrer Distribution:

Distribution Empfohlenes Format Installationsbefehl
Ubuntu / Debian / Mint .deb sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / Rocky .rpm sudo dnf install ./CC-Switch-*.rpm
openSUSE .rpm sudo zypper install ./CC-Switch-*.rpm
Arch / Manjaro / Andere .AppImage Siehe unten

AppImage-Verwendung:

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

Schnellstart

Führen Sie nach der Installation die Ersteinrichtung durch, indem Sie diese Schritte befolgen:

Schritt 1: CC Switch starten

Beim ersten Start erkennt CC Switch automatisch installierte CLI-Tools und versucht, bestehende Konfigurationen zu importieren. Das CC Switch-Symbol wird im System-Tray angezeigt.

Schritt 2: Zu verwaltende Anwendung auswählen

Der obere Bereich der Hauptoberfläche ist die Anwendungs-Umschaltleiste. Klicken Sie auf das entsprechende Symbol (Claude Code / Codex / Gemini CLI usw.), um die aktuell verwaltete Anwendung zu wechseln. Sie können nicht benötigte Anwendungen in den Einstellungen ausblenden.

Schritt 3: Ersten Anbieter hinzufügen

Klicken Sie auf die Schaltfläche in der oberen rechten Ecke+und wählen Sie aus den integrierten Voreinstellungen (wie offizielle Anthropic API, DeepSeek, Alibaba Bailian usw.) oder füllen Sie die folgenden Informationen manuell aus:

  • Name: Ein Bemerkungsname zur leichteren Identifizierung
  • API-Schlüssel: Der vom Dienstanbieter bereitgestellte API-Schlüssel
  • Base URL(Optional): Benutzerdefinierte Proxy-Adresse
  • Modell: Geben Sie den standardmäßig zu verwendenden Modellnamen an
  • API-Format: Natives Anthropic Messages-Format oder kompatibles OpenAI Chat Completions-Format

Schritt 4: Provider wechseln

Klicken Sie in der Liste auf den Ziel-Provider und dann auf "Aktivieren". CC Switch schreibt die Konfiguration automatisch in die Konfigurationsdatei des entsprechenden CLI-Tools:

Führen Sie denclaudeBefehl direkt im Terminal aus, und die neue Konfiguration wird verwendet.

Schritt 5: Konfiguration überprüfen (Optional)

Klicken Sie auf die Schaltfläche "Health Check" neben dem Provider, um eine Testanfrage zu senden und den API-Schlüssel sowie die Netzwerkkonnektivität zu überprüfen.

💡 Drücken SieCmd/Ctrl + ,, um die Einstellungen schnell zu öffnen; drücken SieESC, um das aktuelle Panel zu schließen.

Erweiterte Funktionen

MCP-Server-Verwaltung

Im „MCP“-Panel können MCP-Server (Model Context Protocol) visuell hinzugefügt, bearbeitet und gelöscht werden. Konfigurationen werden automatisch mit den entsprechenden CLI-Tools synchronisiert; der Ein-Klick-Import vorhandener MCP-Konfigurationen aus installierten Anwendungen wird unterstützt.

Skills-Verwaltung

Skills sind eine Prompt-Verbesserungsfunktion von Claude Code. CC Switch unterstützt:

  • Installation von Skills aus GitHub-Repositories (integrierte voreingestellte Repositories wie z. B.baoyu-skillsusw.)
  • Installation aus lokalen ZIP-Dateien
  • Verwaltung von Skills für Claude Code und Codex

Sitzungsmanager

Auf der Seite „Sessions“ können Sie die historischen Gesprächsverläufe aller fünf Anwendungen durchsuchen. Sie unterstützt die Verzeichnisnavigation und die Suche innerhalb der Sitzung und filtert die Anzeige automatisch basierend auf der aktuellen Anwendung.

Backup-Verwaltung

CC Switch sichert die Datenbank regelmäßig automatisch und auch vor einer Datenbankmigration. Unter „Einstellungen → Backup-Verwaltung“ können Sie: alle Backups anzeigen, umbenennen, löschen und manuell Backups erstellen.

Nutzungsstatistiken und Abrechnung

Die Seite "Nutzung" zeigt Token-Verbrauchsstatistiken, unterstützt automatische Aktualisierung, Analyse der Cache-Trefferrate und die Anzeige der Kosten nach Modell und Provider, damit Sie Ihre API-Ausgaben unter Kontrolle behalten.

Claude Rectifier (Thinking-Signatur-Korrektur)

Bei der Verwendung bestimmter Drittanbieter-API-Gateways kann das Thinking-Block-Format von Claude inkompatibel sein. Nach Aktivierung des Rectifiers korrigiert die Proxy-Schicht dieses Problem automatisch. Sie können ihn unter "Einstellungen → Erweitert" umschalten.

WebDAV-Autosynchronisierung

Unterstützt die Synchronisierung der Datenbank mit einem WebDAV-Dienst (z. B. Nutstore), wodurch die Konfigurationsfreigabe über mehrere Geräte hinweg ermöglicht wird. Ein integrierter Schutzmechanismus für große Dateien verhindert versehentliche Uploads.

Andere Erweiterungen