Claude Code Advisor: Sonnet + Opus einrichten und prüfen

Nutze den Advisor in Claude Code, damit Sonnet Routinecode schreibt und Opus schwierige Entscheidungen prüft. Starte mit claude --model sonnet --advisor opus und prüfe den Eintrag Advising samt Ergebnis, bevor du dich auf die Beratung verlässt. Das Modell entscheidet über die Aufrufe. Sie verbrauchen zusätzliche Tokens und können ausbleiben, nachdem ein Gateway das Tool abgelehnt hat.

Stand 2026-11-06 ist die Advisor-Funktion experimentell. Die Beispiele setzen eine installierte CLI, funktionierende Authentifizierung und eine erfolgreiche normale Anfrage direkt über Anthropic voraus. Diesen Zugang können sowohl Konten mit Abonnement als auch Konten mit API-Abrechnung nutzen. Die Unterstützung durch ein Gateway musst du gesondert prüfen.

Wann eignet sich der Advisor besser als ein anderes Modell?

Wähle den Advisor für ein Refactoring, einen wiederkehrenden Fehler oder eine Implementierung mit gelegentlich schwierigen Entscheidungen. Sonnet bearbeitet die Aufgabe. Bei einer Beratung prüft ein zweites Modell den Gesprächsverlauf einschließlich der Tool-Aufrufe und ihrer Ergebnisse.

Diese Aufteilung beschreibt Anthropic in seiner Advisor-Strategie. Sie garantiert weder bei jeder Aufgabe Ergebnisse auf Opus-Niveau noch eine feste Kostenersparnis.

Dein Bedarf	Passende Wahl	Was sich ändert
Gelegentliche Beratung während der Ausführung	Advisor	Claude entscheidet, wann es ein anderes Modell konsultiert
Planung mit Opus, danach Implementierung mit Sonnet	`opusplan`	Der Planungsmodus nutzt Opus, sofern der Modellzugriff erlaubt ist; Sonnet übernimmt die Ausführung
Eine separate Recherche oder Prüfung	Ein Subagent mit gewähltem `model`	Das gewählte Modell bearbeitet die delegierte Aufgabe
Stärkere Analyse bei folgenden Anfragen der Hauptsitzung	`/model`	Du wechselst das Hauptmodell

Beginne bei einer kurzen Aufgabe mit wenig Planungsbedarf ohne Advisor. Brauchst du Opus bei nahezu jedem Schritt, wechsle die Hauptsitzung zu Opus 5.5.

Der Startbefehl erzeugt keine drei Haiku-Subagenten für Suche, grep und Dokumentation. Nutze dafür separat die dokumentierte Modellkonfiguration für Subagenten. Die dokumentierte CLI-Option lautet --agents und erwartet JSON. Ersetze sie nicht durch den kursierenden Befehl --subagents haiku.

Advisor auf drei Arten aktivieren

Nutze beim ersten Versuch die Startoption, damit deine gespeicherte Advisor-Auswahl unverändert bleibt. Prüfe zunächst die Client-Version in Bash:

claude --version

Für dieses Beispiel mit Sonnet 5.5 und Opus 5.5 brauchst du 2.1.284 oder neuer. Diese Mindestversion ergibt sich aus den Modellanforderungen. Sie bezeichnet nicht die erste Version der Advisor-Funktion. Der dokumentierte Befehl zum Aktualisieren der CLI lautet claude update.

Für eine Sitzung: —advisor verwenden

Führe diesen Befehl in Bash aus dem Projektverzeichnis aus:

claude --model sonnet --advisor opus

Bei aktuellen Konfigurationen mit direktem Anthropic-Zugang stehen diese Aliase am 2026-11-06 für Sonnet 5.5 und Opus 5.5. Die Zuordnungen können sich ändern oder durch Einstellungen überschrieben werden. Gib die vollständigen Modell-IDs an, um die Versionen ausdrücklich festzulegen:

claude --model claude-sonnet-5-5 --advisor claude-opus-5-5

Die Startoption hat in dieser Sitzung Vorrang vor advisorModel. Laut Advisor-Dokumentation ist es normal, dass --advisor nicht in claude --help erscheint.

Während einer Sitzung: /advisor verwenden

Gib innerhalb von Claude Code Folgendes ein:

