Claude Model Router: Wann wechselt welches Modell?

Du installierst einen Claude Model Router, siehst eine Empfehlung für ein günstigeres Modell und das Hauptgespräch verwendet weiterhin das teure. Das kann genau dem vorgesehenen Verhalten entsprechen. Entscheidend ist, an welcher Stelle der Router eingreift: im laufenden Gespräch, bei einer künftigen Sitzung, bei einer delegierten Aufgabe oder bei einer ausgehenden API-Anfrage.

Zwei ähnlich benannte Community-Projekte zeigen den Unterschied. tzachbon/claude-model-router-hook empfiehlt Modelle und steuert die Modellwahl beim Start von Subagenten; sein optionaler automatischer Wechsel für Hauptsitzungen wirkt erst bei neuen Sitzungen. musistudio/claude-code-router, kurz CCR, ist ein lokales Gateway, das Anfragen an konfigurierte Modelle und Anbieter weiterleitet. Der Repository-Inhaber gehört zur eindeutigen Identität: Hinter dem Suchbegriff „Claude Model Router“ können verschiedene Projekte stehen.

Geprüft am 7. Oktober 2026. Dieser Leitfaden vergleicht dokumentiertes Verhalten und schlägt einen Ablauf zur Bewertung vor. Die Konfigurationsbeispiele wurden mit den Quellen abgeglichen. Sie sind kein Live-Benchmark mit Modellanbietern und kein Nachweis eines Kundenprojekts von Wavect mit diesen Tools.

Was wechselt ein Claude Model Router tatsächlich?

Frage zuerst, was sich ändert, wann es sich ändert und wie du es nachweisen kannst. Eine Routing-Empfehlung, eine gespeicherte Einstellung und eine tatsächliche Modellantwort sind unterschiedliche Belege.

Wähle zuerst die Ebene, die du brauchst. Ein Team, das Dateisuchen günstiger machen möchte, benötigt womöglich nur explizite Subagentenmodelle. Mehrere Anbieter, Zugangsdaten und Ausweichmodelle pro Anfrage stellen andere Anforderungen an die Infrastruktur. Unser Vergleich von LLM-Gateways und Routern behandelt diese übergeordnete Auswahl- und Architekturentscheidung.

Kann Claude Code ohne Plugin das Modell wechseln?

Ja. Anthropics Referenz zur Modellkonfiguration dokumentiert den Startparameter, die Auswahl im laufenden Gespräch und opusplan. Dieser Alias verwendet Opus im Planungsmodus und Sonnet bei der Umsetzung. Das ist eine konkrete Regel nach Arbeitsphase, kein allgemeiner Klassifikator für jeden Prompt.

Für einen nativen Vergleichslauf startest du eine Sitzung so:

claude --model sonnet

In einer interaktiven Sitzung wählst du mit /model opus Opus oder mit /model opusplan die Regel für Planung und Umsetzung. Modellverfügbarkeit und Organisationsvorgaben gelten weiterhin. Aliasse eignen sich für einen schnellen Versuch; für reproduzierbare Vergleiche solltest du die tatsächlich aufgelöste Modellversion festhalten.

Für eine eng begrenzte delegierte Aufgabe legst du .claude/agents/repo-locator.md an. Dieses Beispiel folgt Anthropics Referenz zur Subagentenkonfiguration und ist unser Vorschlag für eine erste Rolle:

---
name: repo-locator
description: Finde Dateien und Symbole zu einer klar begrenzten Repository-Frage.
tools: Read, Glob, Grep
model: haiku
---
Finde die angefragten Dateien oder Symbole. Liefere Pfade und kurze Belege.
Bearbeite keine Dateien und leite keinen Fix ab. Melde Unklarheiten dem Hauptagenten.

Bitte Claude, repo-locator für eine konkrete Suche einzusetzen. Prüfe anschließend das tatsächliche Subagentenmodell. Ein Modellparameter im einzelnen Aufruf kann die Frontmatter-Angabe übersteuern; Organisationsvorgaben können einen Ersatz auslösen. Die Konfiguration beschreibt die gewünschte Ausführung, bestätigt aber noch nicht die tatsächliche.

Warum wechselt Claude Model Router Hook mein laufendes Modell nicht?

Für die Hauptsitzung dokumentiert das Projekt Empfehlungen oder eine Konfiguration für die nächste Sitzung. Das Changelog des Projekts beschreibt, dass Autoswitch den Standard für neue Sitzungen schreibt. Wenn du das aktuelle Gespräch umstellen möchtest, nutze das native /model.

Dasselbe Changelog dokumentiert die Änderung der Routing-Standardwerte im August 2026: Mechanische Aufgaben verwenden Haiku, während Implementierung, Fehlersuche und umfangreicheres Denken Opus mit unterschiedlichen Effort-Stufen nutzen. Ein älteres Tutorial, das für gewöhnliche Implementierung automatisch Sonnet verspricht, kann eine frühere Regel beschreiben.

Eine kleine Projektkonfiguration in .claude/model-router.json macht das Verhalten ausdrücklich:

{
  "version": 2,
  "apply_mode": "warn",
  "subagent_enforcement": "on",
  "classifier": {
    "cli_fallback": false
  }
}

Das ist unsere Konfiguration zur Bewertung, nicht die Standardeinstellung des Projekts. Sie lässt Hinweise für die Hauptsitzung und das Subagenten-Routing aktiv, deaktiviert aber den optionalen Klassifikator-Fallback über die Claude CLI. apply_mode: warn bedeutet nicht, dass Subagenten-Routing ausgeschaltet ist. Das Projekt-README dokumentiert diese getrennten Einstellungen und die Protokolldatei ~/.claude/hooks/model-router-hook.log.

