Das Advisor-Tool ist experimentell und erfordert die Anthropic API. Es ist nicht auf Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform oder Microsoft Foundry verfügbar. Verhalten, Preisgestaltung und Verfügbarkeit können sich ändern.
Wann der Advisor verwendet werden sollte
Der Advisor eignet sich für lange, mehrstufige Aufgaben, bei denen die meisten Schritte Routine sind, aber die Planqualität das Ergebnis bestimmt. Beispiele sind große Umstrukturierungen, Debugging-Sitzungen, bei denen ein Fehler immer wieder auftritt, und Aufgaben, die Sie unabhängig überprüft haben möchten, bevor Claude sie als abgeschlossen erklärt. Er bietet weniger Wert bei kurzen Aufgaben, bei denen es wenig zu planen gibt, oder bei Arbeiten, bei denen jeder Schritt das stärkste Modell benötigt. Für diese Fälle wechseln Sie das Hauptmodell oder siehe wie der Advisor mit opusplan und Subagents verglichen wird für andere Möglichkeiten, eine zweite Meinung zu erhalten.Aktivieren Sie den Advisor
Sie können das Advisor-Modell auf drei Arten festlegen:/advisorBefehl: Legen Sie den Advisor während einer Sitzung fest oder ändern Sie ihn und speichern Sie ihn als StandardadvisorModelEinstellung: Konfigurieren Sie einen persistenten Standard in Ihrer Einstellungsdatei--advisorFlag: Legen Sie den Advisor für eine einzelne Sitzung beim Start fest
Advisor Tool (experimental) is on and may use more tokens · /advisor Benachrichtigung an. Um die Verwendung des Advisors zu beenden, siehe Schalten Sie den Advisor aus.
Bei einigen Plänen benötigt Fable als Advisor auch Ihre einmalige Zustimmung zur Abrechnung der Fable-Nutzung auf Nutzungsguthaben. Informationen dazu, was vor Ihrer Zustimmung geschieht, finden Sie unter Fable Advisor und Nutzungsguthaben.
Verwenden Sie den /advisor Befehl
Führen Sie /advisor ohne Argumente aus, um eine Auswahl mit den verfügbaren Advisor-Modellen zu öffnen, oder übergeben Sie das Modell direkt:
Advisor set to gefolgt vom Namen des Advisor-Modells. Ihre Auswahl wird in advisorModel in Ihren Benutzereinstellungen gespeichert und bleibt über Sitzungen hinweg erhalten, außer in den Fällen, die der advisorModel Eintrag als nur für die aktuelle Sitzung geltend auflistet.
Der Befehl funktioniert auch dort, wo es keine Terminal-Auswahl gibt: im nicht-interaktiven Modus mit -p, im Agent SDK, in der Desktop-App und über Remote Control. Dies erfordert Claude Code v2.1.260 oder später. Auf diesen Oberflächen:
- Führen Sie
/advisorohne Argument aus, um das aktuelle Advisor-Modell und die Aliase, die es akzeptiert, auszudrucken. - Führen Sie
/advisormit einem Modell aus, wie/advisor opus, um es festzulegen. - Führen Sie
/advisor offaus, um es auszuschalten.
availableModels Allowlist Ihrer Organisation ausschließt. Um den Advisor zu verwenden, wählen Sie ein zulässiges Modell mit /advisor. Claude Code speichert trotzdem einen Advisor, den Ihr aktuelles Hauptmodell nicht unterstützt. Dieser Advisor wird aktiviert, nachdem Sie zu einem kompatiblen Hauptmodell mit /model wechseln.
Bei einigen Plänen benötigt Fable als Advisor auch Ihre einmalige Zustimmung zur Abrechnung der Fable-Nutzung auf Nutzungsguthaben. Informationen dazu, was /advisor fable vor Ihrer Zustimmung tut, finden Sie unter Fable Advisor und Nutzungsguthaben.
Legen Sie advisorModel in den Einstellungen fest
Um den Advisor als Standard zu konfigurieren, ohne eine Sitzung zu öffnen, legen Sie ihn in Ihrer Einstellungsdatei fest:
Verwenden Sie das --advisor Flag
Um den Advisor für eine einzelne Sitzung festzulegen, ohne Ihre gespeicherte Einstellung zu ändern, starten Sie mit dem Flag:
advisorModel Einstellung für diese Sitzung. Es listet --advisor nicht in claude --help auf. Claude Code beendet sich mit einem Fehler beim Start, wenn:
- Das Hauptmodell der Sitzung den Advisor nicht unterstützt
- Das angeforderte Modell, wie Haiku, nicht als Advisor fungieren kann
- Die
availableModelsAllowlist Ihrer Organisation das angeforderte Modell ausschließt - Sie Fable angefordert haben und Ihr Konto erfordert noch die Zustimmung zu Nutzungsguthaben
--advisor starten und eine dieser Bedingungen zutrifft, startet Claude Code die Sitzung ohne den Advisor, anstatt zu beenden.
Wählen Sie ein Advisor-Modell
Der Advisor muss mindestens so leistungsfähig sein wie das Hauptmodell. Die akzeptierten Advisors für jedes Hauptmodell sind:
Fable 5.1 erfordert Claude Code v2.1.257 oder später. Beide Fable-Modelle erfordern Fable-Zugriff.
Legen Sie den Advisor als
fable, opus oder sonnet fest. Diese Aliase werden in die in Claude Code integrierte Standardversion für jede Modellfamilie aufgelöst, die sich mit neuen Claude Code-Versionen weiterentwickelt. Sie können auch eine vollständige Modell-ID wie claude-opus-5 übergeben.
Subagenten erben den konfigurierten Advisor und wenden die gleiche Kopplungsprüfung gegen ihr eigenes Modell an.
Claude Code validiert die Kopplung vor dem Senden einer Anfrage, und die API validiert sie erneut:
- Für einen Advisor, den die Tabelle als abgelehnt auflistet, hängt Claude Code ihn nicht an die Anfragen des Hauptmodells an. Die
/advisorBefehlsausgabe und eine Benachrichtigung zeigen dies an. Subagenten, deren eigenes Modell die Kopplung erfüllt, können den Advisor möglicherweise trotzdem verwenden. - Für einen Advisor, den die Tabelle als fehlgeschlagen mit einem API-Fehler auflistet, hängt Claude Code ihn an und die API lehnt ihn ab. Jede Anfrage schlägt mit
'<advisor model>' cannot be used as an advisor when the request model is '<main model>'fehl, bis Sie den Advisor mit/advisorändern oder ihn ausschalten. - Wenn das Hauptmodell oder der Advisor ein Modell ist, das Claude Code nicht erkennt, wird der Advisor nicht angehängt.
Fable Advisor und Nutzungsguthaben
Bei einigen Plänen wird die Fable-Nutzung auf Nutzungsguthaben abgerechnet, und Fable als Advisor wird auf die gleiche Weise abgerechnet. Wenn Ihr Konto die einmalige Zustimmung zur Abrechnung der Fable-Nutzung auf Nutzungsguthaben erfordert, fragt Claude Code danach, wenn Sie ein Fable-Modell mit/model auswählen, und wendet Fable nicht als Advisor an, bis Sie dieser Zustimmung zugestimmt haben.
Bevor Sie zugestimmt haben, speichert Claude Code Fable nicht als Advisor, wenn Sie /advisor fable eingeben oder Fable in der /advisor Auswahl wählen. Stattdessen verweist es Sie auf /model fable. Mit claude --advisor fable beendet Claude Code den Start mit einer Nachricht, die auf /model fable verweist. In einer Hintergrundsitzung wird die Sitzung ohne den Advisor gestartet, anstatt zu beenden. Mit Fable, das bereits als Ihr advisorModel gespeichert ist, sendet Claude Code Anfragen ohne den Advisor. In einer interaktiven Sitzung, deren Hauptmodell den Advisor unterstützt, wird auch eine Benachrichtigung angezeigt, die auf /model fable verweist.
Um der Zustimmung zuzustimmen, führen Sie /model fable aus und wählen Sie, um mit Fable fortzufahren. Claude Code zeichnet die Zustimmung auf und speichert Fable als Ihr ausgewähltes Modell. Wählen Sie dann Fable als Advisor.
Häufige Modellkombinationen
Jede akzeptierte Kopplung funktioniert. Diese Kombinationen gleichen Kosten gegen Leistung auf verschiedene Weise aus:Wann Claude den Advisor konsultiert
Claude entscheidet, wann der Advisor aufgerufen wird. Es neigt dazu, vor dem Festlegen eines Ansatzes zu konsultieren, wenn ein Fehler immer wieder auftritt, und vor der Erklärung einer Aufgabe als abgeschlossen, aber der Zeitpunkt ist modellgesteuert und nicht regelbasiert. Sie können in Ihrem Prompt eine Konsultation anfordern, genauso wie Sie jedes andere Tool anfordern würden, zum Beispielconsult the advisor before you continue. Es gibt keine Einstellung, um Advisor-Aufrufe zu begrenzen oder zu erzwingen; wenn Sie möchten, dass Claude während einer Aufgabe häufiger oder seltener konsultiert, sagen Sie dies in Ihren Anweisungen.
Was Sie während einer Sitzung sehen
Wenn Claude den Advisor aufruft, zeigt das Transkript eineAdvising Zeile mit dem Namen des Advisor-Modells, während der Aufruf läuft. Wenn das Ergebnis zurückkommt, bestätigt die Zeile, ob der Advisor eine Anleitung gegeben hat:
- Reviewed: Die Zeile bestätigt, dass der Advisor das Gespräch überprüft hat. Wenn der Advisor lesbare Anleitung gegeben hat, drücken Sie
Ctrl+O, um sie zu lesen. - Declined: Die Zeile lautet
Advisor declined to advise on this request. Wenn der Advisor einen Grund angegeben hat, drücken SieCtrl+O, um ihn zu lesen.
Kosten
Wenn Claude den Advisor aufruft, liest das Advisor-Modell das Gespräch, daher verbraucht jeder Aufruf Token zu den Sätzen des Advisor-Modells zusätzlich zu Ihrer Hauptmodellnutzung. Wie diese Advisor-Token abgerechnet werden, hängt davon ab, wie Sie bezahlen:- API-Abrechnung: Sie zahlen die Input- und Output-Sätze des Advisor-Modells für Advisor-Token
- Abonnementpläne: Die Advisor-Nutzung zählt zu den Nutzungsgrenzen Ihres Plans, mit Ausnahme, dass ein Fable-Advisor zu Nutzungsguthaben bei Plänen abgerechnet wird, bei denen die Fable-Nutzung dies tut
/usage angezeigt werden.
Für die Berichterstattung von Advisor-Token in API-Antworten siehe Nutzung und Abrechnung in der Claude API-Dokumentation.
Auswirkung auf Prompt-Caching
Das Aktivieren oder Deaktivieren des Advisors während einer Sitzung invalidiert nicht den Prompt-Cache Ihres Hauptmodells. Im Gegensatz zum Wechsel von Modellen behält das Umschalten von/advisor das zwischengespeicherte Präfix bei, und die vom Advisor zurückgegebene Anleitung wird als Teil des Transkripts bei späteren Schritten zwischengespeichert.
Das eigene Lesen des Advisor-Modells des Gesprächs wird nicht zwischengespeichert. Jeder Advisor-Aufruf verarbeitet das gesamte Transkript neu, ohne Wiederverwendung zwischen Aufrufen.
Anforderungen
Das Advisor-Tool erfordert alle folgenden Voraussetzungen:- Nur Anthropic API: Der Advisor ist ein serverseitig ausgeführtes Tool. Er ist nicht auf Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform oder Microsoft Foundry verfügbar. Über ein LLM-Gateway, das mit
ANTHROPIC_BASE_URLkonfiguriert ist, hängt die Verfügbarkeit davon ab, ob das Gateway die Anfrage intakt an die Anthropic API weiterleitet. - Unterstütztes Hauptmodell: Fable, Opus 4.6 oder später, Sonnet 4.6 oder später oder Haiku 4.5. Siehe Wählen Sie ein Advisor-Modell, um zu erfahren, welche Advisors jedes akzeptiert.
- Feature-Flag-Abruf: Claude Code aktiviert den Advisor über ein Feature-Flag, das er von Anthropic abruft. In einer Sitzung, in der eine Variable, die den Flag-Abruf deaktiviert, gesetzt ist, wie z. B.
DISABLE_TELEMETRY, bleibt der Advisor deaktiviert. Siehe Features, die Feature-Flag-Abruf benötigen.
Schalten Sie den Advisor aus
Um die Verwendung des Advisors zu beenden, führen Sie/advisor off aus oder wählen Sie No advisor in der /advisor Auswahl:
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. Der /advisor Befehl wird nicht verfügbar und jedes konfigurierte advisorModel wird ignoriert. Das --advisor Flag wird akzeptiert, hat aber keine Auswirkung. Siehe Umgebungsvariablen.
Vergleich mit verwandten Funktionen
Der Advisor ist eine von mehreren Möglichkeiten, Modellstärken zu kombinieren. Wählen Sie basierend darauf, wann Sie ein zweites Modell beteiligt haben möchten.Siehe auch
- Modellkonfiguration: Wechseln Sie Modelle, legen Sie Aufwandsstufen fest und verwenden Sie
opusplan - Verwalten Sie Kosten effektiv: Verfolgen Sie die Token-Nutzung über Modelle hinweg
- Advisor-Tool in der Claude API: Verstehen Sie das zugrunde liegende Server-Tool oder verwenden Sie es direkt von der Messages API
- Die Advisor-Strategie: Warum die Kopplung eines schnellen Hauptmodells mit einem stärkeren Advisor funktioniert