CC Switch 4.0: Aggregationsmodus und Ein-Klick-Import
Stand 2026-10-13 trennt CC Switch 4.0 Direktverbindung, Routing und Aggregation in drei Tabs oben auf jeder App-Seite: Die offiziellen Release Notes beschreiben den neuen Aggregationsmodus so: Die Modelle mehrerer Anbieter liegen in einer gemeinsamen Modelliste in Claude Code oder Codex, und jede Anfrage geht an den Anbieter des gewählten Modells, ohne dass Sie den Client verlassen. Was diese Seite über CC Switch aussagt, folgt den offiziellen GitHub-Releases und dem README: v4.0.0 wurde am 2026-10-04 veröffentlicht, v4.0.10 am 2026-10-12, und der neueste Eintrag der offiziellen Release-Liste ist am Checktag v4.0.11 vom 2026-10-13. Eine Kommandozeilenversion von CC Switch gibt es nicht – das offizielle README hält fest, dass die Anwendung nur als Desktop-Programm mit grafischer Oberfläche erscheint. Seit v4.0.10 geht ein ccswitch://-Deep-Link nicht mehr verloren, wenn die App nicht läuft; ein Link kann sein API-Format erklären, und im Bestätigungsdialog wählen Sie, ob direkt nach dem Import umgeschaltet wird.
Aktualisiert 2026-10-13
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
Vier Punkte, die Sie kennen sollten
Direkt / Routing / Aggregation
Laut den offiziellen Release Notes beginnt jede App-Seite mit diesen drei Tabs; ein Klick auf einen Tab ändert nur, was Sie sehen, und greift Ihre Konfiguration nicht, der Button, der den Modus wirklich wechselt, beschreibt was passiert, und die Rückkehr zu Direkt ist ein Schritt mit Rückgängig.
Claude-Code-Version für Aggregation
Der Aggregations-Abschnitt des offiziellen README sagt: Aggregation bietet kein Failover, Claude Code braucht Version 2.1.243 oder neuer; nach einer Änderung der Aggregationsliste muss Codex neu gestartet werden, Claude Code nicht.
Ein-Klick-Import per Link
Das Kernthema von v4.0.10. Offizielle Formulierung: Ein Klick bei nicht laufender App verliert den Link nicht mehr – er wird zuerst gespeichert und gilt erst als behandelt, wenn der Bestätigungsdialog erschienen ist. Der Dialog hat einen Schalter bekommen, mit dem Sie direkt nach dem Import zu diesem Anbieter wechseln, standardmäßig aus.
Der Link erklärt das API-Format
Ein neuer Parameter für Website-Betreiber in v4.0.10: Ein Parameter erklärt, welches API-Format der Dienst spricht (anthropic, openai_chat, openai_responses und weitere), und CC Switch übersetzt ihn in die Felder der jeweiligen App; Links ohne diesen Parameter verhalten sich wie zuvor.
Was der Aggregationsmodus konkret tut
Stand 2026-10-13 ist Aggregation die dritte Verbindungsart, die CC Switch 4.0 ergänzt, und die Release Notes beschreiben sie so: Der neue Aggregationsmodus legt die Modelle mehrerer Anbieter in eine Modelliste in Claude Code oder Codex, damit Sie innerhalb des Clients wechseln. Der vorherige Ablauf ist ebenso beschrieben: Wer früher ein Modell eines anderen Anbieters nutzen wollte, musste zurück zu CC Switch, den Anbieter wechseln und dann in der Arbeit weitermachen; heute fügen Sie mehrere Anbieter hinzu, ihre Modelle erscheinen alle in der Modellauswahl des Clients, und die Anfrage geht an den Anbieter des gewählten Modells. Auch die Grenzen sind offiziell benannt: Aggregation muss manuell eingeschaltet werden, unterstützt bisher Claude Code und Codex, verteilt die Anfragen nach dem gewählten Modell und bietet kein Failover – Formatumwandlung und Failover gehören zum Routing. Das README nennt zwei weitere Voraussetzungen: Claude Code muss 2.1.243 oder neuer sein, und offizielle Claude-Abos sind in der Aggregation derzeit nicht unterstützt. Außerdem wurde das Schreiben der Konfiguration umgebaut: Ein Anbieterwechsel ersetzt nur Adresse, Zugangsdaten, Modell und Protokoll, alles andere bleibt unverändert.
Inhalt und Daten der offiziellen Release Notes
Der Text von v4.0.0 beginnt mit der Aussage, dies sei das bislang größte Update von CC Switch; im GitHub-Release steht published_at 2026-10-04T11:01:01Z, und in den Metadaten ist prerelease auf true gesetzt. Der Unterüberschrift von v4.0.10 zufolge ist es das sechste Fix-Release der stabilen 4.0-Linie, published_at ist 2026-10-12T16:38:21Z mit prerelease false, und der erste Satz benennt den Ein-Klick-Import (ccswitch://-Deep-Links) als Schwerpunkt – zusammen mit einem Leitfaden für Website-Betreiber auf Chinesisch, Englisch und Japanisch sowie einem Online-Link-Generator. Am 2026-10-13 folgte v4.0.11 (published_at 2026-10-13T15:35:29Z, prerelease false), am Checktag der neueste Eintrag der offiziellen Release-Liste; die Release Notes nennen für diese Version eine Deinstallation installierter Werkzeuge auf der Apps-Seite sowie die in allen Apps standardmäßig eingeschaltete Abfrage des Tarifkontingents, nicht nur in Claude Code. v4.0.10 hat auch die Beschreibung der Verbindungsarten umgeschrieben und beginnt mit den Stärken: Direkt bleibt am nächsten an der Arbeitsweise des Clients selbst, Routing wechselt den Anbieter im laufenden Betrieb, kann Formate umwandeln und Failover einrichten, Aggregation wechselt mehrere Anbieter innerhalb des Clients. Der Hintergrund wird ebenfalls genannt: CC Switch erschien im August 2025, als die API-Formate noch deutlich weiter auseinanderlagen, deshalb wurde der Anbieterwechsel damals als komplettes Überschreiben gebaut – jetzt ersetzt durch das Ersetzen einzelner Schlüsselwerte.
Die Timeline rund um 4.0
Der älteste Eintrag der offiziellen GitHub-Release-Liste von CC Switch ist v2.0.3 mit published_at 2025-08-22T00:12:40Z; die Release Notes von v4.0.0 ordnen den Beginn von CC Switch dem August 2025 zu.
v4.0.0 erscheint, in den GitHub-Metadaten mit prerelease true: Die Oberfläche wird von der Seitenleiste bis zum Tray-Icon komplett neu aufgebaut, Aggregation kommt hinzu, und das Konfigurationsschreiben wechselt vom kompletten Überschreiben zum Ersetzen einzelner Werte.
v4.0.10 erscheint mit prerelease false: ccswitch://-Links überleben eine geschlossene App, Parameter für Betreiber wie apiFormat und der Online-Generator kommen dazu, und im Routing-Modus ändert sich der Alias für die Haiku-Stufe in settings.json von claude-haiku-4-5 auf claude-haiku-5-5.
Bestätigt und offen
Bestätigt (wörtlich in Release Notes und README)
Jeder der folgenden Punkte lässt sich Wort für Wort in den für diese Seite gespeicherten Release-Texten und dem README nachprüfen: Direkt, Routing und Aggregation sind auf drei Tabs getrennt, und ein Tab-Klick lässt Ihre Konfiguration unberührt; Aggregation legt die Modelle mehrerer Anbieter in eine Modelliste von Claude Code oder Codex und verteilt nach dem gewählten Modell; Aggregation ist manuell einzuschalten, umfasst bisher Claude Code und Codex, bietet kein Failover, braucht Claude Code 2.1.243 oder neuer und unterstützt offizielle Claude-Abos derzeit nicht; nach einer Änderung der Aggregationsliste braucht Codex einen Neustart, Claude Code nicht; der Anbieterwechsel ersetzt statt eines kompletten Überschreibens nur Adresse, Zugangsdaten, Modell und Protokoll; v4.0.10 behebt den verlorenen Deep-Link bei geschlossener App, ergänzt den Dialogschalter für den Sofortwechsel (standardmäßig aus) und den Parameter apiFormat; der Online-Generator deckt Anbieter, MCP, Prompts und Skills ab; die Veröffentlichungsdaten sind 2026-10-04 für v4.0.0, 2026-10-12 für v4.0.10 und 2026-10-13 für v4.0.11, gelesen aus dem Feld published_at.
Unbestätigt und von den Projekten nicht gesagt
Drei Punkte haben keine belastbare Quelle, planen Sie also nicht damit. Erstens: ein Kommandozeilen-Build von CC Switch selbst – das README sagt eindeutig, dass die Anwendung nur als Desktop-Programm mit grafischer Oberfläche erscheint, und als einzige Ausnahme nennt es ein von der Community gepflegtes CC Switch CLI, ein separat veröffentlichtes Projekt; deshalb nennt diese Seite keine Befehle, mit denen man CC Switch aus dem Terminal steuert. Zweitens: Die offiziellen Release-Seiten sind sich uneinig, was stabil heißt – v4.0.0 trägt prerelease true, während v4.0.10 von der stabilen 4.0-Linie spricht und prerelease false trägt, und auch v4.0.11 trägt prerelease false; diese Seite nennt nur die published_at-Daten und schlussfolgert nichts. Drittens: Online-Streitgespräche darüber, welches vergleichbare Werkzeug besser ist, haben keine nachprüfbare Quelle und werden hier nicht wiederholt; und obwohl v4.0.10 schreibt, dass die Datenbankstruktur weiterhin 20 ist, ist das kein Kompatibilitätsversprechen für künftige Versionen.
Direkt, Routing, Aggregation: so wählen Sie
Direkt gegen Routing
In der offiziellen Einteilung verbindet Direkt den Client unmittelbar mit dem Anbieter und passt für den Alltag; Routing leitet über einen lokalen Dienst auf Ihrem Rechner an einen Anbieter weiter, kann API-Formate umwandeln und Failover einrichten und ist damit bei unverträglichen Formaten sinnvoll oder wenn Sie Failover brauchen. Eine Codex-Konfiguration für QCode braucht das nicht: Die QCode-Doku sagt, dass der Schalter für lokale Routing-Abbildung im Codex-Anbietereditor für Dienste gedacht ist, die nur Chat Completions sprechen, und dass er bei QCode aus bleiben soll, weil QCode das Responses-Protokoll selbst bereitstellt.
Routing gegen Aggregation
Beide laufen über den lokalen Dienst auf Ihrem Rechner; der Unterschied liegt in der Verteilung: Routing sendet die Anfragen an einen Anbieter, Aggregation verteilt sie je nach gewähltem Modell auf mehrere – genau das richtige, wenn Sie in einer Sitzung Modelle mischen wollen. Aggregation bietet kein Failover, ist manuell einzuschalten, umfasst derzeit nur Claude Code und Codex, und offizielle Claude-Abos werden nicht unterstützt. Der Hinweis der Dokumentation: Wer mitten in einer Sitzung das Modell wechselt, muss damit rechnen, dass das neue Modell den Prompt-Cache neu aufbaut und die erste Runde danach spürbar mehr kostet.
QCode in CC Switch 4.0 hinzufügen
① Installieren oder aktualisieren: Das offizielle README nennt Desktop-Pakete und Paketmanager-Kommandos – msi oder portable zip für Windows 10 und neuer, brew install --cask cc-switch für macOS 12 und neuer, paru -S cc-switch-bin für Arch, sowie .deb, .rpm oder .AppImage für andere Linux-Distributionen. Für die Terminal-Nutzung ist das README eindeutig: CC Switch selbst erscheint nur als Desktop-Anwendung mit grafischer Oberfläche; für Server, SSH-Sitzungen und Rechner ohne Desktop-Umgebung empfiehlt es das von der Community gepflegte CC Switch CLI, ein separat veröffentlichtes Projekt mit interaktivem Terminal-Interface (TUI) und Kommandozeilen-Modus, installierbar über brew install cc-switch-cli – und es warnt, dass beide standardmäßig das Datenverzeichnis ~/.cc-switch teilen und dass die von der CLI unterstützte Datenbankversion der Desktop-Version manchmal hinterherhinkt. ② Claude-Seite nach der QCode-Doku: Starten Sie CC Switch, wählen Sie Claude im App-Umschalter oben, klicken Sie oben rechts auf das Plus zum Anlegen eines Anbieters, wählen Sie im Preset-Menü benutzerdefiniert, tragen Sie bei ANTHROPIC_BASE_URL https://api.qcode.cc/api und bei ANTHROPIC_AUTH_TOKEN Ihren cr_-Schlüssel aus der Konsole ein, speichern Sie und klicken Sie auf der Karte auf Enable – CC Switch schreibt beide Werte in ~/.claude/settings.json – und prüfen Sie die Verbindung, indem Sie im Terminal claude ausführen. ③ Codex-Seite: Legen Sie unter Codex einen eigenen Anbieter an mit Base URL https://api.qcode.cc/openai; die config.toml in der QCode-Doku nennt den Anbieter qcode (die Doku empfiehlt Kleinschreibung, damit der Name sich als TOML-Schlüssel verwenden lässt) mit wire_api responses, als Standardmodell sind gpt-6-sol oder gpt-5.6-terra genannt, der Schalter für lokale Routing-Abbildung bleibt aus, und Ihre Codex-Version lesen Sie aus codex --version auf Ihrem Rechner. ④ Aggregation nutzen: Öffnen Sie auf der Claude- oder Codex-Seite den Tab Aggregation, fügen Sie die Anbieter hinzu, die Sie mischen möchten, und wählen Sie einen davon als Standard – Anfragen ohne benanntes Aggregationsmodell gehen dorthin; wenn sich die Modelliste ändert, starten Sie den Client gemäß Hinweis neu, bei Codex CLI geht der Neustart des Hintergrunddienstes per Klick im Banner. ⑤ Import über einen Link: Nach dem Klick auf einen ccswitch://-Link erscheint der Bestätigungsdialog für den Import; schalten Sie dort den Sofort-Wechsel ein, wenn Sie direkt nach dem Import zu diesem Anbieter wechseln wollen (standardmäßig aus) – der Dialog weist dann darauf hin, dass Client-Anfragen an die Adresse im Link umgeleitet werden. Die QCode-Doku ergänzt, dass die App beim ersten Start über einen Deep-Link ihr Fenster neu aufbaut und das etwas langsamer ist.
Wie es bei QCode läuft
CC Switch ist selbst kein Endpunkt – die Anwendung schreibt nur die Konfigurationsdateien der CLI-Tools, und gearbeitet wird mit dem Schlüssel, den Sie bei QCode bekommen. Ein cr_-Schlüssel aus der Konsole deckt beide Protokolle ab, denn der Schlüssel unterscheidet kein Protokoll: Der Pfad entscheidet. Der Claude-Eintrag bekommt ANTHROPIC_BASE_URL https://api.qcode.cc/api (Anthropic-Protokoll, vollständiger Pfad /api/v1/messages), der Codex-Eintrag base_url https://api.qcode.cc/openai mit wire_api responses. Claude-Modelle laufen ausschließlich über den Anthropic-Protokoll-Endpunkt; setzt man eines in den OpenAI-kompatiblen Pfad, kommt eine Fehlermeldung. Aufrufbare Modell-IDs bei QCode sind unter anderem claude-sonnet-5, claude-sonnet-5-5, claude-opus-5, claude-opus-5-5, claude-haiku-5-5, gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol und gpt-5.6-terra. Der Einstieg läuft über Guthaben: Sie laden zunächst auf und kaufen dann ein Paket, das von diesem Guthaben abgezogen wird. Unterstützt sind Alipay, WeChat Pay, Kreditkarten (Visa, Mastercard, AMEX), Apple Pay, Google Pay und Kryptowährung (viele Münzen und Netzwerke); Aufladungen in Renminbi beginnen bei ¥100, der Dollarbereich liegt zwischen $1 und $2.000. Abgerechnet wird pro Token; die Preise je Modell stehen auf /models.
Häufige Fragen
Was ist der Aggregationsmodus in CC Switch 4.0?
Eine gemeinsame Modelliste für mehrere Anbieter. Die offiziellen Release Notes beschreiben den neuen Aggregationsmodus so: Die Modelle mehrerer Anbieter liegen in derselben Modelliste in Claude Code oder Codex, damit Sie innerhalb des Clients wechseln: Jede Anfrage geht an den Anbieter des gewählten Modells, ohne den Client zu verlassen. Der Modus muss manuell eingeschaltet werden, unterstützt bisher Claude Code und Codex, verteilt nach dem ausgewählten Modell und bietet kein Failover.
Gibt es eine Kommandozeilenversion (CLI) von CC Switch?
Von CC Switch selbst nicht. Das offizielle README beantwortet die Frage nach einer Kommandozeilen- oder headless Version eindeutig: CC Switch erscheint nur als Desktop-Anwendung, die eine grafische Oberfläche braucht. Für Server, SSH-Sitzungen und Rechner ohne Desktop-Umgebung empfiehlt das README das von der Community gepflegte CC Switch CLI – ein separat veröffentlichtes Projekt mit interaktivem Terminal-Interface (TUI) und Kommandozeilen-Modus, installierbar mit brew install cc-switch-cli, das standardmäßig das Datenverzeichnis ~/.cc-switch mit der Desktop-App teilt; das README warnt zugleich, dass die von der CLI unterstützte Datenbankversion manchmal hinter der Desktop-Version liegt. Die andere CLI-bezogene Funktion im README ist die Apps-Seite: Dort sehen Sie die Versionen von Kommandozeilen-Werkzeugen wie Claude Code und Codex und aktualisieren sie – das verwaltet jene Tools, statt CC Switch aus dem Terminal zu steuern. Diese Seite nennt daher keine Befehle, mit denen man CC Switch aus dem Terminal steuert; die zitierten Installationsbefehle stehen wörtlich im README.
Geht ein ccswitch://-Import-Link verloren, wenn die App geschlossen ist?
Nein, seit v4.0.10 nicht mehr. Die Release Notes beschreiben das frühere Verhalten: Unter Windows und Linux startete CC Switch beim Klick auf einen Importlink zwar, der Bestätigungsdialog erschien aber nicht, im Light-Mode ging der Link beim Neuaufbau des Fensters verloren, und unter macOS erschien der Dialog für denselben Link zweimal. Heute wird der Link zuerst gespeichert und gilt erst als behandelt, wenn der Dialog sichtbar ist – ein Abbruch verliert ihn also nicht, und ein später eintreffender älterer Link überschreibt keinen neueren. Die QCode-Doku ergänzt, dass die App beim ersten Start über einen ccswitch://-Deep-Link ihr Fenster neu aufbaut und das etwas langsamer ist.
Welche Endpunkte gehören in die Claude- und Codex-Anbieter von CC Switch?
Sie speichern je Client einen QCode-Anbieter: Der Claude-Eintrag bekommt ANTHROPIC_BASE_URL https://api.qcode.cc/api und Ihren cr_-Schlüssel, der Codex-Eintrag base_url https://api.qcode.cc/openai mit wire_api responses. Beide nutzen denselben QCode.cc-API-Key; laut QCode-Doku teilen sie sich Ihr Paketkontingent, es wird nicht doppelt abgerechnet. Claude-Modelle laufen nur über den Anthropic-Protokoll-Endpunkt und gehören nicht in den OpenAI-kompatiblen Pfad.
Worauf muss ich bei der Aggregation achten?
Auf fünf offiziell genannte Punkte. Claude Code muss 2.1.243 oder neuer sein; Aggregation bietet kein Failover; sie wird manuell eingeschaltet und unterstützt bisher Claude Code und Codex, wobei offizielle Claude-Abos derzeit nicht verfügbar sind; nach einer Änderung der Aggregationsliste braucht Codex einen Neustart, Claude Code nicht; und ein Modellwechsel mitten in der Sitzung baut den Prompt-Cache neu auf, wodurch die erste Runde danach spürbar teurer ist.
Wie lade ich QCode in Festland-China auf?
Mit Alipay oder WeChat Pay. Das QCode-Zahlungsdokument sagt: Für Zahlungen in Renminbi aus Festland-China ist Alipay die erste Wahl (die Gebühr wird nicht durchgereicht), WeChat Pay die Alternative, und beide einzuzahlenden Beträge landen auf dem Guthaben in Renminbi; dort steht auch, dass Aufladungen in Renminbi bei ¥100 anfangen. Nach dem Aufladen kopieren Sie Ihren cr_-Schlüssel aus der Konsole in den benutzerdefinierten CC-Switch-Anbieter. Abgerechnet wird pro Token; die Preise je Modell stehen auf /models.
Quellen
Zu CC Switch: die Texte und Metadaten zweier GitHub-Releases aus dem offiziellen Repository farion1231/cc-switch – v4.0.0 (published_at 2026-10-04T11:01:01Z, prerelease true) und v4.0.10 (published_at 2026-10-12T16:38:21Z, prerelease false) – sowie das README von main, alles abgerufen am 2026-10-13. Zu QCode: die CC-Switch-Einrichtungsseite auf docs.qcode.cc (gekennzeichnet als aktualisiert 2026-10-08), die Seite zu Endpunkten und API-Pfaden, der Überblick zu den Zahlungsmethoden (aktualisiert 2026-10-01), am selben Tag abgerufen. Die Release Notes zu v4.0.11 und die offizielle Release-Liste wurden am 2026-10-14 abgerufen.
Ein API-Key für Claude Code und Codex
Der Claude-Eintrag bekommt https://api.qcode.cc/api, der Codex-Eintrag https://api.qcode.cc/openai; beide Anbieter nutzen denselben QCode.cc-API-Schlüssel und teilen sich das Kontingent Ihres Tarifs. Abgerechnet wird pro Token; die Preise je Modell stehen auf /models.
Verwandte Beiträge
CC Switch: APIs in Claude Code und Codex wechseln
Einen eigenen QCode-Anbieter auf der Claude-Seite anlegen, ANTHROPIC_BASE_URL https://api.qcode.cc/api und den cr_-Schlüssel eintragen und über Enable in settings.json schreiben lassen; für Codex ein eigener Eintrag auf /openai, dazu Prüfung, wenn ein Wechsel nicht ankommt oder 401 erscheint.
Codex CLI mit Drittanbieter-API: config.toml, base_url, Fehler
Wie model_provider, base_url, wire_api und env_key in der config.toml zusammenspielen und wie Sie die üblichen Fehler lesen.
Claude Code in China (2026): Alipay und WeChat Pay
ANTHROPIC_BASE_URL in Festland-China auf QCode richten und das Guthaben per Alipay oder WeChat Pay aufladen.
Die Fakten auf dieser Seite wurden am 2026-10-13 geprüft; die Release-Einträge zur aktuellen neuesten Version wurden am 2026-10-14 erneut abgerufen und geprüft. CC Switch ist ein quelloffenes Drittanbieter-Werkzeug (MIT-Lizenz): Funktionen, Oberflächentexte und Wechselverhalten bestimmen sich nach den offiziellen Releases und dem README; diese Seite gibt im Namen von CC Switch keine Kompatibilitätszusagen ab und vertritt keine Position der Projekte. Konfigurationsfelder und Zahlungsangaben von QCode folgen der offiziellen Dokumentation, Änderungen dort können ohne Ankündigung erfolgen. Die Verfügbarkeit von Modellen richtet sich danach, was auf /models steht.