/advisor opus

Die Bestätigung zeigt Advisor set to, gefolgt vom Modellnamen. Mit /advisor ohne Argument öffnest du die Modellauswahl.

In einer lokalen Terminalsitzung wird die Auswahl normalerweise als Standard gespeichert. Für das Speichern in Remote-Sitzungen gelten eigene Regeln in der Einstellungsreferenz.

Für künftige Sitzungen: advisorModel setzen

Ergänze diese Eigenschaft in deinen Benutzereinstellungen unter ~/.claude/settings.json:

{
  "advisorModel": "opus"
}

Behalte die übrigen Einstellungen der Datei bei. Diese Eigenschaft wählt den Advisor aus; sie legt Sonnet nicht als Hauptmodell fest.

Achte nach dem Aktivieren auf diese Meldung:

Advisor Tool (experimental) is on and may use more tokens · /advisor

Die Meldung bestätigt die Aktivierung. Sie beweist noch nicht, dass eine Beratung stattgefunden hat.

Welche Modellpaare funktionieren?

Wähle einen Advisor, den Claude Code mindestens so hoch einstuft wie das Hauptmodell. Die folgenden ausgewählten Paare stammen aus der aktuellen Kompatibilitätstabelle, geprüft am 2026-11-06.

Hauptmodell	Advisor	Einsatzzweck
Sonnet 5.5	Opus 5.5	Routineimplementierung mit Prüfung durch ein stärkeres Modell
Haiku 5.5	Opus 5.5	Ein leichteres Hauptmodell mit gründlicher Beratung
Sonnet 5.5	Sonnet 5.5	Eine zweite Prüfung mit demselben Modell
Opus 5.5	Opus 5.5	Eine zweite Prüfung durch Opus
Opus 4.7 oder Opus 4.8	Sonnet 5.5	Ein dokumentiertes Paar aus unterschiedlichen Modellfamilien

Haiku 5.5 als Hauptmodell oder Advisor erfordert 2.1.293 oder neuer. Sonnet 5.5 als Advisor für Opus 4.7 oder Opus 4.8 erfordert 2.1.287 oder neuer. Haiku 4.5 kann Beratung anfordern, aber nicht selbst als Advisor dienen.

Diese Kombinationen sind zulässig. Sie sind keine garantierte Qualitätsrangfolge für dein Repository. Die Liste erlaubter Modelle availableModels deiner Organisation kann eine Auswahl weiterhin sperren. Eine gesperrte oder ungeeignete Auswahl für --advisor kann den interaktiven Start mit einem Fehler abbrechen. Bei einem niedriger eingestuften Advisor oder einer unbekannten Modell-ID kann die Hauptsitzung ohne Advisor weiterlaufen.

Subagenten übernehmen die Advisor-Konfiguration und prüfen das Paar anhand ihres eigenen Modells. Berücksichtige ihre möglichen Beratungen, wenn du den Gesamtverbrauch bewertest.

Wie weist du einen Advisor-Aufruf nach?

Nutze das Tool-Protokoll als Beleg und prüfe anschließend den Verbrauch. Eine Startmeldung oder Claudes Aussage, es habe Opus konsultiert, reicht nicht aus.

Probiere diesen Prompt ohne Dateiänderungen in einem Repository aus, das du kennst. Er fordert eine Prüfung der Authentifizierung und einen kleinen Refactoring-Vorschlag:

Inspect this repository's authentication flow without changing files.
Propose one small refactor and identify its main regression risk.
Consult the advisor before presenting the plan.
Include the tests that would check the proposed change.

Das ist ein vorgeschlagener Test, kein garantierter Aufruf. Claude bestimmt den Zeitpunkt. Planung, wiederkehrende Fehler und Abschlussprüfungen sind häufige Anlässe, aber keine drei festgelegten Auslöser.

Es gibt keine Advisor-Einstellung in Claude Code, die Aufrufe erzwingt oder ihre Anzahl begrenzt. Anweisungen im Prompt oder in CLAUDE.md können um mehr Beratungen bitten. Sie machen die Prüfung jedoch nicht zu einem technisch erzwungenen Schritt.

Suche nach Advising mit dem Namen des Advisor-Modells. Ordne das Ergebnis so ein:

