CC Switch: Ein lokales Kontrollzentrum für Code-Agenten-Konfigurationen

Alles, was Sie über farion1231/cc-switch wissen müssen: Eine plattformübergreifende Desktop-Anwendung, die Anbieter, Konfigurationen, MCPs, Anweisungen und Sitzungen verschiedener Agenten-Tools zentralisiert.

Was ist CC Switch?

CC Switch ist eine Open-Source-Desktop-Anwendung für Windows, macOS und Linux. Das ursprüngliche Problem, das es lösen soll, ist folgendes: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw und Hermes Agent verwenden unterschiedliche Konfigurationsformate. Das Wechseln zwischen Anbietern erfordert in der Regel die manuelle Bearbeitung von JSON-, TOML- oder .env-Dateien.

Verstreute JSON-, TOML- und .env-Konfigurationsdateien mit Fehlersymbolen werden von einem einzigen Panel aufgesogen, das sie in einem einzigen Ablauf synchronisiert

Das Projekt bietet eine einheitliche Oberfläche zum Importieren und Aktivieren von Anbietern, mit über 50 voreingestellten Konfigurationen. Es zentralisiert auch die Verwaltung von MCP-Servern, Markdown-Anweisungen, Fähigkeiten, Sitzungsprotokollen, Nutzung und Kosten. Das Ziel ist nicht, die Clients der einzelnen Anbieter zu ersetzen: Stattdessen werden deren Konfigurationen gelesen und synchronisiert, sodass der Benutzer weiterhin die gewohnten Oberflächen verwenden kann.

Fenster einer Desktop-Anwendung mit einem Raster aus über 50 Voreinstellungskarten für KI-Anbieter, wobei eine Karte vom Cursor hervorgehoben wird

Der Ursprung: Von einem Schalter für Claude Code zu einer Multi-Agenten-Konsole

Das Repository wurde laut GitHub API am 4. August 2025 erstellt. Der Hauptautor ist Jason Young (farion1231): Sein GitHub-Profil beschreibt ihn als Full-Stack-Entwickler mit Interesse an KI und Tools für Entwickler; die README-Datei weist Jason Young die MIT-Lizenz zu.

Der Name selbst und der ursprüngliche Beitrag, der in Hacker News gefunden wurde, beschreiben die anfängliche Ausrichtung des Produkts: Am 9. November 2025 veröffentlichte amrrs den Thread 45861477, der es als Anbieter-Schalter für Claude Code und Codex vorstellte. Die aktuelle Version zeigt die spätere Erweiterung: Es wechselt nicht nur zwischen den Anbietern von Claude Code und Codex, sondern verwaltet acht Familien von Tools und fügt einen lokalen Proxy, MCP-Verwaltung sowie Anweisungen, Fähigkeiten und Sitzungen hinzu.

Dunkles holografisches Panel verwaltet MCP-Server, Import über einen ccswitch://-Link und Pfeile bidirektionaler Synchronisierung zwischen Symbolen verschiedener KI-Clients

Es wurde kein Veröffentlichungspost des Autors gefunden, der eine Anekdote oder einen Konflikt mit einer bestimmten nativen Funktion erläutert. Daher wird die dokumentierte Spannung auf folgende Weise formuliert: Die verschiedenen Clients behalten ihre eigenen Dateien und Neustartzyklen bei, während CC Switch eine lokale Ebene bietet, die Konfigurationen übersetzt, speichert und anwendet; für die meisten Tools empfiehlt die README-Datei, nach der Änderung das Terminal oder den Client neu zu starten.

Philosophie und Prinzipien

Die Dokumentation legt mehrere Betriebsprinzipien dar:

