Das Advisor-Tool ist experimentell und erfordert Claude Code v2.1.98 oder später mit der Anthropic API. Es ist nicht auf Amazon Bedrock, Google Vertex AI 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:
/advisor Befehl: Legen Sie den Advisor während einer Sitzung fest oder ändern Sie ihn und speichern Sie ihn als StandardadvisorModel Einstellung: Konfigurieren Sie einen persistenten Standard in Ihrer Einstellungsdatei--advisor Flag: Legen Sie den Advisor für eine einzelne Sitzung beim Start fest
Wenn eine dieser Optionen ein Advisor-Modell festlegt, ist der Advisor für Sitzungen aktiviert, deren Hauptmodell es unterstützt. Um die Verwendung zu beenden, siehe Schalten Sie den Advisor aus.
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:
Ihre Auswahl wird in advisorModel in Ihren Benutzereinstellungen gespeichert und bleibt über Sitzungen hinweg erhalten. 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:
{
"advisorModel": "opus"
}
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:
Das Flag hat Vorrang vor der advisorModel Einstellung für diese Sitzung. Im Gegensatz zu /advisor, das eine inaktive Auswahl speichert, beendet sich das Flag mit einem Fehler, wenn das Hauptmodell der Sitzung den Advisor nicht unterstützt.
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:
| Hauptmodell | Akzeptierte Advisors | Hinweise |
|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku kann den Advisor aufrufen, kann aber nicht als einer fungieren |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Opus 4.6 oder später | Fable, Opus in oder über der Version des Hauptmodells | Ein Opus 4.7 Hauptmodell mit einem Opus 4.6 Advisor wird abgelehnt |
| Fable 5 (v2.1.170+) | Fable | Ein Opus oder Sonnet Advisor wird abgelehnt |
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
/advisor Befehlsausgabe 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:
| Kopplung | Wann zu verwenden |
|---|
| Sonnet Hauptmodell + Opus Advisor | Sonnet verarbeitet Routineaufgaben und eskaliert Planung, mehrdeutige Fehler und Abschlussüberprüfungen an Opus |
| Sonnet Hauptmodell + Fable Advisor | Fable 5 Anleitung an Entscheidungspunkten ohne Fable 5 durchgehend auszuführen. Erfordert v2.1.170 oder später und Fable 5 Zugriff |
| Haiku Hauptmodell + Opus Advisor | Kostengünstigstes Hauptmodell mit starker Planung. Erwarten Sie höhere Kosten als Haiku allein, aber niedriger als das Wechseln des Hauptmodells zu Sonnet oder Opus |
| Opus Hauptmodell + Opus Advisor | Ein zweiter Opus überprüft den ersten. Nützlich für hochriskante Aufgaben, bei denen eine unabhängige Überprüfung wichtiger ist als Kosten |
| Fable Hauptmodell + Fable Advisor | Höchste Leistungskopplung, wenn Fable 5 verfügbar ist (v2.1.170+). Fable ist eine höhere Stufe als Opus und Sonnet, daher ist es der einzige akzeptierte Advisor für ein Fable Hauptmodell |
| Sonnet Hauptmodell + Sonnet Advisor | Eine kostengünstigere zweite Meinung zum Erkennen von Routineversäumnissen |
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, 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:
- Claude Code v2.1.98 oder später: Führen Sie
claude update aus, um zu aktualisieren.
- Nur Anthropic API: Der Advisor ist ein serverseitig ausgeführtes Tool. Er ist nicht auf Amazon Bedrock, Google Vertex AI 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: Opus 4.6 oder später, Sonnet 4.6 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 gespeicherten advisorModel zu löschen, führen Sie /advisor off aus oder wählen Sie No advisor in der /advisor Auswahl:
Um das Advisor-Tool vollständig zu deaktivieren, einschließlich des /advisor Befehls und des --advisor Flags, legen Sie CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 fest. 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.
| Ansatz | Wann das stärkere Modell läuft | Wie es startet |
|---|
| Advisor-Tool | An Entscheidungspunkten während der Aufgabe | Claude ruft es auf, wenn es Anleitung benötigt |
opusplan | Während des Plan-Modus, dann wechselt zu Sonnet für die Ausführung | Sie treten in den Plan-Modus ein |
Subagents mit model gesetzt | Für die gesamte delegierte Teilaufgabe | Claude delegiert oder Sie rufen den Subagent auf |
/model | Für alle nachfolgenden Schritte | Sie wechseln Modelle |
Siehe auch
