Claude Code: Anbieter in 5 Minuten mit CC Switch wechseln

Dieses Tutorial basiert auf CC Switch v4.0.26 (November 2026). Die Beschriftungen der Schaltflächen können sich in späteren Versionen ändern; das Konfigurationsmodell bleibt gleich.

Um Claude Code zwischen Anbietern zu wechseln, muss man normalerweise ~/.claude/settings.json bearbeiten: die Basis-URL, den API-Schlüssel und manchmal das Modell. Bei einem Anbieter ist das noch überschaubar. Bei zwei oder drei wird es zu einer kleinen Wartungsaufgabe – und Fehler bleiben leicht unbemerkt, denn ein veralteter ANTHROPIC_*-Export in der Shell kann die gerade bearbeitete Datei überschreiben.

Mit CC Switch wird aus dem Wechseln eine Karte, auf die du klickst. Das integrierte AiHubMix-Preset trägt den Endpunkt ein; du musst nur noch einen API-Schlüssel einfügen. Claude Code übernimmt die Änderung normalerweise ohne Neustart. Dieses Tutorial führt durch die gesamte Einrichtung und erklärt anschließend, was CC Switch schreibt, welche Falle Umgebungsvariablen darstellen und wann der Direktmodus ausreicht.

Die Kurzfassung: Installiere CC Switch, erstelle einen AIHubMix-Schlüssel, wähle unter Claude Code das AiHubMix-Preset aus, füge den Schlüssel ein, ergänze beim Anbieter ANTHROPIC_MODEL=claude-sonnet-5-5, klicke auf Wechseln und führe claude -p "1+1, output only the answer" --model claude-sonnet-5-5 aus. Im Rest dieses Beitrags werden die einzelnen Schritte ausführlich erklärt.

Was CC Switch ist

CC Switch ist eine Open-Source-Desktop-App (MIT, Tauri + Rust + React) zur Verwaltung von Anbieterkonfigurationen für Claude Code, Codex, Gemini CLI, OpenCode und andere Coding-Tools. Sie enthält mehr als 90 Anbieter-Presets und unterstützt benutzerdefinierte Anbieter.

Die App ist mehr als ein einfacher Schlüssel-Umschalter:

• Direktmodus ändert die Schlüssel-Felder in der Konfigurationsdatei des Clients; anschließend kommuniziert der Client direkt mit dem Anbieter.
• Routing-Modus betreibt ein lokales Gateway unter 127.0.0.1:15721 und bietet Formatkonvertierung für APIs, Failover, Zustandsprüfungen und Anfrageprotokolle.
• Aggregationsmodus führt Modelle mehrerer Anbieter in einer gemeinsamen /model-Liste zusammen.

Das Repository und das Benutzerhandbuch findest du unter github.com/farion1231/cc-switch. Nur ccswitch.io und die GitHub-Releases-Seite sind offizielle Downloadquellen; Websites, die nach einer Zahlung oder Kontodaten fragen, sind es nicht.

Vor dem Start

Du brauchst drei Dinge:

• Claude Code muss installiert und im Terminal ausführbar sein. Prüfe das mit claude --version. Falls es fehlt, verwende das offizielle Installationsprogramm: curl -fsSL https://claude.ai/install.sh | bash oder npm i -g @anthropic-ai/claude-code mit Node.js 22 oder neuer.
• Ein AIHubMix-Konto und einen API-Schlüssel. Erstelle einen in der AIHubMix-Konsole. Der Schlüssel beginnt normalerweise mit sk-.
• Ein CC Switch-Installationsprogramm. Lade es von ccswitch.io oder den GitHub-Releases herunter.

Schritt 1: CC Switch installieren

Beim ersten Start importiert CC Switch die bestehende Claude Code-Konfiguration als Anbieter namens default und fügt einen offiziellen Anbieter hinzu. Deine ursprüngliche Konfiguration geht nicht verloren; du kannst jederzeit zurückwechseln.