Ergebnis	Was es belegt	Nächster Schritt
Reviewed	Der Advisor hat den Gesprächsverlauf geprüft	Drücke `Ctrl+O`, wenn lesbare Hinweise zurückgegeben wurden; prüfe den entstandenen Plan
Declined	Der Aufruf fand statt, aber der Advisor lehnte die Beratung ab	Lies eine vorhandene Begründung und überdenke die Anfrage
Unavailable	Der Aufruf ist fehlgeschlagen	Prüfe `Advisor unavailable (<error_code>)` und untersuche diesen Fehler
Kein Eintrag `Advising`	Keine Beratung beobachtet	Fordere sie ausdrücklich an; fehlt sie weiterhin, prüfe Aktivierung und Verbindung zum Anbieter

Führe nach dem Test /usage aus. Der Advisor-Verbrauch zählt zu den Sitzungssummen. Eine steigende Summe allein belegt aber keine erfolgreiche Prüfung. Vergleiche sie mit dem Ergebnis im Protokoll.

Was kostet eine Beratung durch den Advisor?

Plane die Kosten dafür ein, dass ein weiteres Modell den Gesprächsverlauf liest. Die Advisor-Tokens kommen zum Verbrauch des Hauptmodells hinzu.

Bei API-Abrechnung gelten für Ein- und Ausgabe die Preise des Advisor-Modells. Im Sonnet/Opus-Ablauf mit Abonnement verbraucht die Beratung das Nutzungskontingent des Tarifs. Ein separates unbegrenztes Kontingent für Prüfungen gibt es dabei nicht.

Stand 2026-11-06 betragen die Anthropic-Standardpreise für Opus 5.5 $4 pro Million Eingabetokens und $20 pro Million Ausgabetokens.

Die folgende hypothetische Schätzung betrifft nur den Advisor. Sie nimmt direkte Anthropic-API-Abrechnung, globale Standardpreise, 50,000 Eingabetokens ohne Cache und 2,000 berechnete Ausgabetokens an. Zur berechneten Ausgabe gehören auch Thinking-Tokens.

Advisor token cost
= (50,000 × $4 + 2,000 × $20) / 1,000,000
= $0.24

Das ist keine Pauschale pro Beratung. Die Rechnung enthält weder die Arbeit des Hauptmodells noch eine Berechnung des verbrauchten Abonnementkontingents. Ein längerer Gesprächsverlauf oder eine längere Advisor-Ausgabe erhöht die Schätzung.

Laut Claude-Code-Dokumentation liest der Advisor bei jeder Beratung den vollständigen Verlauf erneut, ohne einen eigenen Cache wiederzuverwenden. Das Ein- oder Ausschalten über /advisor erhält den Prompt-Cache des Hauptmodells. Zurückgegebene Hinweise können bei späteren Anfragen Teil dieses Caches werden.

Diese Aussage gilt für Claude Code. Die direkt verwendete Messages API dokumentiert inzwischen eine separate Advisor-Option caching. Sie ist kein Konfigurationsschritt in diesem CLI-Ablauf.

Vergleiche die Gesamtkosten derselben abgeschlossenen Aufgabe, bevor du das Modellpaar einsetzt. Nutze dieselben Abnahmekriterien und zähle Wiederholungen sowie fehlgeschlagene Versuche mit. Bei Sitzungen mit viel Kontext solltest du den zusätzlichen Kontext durch MCP messen, bevor du jeden Anstieg dem Advisor zuschreibst.

Der Dollarbetrag in /usage ist eine Schätzung. Die tatsächlichen Gebühren findest du in der Abrechnung des Anbieters.

Gateway-Fehler 400 und unbemerktes Abschalten beheben

Wähle die Abhilfe passend zur Ursache. Eine fehlende Aktivierung, ein abgelehntes Modellpaar und ein nicht unterstütztes serverseitiges Tool erfordern unterschiedliche Schritte.

Keine Startmeldung oder Advisor-Aktivität

Prüfe die Umgebungsvariablen und den Abschnitt env in den Einstellungen, bevor du Modelle wechselst. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 schaltet die Funktion vollständig aus.

