Skip to main content
A ferramenta advisor é experimental e requer a API Anthropic. Não está disponível no Amazon Bedrock, Claude Platform on AWS, na plataforma de agentes do Google Cloud ou no Microsoft Foundry. O comportamento, preços e disponibilidade podem mudar.
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:
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, exceto nos casos que a entrada advisorModel lista como aplicável apenas à sessão atual. O comando também funciona onde não há um seletor de terminal: em modo não interativo com -p, no Agent SDK, no aplicativo desktop e sobre Remote Control. Isso requer Claude Code v2.1.260 ou posterior. Nessas superfícies:
  • Execute /advisor sem argumento para imprimir o modelo advisor atual e os aliases que ele aceita.
  • Execute /advisor com um modelo, como /advisor opus, para defini-lo.
  • Execute /advisor off para desativá-lo.
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:

​
Use a flag --advisor

Para definir o advisor para uma única sessão sem alterar sua configuração salva, inicie com a flag:
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 availableModels da 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: Fable 5.1 requer Claude Code v2.1.257 ou posterior. Ambos os modelos Fable 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, e a API valida novamente:
  • Para um advisor que a tabela lista como rejeitado, Claude Code não o anexa às solicitações do modelo principal. A saída do comando /advisor e uma notificação mostram isso. Subagentes cujo próprio modelo satisfaz o emparelhamento ainda podem usar o advisor.
  • Para um advisor que a tabela lista como falhando com um erro de API, Claude Code o anexa e a API o recusa. Cada solicitação falha com '<advisor model>' cannot be used as an advisor when the request model is '<main model>' até que você altere o advisor com /advisor ou o desative.
  • 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:

​
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+O para lê-la.
  • Declined: a linha lê Advisor declined to advise on this request. Se o advisor forneceu um motivo, pressione Ctrl+O para 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. Como esses tokens do advisor são faturados depende de como você paga:
  • Faturamento por API: você paga as taxas de entrada e saída do modelo advisor para tokens do advisor
  • 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, execute /advisor off ou escolha No advisor no seletor /advisor:
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. O advisor é uma das várias formas de combinar forças de modelos. Escolha com base em quando você quer um segundo modelo envolvido.

​
Veja também