Claude Code Router Tutorial: Claude Code mit DeepSeek, Gemini oder einem beliebigen Modell verbinden
Der Open-Source-Router bewahrt das Claude-Code-Erlebnis, schickt jede Anfrage aber an günstigere Modelle — DeepSeek, Kimi, Gemini oder ein lokales Ollama-Modell. Installation per npm, Provider-Konfiguration in der ccr-ui-Konsole, szenenbasierte Routen und ein echter Testlauf: 15 Schritte mit Screenshots.
Kurz gesagt: Was der Claude Code Router tut
- Claude Code Router (CCR) ist ein freier Open-Source-Proxy: Claude Code behält UI, Systemprompt und Tools, die Modellaufrufe gehen aber an Ihre Konfiguration — DeepSeek, Kimi K2, Gemini, OpenRouter oder ein lokales Ollama-Modell.
- Die Installation ist ein npm-Befehl (npm install -g @musistudio/claude-code-router), und die ccr-ui-Webkonsole bearbeitet ~/.claude-code-router/config.json für Sie — kein manuelles JSON-Editing nötig.
- Routing erfolgt pro Szenario: default, background, think (Reasoning für den Plan Mode), longContext (greift ab einer Schwelle von 60.000 Token automatisch) und webSearch bekommen jeweils ein eigenes Modell.
- ccr code startet eine geroutete Sitzung mit der Basis-URL http://127.0.0.1:3456; das normale claude funktioniert unverändert. Bekannte Macke: /cost bleibt bei $0 — die Ausgaben sehen Sie im Provider-Dashboard.
Claude Code Router: Use Gemini 2.5 Pro FREE API in Claude Code
Video-Walkthrough:AI With Nathan10:52
claude-code-router — official README
Produktfakten:musistudio on GitHubDocs
Schritte und Screenshots folgen dem Video; config.json-Feldnamen, Router-Rollen und Transformer-Verhalten wurden mit dem offiziellen README abgeglichen.
Die Frames sind mit Quellenangabe versehene Screenshots aus dem Video, jeweils mit Zeitstempel verlinkt. Der Text dieser Anleitung ist eigenständig — kein Transkript.
Claude Code Router einrichten, Schritt für Schritt
1 · Claude Code auf günstigere Modelle lenken
- 1
Warum Claude Code einen Router braucht
Claude Code ist an Claude-Modelle gebunden, und die sind teuer: Opus 4.1 kostet offiziell $15 pro Million Eingabe-Token und $75 pro Million Ausgabe. Das Open-Source-Projekt Claude Code Router (CCR) erhält das Claude-Code-Erlebnis, leitet jede Anfrage aber an ein Modell Ihrer Wahl weiter — DeepSeek, Kimi, Gemini oder ein lokales Ollama-Modell.
Anthropics Listenpreise vor dem Wechsel — genau diese Rechnung vermeidet CCR.Video bei 0:30 - 2
Claude Code installieren, dann den Router
CCR setzt ein installiertes Claude Code voraus: npm install -g @anthropic-ai/claude-code. Danach der Router: npm install -g @musistudio/claude-code-router. Ihre Provider-Konfiguration liegt später in ~/.claude-code-router/config.json.
Die beiden npm-Installationen aus dem offiziellen README — der Router ersetzt Claude Code nie.Video bei 3:36 - 3
npm die globale Installation abschließen lassen
npm zieht die Abhängigkeiten des Routers (eine node-domexception-Deprecation-Warnung ist normal). Anschließend steht der ccr-Befehl überall zur Verfügung.
npm lädt Pakete während der globalen Installation von @musistudio/claude-code-router.Video bei 3:49
2 · Provider in der ccr-ui-Konsole hinzufügen
- 4
Die Konfig-Konsole mit ccr ui öffnen
Statt JSON von Hand zu bearbeiten: ccr ui ausführen. Ein Browser-Tab öffnet 127.0.0.1:3456 — links verwalten Sie Provider, rechts weist der Router-Abschnitt Modellen Szenarien zu, darunter sitzen die Custom Transformers.
Erster Start der ccr-ui-Konsole — Provider leer, Router-Slots warten.Video bei 4:08 - 5
Provider aus einer Vorlage hinzufügen
Auf Add Provider klicken und eine Vorlage wählen — das Video nutzt OpenRouter; Vorlagen gibt es auch für deepseek, gemini, dashscope, modelscope, siliconflow und volcengine. Die Vorlage füllt API-URL und eine Standard-Modellliste automatisch, der Transformer darf leer bleiben.
Provider-Vorlagen in ccr ui — auswählen, und URL plus Modelle füllen sich von selbst.Video bei 4:30 - 6
API-Key einfügen und Modelle wählen
Wirklich wichtig sind drei Felder: die API-URL (bereits vorausgefüllt), der Secret Key und die Modellliste. Das Video fügt unter OpenRouter DeepSeek R1 und Kimi K2 hinzu und speichert — der Provider erscheint im linken Panel, bereit zum Zuweisen.
Das Edit-Provider-Formular: URL, Key, Modelle — alles andere darf Standard bleiben.Video bei 4:53 - 7
Transformer die API-Unterschiede lösen lassen
Transformer schreiben Request- und Response-Payloads um, damit Drittanbieter-APIs mit Claude Code kompatibel bleiben. CCR liefert sinnvolle Standardwerte mit — etwa einen deepseek-Transformer für api.deepseek.com und einen tooluse-Transformer für deepseek-chat — ein eigener ist selten nötig.
Globale und modellspezifische Transformer-Beispiele aus dem README, inklusive der DeepSeek-Voreinstellung.Video bei 3:54 - 8
Einen kostenlosen Gemini-Key für Reasoning hinzufügen
Zweiten Provider über die Gemini-Vorlage anlegen und in Google AI Studio einen kostenlosen API-Key erstellen (Get API key → Create API key). Einfügen, speichern — gleich weisen Sie diesen Provider den Slots für Thinking, langen Kontext und Websuche zu.
Der kostenlose Gemini-API-Key wird in Google AI Studio erstellt.Video bei 5:45
3 · Die Routing-Regeln festlegen
- 9
Die fünf Router-Rollen verstehen
default übernimmt allgemeine Aufgaben (und alles, was Sie nicht zuweisen). background erledigt Hintergrundjobs — hier spart ein kleines oder lokales Modell Kosten. think stemmt Reasoning-lastige Arbeit wie den Plan Mode. longContext greift automatisch ab longContextThreshold (Standard: 60.000 Token), und webSearch braucht ein Modell mit dieser Funktion — bei OpenRouter hängen Sie :online an den Modellnamen. /model wechselt auch mitten in der Sitzung.
Das Router-Objekt im README: alle Rollen, die 60K-Schwelle und der :online-Suffix.Video bei 1:06 - 10
Jedem Szenario ein Modell zuweisen
Im Router-Abschnitt aus den Modellen Ihrer gespeicherten Provider wählen: Das Video setzt DeepSeek R1 als default, Kimi K2 für den Alltag, Gemini 2.5 Pro (1M Kontextfenster) für longContext und das schnelle Gemini Flash für webSearch. Oben rechts Save and Restart drücken.
Der Default-Slot wird mit deepseek/deepseek-r1-0528 aus dem gespeicherten Provider gefüllt.Video bei 5:15 - 11
Die geroutete Sitzung mit ccr code starten
Im Terminal ccr code ausführen. Der Claude-Code-Begrüßungsbildschirm listet Overrides (via env) — API Base URL http://127.0.0.1:3456 — und beweist so, dass Anfragen durch den Router laufen. Der einfache claude-Befehl startet weiterhin eine ungeleitete Sitzung, kein Deinstallieren nötig.
Der Overrides-Block auf dem Begrüßungsbildschirm: Der Traffic läuft durch CCRs lokalen Proxy.Video bei 6:45
4 · Echte Aufgabe ausführen und prüfen
- 12
Ihm eine echte Coding-Aufgabe geben
Wie gewohnt prompten — das Video verlangt ein Neon-Breakout-Spiel mit modernen Animationen. Claude Code plant eine Todo-Liste und arbeitet sie über die gerouteten Modelle ab. Kosmetische Macken sind möglich: Der Input-Token-Zähler kann auf null stehen bleiben.
Claude Code arbeitet seine Todo-Liste ab, während CCR die Modellaufrufe leitet.Video bei 7:06 - 13
Das fertige Ergebnis prüfen
Der Agent schließt mit einer Funktionszusammenfassung — Visuelle Effekte, Responsive Design, Steuerung, Spielmechanik — und die Dateien landen im Projekt (index.html, style.css, script.js). HTML im Browser öffnen und selbst testen.
Claude Codes Abschlussbericht zum Neon-Breakout-Spiel.Video bei 7:30 - 14
Die echte Nutzung im Provider-Dashboard prüfen
OpenRouters Your Activity-Seite ist die wahre Quelle: Sie zeigt die gerouteten Aufrufe — wiederholte Kimi-K2-Requests und den DeepSeek-Aufruf — mit Tokenzahlen und Ausgaben. So bestätigen Sie, dass CCR wirklich die günstigeren Modelle nutzt.
OpenRouter-Nutzung nach der Sitzung: Die gerouteten Modelle erscheinen mit echten Request-Zählern.Video bei 7:45 - 15
Die Schwächen kennen, bevor Sie sich darauf verlassen
/cost meldet in einer gerouteten Sitzung $0.0000, und die Nutzung nach Modellen zeigt claude-sonnet mit Nullen — die Kostenabrechnung ist noch nicht an externe Provider angebunden. Das Routing selbst funktioniert; die Ausgaben sehen Sie vorerst im Provider-Dashboard.
Die bekannte /cost-Lücke in gerouteten Sitzungen — Provider-Dashboards sind Ihr echter Zähler.Video bei 9:25