claude-code-router: One local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control
Projektüberblick: Eine lokale Steuerungsebene für jeden KI-Agenten: Leiten Sie über Modelle hinweg, vereinen Sie neue Funktionen, orchestrieren Sie Tools und behalten Sie die volle Kontrolle.
Auf einen Blick
- Was ist das?
- One local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.
- Für wen ist es gedacht?
- claude-code-router passt zu Nutzern, deren Aufgabe den im README beschriebenen Rahmen trifft. Es passt nicht als Beleg für unbeschriebene Plattformen, Leistungswerte oder Supportzusagen.
- Darf ich es kommerziell nutzen?
- Ja. MIT ist eine freizügige Lizenz: Sie dürfen darauf aufbauende Software nutzen, verändern und verkaufen, solange Sie die Urheberrechts- und Lizenzhinweise beibehalten.
- Wird es noch gepflegt?
- Ja. Das Repository hat innerhalb des letzten Tages neue Commits erhalten.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich TypeScript, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 15. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Eine lokale Kontrollebene für Coding-Agenten
Claude Code Router (CCR) ist ein lokales Modell-Gateway und eine Kontrollebene für Coding-Agenten, wie im README beschrieben. Es bietet standardmäßig einen einzelnen lokalen Endpunkt auf Port 3456, während der Benutzer Anbieter, Modelle, Konten, Routing-Regeln und Werkzeuge über eine Oberfläche verwaltet. Das README listet unterstützte Agenten auf: Claude Code, Claude Design, Codex, Grok CLI, Kimi CLI, Kilo Code, OpenCode, Pi und ZCode sowie kompatible API-Clients. Auf der Anbieterseite unterstützt CCR OpenAI Chat und Responses, Anthropic Messages, Gemini Generate Content und Interactions, OpenRouter, DeepSeek, SiliconFlow, Moonshot, Kimi Code, Mistral, Z.AI, Bailian und benutzerdefinierte kompatible Anbieter. Das Projekt ist in TypeScript geschrieben, und die Repository-Metadaten zeigen 36.422 Sterne, 3.046 Forks und 1.050 offene Issues. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 1 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
Routing, Failover, Erweiterung und Beobachtbarkeit
Das README nennt fünf konkrete Vorteile. Sie können alle Agenten und Anbieter gemeinsam verwalten, anstatt für jeden Client eine separate Modellkonfiguration zu pflegen. Sie können Anbieter oder Modelle wechseln, ohne Ihren Workflow zu ändern oder Agentenkonfigurationsdateien wiederholt zu bearbeiten. CCR hält Anfragen mit Wiederholungen, Anmeldedatenpools, Schlüsselrotation und geordneten Fallback-Modellen am Laufen. Es kann bestehenden Modellen Funktionen hinzufügen, etwa Fusion-Vision, Websuche, MCP-Tools und ToolHub. Und es zeigt, was tatsächlich passiert ist, über Anforderungsprotokolle, aufgelöste Routen, Latenz, Token-Nutzung, Kostenschätzungen und Kontostatus. Laut der Tabelle der Kernfunktionen unterstützt die Routing-Ebene Bedingungen an Headern und Body, Präfixe, Umschreibungen, Wiederholungen und geordnete Fallbacks. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 2 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
Schnellstart mit der Desktop-App
Der empfohlene Weg ist die Desktop-App für macOS, Windows oder Linux. Das README gibt eine fünfstufige Abfolge: App herunterladen, Providers öffnen und einen Anbieter hinzufügen (integrierte Voreinstellung oder benutzerdefinierter Endpunkt, API-Schlüssel, Protokoll, Modelle), Server öffnen und starten, wodurch das Gateway auf http://127.0.0.1:3456 lauscht, Agent Config öffnen, um einen Agenten und ein Modell auszuwählen und das Profil anzuwenden, dann den Agenten verwenden und in den Logs den aufgelösten Anbieter, das Modell, den Status, Token, Latenz und Fehler prüfen. Die Download-Links im README verweisen auf konkrete Release-Artefakte für Windows, Linux, macOS Apple Silicon und macOS Intel. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 3 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
CLI- und Docker-Optionen
Die npm-CLI benötigt Node.js 22 oder neuer. Der Befehl `npm install -g @musistudio/claude-code-router` gefolgt von `ccr ui` startet dasselbe Gateway und eine browserbasierte Verwaltungsoberfläche ohne Electron. Die Oberfläche ist unter http://127.0.0.1:3458 erreichbar, während das Modell-Gateway auf 3456 bleibt. Das README verweist auf eine CLI-Referenz für Servicemodi, Authentifizierung und Profilbefehle. Für die Container-Bereitstellung exponiert `docker compose up -d --build` standardmäßig die Verwaltungsoberfläche und Gateway-Routen über http://127.0.0.1:3458, und das README rät, vor dem Remote-Exponieren von CCR den Docker-Bereitstellungsleitfaden zu lesen. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 4 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
Wie Anfragen durch CCR fließen
Das Diagramm im README beginnt mit allen unterstützten Agenten oben, die in den Claude Code Router auf Port 3456 münden. Im Inneren wendet der Router Profile, Routing-Regeln, Anmeldedaten, Werkzeuge und Protokolle an, bevor er den endgültigen Anbieter, das Modell und das Konto auswählt. Die Tabelle der Kernfunktionen ergänzt Details: Agenten können Profile mit Modellüberschreibungen, Bereichen, Umgebungseinstellungen, CLI- und App-Starteinträgen sowie Multi-Instanz-Workflows haben. Anbieter können Voreinstellungen oder benutzerdefinierte Endpunkte sein, mit Protokoll-Erkennung, Modell-Entdeckung, Konnektivitätsprüfungen und Anmeldedatenpools. Es gibt auch eine AgentClaw-Funktion, die Agentenverkehr über Messaging-Plattformen wie Weixin iLink, WeCom, Slack, Discord, Telegram, LINE, Feishu und DingTalk weiterleitet. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 5 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
Desktop-Apps aus dem Quellcode erstellen
Für lokale Builds verlangt das README die Installation von Node.js 22 oder neuer und die Ausführung von `npm ci`. Die Build-Befehle sind `npm run build:app:mac` für ein lokales macOS-DMG/ZIP und `npm run build:app:win` für einen Windows-NSIS-Installer, beide mit Ausgabe nach `release-local/`. Windows-Packaging muss unter Windows x64 laufen, da `better-sqlite3` ein natives Electron-Modul mitbringt. Der Release-Workflow baut macOS auf macOS-Runnern und Windows auf `windows-latest`, wenn ein `v*`-Tag gepusht wird. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 6 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
Dokumentation, Lizenz und Repository-Zustand
Die vollständige Dokumentation befindet sich auf ccrdesk.top, mit Links zu Installation, Anbieterkonfiguration, Routing und Konfiguration, CLI-Nutzung, Docker-Bereitstellung und Fehlerbehebung. Das Projekt ist unter der MIT-Lizenz lizenziert, Copyright 2025 musistudio, die das Verwenden, Kopieren, Ändern, Zusammenführen, Veröffentlichen, Verteilen, Unterlizenzieren und Verkaufen von Kopien erlaubt, sofern der Urheberrechtshinweis enthalten ist. Die Lizenz stellt keine Gewährleistung dar, wie ausdrücklich vermerkt. Das README listet außerdem Sponsoren und Spendenoptionen auf, und die Repository-Metadaten zeigen, dass das Projekt nicht archiviert ist. Das README erwähnt kein Sicherheitsaudit oder eine Garantie. Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. zugleich für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird. Abschnitt 7 bleibt auf claude-code-router bezogen und beschreibt nur die im Repository erkennbare Funktion.
Redaktionelles Fazit
claude-code-router passt zu Nutzern, deren Aufgabe den im README beschriebenen Rahmen trifft. Es passt nicht als Beleg für unbeschriebene Plattformen, Leistungswerte oder Supportzusagen. Prüfe zuerst Starte den Router mit dem dokumentierten Befehl und prüfe die Konfiguration der Provider, Modelle und Fallbacks. Entscheidend für die Einordnung sind die tatsächlichen Logs, der verwendete Endpunkt und die Frage, ob ein Request nach einem Providerfehler korrekt weitergeleitet wird.
Community-Notizen