Minimale Intervention: Es wird immer eine aktive Konfiguration beibehalten, um zu verhindern, dass der Befehlszeilenclient unbrauchbar wird, wenn Anbieter gelöscht werden.
Einheitliche lokale Datenquelle: Die synchronisierbaren Daten werden in SQLite unter ~/.cc-switch/cc-switch.db gespeichert; die Gerätepräferenzen werden separat in JSON gespeichert.
Sichere Schreibvorgänge: Es wird das Muster “temporäre Datei, dann atomares Umbenennen” verwendet, um das Risiko von Konfigurationsbeschädigungen zu verringern, zusammen mit rotierenden Backups.
Bidirektionale Synchronisierung: Beim Aktivieren eines Anbieters werden die verwendeten Dateien geschrieben und beim Bearbeiten des aktiven Anbieters werden Änderungen übernommen, die an diesen vorgenommen wurden.
Menschliche Verantwortung gegenüber KI-gestütztem Code: Die Beitragsrichtlinie akzeptiert KI-gestützte Beiträge, verlangt aber, dass der Einreicher den Code versteht und testet; sie warnt davor, dass ungeprüfte Änderungen abgelehnt werden können.

Kern einer leuchtenden SQLite-Datenbank im Zentrum eines Serverraums, umgeben von bidirektionalen Datenströmen und rotierenden Backups, die ihn umkreisen

Dies sind Produktentscheidungen, die im Repository selbst beschrieben werden, nicht eine unabhängige Sicherheits-, Verfügbarkeits- oder Kompatibilitätsprüfung der konfigurierten Anbieter.

Funktionsweise

Die Anwendung besteht aus einer React- und TypeScript-Oberfläche sowie einem Tauri 2-Backend mit Rust. Die README-Datei trennt Befehle, Dienste, Datenzugriff und die SQLite-Datenbank; sie identifiziert Dienste für Anbieter, MCPs, Proxys, Sitzungen, Konfigurationen und Latenztests.

Der dokumentierte tägliche Ablauf ist:

Auf Anbieter hinzufügen klicken, eine voreingestellte Konfiguration auswählen oder eine benutzerdefinierte Konfiguration erstellen.
Diese über die Oberfläche oder das Systemtray aktivieren.
Das entsprechende Terminal oder den Client neu starten, damit die Änderungen übernommen werden; die README-Datei macht Claude Code zu einer Ausnahme, da es eine dynamische Änderung der Anbieterdaten ermöglicht.
Um zum offiziellen Zugriff zurückzukehren, eine offizielle Login-Voreinstellung aktivieren und den Authentifizierungsablauf des Clients durchführen.

Der lokale Proxy-Modus fügt Formatkonvertierung, Hot-Swapping, Zustandsprüfung, Schutzschalter und Failover hinzu. Für MCPs gibt es ein vereinheitlichtes Dashboard, Import über einen ccswitch://-Link und bidirektionale Synchronisierung zwischen den dokumentierten Tools. Für Anweisungen werden Dateien wie CLAUDE.md, AGENTS.md und GEMINI.md synchronisiert; für Fähigkeiten können diese von GitHub-Repositories oder ZIP-Dateien über symbolische Links oder Kopien installiert werden.

Ein Knoten des lokalen Proxys leitet leuchtende Datenpakete zwischen Anbietern weiter, mit einem blinkenden Schutzschalter und konzentrischen Ringen der Zustandsprüfung

Die lokale Speicherung umfasst die Datenbank, Einstellungen, Backups und Fähigkeitsverzeichnisse unter ~/.cc-switch/. Die Dokumentation erwähnt auch die Synchronisierung über Dropbox, OneDrive, iCloud oder WebDAV. Zu den veröffentlichten Entwicklungsbefehlen gehören pnpm dev, pnpm typecheck, pnpm test:unit, pnpm build, cargo clippy und cargo test.

Ausgeklapptes Systemtray mit einer Liste von KI-Anbietern und einem aktiven Schalter in Cyan, neben einem Terminal, das Build-Befehle in Rust und TypeScript ausführt

Offizieller und semioffizieller Status

Es gibt keine nachweisbaren Belege dafür, dass die Anbieter der verwalteten Tools CC Switch als offizielles Tool übernommen, es in einen offiziellen Marktplatz integriert oder seinen Proxy und seine Voreinstellungen zertifiziert haben. Das Repository identifiziert sich ausdrücklich als MIT-Software und deklariert ccswitch.io als einzige offizielle Website; daher sollte es als unabhängiges Projekt betrachtet werden.

