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
Um Fable 5 als Advisor zu verwenden, benötigen Sie Claude Code v2.1.170 oder später und Fable 5 Zugriff für Ihre Organisation.
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:
advisorModel in Ihren Benutzereinstellungen gespeichert und bleibt über Sitzungen hinweg erhalten. Wenn die availableModels Allowlist Ihrer Organisation das gespeicherte Advisor-Modell ausschließt, wird der Advisor nicht aufgerufen, bis Sie ein zulässiges Modell mit /advisor auswählen. Wenn Ihr aktuelles Hauptmodell den Advisor nicht unterstützt, wird die Auswahl trotzdem gespeichert und aktiviert sich, wenn Sie zu einem kompatiblen Hauptmodell mit /model wechseln.
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 beendet sich mit einem Fehler, wenn das Hauptmodell der Sitzung den Advisor nicht unterstützt, oder wenn das angeforderte Advisor-Modell durch die availableModels Allowlist Ihrer Organisation ausgeschlossen ist.
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 erfordert Claude Code v2.1.170 oder später und Fable 5 Zugriff, unabhängig davon, ob es als Hauptmodell oder als Advisor fungiert.
Legen Sie den Advisor als
opus, sonnet oder fable fest. Diese Aliase werden in die neueste Version jedes Modells aufgelöst. Sie können auch eine vollständige Modell-ID wie claude-opus-4-8 ü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:
- Wenn der Advisor weniger leistungsfähig ist als das Hauptmodell, wird der Advisor nicht an die Anfragen des Hauptmodells angehängt. Die
/advisorBefehlsausgabe und eine Benachrichtigung zeigen dies an. Subagenten, deren eigenes Modell die Kopplung erfüllt, können den Advisor möglicherweise trotzdem verwenden. - Wenn das Hauptmodell oder der Advisor ein Modell ist, das Claude Code nicht erkennt, wird der Advisor nicht angehängt.
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, dass der Advisor das Gespräch überprüft hat. Drücken Sie Ctrl+O, um es zu erweitern und die vollständige Anleitung des Advisors 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
Jeder Advisor-Aufruf sendet das Gespräch an das Advisor-Modell, daher verbraucht es Token zu den Sätzen des Advisor-Modells zusätzlich zu Ihrer Hauptmodellnutzung. Bei API-Abrechnung werden Advisor-Token zu den Input- und Output-Sätzen des Advisor-Modells berechnet. Bei Abonnementplänen zählt die Advisor-Nutzung zu den Nutzungsgrenzen Ihres Plans. 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 Ändern von Modell oder Aufwandsstufe 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: Opus 4.6 oder später, Sonnet 4.6 oder später oder Haiku 4.5. Fable 5 qualifiziert sich auch auf Claude Code v2.1.170 oder später.
Schalten Sie den Advisor aus
Um die Verwendung des Advisors zu beenden und Ihren gespeichertenadvisorModel zu löschen, 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; vorhandene Skripte, die es übergeben, funktionieren weiterhin ohne Fehler. 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