Falls Claude Code noch nicht installiert ist, kannst du es über die Seite Apps in CC Switch installieren oder aktualisieren.

Schritt 2: Einen AIHubMix-API-Schlüssel erstellen

Öffne die AIHubMix-Seite für API-Schlüssel, erstelle einen Schlüssel und kopiere ihn.

Der Platzhalter AIHUBMIX_API_KEY in der Dokumentation ist kein echter Schlüssel. Wenn du ihn unverändert einfügst, schlägt die Anfrage mit 401 invalid key: AIHUBMIX_API_KEY fehl.

Schritt 3: AIHubMix zu Claude Code hinzufügen

1. Wähle in der linken Seitenleiste Claude Code aus.
2. Klicke oben rechts auf die Schaltfläche +.
3. Suche nach AiHubMix oder suche in der Kategorie für Drittanbieterplattformen danach.
4. Name und Endpunkt werden automatisch eingetragen: https://aihubmix.com. Füge deinen Schlüssel unter API Key ein.
5. Klicke auf Hinzufügen.

Das Preset speichert zwei Umgebungsvariablen:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

Das Preset legt kein Modell fest. In der AIHubMix-Anleitung wird ANTHROPIC_MODEL als zentrale Variable behandelt. Ergänze sie daher vor dem Wechsel im selben env-Block:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Ohne Modell sendet Claude Code seine eigene Standard-Modell-ID, die möglicherweise nicht zu den von AIHubMix angebotenen Modellen gehört.

Zwei Details solltest du beachten.

Hänge nicht /v1 an die Basis-URL an. Claude Code verwendet das Anthropic-Messages-Protokoll und erstellt den Anfragepfad selbst. https://aihubmix.com ist korrekt; https://aihubmix.com/v1 ist die OpenAI-kompatible Basis-URL für andere Clients. Claude Code würde daran sein eigenes /v1/messages anhängen.

Das Preset verwendet ANTHROPIC_API_KEY, während die Claude-Code-Anleitung von AIHubMix ANTHROPIC_AUTH_TOKEN verwendet. AIHubMix akzeptiert beides: ANTHROPIC_AUTH_TOKEN sendet einen Bearer-Header, während ANTHROPIC_API_KEY x-api-key sendet. Wähle eine der beiden Variablen. Trage nicht unterschiedliche Werte in beide ein. Details zur Einrichtung mit AIHubMix, Modell-IDs und Fehler findest du in der Claude-Code-Dokumentation von AIHubMix.

Falls das Preset fehlt – etwa in einer älteren Version oder nachdem du die Karte gelöscht hast –, wähle Benutzerdefinierte Konfiguration und füge das obige JSON ein. Mit der Endpunktverwaltung der Anbieterkarte kannst du die Latenz testen. Das Preset enthält außerdem https://api.aihubmix.com als alternativen Endpunkt, falls aihubmix.com nicht aufgelöst werden kann.

Schritt 4: Wechseln und überprüfen

Klicke im Tab Direkt auf der AiHubMix-Karte auf Wechseln. Sobald die Konfiguration geschrieben wurde, ändert sich die Schaltfläche zu In Verwendung.

Claude Code lädt die Konfiguration automatisch neu; normalerweise ist kein Neustart erforderlich. Falls die aktuelle Sitzung weiterhin den alten Anbieter verwendet, beende sie und starte sie erneut.

Überprüfe den gesamten Ablauf:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

Eine Antwort mit 2 bedeutet, dass die Anfrage AIHubMix erreicht hat. In einer interaktiven Sitzung sollte die Zeile Anthropic base URL unter /status https://aihubmix.com anzeigen.

Für schnelle Wechsel kannst du die Taskleistenleiste verwenden: Klicke mit der rechten Maustaste auf das CC Switch-Symbol, öffne das Untermenü Claude Code und klicke auf einen Anbieter. Im Titel des Untermenüs stehen der aktive Anbieter und eine Kontingentübersicht.

