CC Switch CLI: Installation und Wechsel auf dem Server
CC Switch CLI ist eine von der Community gepflegte Kommandozeilen-Version und kein offizielles CC-Switch-Produkt: Im offiziellen README steht, dass CC Switch selbst ausschließlich als Desktop-App mit grafischer Oberfläche erscheint; für Server, SSH-Sitzungen und Rechner ohne Desktop wird diese CLI empfohlen. Sie ist ein CLI-Fork von CC Switch, den ein anderer Autor eigenständig veröffentlicht. Installation, Umschalten und das gemeinsame Datenverzeichnis folgen dem README des CLI-Projekts, die Felder für QCode der QCode-Dokumentation.
Aktualisiert 2026-10-20
Richten Sie dieses Tool auf den QCode-Endpunkt — ein Key für Claude, GPT und chinesische Modelle.
- Bezahlung pro Token — aktuelle Preise unter /models
- Zahlung per Karte (Visa / Mastercard / AMEX), Apple Pay, Google Pay oder Krypto
- Selbstbedienung: aufladen und sofort aktivieren
Was es ist, Installation, Umschalten, Datenverzeichnis, QCode-Felder
kein offizielles CC-Switch-Produkt
Es ist ein CLI-Fork von CC Switch, den ein anderer Autor eigenständig veröffentlicht; ein offizielles CC-Switch-Produkt ist es nicht. Für Server, SSH-Sitzungen und Rechner ohne Desktop empfiehlt es das offizielle README.
zwei Installationswege
Das README des Projekts nennt als schnelle Installation curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash, die das Programm nach ~/.local/bin legt; zusätzlich ist die Variante brew install cc-switch-cli über Homebrew beschrieben.
Auflisten und umschalten
Das README des Projekts nennt den Grundgebrauch: cc-switch öffnet die Vollbild-Terminalansicht; cc-switch provider list zeigt die gespeicherten Einträge; cc-switch provider switch (id) schaltet um; cc-switch use (id) ist die Kurzform dazu; cc-switch --app codex provider list wählt das Werkzeug über --app, voreingestellt ist claude.
mit der Desktop-App gemeinsames Datenverzeichnis
Die QCode-Dokumentation schreibt, dass diese CLI standardmäßig das Datenverzeichnis ~/.cc-switch mit der Desktop-App teilt; die von ihr unterstützte Datenbankversion liegt manchmal hinter der Desktop-App zurück — wenn die Datenbankversion zu neu ist, aktualisiert man die CLI oder wartet auf ein Update.
Wann die Kommandozeilen-Version sinnvoll ist
Auf Servern, in SSH-Sitzungen und in Containern ohne Desktop lässt sich die Desktop-App nicht nutzen; hier kommt die Kommandozeilen-Version infrage. Im README des Projekts selbst heißt es, es gebe eine Vollbild-Terminalansicht und eine in Skripte einbindbare Kommandozeile.
Offizielle Empfehlung und aktuelle Version
Im FAQ des offiziellen CC-Switch-README wird auf die Frage nach einer Kommandozeilen- oder Headless-Version das von der Community gepflegte CC Switch CLI empfohlen. Das aktuelle Release dieses CLI-Projekts ist v5.11.2, veröffentlicht am 16.10.2026.
Zeitleiste
Release der Desktop-Version CC Switch v4.0.12; die QCode-Dokumentationsseite vermerkt, dass die Abschnitte zu Download und Kommandozeile am 2026-10-15 mit README und Releases abgeglichen wurden.
Das Aktualisierungsdatum der QCode-Dokumentationsseite zu CC Switch: Dort steht, dass es keine offizielle Kommandozeilenversion gibt, für Server und SSH die Community-CLI empfohlen wird und das Verzeichnis ~/.cc-switch standardmäßig gemeinsam genutzt wird.
Das Community-CLI-Projekt hat v5.11.2 veröffentlicht; die Release-Seite nennt Tag v5.11.2 und den Veröffentlichungszeitstempel 2026-10-16T13:51:51Z. Auf der QCode-Dokumentationsseite war bei der Prüfung am 2026-10-15 die Version v5.11.1 vermerkt.
Was belegt ist — und was nicht
Mit Quelle belegt
① Im offiziellen README steht, dass CC Switch nur als Desktop-App mit grafischer Oberfläche veröffentlicht wird. ② Für Server, SSH-Sitzungen und Rechner ohne Desktop wird die von der Community gepflegte CC Switch CLI empfohlen; laut README des CLI-Projekts und QCode-Dokumentation ist sie ein CLI-Fork von CC Switch, den ein anderer Autor eigenständig veröffentlicht und der kein offizielles CC-Switch-Produkt ist. ③ Das README des Projekts nennt zwei Installationswege: Installationsskript und Homebrew. ④ Der Grundgebrauch umfasst den Start der Vollbild-Terminalansicht, das Auflisten, das Umschalten, die Kurzform des Umschaltens, die Werkzeugauswahl über --app und den Start einer Sitzung mit einem vorgegebenen Eintrag. ⑤ Standardmäßig wird das Verzeichnis ~/.cc-switch mit der Desktop-App geteilt, die Kerndaten liegen in ~/.cc-switch/cc-switch.db, und CC_SWITCH_CONFIG_DIR verlegt das Verzeichnis. ⑥ Die Felder für QCode folgen der QCode-Dokumentation: für Claude ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN, für Codex Base URL und API Key.
Was weder die offizielle Doku noch das Projekt hergibt
① Eine offizielle Gegenüberstellung der Funktionen von Kommandozeilen-Version und Desktop-App gibt es nicht, und die QCode-Dokumentation hält fest, dass die Community-CLI nicht Funktion für Funktion getestet wurde. ② Im README des Projekts steht nichts dazu, wie die Datenbankversion der CLI mit der der Desktop-App zusammenhängt. ③ Auf keiner der beiden Seiten steht, unter welchen genauen Bedingungen die Meldung „database version is too new“ erscheint. ④ Ebenfalls nirgends steht, welche Abhängigkeiten diese CLI in einem Container-Image braucht.
Kommandozeilen-Version und Desktop-App
Desktop-App (offiziell)
Die QCode-Dokumentationsseite nennt als Installationswege der Desktop-Version die Installer je System und Befehle für Paketmanager; am Ende steht eine Anwendung mit grafischer Oberfläche.
Kommandozeilen-Version (Community-Fork)
Das Community-Projekt bietet eine Vollbild-Terminalansicht und eine in Skripte einbindbare Kommandozeile; bei auseinanderlaufenden Versionen meldet die CLI, dass die Datenbankversion zu neu ist.
Installation, Umschalten und Prüfen auf dem Server
① Installation: Aus dem README des Projekts den Befehl curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash ausführen (die Datei landet in ~/.local/bin) oder Homebrew nutzen: brew install cc-switch-cli. ② Eintrag anlegen: cc-switch provider add, die Felder nach Angaben der QCode-Dokumentation ausfüllen. ③ Umschalten: cc-switch provider switch (id) (Kurzform cc-switch use (id)); soll ein Eintrag nur für einen Start gelten, nutzt man cc-switch start claude (id) — laut README wirkt das nur auf die von diesem Befehl gestartete Sitzung, während provider switch und use weiterhin den globalen Eintrag ändern. ④ Datenverzeichnis und Updates: Die Kerndaten liegen standardmäßig in ~/.cc-switch/cc-switch.db und lassen sich mit CC_SWITCH_CONFIG_DIR verlegen (laut README werden vorhandene Daten unter ~/.cc-switch nicht automatisch migriert); für Homebrew-Installationen nennt das README brew upgrade cc-switch-cli.
Mit QCode
Nach der QCode-Dokumentation zu CC Switch: für Claude tragen Sie ANTHROPIC_BASE_URL https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN (Schlüssel mit dem Präfix cr_) ein, für Codex Base URL https://api.qcode.cc/openai und API Key; CC Switch schreibt die Konfiguration in ~/.claude/settings.json und ~/.codex/config.toml. QCode rechnet nach Tokens ab, die Preise je Modell stehen auf qcode.cc/models. Wenn Claude Code oder Codex dauerhaft auf einem Server laufen sollen, helfen die Cloud-Server von QCode: Die Maschine steht im Ausland, darauf sind Claude Code / Codex installiert, und die Modelle rufen Sie mit Ihrem QCode-Key auf; KI-Service und Cloud-Server teilen sich ein Guthaben. Die Cloud-Server haben derzeit nur eine chinesische und eine englische Oberfläche (qcode.cc/en/cloud).
Häufige Fragen
Gibt es eine offizielle Kommandozeilen-Version von CC Switch?
Nein. Im offiziellen README steht, dass CC Switch nur als Desktop-App mit grafischer Oberfläche veröffentlicht wird; für Server, SSH-Sitzungen und Rechner ohne Desktop wird dort die von der Community gepflegte CC Switch CLI empfohlen (laut README des CLI-Projekts und QCode-Dokumentation ist sie kein offizielles CC-Switch-Produkt).
Wie installiere ich das auf einem Server?
Das README des Projekts nennt zwei Wege: Homebrew mit brew install cc-switch-cli oder curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash, die das Programm nach ~/.local/bin installiert. Das README beschreibt außerdem den manuellen Weg: Archiv für das System herunterladen und in den PATH legen; für Linux gibt es den statischen musl-Build.
Wie wechsle ich zu einem anderen Eintrag?
Der Grundgebrauch im README des Projekts: cc-switch provider list zeigt die gespeicherten Einträge, cc-switch provider switch (id) schaltet um, cc-switch use (id) ist die Kurzform, cc-switch --app codex provider list wählt das Werkzeug über --app (voreingestellt ist claude). Soll ein Eintrag nur für einen Start gelten, führen Sie cc-switch start claude (id) aus.
Was tun bei „database version is too new“?
Das FAQ des offiziellen README und die QCode-Dokumentation schreiben, dass diese CLI standardmäßig das Verzeichnis ~/.cc-switch mit der Desktop-App teilt und die von ihr unterstützte Datenbankversion manchmal hinter der Desktop-App zurückliegt — in diesem Fall aktualisiert man die CLI oder wartet auf ein Update.
Welche Felder trage ich für QCode ein?
Nach der QCode-Dokumentation zu CC Switch: für Claude tragen Sie in ANTHROPIC_BASE_URL https://api.qcode.cc/api und in ANTHROPIC_AUTH_TOKEN den Schlüssel mit dem Präfix cr_ ein; für Codex in Base URL https://api.qcode.cc/openai und in API Key denselben Schlüssel. CC Switch schreibt das in ~/.claude/settings.json und ~/.codex/config.toml. Die Feldnamen stammen aus der QCode-Dokumentation, die die Desktop-App beschreibt und festhält, dass die Community-CLI nicht Funktion für Funktion getestet wurde; bei cc-switch provider add gelten die Eingabeaufforderungen, die tatsächlich erscheinen.
Gibt es in der npm-Registry ein Paket namens cc-switch-cli?
Ja, aber das ist nicht dasselbe Projekt wie im README: Das Paket mit diesem Namen in der npm-Registry hat jacob.shi als Maintainer, die neueste Version ist 1.0.1, veröffentlicht am 2026-04-26; das Projekt, auf das das offizielle README verweist, ist ein in Rust geschriebenes Binärprogramm, dessen Befehl cc-switch heißt, und sein README nennt keine Installation über npm. Installieren Sie die Homebrew-Version oder das Installationsskript wie im README beschrieben.
Quellen
README und releases/latest des Community-Projekts CC Switch CLI (Tag v5.11.2, veröffentlicht 2026-10-16, abgerufen und geprüft am 2026-10-20); die QCode-Dokumentationsseite zu CC Switch (Stand 2026-10-15, geprüft am 2026-10-20); die Registry-Metadaten des gleichnamigen npm-Pakets (geprüft am 2026-10-20).
Claude Code auf dem Server mit QCode verbinden
Abrechnung nach Tokens; die Preise je Modell stehen auf qcode.cc/models.
Weiterlesen
Nutzungspakete für Claude Code: ohne Abo, 7–90 Tage gültig
Einmal gekauftes Kontingent, das Sie in 7–90 Tagen verbrauchen, ganz ohne Abo; weitere Pakete landen auf demselben Key.
CC Switch: APIs in Claude Code und Codex wechseln
Wie die Desktop-App APIs zwischen Claude Code und Codex umschaltet, welche Felder belegt werden und was zu prüfen ist, wenn der Wechsel nicht wirkt.
CC Switch 4.0: Aggregation, Deep-Links, CLI (Okt. 2026)
4.0 trennt Direktanschluss, Routing und Aggregation in drei Tabs und hält fest, dass das offizielle README keine Kommandozeilenversion nennt.
Krypto-Zahlungsleitfaden
Neun Coins, 56 Netzwerke, keine Plattformgebühr für KI-Coding-API-Guthaben.
Der Inhalt dieser Seite wurde am 2026-10-20 gegen README und Release des Community-Projekts CC Switch CLI sowie gegen die QCode-Dokumentation geprüft; das Projekt wird von der Community gepflegt und eigenständig veröffentlicht, Versionen und Funktionen können sich daher jederzeit ändern — lesen Sie vor der Installation sein README. Die Konfigurationsfelder auf der QCode-Seite folgen der QCode-Dokumentation, die verfügbaren Modelle stehen auf /models.