Prüfe den Hook zusammen mit bereits installierten Automatisierungen. Anthropics Hook-Referenz beschreibt, wie PreToolUse Werkzeugeingaben ändern kann. Command-Hooks laufen außerdem mit den Berechtigungen deines Benutzerkontos. Prüfe installierte Befehle und vorhandene Hooks, bevor eine weitere Komponente Agentenstarts verändert.

Was ändert Claude Code Router als Proxy?

Der Weg der Anfrage ändert sich. CCR empfängt die Modellanfrage und leitet sie entsprechend seiner Konfiguration weiter. „Lokales Gateway“ beschreibt den Betriebsort dieser Komponente; der gewählte Zielanbieter bestimmt, wo die Inferenz stattfindet. Ein Cloud-Anbieter erhält weiterhin die Inhalte, die an sein Modell gesendet werden.

Die aktuelle CCR-CLI-Anleitung trennt Verwaltungszugriff und Modellzugriff: Management-Token und CCR-Client-Schlüssel sind unabhängige Zugangsdaten. Behandle den Zugriff auf die Verwaltungsoberfläche und die Berechtigung für Modellaufrufe als getrennte Entscheidungen.

Anthropics Gateway-Dokumentation erklärt, dass die Abrechnung den weitergereichten Zugangsdaten folgt. ANTHROPIC_BASE_URL allein ersetzt keine gespeicherte Anmeldung für ein Abonnement. Ein Router macht die Inferenz eines anderen Anbieters daher nicht zum Bestandteil deines Claude-Abos.

Prüfe außerdem mehr als eine erfolgreiche Begrüßung. Die offizielle Anleitung zur Gateway-Kompatibilität behandelt Streaming, Capability-Header, Anfragefelder und Cache-Marker. Fehler bei der Weiterleitung können Anfragen scheitern lassen oder erwartetes Verhalten entfernen. Teste einen vollständigen Ablauf mit Werkzeugaufruf und prüfe Route und Verbrauch, bevor du einer Anbieterkombination vertraust.

Warum kann ein günstigeres Claude-Modell die Aufgabe verteuern?

Ein Modellwechsel kann günstige Cache-Lesezugriffe durch einen neuen Cache-Schreibvorgang ersetzen. Anthropics Cookbook zur API-Kostenoptimierung erklärt, dass Caches an das Modell gebunden sind und ein Subagent mit einem frischen Präfix startet. Der übergebene Gesprächsverlauf überträgt nicht zugleich den Cache des Hauptmodells.

Stell dir eine lange Fehlersuche vor, auf die eine kleine Formatierungsaufgabe folgt. Den gesamten Untersuchungsverlauf an ein günstigeres Modell zu schicken, kann teurer sein, als das Ergebnis dort zu formatieren, wo der Cache bereits warm ist. Eine weitere Möglichkeit wäre, nur einen kurzen, eigenständig verständlichen Ausschnitt zu delegieren. Vergleiche beide Varianten anhand desselben abgenommenen Ergebnisses, statt den niedrigeren Tokenpreis automatisch gewinnen zu lassen.

Auch Effort verlangt Aufmerksamkeit. Die Referenz zum Prompt-Caching unterscheidet zwischen Effort-Änderungen auf Anfrageebene, die gecachte Nachrichtenblöcke ungültig machen, und unterstützten Änderungen pro Nachricht, die das frühere Präfix erhalten. „Gleiches Modell“ bedeutet nicht automatisch „gleicher Cache“.

Unsere Bewertungsregel: Erfasse Klassifikation, Generierung, Cache-Schreibvorgänge, weitere Versuche und manuelle Korrekturen für die gesamte Aufgabe. Wechsle an einem sinnvollen Arbeitsschritt, sofern gemessene Qualität oder Gesamtkosten keinen weiteren Wechsel rechtfertigen. Ein pauschaler Einsparungsprozentsatz sagt wenig über deinen eigenen Aufgabenmix aus.

Fehlersuche beim Claude Model Router

Die Prüfpunkte folgen den oben verlinkten Schnittstellen für native Konfiguration, Subagenten und Gateways. Halte das beobachtete Verhalten fest, bevor du mehrere Einstellungen gleichzeitig änderst.

Wie sollte ein Team automatisches Modell-Routing bewerten?

1. Einen Aufgabentyp auswählen. Dateisuchen, begrenzte Änderungen und unklare Fehlerursachen getrennt betrachten und jeweils eine Abnahmeprüfung definieren.
2. Einen nativen Ausgangswert erfassen. Repository-Stand und Aufgabenbeschreibung konstant halten. Tatsächliche Modelle, Bearbeitungszeit und Korrekturaufwand protokollieren.
3. Eine Ebene verändern. Explizite Subagentenmodelle mit Hook-Routing vergleichen, bevor zusätzlich Anbieterwechsel in denselben Versuch kommen.
4. Ausnahmen prüfen. Einen expliziten Modellparameter, eine unklare Anfrage, eine lange Sitzung mit warmem Cache und einen Anbieterausfall in der Testumgebung einbeziehen.
5. Belege behalten. Routing-Gründe, tatsächliche Modelle, Verbrauch und Abnahmeergebnisse speichern. Nach Client-, Plugin- oder Modellupdates erneut prüfen.

Beginne mit einem Ablauf, bei dem Fehler gut erkennbar sind. Erweitere den Einsatz, sobald die geroutete Variante das Qualitätsziel erreicht und Gesamtkosten oder Bearbeitungszeit verbessert. Für eigene Agentenschleifen behandelt unser Leitfaden zum LiteAgents-Routing die SDK-Ebene. Unser Leitfaden zur OpenAI Decisions API erklärt Klassifikatorergebnisse und Fallback-Regeln, wenn deine Anwendung die Entscheidung steuert.