Um zum offiziellen Anbieter zurückzukehren, wechsle zu Claude Official, starte Claude Code neu und schließe den Anmeldevorgang ab.

Was beim Wechsel tatsächlich geändert wird

Im Direktmodus ersetzt CC Switch in ~/.claude/settings.json nur die Verbindungs- und Kompatibilitätsfelder: ANTHROPIC_*, AWS_*, Protokollauswahlvariablen wie CLAUDE_CODE_USE_BEDROCK, model, apiKeyHelper sowie einige anbieterspezifische Kompatibilitätsoptionen wie CLAUDE_CODE_DISABLE_ARTIFACT und das Kontextfenster.

permissions, hooks, enabledPlugins, statusLine, die MCP-Konfiguration, Kommentare und alle anderen Ergänzungen bleiben erhalten. Die genaue Liste findest du in der Referenz zu Konfigurationsdateien.

Vor der ersten Änderung an der Konfiguration eines Tools sichert CC Switch das Original unter ~/.cc-switch/backups/live-first-write/. Ist das JSON fehlerhaft formatiert, verweigert die App das Schreiben, meldet Zeile und Spalte und lässt die Datei unverändert.

Die Falle: veraltete ANTHROPIC_*-Variablen

Dieser Fehler sieht so aus, als hätte CC Switch nicht funktioniert.

Falls du zuvor einer manuellen Einrichtungsanleitung gefolgt bist und export ANTHROPIC_BASE_URL=... oder export ANTHROPIC_AUTH_TOKEN=... zu ~/.zshrc oder ~/.bash_profile hinzugefügt hast, können diese Variablen die von CC Switch geschriebenen Werte überschreiben. Du wechselst die Karte zu AIHubMix, aber die Anfragen gehen weiterhin an den alten Endpunkt.

CC Switch erkennt den Konflikt. Oben im Fenster erscheint ein gelbes Banner, das darauf hinweist, dass Umgebungsvariablen deine Konfiguration überschreiben können. Unter „Details“ werden der Variablenname, der Wert und die Quelle angezeigt. Mit Ausgewählte löschen werden die Variablen entfernt; zuvor wird eine Sicherung unter ~/.cc-switch/backups/env-backup-<timestamp>.json angelegt.

So prüfst du es manuell:

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Kommentiere die alten Exporte aus und führe dann source ~/.zshrc aus oder öffne ein neues Terminal. In der eigenen Dokumentation empfiehlt AIHubMix, globale ANTHROPIC_*-Variablen zu entfernen, wenn CC Switch die Konfiguration verwaltet. Den vollständigen Ablauf zur Behebung von Konflikten findest du in der Referenz zu Umgebungsvariablen.

Modell-Aliasse und Wechsel

Wenn ANTHROPIC_MODEL gesetzt ist, verwendet Claude Code standardmäßig Sonnet 5.5. Die Aliasse von /model (opus, sonnet, haiku, fable) müssen weiterhin zugeordnet werden, wenn sie auf die Modell-IDs von AIHubMix verweisen sollen. Füge die folgenden Schlüssel unter env hinzu:

Die vollständige Anbieterkonfiguration sieht dann so aus:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

Priorität bei der Modellauswahl, absteigend: /model <name> → claude --model <name> → ANTHROPIC_MODEL → das Feld model in settings.json. Modell-IDs findest du in der AIHubMix-Modellliste; bei ihnen wird zwischen Groß- und Kleinschreibung unterschieden.

Wann Routing oder Aggregation sinnvoll ist

Für AIHubMix ist der Direktmodus die richtige Standardeinstellung. Der Endpunkt unterstützt bereits Anthropic Messages; eine Protokollkonvertierung ist daher nicht erforderlich.

