Escalate hard decisions with the advisor tool

Abbina il tuo modello principale con un modello advisor più potente che Claude consulta nei momenti chiave durante un'attività.

Lo strumento advisor consente a Claude di consultare un secondo modello, tipicamente più potente, nei momenti chiave durante un'attività, ad esempio prima di impegnarsi in un approccio, quando bloccato su un errore ricorrente, o prima di dichiarare un'attività completata. L'advisor riceve l'intera conversazione, incluse tutte le chiamate agli strumenti e i risultati, e restituisce una guida che Claude applica prima di continuare.

L'advisor viene eseguito lato server sull'infrastruttura di Anthropic come server tool, disponibile sia per gli account con abbonamento che per quelli fatturati tramite API. Scegli quale modello agisce come advisor, e Claude decide quando chiamarlo.

Questa pagina spiega come abilitare l'advisor, quali accoppiamenti di modelli sono accettati, cosa Claude mostra durante una consultazione e come viene fatturato l'utilizzo dell'advisor.

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

Ognuno di questi abilita l'advisor per le sessioni il cui modello principale lo supporta. Dopo l'avvio della sessione, Claude Code mostra una notifica Advisor Tool (experimental) is on and may use more tokens · /advisor. Per smettere di usare l'advisor, vedi Disattiva l'advisor.

Su alcuni piani, Fable come advisor ha anche bisogno del tuo consenso una tantum per fatturare l'utilizzo di Fable ai crediti di utilizzo. Per sapere cosa accade prima di aver dato quel consenso, vedi Advisor Fable e crediti di utilizzo.

Usa il comando `/advisor`

Esegui /advisor senza argomenti per aprire un selettore che elenca i modelli advisor disponibili, o passa il modello direttamente:

/advisor opus

Il comando conferma con Advisor set to seguito dal nome del modello advisor. La tua selezione viene salvata in advisorModel nelle impostazioni utente e persiste tra le sessioni, eccetto nei casi che la voce advisorModel elenca come applicabili solo alla sessione corrente.

Il comando funziona anche dove non c'è un selettore di terminale: in modalità non interattiva con -p, nell'Agent SDK, nell'app desktop e su Remote Control. Questo richiede Claude Code v2.1.260 o successivo. Su quelle superfici:

• Esegui /advisor senza argomento per stampare il modello advisor corrente e gli alias che accetta.
• Esegui /advisor con un modello, come /advisor opus, per impostarlo.
• Esegui /advisor off per disattivarlo.

Claude Code non invoca un advisor salvato che l'allowlist availableModels della tua organizzazione esclude. Per usare l'advisor, scegli un modello consentito con /advisor. Claude Code salva comunque un advisor che il tuo modello principale attuale non supporta. Quell'advisor si attiva dopo che passi a un modello principale compatibile con /model. Se l'API ha già rifiutato l'advisor salvato nella conversazione corrente, rimane disattivato fino a /clear o /compact, anche dopo aver cambiato modelli.

Su alcuni piani, Fable come advisor ha anche bisogno del tuo consenso una tantum per fatturare l'utilizzo di Fable ai crediti di utilizzo. Per sapere cosa fa /advisor fable prima di aver dato quel consenso, vedi Advisor Fable e crediti di utilizzo.

Imposta `advisorModel` nelle impostazioni

Per configurare l'advisor come predefinito senza aprire una sessione, impostalo nel tuo file di impostazioni:

{
  "advisorModel": "opus"
}

Usa il flag `--advisor`

Per impostare l'advisor per una singola sessione senza modificare l'impostazione salvata, avvia con il flag:

claude --advisor opus

Claude Code usa il flag al posto dell'impostazione advisorModel per quella sessione. Non elenca --advisor in claude --help. Claude Code esce con un errore al lancio se:

• Il modello principale della sessione non supporta l'advisor
• Il modello richiesto, come Haiku, non può agire come advisor
• L'allowlist availableModels della tua organizzazione esclude il modello richiesto
• Hai richiesto Fable e il tuo account richiede ancora il consenso ai crediti di utilizzo

Se avvii una sessione in background con --advisor e uno di questi si applica, Claude Code avvia la sessione senza l'advisor invece di uscire.

Scegli un modello advisor

L'advisor deve essere almeno altrettanto capace del modello principale. Gli advisor accettati per ogni modello principale sono:

Fable 5.1 richiede Claude Code v2.1.257 o successivo. Entrambi i modelli Fable richiedono accesso a Fable.

