Lo strumento advisor è sperimentale e richiede l’API Anthropic. Non è disponibile su Amazon Bedrock, Claude Platform su AWS, Google Cloud’s Agent Platform o Microsoft Foundry. Il comportamento, i prezzi e la disponibilità potrebbero cambiare.
Quando utilizzare l’advisor
L’advisor è adatto per attività lunghe e multi-step dove la maggior parte dei turni sono di routine ma la qualità del piano determina il risultato. Gli esempi includono refactoring di grandi dimensioni, sessioni di debug dove un errore continua a ripetersi, e attività che desideri controllare in modo indipendente prima che Claude le dichiari completate. Aggiunge meno valore su attività brevi dove c’è poco da pianificare, o su lavori dove ogni turno ha bisogno del modello più potente. Per questi, cambia il modello principale invece, o vedi come l’advisor si confronta con opusplan e subagents per altri modi di ottenere un secondo parere.Abilita l’advisor
Puoi impostare il modello advisor in tre modi:- Comando
/advisor: imposta o cambia l’advisor a metà sessione e salvalo come predefinito - Impostazione
advisorModel: configura un predefinito persistente nel tuo file di impostazioni - Flag
--advisor: imposta l’advisor per una singola sessione al lancio
Per utilizzare Fable 5 come advisor, hai bisogno di Claude Code v2.1.170 o successivo e accesso a Fable 5 per la tua organizzazione.
Usa il comando /advisor
Esegui /advisor senza argomenti per aprire un selettore che elenca i modelli advisor disponibili, o passa il modello direttamente:
advisorModel nelle impostazioni utente e persiste tra le sessioni. Se l’allowlist availableModels della tua organizzazione esclude il modello advisor salvato, l’advisor non viene invocato finché non scegli un modello consentito con /advisor. Se il tuo modello principale attuale non supporta l’advisor, la selezione viene comunque salvata e si attiva quando passi a un modello principale compatibile con /model.
Imposta advisorModel nelle impostazioni
Per configurare l’advisor come predefinito senza aprire una sessione, impostalo nel tuo file di impostazioni:
Usa il flag --advisor
Per impostare l’advisor per una singola sessione senza modificare l’impostazione salvata, avvia con il flag:
advisorModel per quella sessione. Esce con un errore se il modello principale della sessione non supporta l’advisor, o se il modello advisor richiesto è escluso dall’allowlist availableModels della tua organizzazione.
Scegli un modello advisor
L’advisor deve essere almeno altrettanto capace del modello principale. Gli advisor accettati per ogni modello principale sono:
Fable 5 richiede Claude Code v2.1.170 o successivo e accesso a Fable 5, sia che agisca come modello principale che come advisor.
Imposta l’advisor come
opus, sonnet, o fable. Questi alias si risolvono nella versione più recente di ogni modello. Puoi anche passare un ID modello completo come claude-opus-4-8.
I subagent ereditano l’advisor configurato e applicano lo stesso controllo di accoppiamento rispetto al loro modello.
Claude Code convalida l’accoppiamento prima di inviare una richiesta:
- Se l’advisor è meno capace del modello principale, l’advisor non è allegato alle richieste del modello principale. L’output del comando
/advisore una notifica mostrano questo. I subagent il cui modello soddisfa l’accoppiamento possono comunque utilizzare l’advisor. - Se il modello principale o l’advisor è un modello che Claude Code non riconosce, l’advisor non è allegato.
Accoppiamenti di modelli comuni
Qualsiasi accoppiamento accettato funziona. Queste combinazioni bilanciano il costo rispetto alla capacità in modi diversi:Quando Claude consulta l’advisor
Claude decide quando chiamare l’advisor. Tende a consultare prima di impegnarsi in un approccio, quando un errore continua a ripetersi, e prima di dichiarare un’attività completata, ma i tempi sono guidati dal modello piuttosto che basati su regole. Puoi chiedere una consultazione nel tuo prompt nello stesso modo in cui richiederesti qualsiasi strumento, ad esempioconsult the advisor before you continue. Non c’è un’impostazione per limitare o forzare le chiamate dell’advisor; se desideri che Claude consulti più o meno spesso durante un’attività, dillo nelle tue istruzioni.
Cosa vedi durante una sessione
Quando Claude chiama l’advisor, la trascrizione mostra una rigaAdvising con il nome del modello advisor mentre la chiamata è in corso. Quando il risultato ritorna, la riga conferma che l’advisor ha esaminato la conversazione. Premi Ctrl+O per espanderla e leggere la guida completa dell’advisor.
Claude generalmente segue la guida dell’advisor, ma si adatta quando le sue stesse prove contraddicono un’affermazione specifica: se un passaggio consigliato fallisce quando provato, o il contenuto del file contraddice il consiglio, Claude evidenzia il conflitto piuttosto che seguire la guida incondizionatamente.
L’advisor riceve sempre la conversazione completa, e Claude controlla i tempi. Per un maggiore controllo o una configurazione diversa, vedi come l’advisor si confronta con subagents e opusplan.
Costo
Ogni chiamata dell’advisor invia la conversazione al modello advisor, quindi consuma token alle tariffe del modello advisor in aggiunta all’utilizzo del tuo modello principale. Con la fatturazione API, i token dell’advisor vengono addebitati alle tariffe di input e output del modello advisor. Sui piani di abbonamento, l’utilizzo dell’advisor conta verso i limiti di utilizzo del tuo piano. Claude chiama l’advisor nei punti decisionali piuttosto che ad ogni turno, quindi l’accoppiamento di un modello principale più veloce con un advisor più potente in genere costa meno che eseguire il modello più potente in tutto. L’utilizzo dell’advisor conta verso i totali della sessione mostrati da/usage.
Per come i token dell’advisor vengono segnalati nelle risposte API, vedi Usage and billing nella documentazione dell’API Claude.
Impatto sulla memorizzazione nella cache dei prompt
L’abilitazione o la disabilitazione dell’advisor a metà sessione non invalida la cache dei prompt del tuo modello principale. A differenza di cambiare modello o livello di sforzo, l’attivazione/disattivazione di/advisor mantiene il prefisso memorizzato nella cache intatto, e la guida restituita dall’advisor viene memorizzata nella cache come parte della trascrizione nei turni successivi.
La lettura della conversazione da parte del modello advisor stesso non viene memorizzata nella cache. Ogni chiamata dell’advisor elabora la trascrizione completa da capo, senza riutilizzo tra le chiamate.
Requisiti
Lo strumento advisor richiede tutti i seguenti:- Solo API Anthropic: l’advisor è uno strumento eseguito dal server. Non è disponibile su Amazon Bedrock, Claude Platform su AWS, Google Cloud’s Agent Platform, o Microsoft Foundry. Attraverso un gateway LLM configurato con
ANTHROPIC_BASE_URL, la disponibilità dipende dal fatto che il gateway inoltri la richiesta intatta all’API Anthropic. - Modello principale supportato: Opus 4.6 o successivo, Sonnet 4.6 o successivo, o Haiku 4.5. Fable 5 si qualifica anche su Claude Code v2.1.170 o successivo.
Disattiva l’advisor
Per smettere di usare l’advisor e cancellare il tuoadvisorModel salvato, esegui /advisor off o scegli No advisor nel selettore /advisor:
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. Il comando /advisor diventa non disponibile e qualsiasi advisorModel configurato viene ignorato. Il flag --advisor è accettato ma non ha alcun effetto; gli script esistenti che lo passano continuano a funzionare senza errori. Vedi Environment variables.
Confronta con funzionalità correlate
L’advisor è uno dei diversi modi per combinare i punti di forza dei modelli. Scegli in base a quando desideri che un secondo modello sia coinvolto.Vedi anche
- Model configuration: cambia modelli, imposta livelli di sforzo e usa
opusplan - Manage costs effectively: traccia l’utilizzo dei token tra i modelli
- Advisor tool in the Claude API: comprendi lo strumento server sottostante, o usalo direttamente dall’API Messages
- The advisor strategy: perché l’accoppiamento di un modello principale veloce con un advisor più potente funziona