Escale decisões difíceis com a ferramenta advisor
Combine seu modelo principal com um modelo advisor mais forte que Claude consulta em momentos-chave durante uma tarefa.
A ferramenta advisor permite que Claude consulte um segundo modelo, tipicamente mais forte, em momentos-chave durante uma tarefa, como antes de se comprometer com uma abordagem, quando preso em um erro recorrente, ou antes de declarar uma tarefa concluída. O advisor recebe a conversa completa, incluindo cada chamada de ferramenta e resultado, e retorna orientação que Claude aplica antes de continuar.
O advisor é executado no servidor na infraestrutura da Anthropic como uma server tool, disponível para contas de assinatura e faturadas por API. Você escolhe qual modelo atua como advisor, e Claude decide quando chamá-lo.
Esta página cobre como ativar o advisor, quais emparelhamentos de modelos são aceitos, o que Claude mostra durante uma consulta, e como o uso do advisor é faturado.
Quando usar o advisor
O advisor é adequado para tarefas longas e com múltiplas etapas onde a maioria dos turnos é rotineira, mas a qualidade do plano determina o resultado. Exemplos incluem grandes refatorações, sessões de depuração onde um erro continua recorrendo, e tarefas que você deseja verificadas independentemente antes de Claude declarar que estão concluídas.
Adiciona menos valor em tarefas curtas onde há pouco a planejar, ou em trabalho onde cada turno precisa do modelo mais forte. Para esses casos, mude o modelo principal em vez disso, ou veja como o advisor se compara com opusplan e subagents para outras formas de obter uma segunda opinião.
Ativar o advisor
Você pode definir o modelo advisor de três formas:
- Comando
/advisor: defina ou altere o advisor no meio da sessão e salve-o como seu padrão - Configuração
advisorModel: configure um padrão persistente em seu arquivo de configurações - Flag
--advisor: defina o advisor para uma única sessão no lançamento
Cada uma dessas opções ativa o advisor para sessões cujo modelo principal o suporta. Após a sessão iniciar, Claude Code mostra uma notificação Advisor Tool (experimental) is on and may use more tokens · /advisor. Para parar de usar o advisor, veja Desativar o advisor.
Em alguns planos, Fable como advisor também precisa de seu consentimento único para cobrar o uso de Fable aos créditos de uso. Para saber o que acontece antes de você ter dado esse consentimento, veja Advisor Fable e créditos de uso.
Use o comando `/advisor`
Execute /advisor sem argumentos para abrir um seletor listando os modelos advisor disponíveis, ou passe o modelo diretamente:
/advisor opus
O comando confirma com Advisor set to seguido pelo nome do modelo advisor. Sua seleção é salva em advisorModel nas configurações do usuário e persiste entre sessões.
Claude Code não invoca um advisor salvo que a allowlist availableModels da sua organização exclua. Para usar o advisor, escolha um modelo permitido com /advisor. Claude Code ainda salva um advisor que seu modelo principal atual não suporta. Esse advisor é ativado após você mudar para um modelo principal compatível com /model.
Em alguns planos, Fable como advisor também precisa de seu consentimento único para cobrar o uso de Fable aos créditos de uso. Para saber o que /advisor fable faz antes de você ter dado esse consentimento, veja Advisor Fable e créditos de uso.
Defina `advisorModel` nas configurações
Para configurar o advisor como padrão sem abrir uma sessão, defina-o em seu arquivo de configurações:
{
"advisorModel": "opus"
}
Use a flag `--advisor`
Para definir o advisor para uma única sessão sem alterar sua configuração salva, inicie com a flag:
claude --advisor opus
Claude Code usa a flag em vez da configuração advisorModel para essa sessão. Ela não lista --advisor em claude --help. Claude Code sai com um erro no lançamento se:
- O modelo principal da sessão não suportar o advisor
- O modelo solicitado, como Haiku, não puder atuar como um advisor
- A allowlist
availableModelsda sua organização exclua o modelo solicitado - Você solicitou Fable e sua conta ainda requer o consentimento de créditos de uso
Se você iniciar uma sessão em background com --advisor e uma dessas situações se aplicar, Claude Code inicia a sessão sem o advisor em vez de sair.
Escolha um modelo advisor
O advisor deve ser pelo menos tão capaz quanto o modelo principal. Os advisors aceitos para cada modelo principal são:
| Modelo principal | Advisors aceitos | Notas |
|---|---|---|
| Haiku 4.5 | Fable, Opus, Sonnet | Haiku pode chamar o advisor, mas não pode atuar como um |
| Sonnet 4.6 | Fable, Opus, Sonnet | |
| Sonnet 5 | Fable, Opus, Sonnet 5 | Um advisor Sonnet 4.6 é rejeitado |
| Opus 4.6 | Fable, Opus, Sonnet 5 | Sonnet 5 e Opus 4.6 são classificados como igualmente capazes, então um Opus 4.6 principal aceita um advisor Sonnet 5 |
| Opus 4.7 ou posterior | Fable, e Opus 4.7 ou posterior | Opus 4.7 e modelos Opus posteriores são classificados como igualmente capazes, então qualquer um deles aceita outro como um advisor. Um Opus 4.7 principal com um advisor Opus 4.6 ou Sonnet 5 é rejeitado |
| Fable 5.1 ou Fable 5 | Fable 5.1, ou a mesma versão Fable | Um advisor Opus ou Sonnet é rejeitado, e também um advisor Fable 5 para um modelo principal Fable 5.1 |
Fable 5.1 requer Claude Code v2.1.257 ou posterior, e Fable 5 requer v2.1.170 ou posterior. Ambos requerem acesso a Fable.
Defina o advisor como fable, opus, ou sonnet. Esses aliases resolvem para a versão padrão integrada do Claude Code para cada família de modelos, que avança com novos lançamentos do Claude Code. Você também pode passar um ID de modelo completo como claude-opus-5.
Subagentes herdam o advisor configurado e aplicam a mesma verificação de emparelhamento contra seu próprio modelo.
Claude Code valida o emparelhamento antes de enviar uma solicitação:
- Se o advisor for menos capaz que o modelo principal, o advisor não será anexado às solicitações do modelo principal. A saída do comando
/advisore uma notificação mostram isso. Subagentes cujo próprio modelo satisfaz o emparelhamento ainda podem usar o advisor. - Se o modelo principal ou o advisor for um modelo que Claude Code não reconhece, o advisor não será anexado.
Advisor Fable e créditos de uso
Em alguns planos, o uso de Fable é cobrado em créditos de uso, e Fable como advisor é cobrado da mesma forma. Se sua conta exigir o consentimento único para cobrar o uso de Fable em créditos de uso, Claude Code solicitará quando você selecionar um modelo Fable com /model e não aplicará Fable como advisor até que você tenha aceito esse consentimento.
Antes de você ter aceito, Claude Code não salva Fable como advisor quando você digita /advisor fable ou escolhe Fable no seletor /advisor. Em vez disso, ele o aponta para /model fable. Com claude --advisor fable, Claude Code sai no lançamento com uma mensagem que aponta para /model fable. Em uma sessão em segundo plano, ele inicia a sessão sem o advisor em vez de sair. Com Fable já salvo como seu advisorModel, Claude Code envia solicitações sem o advisor. Em uma sessão interativa cujo modelo principal suporta o advisor, ele também mostra uma notificação que aponta para /model fable.
Para aceitar o consentimento, execute /model fable e escolha continuar em Fable. Claude Code registra o consentimento e salva Fable como seu modelo selecionado. Em seguida, selecione Fable como o advisor.
Emparelhamentos de modelos comuns
Qualquer emparelhamento aceito funciona. Essas combinações equilibram custo contra capacidade de diferentes formas:
| Emparelhamento | Quando usar |
|---|---|
| Sonnet principal + advisor Opus | Sonnet lida com trabalho rotineiro e escala planejamento, falhas ambíguas e verificações de conclusão para Opus |
| Sonnet principal + advisor Fable | Orientação Fable em pontos de decisão sem executar Fable em toda parte. Requer acesso a Fable |
| Haiku principal + advisor Opus | Modelo principal de menor custo com planejamento forte. Espere custo mais alto que Haiku sozinho, mas menor que mudar o modelo principal para Sonnet ou Opus |
| Opus principal + advisor Opus | Um segundo Opus revisa o primeiro. Útil para tarefas de alto risco onde uma verificação independente importa mais que o custo |
| Fable principal + advisor Fable | Emparelhamento de maior capacidade quando Fable está disponível. Claude Code não aplica um advisor Opus ou Sonnet a um modelo principal Fable |
| Sonnet principal + advisor Sonnet | Uma segunda opinião de menor custo para capturar oversights rotineiros |
Quando Claude consulta o advisor
Claude decide quando chamar o advisor. Tende a consultar antes de se comprometer com uma abordagem, quando um erro continua recorrendo, e antes de declarar uma tarefa concluída, mas o tempo é orientado pelo modelo em vez de baseado em regras.
Você pode pedir uma consulta em seu prompt da mesma forma que solicitaria qualquer ferramenta, por exemplo consult the advisor before you continue. Não há configuração para limitar ou forçar chamadas do advisor; se você quiser que Claude consulte mais ou menos frequentemente durante uma tarefa, diga isso em suas instruções.
O que você vê durante uma sessão
Quando Claude chama o advisor, a transcrição mostra uma linha Advising com o nome do modelo advisor enquanto a chamada está em andamento. Quando o resultado retorna, a linha relata se o advisor forneceu orientação:
- Reviewed: a linha confirma que o advisor revisou a conversa. Quando o advisor retornou orientação legível, pressione
Ctrl+Opara lê-la. - Declined: a linha lê
Advisor declined to advise on this request. Se o advisor forneceu um motivo, pressioneCtrl+Opara lê-lo.
Claude geralmente segue a orientação do advisor, mas se adapta quando sua própria evidência contradiz uma afirmação específica: se uma etapa recomendada falha quando tentada, ou o conteúdo do arquivo contradiz o conselho, Claude expõe o conflito em vez de seguir a orientação incondicionalmente.
O advisor sempre recebe a conversa completa, e Claude controla o tempo. Para mais controle ou uma configuração diferente, veja como o advisor se compara com subagents e opusplan.
Custo
Quando Claude chama o advisor, o modelo advisor lê a conversa, então cada chamada consome tokens nas taxas do modelo advisor além do uso do seu modelo principal. Com faturamento por API, você paga as taxas de entrada e saída do modelo advisor para tokens do advisor. Em planos de assinatura, o uso do advisor conta para os limites de uso do seu plano, exceto que um advisor Fable é cobrado em créditos de uso em planos onde o uso de Fable o faz. Se sua conta exigir o consentimento de créditos de uso, um advisor Fable não cobra nada antes de você concedê-lo, porque Claude Code não aplica a seleção até então.
Claude chama o advisor em pontos de decisão em vez de em cada turno, então emparelhar um modelo principal mais rápido com um advisor mais forte tipicamente custa menos que executar o modelo mais forte em toda parte. O uso do advisor conta para os totais da sessão mostrados por /usage.
Para como tokens do advisor são reportados em respostas da API, veja Usage and billing na documentação da API Claude.
Impacto no prompt caching
Ativar ou desativar o advisor no meio da sessão não invalida o prompt cache do seu modelo principal. Diferentemente de mudar modelos, alternar /advisor mantém o prefixo em cache intacto, e a orientação retornada pelo advisor é armazenada em cache como parte da transcrição em turnos posteriores.
A própria leitura do advisor da conversa não é armazenada em cache. Cada chamada do advisor processa a transcrição completa novamente, sem reutilização entre chamadas.
Requisitos
A ferramenta advisor requer todos os seguintes:
- Apenas API Anthropic: o advisor é uma ferramenta executada no servidor. Não está disponível no Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform ou Microsoft Foundry. Através de um LLM gateway configurado com
ANTHROPIC_BASE_URL, a disponibilidade depende se o gateway encaminha a solicitação intacta para a API Anthropic. - Modelo principal suportado: Fable, Opus 4.6 ou posterior, Sonnet 4.6 ou posterior, ou Haiku 4.5. Consulte Escolher um modelo advisor para saber quais advisors cada um aceita.
- Busca de feature-flag: Claude Code ativa o advisor através de um feature flag que busca da Anthropic. Em uma sessão onde uma variável que desativa a busca de flag está definida, como
DISABLE_TELEMETRY, o advisor permanece desativado. Consulte Recursos que precisam de busca de feature-flag.
Desativar o advisor
Para parar de usar o advisor e limpar seu advisorModel salvo, execute /advisor off ou escolha No advisor no seletor /advisor:
/advisor off
Para desativar a ferramenta advisor inteiramente, defina CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. O comando /advisor fica indisponível e qualquer advisorModel configurado é ignorado. A flag --advisor é aceita mas não tem efeito. Veja Environment variables.
Compare com recursos relacionados
O advisor é uma das várias formas de combinar forças de modelos. Escolha com base em quando você quer um segundo modelo envolvido.
| Abordagem | Quando o modelo mais forte é executado | Como começa |
|---|---|---|
| Ferramenta Advisor | Em pontos de decisão no meio da tarefa | Claude a chama quando precisa de orientação |
opusplan |
Durante plan mode quando permitido por availableModels, depois muda para Sonnet para execução |
Você entra em plan mode |
Subagents com model definido |
Para toda a subtarefa delegada | Claude delega, ou você invoca o subagent |
/model |
Para todos os turnos subsequentes | Você muda de modelos |
Veja também
- Model configuration: mude modelos, defina níveis de esforço, e use
opusplan - Manage costs effectively: rastreie o uso de tokens entre modelos
- Advisor tool in the Claude API: entenda a ferramenta de servidor subjacente, ou use-a diretamente da Messages API
- The advisor strategy: por que emparelhar um modelo principal rápido com um advisor mais forte funciona