Skip to main content
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.
Das Advisor-Tool ermöglicht es Claude, ein zweites, typischerweise stärkeres Modell an wichtigen Momenten während einer Aufgabe zu konsultieren, z. B. bevor ein Ansatz festgelegt wird, wenn ein wiederkehrender Fehler auftritt, oder bevor eine Aufgabe als abgeschlossen erklärt wird. Der Advisor erhält das gesamte Gespräch, einschließlich aller Tool-Aufrufe und Ergebnisse, und gibt Anleitung zurück, die Claude vor dem Fortfahren anwendet. Der Advisor läuft serverseitig auf der Infrastruktur von Anthropic als Server-Tool, das sowohl für Abonnement- als auch für API-abgerechnete Konten verfügbar ist. Sie wählen, welches Modell als Advisor fungiert, und Claude entscheidet, wann es aufgerufen wird. Diese Seite behandelt, wie Sie den Advisor aktivieren, welche Modellkombinationen akzeptiert werden, was Claude während einer Konsultation anzeigt, und wie die Advisor-Nutzung abgerechnet wird.

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:
  • /advisor Befehl: Legen Sie den Advisor während einer Sitzung fest oder ändern Sie ihn und speichern Sie ihn als Standard
  • advisorModel Einstellung: Konfigurieren Sie einen persistenten Standard in Ihrer Einstellungsdatei
  • --advisor Flag: Legen Sie den Advisor für eine einzelne Sitzung beim Start fest
Jede dieser Optionen aktiviert den Advisor für Sitzungen, deren Hauptmodell es unterstützt. Nach dem Start der Sitzung zeigt Claude Code eine 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:
Der Befehl bestätigt mit 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 /advisor ohne Argument aus, um das aktuelle Advisor-Modell und die Aliase, die es akzeptiert, auszudrucken.
  • Führen Sie /advisor mit einem Modell aus, wie /advisor opus, um es festzulegen.
  • Führen Sie /advisor off aus, um es auszuschalten.
Claude Code ruft einen gespeicherten Advisor nicht auf, den die 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:
Claude Code verwendet das Flag statt der 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 availableModels Allowlist Ihrer Organisation das angeforderte Modell ausschließt
  • Sie Fable angefordert haben und Ihr Konto erfordert noch die Zustimmung zu Nutzungsguthaben
Wenn Sie eine Hintergrund-Sitzung mit --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 /advisor Befehlsausgabe 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 Beispiel consult 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 eine Advising 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 Sie Ctrl+O, um ihn zu lesen.
Claude folgt im Allgemeinen der Anleitung des Advisors, passt sich aber an, wenn seine eigenen Erkenntnisse einer spezifischen Aussage widersprechen: Wenn ein empfohlener Schritt beim Versuch fehlschlägt oder der Dateiinhalt der Anleitung widerspricht, zeigt Claude den Konflikt auf, anstatt die Anleitung bedingungslos zu befolgen. Der Advisor erhält immer das gesamte Gespräch, und Claude kontrolliert den Zeitpunkt. Für mehr Kontrolle oder eine andere Konfiguration siehe wie der Advisor mit Subagents und opusplan verglichen wird.

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
Wenn Ihr Konto die Zustimmung zu Nutzungsguthaben erfordert, wird ein Fable-Advisor vor der Zustimmung nicht abgerechnet, da Claude Code die Auswahl nicht anwendet, bis Sie dies tun. Claude ruft den Advisor an Entscheidungspunkten auf, nicht bei jedem Schritt, daher kostet die Kopplung eines schnelleren Hauptmodells mit einem stärkeren Advisor typischerweise weniger als das durchgehende Ausführen des stärkeren Modells. Die Advisor-Nutzung zählt zu den Sitzungssummen, die von /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_URL konfiguriert 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:
Um das Advisor-Tool vollständig zu deaktivieren, setzen Sie 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. 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