A ferramenta advisor é experimental e requer Claude Code v2.1.98 ou posterior com a API Anthropic. Não está disponível no Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. O comportamento, preços e disponibilidade podem mudar.
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
Se qualquer uma dessas opções definir um modelo advisor, o advisor será ativado para sessões cujo modelo principal o suporta. Para parar de usá-lo, veja Desativar o advisor.
Para usar Fable 5 como o advisor, você precisa de Claude Code v2.1.170 ou posterior e acesso a Fable 5 para sua organização. Use o comando /advisor
Execute /advisor sem argumentos para abrir um seletor listando os modelos advisor disponíveis, ou passe o modelo diretamente:
Sua seleção é salva em advisorModel nas configurações do usuário e persiste entre sessões. Se seu modelo principal atual não suportar o advisor, a seleção ainda é salva e ativada quando você muda para um modelo principal compatível com /model.
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:
A flag tem precedência sobre a configuração advisorModel para essa sessão. Diferentemente de /advisor, que salva uma seleção inativa, a flag sai com um erro se o modelo principal da sessão não suportar o advisor.
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 | |
| Opus 4.6 ou posterior | Fable, Opus na versão do modelo principal ou acima | Um Opus 4.7 principal com um advisor Opus 4.6 é rejeitado |
| Fable 5 (v2.1.170+) | Fable | Um advisor Opus ou Sonnet é rejeitado |
opus, sonnet, ou fable. Esses aliases resolvem para a versão mais recente de cada modelo. Você também pode passar um ID de modelo completo como claude-opus-4-8.
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
/advisor e 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.
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 5 em pontos de decisão sem executar Fable 5 em toda parte. Requer v2.1.170 ou posterior e acesso a Fable 5 |
| 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 5 está disponível (v2.1.170+). Fable é um nível superior a Opus e Sonnet, então é o único advisor aceito para 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 confirma que o advisor revisou a conversa. Pressione Ctrl+O para expandi-la e ler a orientação completa do advisor.
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
Cada chamada do advisor envia a conversa para o modelo advisor, então consome tokens nas taxas do modelo advisor além do uso do seu modelo principal. Com faturamento por API, tokens do advisor são cobrados nas taxas de entrada e saída do modelo advisor. Em planos de assinatura, o uso do advisor conta para os limites de uso do seu plano.
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 modelo ou nível de esforço, 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:
- Claude Code v2.1.98 ou posterior: execute
claude update para atualizar.
- Apenas API Anthropic: o advisor é uma ferramenta executada no servidor. Não está disponível no Amazon Bedrock, Google Vertex AI 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: Opus 4.6 ou posterior, Sonnet 4.6, ou Haiku 4.5. Fable 5 também se qualifica no Claude Code v2.1.170 ou posterior.
Desativar o advisor
Para parar de usar o advisor e limpar seu advisorModel salvo, execute /advisor off ou escolha No advisor no seletor /advisor:
Para desativar a ferramenta advisor inteiramente, incluindo o comando /advisor e a flag --advisor, defina CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1. 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.
| 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, 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