Prüfe außerdem DISABLE_TELEMETRY und CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Sie können den Mechanismus für Feature-Flags abschalten, über den Advisor aktiviert wird. Lies die dokumentierten Auswirkungen, einschließlich der Bedingungen für die erste Sitzung und die Zugangsdaten bei Gateway-Nutzung.

Hat deine Organisation diese Einstellungen bewusst gesetzt, nutze eine genehmigte Konfiguration oder einen anderen Prüfablauf. Verursacht eine optionale lokale Einstellung das Problem, entferne sie dort, wo sie definiert ist, und starte den Client erneut. Wiederhole den Test und prüfe das Protokoll. Eine geänderte Umgebungsvariable allein beweist noch keinen Erfolg.

Die Sitzung läuft, aber das Modellpaar wurde abgelehnt

Prüfe die tatsächlich verwendeten IDs beider Modelle und availableModels. Ein gespeicherter Advisor kann inaktiv bleiben, wenn das Hauptmodell nicht kompatibel ist.

Lehnt die API ein mitgesendetes Modellpaar ab, wiederholt Claude Code die Anfrage ohne Advisor. Das Gespräch kann ohne Fehlermeldung weiterlaufen. Wähle einen zulässigen Advisor und nutze dann /clear, /compact oder eine neue Sitzung, bevor du erneut prüfst.

Sichere benötigten Aufgabenkontext, bevor du das Gespräch leerst. Diese Abhilfe gilt für abgelehnte Modellpaare, nicht für jede Ablehnung durch ein Gateway.

Die Meldung Input tag ‘advisor_20260301’ erscheint

Ein 400 oder 422 mit Input tag 'advisor_20260301' bedeutet, dass das Gateway oder der dahinterliegende Dienst den Advisor-Tool-Typ abgelehnt hat.

Ab 2.1.280 erkennt Claude Code diese Ablehnung und wiederholt die Anfrage einmal ohne den Advisor-Eintrag und dessen Beta-Wert. Die Sitzung kann wieder Code schreiben, während der Advisor weiterhin fehlt.

Der Leitfaden zur Gateway-Kompatibilität nennt die aktuelle Dauer dieses Zustands: Anfragen an dieselbe Basis-URL lassen Advisor weg, bis Claude Code beendet wird. Währenddessen ist /advisor nicht verfügbar. Korrigiere den Verbindungsweg, beende Claude Code vollständig und starte es erneut. /clear allein ist hier nicht der dokumentierte Weg zum Zurücksetzen.

Aktualisiere zuerst, wenn du einen älteren Client nutzt. Tritt der Fehler mit einem aktuellen Client weiterhin auf, soll der Gateway-Betreiber die Tool-Definition prüfen:

Der Eintrag in tools mit dem Typ advisor_20260301 erreicht einen Anthropic-Dienst, der ihn unterstützt.
Der zugehörige Wert advisor-tool-2026-03-01 im Header anthropic-beta wird zusammen mit dem Eintrag übertragen.
Die Fehlerantworten des nachgelagerten Dienstes behalten den Wortlaut bei, an dem Claude Code die Ablehnung erkennt.

Funktionieren normale Anfragen nach dem Entfernen des Tools und seines Headers, zeigt das den Rückfall auf einen Betrieb ohne Advisor. Es belegt keine Advisor-Kompatibilität.

BetterToken listet am 2026-11-06 claude-sonnet-5-5 und claude-opus-5-5. Die Claude-Code-Konfiguration verwendet https://bettertoken.ai als ANTHROPIC_BASE_URL, ohne /v1. Verfügbare Modelle bestätigen keine Advisor-Unterstützung. Lass sie für den konkreten Verbindungsweg bestätigen und prüfe eine tatsächliche Beratung.

Scheitern auch normale Messages-Anfragen, prüfe zunächst die Verbindung mit der Anleitung für eine minimale Claude-API-Anfrage. Wiederhole danach den gezielten Advisor-Test.

Advisor ausschalten

Nutze den Sitzungsbefehl, wenn du keine weiteren Beratungen möchtest:

/advisor off

Für eine vollständige Deaktivierung setzt du diese Variable in Bash vor dem Start:

export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1
claude

Ist diese Variable gesetzt, ist /advisor nicht verfügbar und advisorModel wird ignoriert. Claude Code akzeptiert --advisor, die Option hat jedoch keine Wirkung.