Imposta l'advisor come fable, opus, o sonnet. Questi alias si risolvono nella versione predefinita integrata di Claude Code per ogni famiglia di modelli, che avanza con le nuove versioni di Claude Code. Puoi anche passare un ID modello completo come claude-opus-5-5.

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 e l'API lo convalida di nuovo:

• Per un advisor che la tabella elenca come rifiutato, Claude Code non lo allega alle richieste del modello principale. L'output del comando /advisor e una notifica mostrano questo. I subagent il cui modello soddisfa l'accoppiamento possono comunque utilizzare l'advisor.
• Per un advisor che la tabella elenca come rifiutato dall'API, Claude Code lo allega e l'API lo rifiuta. Claude Code quindi rinvia quella richiesta senza l'advisor e il resto della conversazione procede senza uno, quindi non vedi alcun errore e non ottieni alcuna chiamata advisor. Scegli un advisor accettato con /advisor; il cambiamento ha effetto dopo /clear o /compact e nelle nuove sessioni.
• Se il modello principale o l'advisor è un modello che Claude Code non riconosce, l'advisor non è allegato.

Advisor Fable e crediti di utilizzo

Su alcuni piani, l'utilizzo di Fable viene addebitato ai crediti di utilizzo, e Fable come advisor viene addebitato allo stesso modo. Se il tuo account richiede il consenso una tantum per addebitare l'utilizzo di Fable ai crediti di utilizzo, Claude Code lo chiede quando selezioni un modello Fable con /model e non applica Fable come advisor finché non hai accettato quel consenso.

Prima di averlo accettato, Claude Code non salva Fable come advisor quando digiti /advisor fable o scegli Fable nel selettore /advisor. Ti indirizza invece a /model fable. Con claude --advisor fable, Claude Code esce al lancio con un messaggio che punta a /model fable. In una sessione in background, avvia la sessione senza l'advisor invece di uscire. Con Fable già salvato come tuo advisorModel, Claude Code invia richieste senza l'advisor. In una sessione interattiva il cui modello principale supporta l'advisor, mostra anche una notifica che punta a /model fable.

Per accettare il consenso, esegui /model fable e scegli di continuare su Fable. Claude Code registra il consenso e salva Fable come modello selezionato. Quindi seleziona Fable come advisor.

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 esempio consult 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 riga Advising con il nome del modello advisor mentre la chiamata è in corso. Quando il risultato ritorna, la riga riporta se l'advisor ha fornito una guida:

• Reviewed: la riga conferma che l'advisor ha esaminato la conversazione. Quando l'advisor ha restituito una guida leggibile, premi Ctrl+O per leggerla.
• Declined: la riga legge Advisor declined to advise on this request. Se l'advisor ha fornito un motivo, premi Ctrl+O per leggerlo.

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

Quando Claude chiama l'advisor, il modello advisor legge la conversazione, quindi ogni chiamata consuma token alle tariffe del modello advisor in aggiunta all'utilizzo del tuo modello principale. Come questi token dell'advisor vengono fatturati dipende da come paghi:

• Fatturazione API: paghi le tariffe di input e output del modello advisor per i token dell'advisor
• Piani di abbonamento: l'utilizzo dell'advisor conta verso i limiti di utilizzo del tuo piano, ad eccezione del fatto che un advisor Fable viene fatturato ai crediti di utilizzo sui piani in cui l'utilizzo di Fable lo fa

Se il tuo account richiede il consenso ai crediti di utilizzo, un advisor Fable non viene fatturato finché non lo dai, perché Claude Code non applica la selezione fino ad allora.

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, 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. Se il gateway o il suo upstream non riconosce lo strumento advisor, vedere Retry automatico e inoltro degli errori per sapere come Claude Code risponde.
• Modello principale supportato: Fable, Opus 4.6 o successivo, Sonnet 4.6 o successivo, o Haiku 4.5. Vedere Scegliere un modello advisor per sapere quali advisor accettano ciascuno.
• Recupero del feature flag: Claude Code attiva l'advisor tramite un feature flag che recupera da Anthropic. In una sessione in cui è impostata una variabile che disattiva il recupero dei flag, come DISABLE_TELEMETRY, l'advisor rimane disattivato. Vedere Funzionalità che richiedono il recupero del feature flag.

Disattiva l'advisor

Per smettere di usare l'advisor, esegui /advisor off o scegli No advisor nel selettore /advisor:

/advisor off

Per disabilitare completamente lo strumento advisor, imposta 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. 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