Claude Code Router: Claude Code mit anderen Modellen ausführen (und wann ein Gateway einfacher ist)

Was Claude Code Router leistet

Claude Code Router von musistudio, häufig als CCR abgekürzt, beschreibt sich selbst als „lokales Modell-Gateway und Steuerungsebene für Coding-Agenten“. Es stellt einen stabilen lokalen Endpunkt für Claude Code und andere Clients bereit, mit Anbieterzugangsdaten, Routing-Regeln, Wiederholungsversuchen, geordneten Fallbacks und Anfrageprotokollen.

Das v3.1.1 README führt die Unterstützung für die Formate OpenAI Chat und Responses, Anthropic Messages sowie Gemini Generate Content und Interactions auf. Die Protokollanpassung ermöglicht es, Claude Code über CCR mit anderen Modellen zu betreiben.

CCR steht unter der MIT-Lizenz, mit einem musistudio-Copyright aus dem Jahr 2025, und wird „WIE BESEHEN“ bereitgestellt. Die Erlaubnis zur Nutzung der Software macht die Inferenz bei den vorgeschalteten Anbietern nicht kostenlos. Anbietergebühren und Nutzungskontingente bleiben davon getrennt; frühere Anbieterpreise und die in Dollar angegebenen OpenCode Go-Kontingente wurden für dieses Veröffentlichungsdatum nicht überprüft.

Die relevante Version 3.1 von Claude Code Router

Version 3.1.1 wurde am 16. September 2026 veröffentlicht. Sie bietet einen direkt integrierten lokalen Import für OpenCode Go, macht einzelne fehlgeschlagene Gateway-Versuche sichtbar und korrigiert die nutzungsbasierte Preisberechnung für geroutete Modelle.

Die Version akzeptiert außerdem --daemon bei start und serve, behebt den Worker für Protokollinhalte in der Docker-Oberfläche und bietet Builds für macOS mit Apple Silicon und Intel, ein Windows-Installationsprogramm sowie ein Linux-AppImage. Die folgende Einrichtung verwendet die npm-Distribution und die auf v3.1.1 festgelegte Dokumentation.

CCR installieren und Claude Code verbinden

Die npm-Distribution erfordert Node.js 22 oder neuer. Der versionsgebundene CLI-Leitfaden dokumentiert diese Befehle:

npm install -g @musistudio/claude-code-router
ccr --help
ccr ui

Zum Starten, ohne einen Browser zu öffnen:

ccr ui --no-open

Die Verwaltungsoberfläche und das Modell-Gateway haben unterschiedliche Standardadressen:

Diese Rollen klar zu unterscheiden hilft bei der Prüfung, wo eine Verbindung fehlgeschlagen ist. Eine funktionierende Verwaltungsseite allein belegt nicht, dass das Modell-Gateway seine Konfiguration akzeptiert hat.

Anbieter und Client-Schlüssel hinzufügen

Öffnen Sie Anbieter → Anbieter hinzufügen, wählen Sie eine Voreinstellung oder Anderer / benutzerdefinierter API-Endpunktund geben Sie den Endpunkt sowie den API-Schlüssel ein. CCR erkennt Protokolle und Modelle; Erweiterte Einstellungen ermöglicht die manuelle Auswahl eines Protokolls.

Verwenden Sie Verbindung prüfen , um den Anbieter zu testen. Dabei wird eine echte Anfrage gesendet, die Tokens oder einen Teil des Anfragekontingents des Anbieters verbrauchen kann.

Erstellen Sie einen CCR-Client-Schlüssel bei API-Schlüssel für Modellanfragen. Dieser Schlüssel ist vom Token für die Verwaltungsoberfläche/RPC getrennt: Behandeln Sie Client-Zugriff und Verwaltungszugriff als getrennte Konfigurationselemente.

Ein Claude Code-Profil erstellen

Unter Agentenkonfigurationerstellen Sie ein aktiviertes Profil für Claude Code, wählen Sie ein Modell wie Provider/modelund speichern Sie es. Ein Profil namens „Claude Code - Work“ starten Sie mit:

ccr "Claude Code - Work"

Von der Desktop-Anwendung erzeugte Startbefehle verwenden ccr-app. Der Leitfaden für Claude Code-Profile unterscheidet zwei Geltungsbereiche:

• Nur beim Öffnen aus CCR wendet die Konfiguration auf Starts aus CCR an.
• Systemstandard wirkt sich auch auf direkte Starts von Claude Code aus.

Profile unterstützen Überschreibungen für Fable, Opus, Sonnet und Haiku. Prüfen Sie die aktive Auswahl mit /modelund prüfen Sie anschließend in CCR die Anfrageprotokolle , um die Anfragen zu sehen, die über das Gateway laufen. Halten Sie die Claude Code-Modellleitfaden griffbereit, wenn Sie diese Auswahl planen.

Routing, Wiederholungsversuche und Fallbacks konfigurieren

CCR-Routing-Regeln können request.header und request.bodyprüfen und request.body.modelumschreiben. So können Sie die Modellauswahl anhand der eingehenden Anfrage steuern, über das im Agentenprofil gewählte Modell hinaus.

Die Fallback-Konfiguration verwendet mode, modelsund retryCount. Die drei Modi sind off, retryund model-chain.

Die Unterscheidung zwischen den Voraussetzungen für einen Wiederholungsversuch und denen für einen Fallback ist wichtig. Eine Antwort, die keinen Wiederholungsversuch erlaubt, kann dennoch für ein Fallback-Ziel infrage kommen.

Prüfen, welches Modell die Anfrage tatsächlich bearbeitet hat

Eine Modellkette kann das Modell ändern, das eine Anfrage letztlich bearbeitet. CCR-Protokolle zeigen den endgültigen Anbieter und das endgültige Modell. Nutzen Sie diese Protokolle daher, wenn Sie unerwartetes Verhalten oder die Nutzung prüfen.

Beginnen Sie mit einem Profil, dessen Anbieter und Modell Sie identifizieren können. Fügen Sie Routing-Regeln und Fallback-Ziele gezielt hinzu und prüfen Sie nach deren Nutzung das endgültige Ziel. So lassen sich veränderte Antworten oder Kostenmuster leichter mit der Routing-Konfiguration in Verbindung bringen.

Version 3.1.1 macht außerdem einzelne fehlgeschlagene Gateway-Versuche sichtbar. Diese Einträge helfen dabei, eine erfolgreiche abschließende Antwort von den vorausgegangenen Versuchen zu unterscheiden.

Den OpenCode Go-Import in v3.1.1 verwenden

Die Version v3.1.1 von musistudios Claude Code Router bietet einen direkt integrierten lokalen Import für OpenCode Go. Die Integration trennt Zen, gekennzeichnet als opencode, von Go, gekennzeichnet als opencode-go, einschließlich ihrer Zugangsdaten und sich überschneidender Modell-IDs.

Der Importer liest die OpenCode-Konfiguration, auth.jsonund zwischengespeicherte Modellmetadaten. OPENCODE_API_KEY gilt für beide Dienste; OPENCODE_GO_API_KEY stellt eine Go-spezifische Überschreibung bereit. Die Erkennung filtert Modelle nach Protokoll und gleicht zwischengespeicherte Metadaten mit aktuellen /models Ergebnissen ab.

Warum der Sitzungsheader wichtig ist

Das PR zur OpenCode Go-Integration hält fest, dass Anfragen an https://opencode.ai/zen/go/v1 Folgendes erfordern: x-opencode-session. Ohne diesen Header gibt der Endpunkt Folgendes zurück: 400 MissingSessionID.

CCR wählt den Sitzungswert in dieser Reihenfolge aus: explizite Konfiguration, ein expliziter Client-Header, Claude-Sitzungsheader, metadata.user_idund schließlich ein stabiler Ersatzwert auf Prozessebene. Der Header wird nur für den offiziellen Go-Endpunkt eingefügt.