Es gibt eine erkennbare, aber von einer Anbietergenehmigung abweichende Vertriebsmethode: Die README-Datei veröffentlicht brew install --cask cc-switch für macOS und paru -S cc-switch-bin für Arch Linux. Dies bestätigt die vom Projekt gepflegten Installationsanweisungen, nicht eine Garantie für Kompatibilität, Qualität von Drittanbieterpfaden oder Unterstützung durch die Modellhersteller.

Das Ökosystem

Repositories des Autors

Die Liste der gefundenen öffentlichen Repositories für farion1231 zeigt verwandte Projekte, obwohl nicht alle notwendigerweise Abhängigkeiten von CC Switch sind:

farion1231/cc-switch-website: Website des Projekts; 14 Sterne.
farion1231/homebrew-ccswitch: Homebrew Tap für CC Switch; 53 Sterne.
farion1231/claude-code-mux: Routing-Proxy in Rust mit Failover und Prioritäten; 4 Sterne.
farion1231/CLIProxyAPI: Wrappt verschiedene CLI-Clients als API-kompatiblen Dienst für OpenAI, Gemini, Claude und Codex; 4 Sterne.
farion1231/code-switch: Proxy- und Verwaltungs-Tool für Claude Code und Codex; 3 Sterne.
farion1231/claude-code-router: Repository, das vorschlägt, Claude Code als Grundlage für eine Code-Infrastruktur zu verwenden; 2 Sterne.

Die GitHub-Beschreibungen ermöglichen es, diese um die Verwaltung und das Routing von Modellen herum einzuordnen, aber sie beweisen nicht, dass sie zusammen installiert werden oder einen gemeinsamen Support- oder Versionszyklus haben.

Community-Forks, Ports und Erweiterungen

Die in dieser Recherche durchgeführte GitHub-Suche zeigt Forks und Ableitungen in anderen Sprachen, insbesondere Chinesisch:

BigStrongSun/ccswitchmulti, 239 Sterne: Schlägt ein multimodales Routing für Codex vor, einschließlich OpenAI-Abonnement, DeepSeek, Qwen, lokale Modelle und OpenAI-kompatible Endpunkte.
Zhang161215/cc-switch, 93 Sterne: Desktop-Anwendung zum Verwalten und Wechseln von Konfigurationen für Claude Code und Codex.
kongkongyo/cc-switch, 82 Sterne: Fork oder Ableitung für den Desktop, für Claude Code, Codex, OpenCode und Gemini CLI.
Radiant303/cc-switch-kimicode, 13 Sterne: Wird als Variante mit erweitertem Support für Kimi Code dargestellt.
piaomiaoguying/cc-switch, 10 Sterne: Archivierter, verbesserter Zweig, dessen Text empfiehlt, die spätere offizielle Version zu verwenden.
jianhongyu136/claude-cli-switch, 3 Sterne: CLI-Client auf der Grundlage von CC Switch zum Ausführen von Claude, Codex, Gemini und OpenCode mit isolierten Anbieterumgebungen, ohne globale Konfigurationen zu ändern.

Diese Zahlen stammen aus der GitHub-Repository-Suche vom 1. August 2026. Ein Fork, die Wiederverwendung des Namens oder die Angabe, dass es auf CC Switch basiert, bedeutet nicht, dass Jason Young eine Zugehörigkeit bestätigt, eine Sicherheitsprüfung durchführt oder Unterstützung leistet.

Leuchtender Kern mit der Aufschrift CC Switch, verbunden durch neuronale Pfade mit Satellitenknoten, die Community-Forks darstellen, mit chinesischen Schriftzeichen und Fragmenten einer Weltkarte im Hintergrund

Repository-Zahlen

Messung: 1. August 2026, API und GitHub-Seite.

Metrik	Wert
Sterne	123.204
Forks	8.332
Echte Follower	220
Commits	2.232
Offene Issues, die von der API gemeldet werden	2.086
Hauptsprache	Rust
Andere relevante Sprachen nach Byte-Anzahl	TypeScript, HTML, JavaScript und CSS
Lizenz	MIT
Erstellung	4. August 2025
Letztes Update der Metadaten	1. August 2026
Neueste Version	`v3.19.1`, veröffentlicht am 31. Juli 2026