Verwende Routing, wenn du eine Failover-Warteschlange möchtest oder einen Anbieter mit OpenAI-Format über Claude Code nutzen musst. Beim Routing wird Claude Code auf http://127.0.0.1:15721 ausgerichtet, der Schlüssel in der Konfiguration durch PROXY_MANAGED ersetzt und der echte Schlüssel von CC Switch eingefügt. Die App muss dabei geöffnet bleiben; beim Beenden von CC Switch wird die direkte Konfiguration wiederhergestellt. Offizielle Claude-Abonnements laufen nicht über das Routing; verwende dafür den Direktmodus.

Nutzen Sie Aggregation, wenn Sie Modelle mehrerer Anbieter in einer /model-Liste verwenden möchten. Der Standardanbieter verarbeitet Anfragen ohne Präfix; die Modelle anderer Anbieter werden mit dem Präfix ccs- angezeigt. Bei der Aggregation gibt es kein Failover. Sie ist nur für Claude Code und Codex verfügbar; offizielle Claude-Abonnements werden bei der Aggregation nicht unterstützt. Für die ccs--Modellliste ist Claude Code 2.1.243 oder neuer erforderlich. Claude Code übernimmt Änderungen an der Modellliste sofort; Codex muss vollständig neu gestartet werden.

Was CC Switch sonst noch verwaltet

• Nutzung: Das Dashboard kombiniert weitergeleitete Anfragen mit lokalen Sitzungsprotokollen. Sitzungen können auch ohne Weiterleitung erfasst werden; ihre Kosten werden anhand des im Protokoll vermerkten Modells berechnet. Weitergeleitete Anfragen werden separat protokolliert.
• MCP: ein zentrales Panel für MCP-Server, synchronisiert mit den von Ihnen ausgewählten Apps.
• Skills: Skills zentral suchen, installieren und entfernen.
• Sitzungen: lokale Sitzungen durchsuchen, ansehen, exportieren und fortsetzen.
• Projekte: Speichern Sie den Anbieter, die MCP-Server, Skills und Memory-Dateien eines Projekts als Snapshot und wechseln Sie dann für jedes Projekt zum gesamten Satz.

Die Daten liegen in ~/.cc-switch/; im Zentrum steht eine SQLite-Datenbank. Automatische Backups behalten standardmäßig die 10 neuesten. Außerdem ist eine Synchronisierung über WebDAV oder S3-kompatible Dienste verfügbar. Die Datenbank und exportierte Backups enthalten Anbieter-Konfigurationen einschließlich API-Schlüsseln und müssen daher wie Geheimnisse behandelt werden.

Fehlerbehebung

Die folgenden Fehlermeldungen sind der Claude-Code-Dokumentation von AIHubMix entnommen.

Bei Symptomen, die keine Fehler sind:

• Anmeldebildschirm oder Not logged in: Prüfen Sie /status; aktivieren Sie unter Settings → App config → Claude Code die Option Skip Claude Code first-run confirmation; starten Sie Claude Code neu und vergewissern Sie sich, dass der Schlüssel eingetragen ist.
• Der Wechsel hat keine Wirkung: Eine veraltete Shell-Variable oder eine zwischengespeicherte Sitzung ist die Ursache. Öffnen Sie ein neues Terminal oder starten Sie Claude Code neu.
• Der Verbindungstest der Karte ist erfolgreich, aber Anfragen schlagen fehl: Der Test prüft die Erreichbarkeit, nicht den Schlüssel oder das Modell. Führen Sie den Ende-zu-Ende-Befehl claude -p aus.
• Sie möchten zum offiziellen Anbieter zurückkehren: Wechseln Sie zu Claude Official, starten Sie Claude Code neu und melden Sie sich erneut an.

Wenn der Befehl claude unter macOS nicht gefunden wird, legt das offizielle Installationsprogramm ihn normalerweise unter ~/.local/bin/claude ab. Fügen Sie export PATH="$HOME/.local/bin:$PATH" zu Ihrem Shell-Profil hinzu und öffnen Sie ein neues Terminal.