Das erklärt, warum die Eingabe eines Endpunkts und von Zugangsdaten allein für Go möglicherweise nicht ausreicht. Die Sitzungsanforderung ist Teil der Anbieterintegration.

Modellerkennung aktualisieren und Nutzungslimits ablesen

Wenn der Go-Import nicht verfügbar ist, verbinden Sie OpenCode Go in OpenCode, aktualisieren Sie dessen lokalen Modellcache und führen Sie die Erkennung in CCR erneut aus.

CCR ruft Nutzungsdaten ab von GET https://opencode.ai/zen/go/v1/usage und zeigt die verbleibenden Prozentsätze für Zeitfenster von fünf Stunden, einer Woche und einem Monat an. Die Dokumentation mit festgelegtem Versionsstand nennt keine Dollar-Kontingente. Interpretieren Sie diese Werte als verbleibende Prozentsätze für die genannten Zeitfenster; sie geben kein Geldguthaben an.

Verbindungsprobleme schrittweise beheben

Die Materialien zur Fehlerbehebung von CCR behandeln umgangenes Routing, Authentifizierungsfehler, fehlende Modelle, unerwartete Modellauswahl, Kostenspitzen, Zeitüberschreitungen und fehlende Agent-Traces. Eine hilfreiche Diagnosefolge verfolgt die Anfrage von der Startkonfiguration bis zu ihrem endgültigen Anbieter.

Claude Code umgeht CCR

Prüfen Sie, ob das gewünschte Agent Config-Profil aktiviert ist und Sie den Start über dieses Profil ausgeführt haben. Ein Profil mit der Einstellung Nur beim Öffnen aus CCR beschränkt seine Konfiguration auf Starts über CCR; direkte Starts werden beeinflusst, wenn Systemstandard ausgewählt ist.

Verwenden Sie /model und die CCR-Anfrageprotokolle gemeinsam, um die Einrichtung zu überprüfen. Die CLI-Referenz für Claude Code bietet eine umfassendere Referenz für die Arbeit mit dem Client.

Authentifizierungsfehler oder fehlende Modelle

Prüfen Sie bei 401/403-Fehlern die Zugangsdaten auf jeder relevanten Ebene: den API-Schlüssel des Anbieters, den CCR-Client-Schlüssel für Modellanfragen und das separate Verwaltungstoken. Diese Zugangsdaten erfüllen unterschiedliche Aufgaben.

Bei model not foundprüfen Sie die erkannten Modelle, das ausgewählte Protokoll und die Anbieter-/Modellauswahl des Profils. Aktualisieren Sie bei OpenCode Go den lokalen Cache und führen Sie die Erkennung erneut aus, wenn der Import nicht verfügbar ist.

Startfehler und Zeitüberschreitungen

Version 3.1.1 erhöht die Zeit für die Übernahme der Gateway-Konfiguration von fünf Sekunden auf 30 Sekunden. Das behebt Fälle, in denen die Verwaltungsoberfläche startet, das Gateway jedoch unter Last auf dem Host fehlschlägt, insbesondere unter Windows.

CCR_GATEWAY_CONFIG_TIMEOUT_MS überschreibt das Zeitlimit. Bei ungültigen Werten oder Werten unter 1,000 Millisekunden wird der Standardwert verwendet.

Die Konfiguration befindet sich in ~/.claude-code-router unter macOS/Linux und in %APPDATA%\claude-code-router unter Windows. Zu den relevanten Dateien gehören config.sqlite, die generierte gateway.config.jsonund service.json. Zu den Dienstbefehlen gehören ccr start, ccr stopund für den Vordergrund ccr serve.

Wann ein gehostetes Gateway einfacher ist

CCR eignet sich für Workflows, die lokale Anbieterverwaltung, anfragebasiertes Routing, Zugangsdaten-Pools oder explizite Fallback-Ketten benötigen. Ein gehostetes Gateway kann weniger lokale Einrichtungsschritte erfordern, wenn Ihr unmittelbares Ziel darin besteht, Claude Code mit einem Upstream-Dienst zu verbinden.

