CC Switch: APIs für Claude Code und Codex mit einem Klick wechseln
Stand 2026-10-07 wechseln Sie die API von Claude Code mit CC Switch so: Auf der Claude-Seite klicken Sie oben rechts auf +, legen eine benutzerdefinierte Konfiguration (Custom) an, setzen ANTHROPIC_BASE_URL auf https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN auf Ihren Schlüssel mit cr_-Präfix, speichern und klicken auf der Karte auf Enable. CC Switch schreibt beide Werte in ~/.claude/settings.json, und Enable auf einer anderen Karte schaltet auf diese um. Für Codex legen Sie auf der Codex-Seite eine zweite Konfiguration mit der Base URL https://api.qcode.cc/openai an. Diese Seite behandelt Installation, Einrichtung, Wechsel und häufige Probleme anhand der QCode-Dokumentation und des offiziellen CC-Switch-README.
Aktualisiert 2026-10-07
Vier Dinge, die Sie vorher wissen sollten
Adresse für Claude Code
ANTHROPIC_BASE_URL auf https://api.qcode.cc/api, ANTHROPIC_AUTH_TOKEN auf Ihren Schlüssel mit cr_-Präfix; ohne Schrägstrich am Ende.
Adresse für Codex
Base URL https://api.qcode.cc/openai, nicht /openai/v1; in der erzeugten config.toml muss wire_api = "responses" stehen bleiben.
Ein Klick zum Wechseln
Bei Claude Code wie bei Codex ist immer genau eine Konfiguration aktiv; klicken Sie auf einer anderen Karte auf Enable, schreibt CC Switch diesen Satz in die Konfigurationsdatei.
Neueste stabile Version (Stand 2026-10-07)
Erschienen am 2026-09-22; v4.0.0 bis v4.0.3 sind Vorschauversionen ab 2026-10-04, und Vorschauversionen aktualisieren sich nicht automatisch.
Was CC Switch eigentlich macht
Stand 2026-10-07 ist CC Switch eine quelloffene (MIT-Lizenz), plattformübergreifende Desktop-App für Windows, macOS und Linux, die API-Konfigurationen von Kommandozeilen-Tools wie Claude Code und Codex als Karten verwaltet: Ein Klick auf Enable setzt einen anderen Satz ein. Die QCode-Dokumentation beschreibt sie als Umschalter für Konfigurationsprofile. CC Switch ist selbst kein Inferenz-Endpunkt, sondern schreibt jede Konfiguration nur in die Standard-Konfigurationsdatei des Tools (bei Claude Code ~/.claude/settings.json, bei Codex ~/.codex/config.toml), überschreibt sie beim Aktivieren einer Karte und tauscht sie beim Wechsel zurück. Deshalb gilt bei Claude Code wie bei Codex immer nur eine Konfiguration; zwei Sätze wirken nie gleichzeitig. Laut offiziellem README wechseln Sie mit einem Klick, ohne JSON-, TOML- oder YAML-Dateien von Hand zu bearbeiten; die Liste der unterstützten Tools ändert sich je nach Version, maßgeblich ist das offizielle README.
Aktuelle CC-Switch-Versionen (Stand 2026-10-07)
Stand 2026-10-07 ist die neueste stabile Version auf GitHub Releases v3.20.4, veröffentlicht am 2026-09-22 (UTC); laut Release Notes löscht das Bearbeiten einer Codex-Konfiguration oder der Wechsel weg von ihr den gespeicherten API-Schlüssel nicht mehr. Alles von v4.0.0 (2026-10-04) bis v4.0.3 (2026-10-06) ist als Vorschau markiert. Laut den Release Notes zu v4.0 wurde der Mechanismus zum Schreiben der Konfiguration neu gebaut, sodass beim Wechsel nur noch Schlüsselfelder ersetzt werden statt der ganzen Datei, und ein neuer Aggregationsmodus führt Modelle mehrerer Provider in einer Modellliste in Claude Code oder Codex zusammen. Vorschauversionen aktualisieren sich nicht automatisch; In-App-Updates folgen nur stabilen Versionen. Die QCode-Dokumentation zu CC Switch wurde anhand der offiziellen Dokumentation zu v3.20.3 (2026-09-11) geprüft, Beschriftungen können sich daher je nach Version unterscheiden.
Zeitleiste der Versionen und Dokumentation
CC Switch v3.20.3 erscheint; die QCode-Dokumentation zu CC Switch wurde anhand der offiziellen Dokumentation dieser Version geprüft. Laut QCode-Dokumentation hat der Claude-Editor ab dieser Version einen Schnellschalter Disable Artifact Tool.
v3.20.4 erscheint und behebt einen Fehler, durch den das Bearbeiten einer Codex-Konfiguration oder der Wechsel weg von ihr den gespeicherten API-Schlüssel löschte; Stand 2026-10-07 ist sie weiterhin die neueste stabile Version auf GitHub.
Die Vorschau v4.0.0 erscheint: Beim Wechsel werden nur noch Schlüsselfelder ersetzt statt der ganzen Datei; bis 2026-10-06 ist die Vorschau bei v4.0.3 angekommen, und Vorschauversionen aktualisieren sich nicht automatisch.
Bestätigt vs. nicht dokumentiert oder widersprüchlich
Bestätigt (wörtlich in der Dokumentation)
Alles Folgende lässt sich wörtlich in der QCode-Dokumentation, im offiziellen CC-Switch-README, im Benutzerhandbuch oder in den GitHub-Release-Notes nachprüfen: Die Claude-Code-Konfiguration besteht aus ANTHROPIC_BASE_URL = https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN = einem Schlüssel mit cr_-Präfix, und beim Aktivieren landen beide in ~/.claude/settings.json; die Base URL für Codex ist https://api.qcode.cc/openai, und CC Switch erzeugt ~/.codex/config.toml und ~/.codex/auth.json mit wire_api = "responses"; der Schalter für lokale Proxy-Umwandlung im Codex-Panel, gedacht für Dienste, die nur Chat Completions anbieten, bleibt bei QCode aus; es ist immer nur eine Konfiguration aktiv; die Konfigurationen für Claude und Codex können denselben Schlüssel nutzen; CC Switch speichert für jede Konfiguration einen eigenen Schlüssel; die Verbindungsprüfung auf einer Karte prüft den Schlüssel nicht; die neueste stabile Version v3.20.4 erschien am 2026-09-22, v4.0.0 bis v4.0.3 sind Vorschauversionen.
Nicht dokumentiert oder widersprüchlich
Zu drei Punkten zieht diese Seite keinen Schluss. Erstens, ob Claude Code nach einem Wechsel neu gestartet werden muss: Das offizielle README sagt, Claude Code unterstütze Hot-Switching ohne Neustart, die FAQ im offiziellen Benutzerhandbuch rät dagegen, das Terminal zu schließen und neu zu öffnen, und Issue #3057, auf das die QCode-Dokumentation verweist, hält fest, dass eine laufende Sitzung weiter die alte Konfiguration nutzte. Testen Sie es mit Ihrer Version; gehen Anfragen noch an die alte Adresse, öffnen Sie die Sitzung neu. Zweitens, ob das Aktivieren Ihre Handänderungen an settings.json löscht: Die QCode-Dokumentation nennt Berichte, wonach manche Versionen die ganze Datei überschrieben und enabledPlugins sowie hooks verloren gingen; v4.0 ersetzt nur Schlüsselfelder, ist aber noch eine Vorschau, und das Verhalten der stabilen v3.20.4 hat diese Seite nicht getestet. Drittens, ein Schrägstrich am Ende der Base URL: QCode-Endpunkte verlangen die Adresse ohne ihn, und wie CC Switch selbst damit umgeht, ist laut QCode-Dokumentation in der offiziellen Dokumentation nicht beschrieben.
CC Switch oder Konfigurationsdateien von Hand bearbeiten
CC Switch vs. Handbearbeitung
Beides ändert dieselben Dateien: CC Switch schreibt ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN in ~/.claude/settings.json und base_url samt zugehöriger Schlüssel in ~/.codex/config.toml; es ist selbst kein Inferenz-Endpunkt. Wenn Sie oft zwischen mehreren Sätzen wechseln, etwa in einem Netz in Festlandchina zwischen asia.qcode.cc und api.qcode.cc oder zum Vergleich zwischen dem offiziellen Login und QCode, spart CC Switch Zeit. Nutzen Sie nur einen Satz oder arbeiten Sie auf einem Server ohne Desktop, ist Handbearbeitung direkter: CC Switch gibt es nur als Desktop-App mit grafischer Oberfläche, und für Rechner ohne Desktop empfiehlt das offizielle README das von der Community gepflegte CC Switch CLI.
Claude Code vs. Codex
In CC Switch sind das zwei Seiten mit zwei Konfigurationen: Claude landet in ~/.claude/, Codex in ~/.codex/, beide stören sich nicht, Sie starten also einfach claude und codex in getrennten Terminals. Der Unterschied liegt in Protokoll und Adresse: Claude Code nutzt das Anthropic-Protokoll mit https://api.qcode.cc/api, Codex das OpenAI-Responses-Protokoll mit https://api.qcode.cc/openai. Die QCode-Dokumentation hält fest, dass Claude-Modelle nur über den Anthropic-Endpunkt laufen und Codex Responses nutzen muss; beide Konfigurationen können denselben cr_-Schlüssel erhalten.
Sechs Schritte: installieren, einrichten, wechseln
① Installation: Laden Sie ein Paket von den GitHub Releases von CC Switch. Für Windows 10 und neuer die .msi oder die portable .zip; für macOS 12 und neuer die .dmg oder brew install --cask cc-switch; für Linux .deb, .rpm oder .AppImage (offiziell vorausgesetzt sind glibc 2.35+ und WebKitGTK 4.1), unter Arch paru -S cc-switch-bin. ② Claude Code einrichten: Wählen Sie oben im Umschalter Claude, klicken Sie oben rechts auf +, wählen Sie als Preset Custom und setzen Sie im Konfigurations-JSON ANTHROPIC_BASE_URL auf https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN auf Ihren cr_-Schlüssel; den Namen wählen Sie frei, im Beispiel der Dokumentation heißt er QCode.cc. ③ Speichern, mit der Maus über die Karte fahren und Enable klicken: CC Switch schreibt beide Werte in ~/.claude/settings.json. Zum Prüfen starten Sie claude im Terminal. ④ Codex einrichten: Wechseln Sie zu Codex, klicken Sie auf + und wählen Sie Custom, setzen Sie die Base URL auf https://api.qcode.cc/openai, den API Key auf denselben cr_-Schlüssel und das Standardmodell auf gpt-6-sol oder gpt-5.6-terra; den Namen wählen Sie frei, im Beispiel der Dokumentation heißt er kleingeschrieben qcode (praktisch als TOML-Schlüssel) und erscheint in der config.toml als model_provider = "qcode". Den Schalter für lokale Proxy-Umwandlung, gedacht für Dienste nur mit Chat Completions, lassen Sie aus. ⑤ Speichern, Enable klicken und zum Prüfen codex starten; in der config.toml sollten base_url = "https://api.qcode.cc/openai" und wire_api = "responses" stehen. ⑥ Später wechseln: Klicken Sie auf einer anderen Karte auf Enable oder im System-Tray direkt auf den Konfigurationsnamen. Prüfen Sie zuerst in ~/.claude/settings.json (bei Codex ~/.codex/config.toml), ob sich die Adresse geändert hat; Codex braucht ein neues Terminal, und wenn Claude Code noch die alte Adresse nutzt, schließen Sie die Sitzung und öffnen eine neue. Speichern Sie eine zweite Kopie für asia.qcode.cc, hängen Sie an den Namen ein Suffix wie (asia) an, damit Sie beide im Tray unterscheiden können.
Auf QCode
Auf QCode können die Konfigurationen für Claude Code und Codex denselben cr_-Schlüssel erhalten (in der Konsole erstellt): Der Schlüssel funktioniert protokollübergreifend, welches Protokoll greift, entscheidet der Anfragepfad. Die Claude-Code-Konfiguration nutzt https://api.qcode.cc/api mit Modellen wie claude-sonnet-5, claude-sonnet-5-5 oder claude-opus-5, und innerhalb von Claude Code können Sie das Modell auch mit /model wechseln; die Codex-Konfiguration nutzt https://api.qcode.cc/openai mit gpt-6-sol oder gpt-5.6-terra. Die drei Zugangsdomains bieten denselben Funktionsumfang und akzeptieren denselben Schlüssel: us.qcode.cc richtet sich an Nordamerika und Europa, für Netze in Festlandchina empfiehlt die Dokumentation asia.qcode.cc, die Pfade bleiben gleich, sodass Sie in CC Switch je Domain eine Konfiguration anlegen können. Ein gemeinsamer Schlüssel für beide Konfigurationen führt nicht zu doppelten Abbuchungen; berechnet wird pro Token, die Preise je Modell stehen unter /models. Jede Anfrage können Sie auf probe.qcode.cc nach Eingabe Ihres Schlüssels einsehen.
Häufig gestellte Fragen
CC Switch hat gewechselt, aber Claude Code merkt nichts davon. Was tun?
Erst die Datei prüfen, dann die Sitzung neu öffnen. Öffnen Sie ~/.claude/settings.json und prüfen Sie, ob ANTHROPIC_BASE_URL den gerade aktivierten Satz zeigt; hat sich die Datei geändert, die Sitzung aber nicht, schließen Sie das laufende claude und starten es in einem neuen Terminal. Issue #3057, auf das die QCode-Dokumentation verweist, beschreibt genau das: Claude Code liest den env-Block aus settings.json beim Prozessstart in Umgebungsvariablen ein, und eine laufende Sitzung liest ihn nicht neu. Ob überhaupt ein Neustart nötig ist, beschreiben die offiziellen Quellen unterschiedlich: Das offizielle README sagt, Claude Code unterstütze Hot-Switching ohne Neustart, die FAQ im Benutzerhandbuch rät, das Terminal zu schließen und neu zu öffnen oder die IDE neu zu starten; für Codex verlangen beide ein neues Terminal. Ein Wechsel über das Tray schreibt dieselbe Datei und beendet ein laufendes claude nicht für Sie.
Wie finde ich die Ursache für 401 Unauthorized?
Meist ist in einer der Konfigurationen der Schlüssel falsch. Prüfen Sie, ob der Schlüssel mit cr_ beginnt und keine Leerzeichen am Anfang oder Ende hat, und dann in der Konsole, ob er noch gültig ist. Liefert Claude Code 401, während Codex funktioniert (oder umgekehrt), liegt der Fehler in genau dieser Konfiguration: CC Switch speichert für jede Konfiguration einen eigenen Schlüssel, aktualisieren Sie beim Schlüsselwechsel also jede einzeln. Beachten Sie außerdem: Die Verbindungsprüfung auf einer Karte testet nur, ob die Adresse erreichbar ist; laut offiziellem Benutzerhandbuch prüft sie den Schlüssel nicht, eine bestandene Prüfung beweist also nicht, dass er stimmt.
Codex dreht sich nach dem Start endlos. Was prüfe ich?
Prüfen Sie zuerst ~/.codex/config.toml. base_url muss bei /openai enden, nicht bei /openai/v1, und wire_api = "responses" muss stehen bleiben. Laut QCode-Dokumentation ist die häufigste Ursache ein fehlendes model_provider auf oberster Ebene oder eines, das nicht zum Tabellennamen [model_providers.xxx] passt; dann fällt Codex auf seinen eingebauten offiziellen openai-Endpunkt zurück. Korrigieren, Terminal neu öffnen und codex erneut starten.
Kann ich Claude Code und Codex gleichzeitig nutzen?
Ja. CC Switch schreibt die Claude-Konfiguration nach ~/.claude/ und die Codex-Konfiguration nach ~/.codex/; beide stören sich nicht, starten Sie claude und codex einfach in getrennten Terminals. Beide können denselben cr_-Schlüssel erhalten: Claude Code mit https://api.qcode.cc/api, Codex mit https://api.qcode.cc/openai. Laut QCode-Dokumentation führt ein so geteilter Schlüssel nicht zu doppelten Abbuchungen, nur weil Sie eine zweite Konfiguration angelegt haben.
Ich habe settings.json von Hand bearbeitet. Gehen meine Änderungen verloren, wenn ich eine andere Konfiguration aktiviere?
Das kann passieren, sichern Sie die Datei also vorher. Laut QCode-Dokumentation überschreibt CC Switch beim Aktivieren die passenden Einträge in ~/.claude/settings.json mit den Werten dieser Konfiguration, und für manche Versionen gab es Berichte, dass die ganze Datei überschrieben wurde und enabledPlugins sowie hooks verloren gingen; die Release Notes der Vorschau v4.0 sagen, dass beim Wechsel jetzt nur noch Schlüsselfelder ersetzt werden. Ist etwas verloren, stellen Sie es aus ~/.cc-switch/backups/ wieder her (offiziell werden die 10 neuesten aufbewahrt) oder aus einem Export namens cc-switch-export-{timestamp}.sql. Außerdem importiert CC Switch beim ersten Start Ihre vorhandene Claude-Code- und Codex-Einrichtung als Konfiguration mit dem Namen default.
Wie komme ich zum offiziellen Anthropic-Login zurück?
Wählen Sie in der Liste die eingebaute offizielle Konfiguration (für Claude Code Claude Official, für Codex OpenAI Official; haben Sie sie gelöscht, fügen Sie sie aus den Presets wieder hinzu), klicken Sie auf Enable, starten Sie die CLI neu und durchlaufen Sie den Login des Tools selbst: /login in Claude Code, codex login bei Codex. Danach können Sie frei zwischen offiziellem Login und Ihrer QCode-Konfiguration wechseln. Die QCode-Dokumentation warnt davor, von Hand eine Mischkonfiguration zu bauen, deren env-Block leer ist, die aber noch einen cr_-Schlüssel enthält.
Quellen
Einrichtung, Adressen und Fehlersuche: die QCode-Dokumentationsseite zu CC Switch (aktualisiert am 2026-09-25, geprüft anhand der offiziellen Dokumentation zu CC Switch v3.20.3) und die Seite zu Endpunkten und API-Formaten (aktualisiert am 2026-09-25; welches Protokoll welchen Endpunkt nutzt, die drei Zugangsdomains und die Regel zum Schrägstrich am Ende), beide abgerufen am 2026-10-07. Installation, Systemvoraussetzungen, Regeln dafür, wann ein Wechsel greift, und offizieller Login auf Seiten von CC Switch: README und Benutzerhandbuch-FAQ im GitHub-Repository von CC Switch, am selben Tag abgerufen. Versionen und Daten: die GitHub Releases von CC Switch (Release Notes zu v3.20.3, v3.20.4 und v4.0.0 bis v4.0.3), am selben Tag abgerufen.
CC Switch mit QCode verbinden
Ein cr_-Schlüssel: Claude Code auf /api, Codex auf /openai, gewechselt wird mit einem Klick auf Enable. Berechnet wird pro Token, die Preise je Modell stehen unter /models.
Weiterführende Lektüre
Claude Code: benutzerdefinierten Endpunkt einrichten
Die beiden Umgebungsvariablen, die Form in settings.json und apiKeyHelper.
Codex CLI mit Drittanbieter-API einrichten
So setzen Sie model_provider, base_url und env_key in der config.toml.
Claude Code Benutzerhandbuch
Ein Tutorial zur Claude Code CLI von Installation und Einrichtung bis zur täglichen Nutzung.
Die Schritte und Zitate auf dieser Seite wurden am 2026-10-07 geprüft; maßgeblich sind die offiziellen Seiten, also die QCode-Dokumentation, das offizielle CC-Switch-README und die GitHub-Release-Notes, und Änderungen bei den Anbietern sind ohne Vorankündigung möglich. Beschriftungen und Wechselverhalten von CC Switch ändern sich je nach Version, maßgeblich ist Ihre eigene; für die Modellverfügbarkeit gilt /models.