Die von der API zurückgegebenen Hauptbeitragenden waren farion1231 mit 1.835 Beiträgen, yovinchen mit 81, makoMakoGo mit 15, TinsFox mit 12 und dependabot[bot] mit 9. Die Gesamtzahl von 2.232 Commits wurde aus dem letzten Paginierungslink der Commit-API abgerufen. open_issues_count kann Pull-Requests umfassen, daher stellt es nicht nur Issues dar. Die API wiederholt die Anzahl der Sterne in watchers_count; daher wird subscribers_count als Anzahl der echten Follower angegeben.

Wie man beiträgt

Die Beitragsrichtlinie fordert auf, zuerst ein Issue zu öffnen, um neue Funktionen zu besprechen, von main aus zu forken und einen fokussierten Zweig zu erstellen, z. B. feat/my-feature oder fix/issue-123. Jeder Pull Request sollte eine einzelne Funktion oder Korrektur behandeln und die entsprechende Vorlage ausfüllen.

Vor dem Absenden sind mindestens pnpm typecheck, pnpm format:check und pnpm test:unit erforderlich; wenn Rust geändert wird, auch cargo fmt --check, cargo clippy und cargo test. Das Projekt verwendet Conventional Commits und fordert bei sichtbaren Änderungen für den Benutzer auf, die drei englischen Lokalisierungsdateien zu aktualisieren.

Wie die Community es aufgenommen hat

Die gefundenen Belege zeigen eine sichtbare Akzeptanz sowie operative und Kompatibilitäts-Issues; sie ermöglichen keine Schlussfolgerung über einen allgemeinen Konsens:

Der Hacker News-Thread 45861477, der von amrrs am 9. November 2025 veröffentlicht wurde, nannte das Projekt als Anbieter-Schalter für Claude Code und Codex. Bei der Abfrage hatte er 3 Punkte und 0 Kommentare. Es handelt sich um eine direkte Referenz, aber ihr Volumen erlaubt keine Rückschlüsse auf eine breite Akzeptanz.
In dem Thread 46255285 schrieb der Benutzer radio879, dass er CC Switch verwendet, um Modelle in Claude Code zu wechseln, und berichtete von guten Erfahrungen mit einem anderen, günstigeren Modell. Es handelt sich um eine einzelne Nutzerempfehlung, nicht um einen Vergleichstest oder eine Validierung des Proxys.
Die Issue-Seite auf GitHub zeigt reale Anforderungen im großen Maßstab: Das Issue #404, das von zlyuan99 geöffnet wurde, sammelte 70 Kommentare darüber, dass Claude nach der Konfiguration von settings.json immer noch eine Anmeldung anfordert; das Issue #4420 von Zayia hatte 27 Kommentare darüber, dass Codex Desktop keine benutzerdefinierte Liste von Modellen anzeigt. Dies sind konkrete Kompatibilitäts- und Konfigurationsprobleme, nicht nur abstrakte Meinungen.
Auf derselben Seite eröffnete makoMakoGo das Issue #2337 mit 32 Kommentaren, um auf eine DeepSeek-Kontextanpassung im lokalen Routing-Modus hinzuweisen. Die Aktivität bestätigt, dass der Proxy und die Konfigurationsübersetzung einen kontinuierlichen operativen Support benötigen.
Die Notizen von v3.19.0 erkennen und beheben bestimmte Sicherheitsprobleme: Ein Schlüssel-Leak in einer universellen Gemini-Konfiguration und ein Bestätigungsfenster, das möglicherweise nicht den zu importierenden MCP-Befehl anzeigt. Das Projekt empfiehlt, die Schlüssel zu rotieren und unbekannte Importlinks zu überprüfen, wenn diese verwendet wurden. Dies ist eine technische Kritik vom Maintainer und ein Grund für ein Update und eine Überprüfung der Konfigurationen, bevor man sich auf Automatisierungen verlässt.

CC Switch im Vergleich zu anderen Vorschlägen