Checkliste

• [ ] CC Switch von ccswitch.io oder über GitHub Releases installieren.
• [ ] In der AIHubMix-Konsole einen API-Schlüssel erstellen.
• [ ] In Claude Code → + → AiHubMix → Schlüssel einfügen → Add.
• [ ] ANTHROPIC_MODEL=claude-sonnet-5-5 zur JSON-Konfiguration des Anbieters hinzufügen.
• [ ] Auf Switch klicken und bestätigen, dass auf der Karte In use angezeigt wird.
• [ ] Veraltete ANTHROPIC_*-Exporte aus dem Shell-Profil entfernen.
• [ ] claude -p "1+1, output only the answer" --model claude-sonnet-5-5 ausführen und prüfen, ob 2 zurückgegeben wird.

Wenn der letzte Befehl 2 zurückgibt, ist der Anbieterwechsel abgeschlossen. Als Nächstes müssen Sie nur noch gewünschte Modell-Aliasse hinzufügen und entscheiden, ob Sie Weiterleitung oder Aggregation benötigen. Für die meisten AIHubMix-Nutzer reicht der Direktmodus aus.

FAQ

Ist CC Switch kostenlos?
Ja. Die Software ist Open Source und steht unter der MIT-Lizenz. Sie zahlen nur für den Anbieter, dessen API Sie verwenden.

Werden meine Hooks, MCP-Server oder Plugins beim Wechsel gelöscht?
Nein. Beim direkten Wechsel werden der Endpunkt, der Schlüssel, das Modell und einige anbieterspezifische Optionen ersetzt. Hooks, Berechtigungen, MCP-Server, Plugins und Statusleisten-Einstellungen bleiben in der Datei erhalten.

Lädt CC Switch meinen API-Schlüssel hoch?
Anbieter-Konfigurationen werden lokal in ~/.cc-switch/cc-switch.db gespeichert. Wenn Sie die Synchronisierung über WebDAV oder S3 aktivieren, werden sie mit einem Speicher synchronisiert, den Sie selbst kontrollieren. Datenbanken und Backups enthalten Schlüssel und müssen daher wie Geheimnisse behandelt werden.

Muss CC Switch ständig laufen?
Im Direktmodus nicht. Weiterleitung und Aggregation setzen voraus, dass die App läuft. Wenn Sie CC Switch beenden, kehrt der Client zum Direktmodus zurück.

Kann ich Claude Official und AIHubMix gleichzeitig verwenden?
Im Direktmodus ist jeweils nur ein Anbieter aktiv. Durch Aggregation können die Modelle mehrerer Anbieter in einer Liste erscheinen, aber offizielle Claude-Abonnements werden dabei nicht unterstützt. Wechseln Sie zurück zum Direktmodus, um sie zu nutzen.

Funktioniert es unter Windows?
Ja. CC Switch unterstützt Windows 10 und höher. Verfügbar sind ein .msi-Installationsprogramm und eine portable Version. Unter Linux sind glibc 2.35+ und WebKitGTK 4.1 erforderlich.

Warum zeigt die Anbieterk Karte eine funktionierende Verbindung an, während Claude Code weiterhin fehlschlägt?
Der Verbindungstest der Karte prüft, ob der Endpunkt erreichbar ist. Er überprüft weder den API-Schlüssel noch das Modell. Testen Sie den gesamten Ablauf mit dem Ende-zu-Ende-Befehl claude -p.

Quellen

• CC-Switch-Repository
• CC-Switch-Benutzerhandbuch: Anbieter hinzufügen
• CC-Switch-Benutzerhandbuch: Anbieter wechseln
• CC-Switch-Benutzerhandbuch: Konfigurationsdateien
• AIHubMix-Dokumentation: Claude Code