Die von OpenRouter veröffentlichte Ankündigung vom August 4, 2026 dokumentiert diese Verbindungseinstellungen:

ANTHROPIC_BASE_URL=https://openrouter.ai/api
ANTHROPIC_AUTH_TOKEN=<openrouter-api-key>
ANTHROPIC_API_KEY=

Die Ankündigung nennt außerdem zusätzliche Modell- und Funktionseinstellungen. Diese drei Variablen sind die Verbindungseinstellungen, keine vollständige Konfiguration für jedes Modell. OpenRouter weist darauf hin, dass die meisten offenen Modelle keine Werkzeugsuche unterstützen, weshalb sich die Einstellungen je nach Modell unterscheiden.

Die zugehörige Ori CLI automatisiert die Einrichtung über:

ori login
ori claude

Dieselben Workflows können auch über ein API-Gateway wie AI Prime Tech ausgeführt werden, einen unabhängigen Dienst ohne Verbindung zu Anthropic oder OpenAI; siehe die Anleitung zu Claude Code mit einem API-Schlüssel verwenden.

Treffen Sie Ihre Wahl anhand der benötigten Steuerungsmöglichkeiten. CCR bietet eine lokale Stelle, an der Sie Routen verwalten, Versuche prüfen und Fallbacks konfigurieren können; beim dokumentierten gehosteten Ansatz müssen Sie CCR nicht lokal betreiben.

Wichtige Erkenntnisse

• Claude Code Router verbindet Claude Code und andere Clients über einen stabilen lokalen Endpunkt mit Protokollanpassung mit Anbietern.
• Die npm-Distribution erfordert Node.js 22+, und die Verwaltungsoberfläche und das Modell-Gateway verwenden separate Standardports.
• Der Geltungsbereich von Agent Config bestimmt, ob ein Profil nur für Starts über CCR oder auch für direkte Starts gilt.
• Fallbacks können das ausführende Modell ändern; prüfen Sie die Anfrageprotokolle, um den endgültigen Anbieter und das endgültige Modell zu ermitteln.
• v3.1.1 ergänzt den OpenCode Go-Import mit separaten Zugangsdaten und der erforderlichen Verarbeitung des Sitzungsheaders.
• Ein gehostetes Gateway kann den lokalen Einrichtungsaufwand verringern, wenn Sie die lokalen Routing-Steuerungsmöglichkeiten von CCR nicht benötigen.

FAQ

Ist Claude Code Router kostenlos?

Claude Code Router steht unter der MIT-Lizenz, die die Nutzung der Software erlaubt. Daraus ergibt sich keine kostenlose Upstream-Inferenz, und frühere Anbieterpreise oder Dollar-Kontingente von OpenCode Go werden hier nicht überprüft.

Kann ich Claude Code über CCR mit anderen Modellen verwenden?

Ja. CCR bietet Protokollanpassung und Anbieter-/Modellauswahl, und mit seinen Claude Code-Profilen können Sie ein Modell auswählen, etwa Provider/model. Zu den unterstützten Upstream-Formaten gehören OpenAI Chat/Responses, Anthropic Messages und Gemini Generate Content/Interactions.

Was hat sich in Claude Code Router 3.1.1 geändert?

Die im September 16, 2026 veröffentlichte Version v3.1.1 ergänzt einen vollwertig unterstützten lokalen OpenCode Go-Import, die Anzeige einzelner fehlgeschlagener Versuche und korrigierte Nutzungspreise für geroutete Modelle. Außerdem erhöht sie die Zeit für die Übernahme der Gateway-Konfiguration auf 30 Sekunden und akzeptiert --daemon bei start und serve.

Warum gibt OpenCode Go MissingSessionID zurück?

Der offizielle OpenCode Go-Endpunkt erfordert den x-opencode-session Header und gibt 400 MissingSessionID zurück, wenn er fehlt. Die Go-Integration von CCR wählt anhand einer festgelegten Rangfolge einen Sitzungswert aus und fügt den Header nur für den offiziellen Go-Endpunkt ein.