Vorschlag	Verifizierbare Übereinstimmung	Verifizierbarer Unterschied
`BigStrongSun/ccswitchmulti`	Routet oder integriert mehrere Modelle für die Verwendung mit Codex.	Die Beschreibung konzentriert sich auf Codex und kombiniert Abonnement, DeepSeek, Qwen und lokale Modelle; CC Switch dokumentiert eine Desktop-Anwendung, die acht Familien von Tools sowie MCPs, Anweisungen und Fähigkeiten verwaltet.
`jianhongyu136/claude-cli-switch`	Wechselt Anbieter für Claude, Codex, Gemini und OpenCode und basiert auf CC Switch.	Es handelt sich um einen CLI-Client mit isolierten Sitzungen und ohne Änderung der globalen Konfiguration; CC Switch verwendet eine Desktop-Oberfläche und verwaltet eine SQLite-Datenbank mit Synchronisierung zu Client-Dateien.
`Zhang161215/cc-switch`	Verwaltet und wechselt Konfigurationen für Claude Code und Codex auf dem Desktop.	Die gefundene Quelle bestätigt nur diesen Umfang von zwei Tools; die README-Datei von `farion1231/cc-switch` dokumentiert zusätzlichen Support für Claude Desktop, Gemini CLI, Grok Build, OpenCode, OpenClaw und Hermes Agent.

Der Vergleich basiert auf den in GitHub gefundenen Beschreibungen. Es wurden keine Leistungstests, Datenschutzprüfungen oder Protokolltreue-Tests durchgeführt, daher werden die Alternativen nicht nach Qualität geordnet.

Anwendungsfälle und für wen dieses Repository nützlich sein kann

Personen, die zwischen Claude Code, Codex, Gemini CLI, OpenCode oder anderen unterstützten Clients wechseln, können Anbieter-Voreinstellungen erstellen und diese über eine einzige Oberfläche aktivieren, ohne JSON-, TOML- oder .env-Dateien jedes Tools manuell zu bearbeiten. Nach der Änderung ist der dokumentierte Ablauf das Neustarten des entsprechenden Terminals oder Clients, mit Ausnahme der für Claude Code angegebenen Ausnahme.
Teams, die eine lokale Konfiguration von Agenten gemeinsam nutzen, können Anbieter, MCP-Server, Anweisungen, Fähigkeiten, Sitzungen, Nutzung und Kosten in der SQLite-Datenbank unter ~/.cc-switch/ zentralisieren und diese Daten über Dropbox, OneDrive, iCloud oder WebDAV synchronisieren. Die atomare Schreibweise und die rotierenden Backups sind nützlich, wenn Änderungen an mehreren Client-Dateien vorgenommen werden.
Benutzer, die projektbezogene Anweisungen pflegen, können CLAUDE.md, AGENTS.md und GEMINI.md synchronisieren und Fähigkeiten von GitHub-Repositories oder ZIP-Dateien über symbolische Links oder Kopien installieren. Sie können auch den lokalen Proxy verwenden, wenn sie eine Formatkonvertierung, Zustandsprüfung oder Failover zwischen Anbietern benötigen.

Das Projekt koordiniert lokale Konfigurationen, ersetzt aber nicht die Verwaltung von Geheimnissen und validiert nicht die Endpunkte, ccswitch://-Links oder Fähigkeitspakete, die importiert werden. Die Sicherheitskorrekturen von v3.19.0 machen es notwendig, die Schlüssel und die Herkunft jedes Imports zu überprüfen.

Ressourcen

Repository: https://github.com/farion1231/cc-switch
Dokumentation und Installation: https://github.com/farion1231/cc-switch#quick-start
Benutzerhandbuch: https://github.com/farion1231/cc-switch/tree/main/docs/user-manual/en
Beitragsleitfaden: https://github.com/farion1231/cc-switch/blob/main/CONTRIBUTING.md
Versionen und Überprüfungen: https://github.com/farion1231/cc-switch/releases
Offizielle Website: https://ccswitch.io
Community und Issues: https://github.com/farion1231/cc-switch/discussions, https://github.com/farion1231/cc-switch/issues
Gespräche: https://news.ycombinator.com/item?id=45861477, https://news.ycombinator.com/item?id=46255285

Hinweis: Dieser Artikel kombiniert das README, den Beitragsleitfaden, die Versionshinweise, die Issue-Seite, die Projektwebsite, die GitHub-API und Ergebnisse von Hacker News, abgerufen am 1. August 2026. Die Zahlen ändern sich mit der Zeit.