Claude Code Advisor: configure Sonnet + Opus e confira as chamadas

Use o advisor do Claude Code para deixar Sonnet cuidar da programação rotineira enquanto Opus revisa decisões difíceis. Comece com claude --model sonnet --advisor opus e confira a linha Advising e o resultado da consulta antes de confiar na revisão. O modelo escolhe quando consultar; as consultas consomem tokens extras e podem parar depois que um gateway rejeita a ferramenta.

Em 2026-11-06, o recurso advisor continua experimental. Os exemplos abaixo pressupõem um cliente CLI instalado, autenticação funcionando e uma requisição comum bem-sucedida pela Anthropic. Contas com assinatura e contas cobradas pela API podem usar esse caminho. O suporte por gateway exige verificações próprias.

Quando usar o advisor em vez de outro modelo?

Escolha o advisor para uma refatoração, um erro recorrente ou uma implementação com decisões difíceis em alguns momentos. Sonnet continua a tarefa enquanto um segundo modelo revisa a conversa, incluindo chamadas de ferramentas e seus resultados.

Essa é a divisão descrita na estratégia com advisor da Anthropic. Ela não garante resultados com a qualidade de Opus em todas as tarefas nem uma economia fixa.

Sua necessidade	O que escolher	O que muda
Orientação ocasional durante a execução	Advisor	Claude decide quando consultar outro modelo
Planejamento com Opus seguido de implementação com Sonnet	opusplan	O modo de planejamento usa Opus, conforme o acesso ao modelo; a execução usa Sonnet
Uma tarefa separada de pesquisa ou revisão	Um subagente com model definido	O modelo selecionado executa a tarefa delegada
Raciocínio mais forte nas próximas requisições da sessão principal	/model	Você muda o modelo principal

Para uma tarefa curta com pouco planejamento, comece sem advisor. Se quase toda etapa precisar de Opus, mude a sessão principal para Opus 5.5.

O comando de inicialização não cria três subagentes Haiku para busca, grep e documentação. Para essa configuração separada, consulte a configuração documentada do modelo dos subagentes. A opção documentada da CLI é --agents com JSON. Não a substitua pelo comando --subagents haiku que circula em publicações.

Ative o advisor de uma destas três formas

Use a opção de inicialização no primeiro teste: ela não altera a preferência salva para o consultor. Primeiro, confira a versão do cliente no Bash:

claude --version

Use 2.1.284 ou posterior neste exemplo com Sonnet 5.5 e Opus 5.5. Os requisitos dos modelos definem esse mínimo; ele não indica a versão de lançamento do advisor. O comando documentado para atualizar a CLI é claude update.

Para uma sessão: use —advisor

Execute no Bash, a partir do diretório do projeto:

claude --model sonnet --advisor opus

Em 2026-11-06, esses aliases selecionam Sonnet 5.5 e Opus 5.5 nas configurações atuais de acesso direto à Anthropic. As associações dos aliases podem mudar ou ser sobrescritas. Para indicar as versões explicitamente:

claude --model claude-sonnet-5-5 --advisor claude-opus-5-5

A opção prevalece sobre advisorModel nessa sessão. Segundo a documentação do advisor, é esperado que --advisor não apareça em claude --help.

Durante uma sessão: use /advisor

Digite dentro do Claude Code:

/advisor opus

Você deve ver Advisor set to seguido do nome do modelo. Executar /advisor sem argumentos abre o seletor de modelos.

Em uma sessão de terminal local, a seleção normalmente se torna o padrão salvo. O salvamento em sessões remotas segue regras próprias na referência de configurações.

Para sessões futuras: defina advisorModel

Adicione esta propriedade às configurações do usuário em ~/.claude/settings.json:

{
  "advisorModel": "opus"
}

Mantenha as demais configurações do arquivo. Essa propriedade seleciona o consultor; ela não define Sonnet como modelo principal.

Depois de ativar o recurso, procure este aviso:

Advisor Tool (experimental) is on and may use more tokens · /advisor

O aviso confirma a ativação. Ele não comprova que houve uma consulta.

Quais combinações de modelos funcionam?

Escolha um consultor que o Claude Code classifique no mesmo nível ou acima do modelo principal. Estas combinações selecionadas vêm da tabela atual de pares, conferida em 2026-11-06.

Modelo principal	Consultor	Uso previsto
Sonnet 5.5	Opus 5.5	Implementação rotineira com revisão de um modelo mais forte
Haiku 5.5	Opus 5.5	Um modelo principal mais leve com consulta aprofundada
Sonnet 5.5	Sonnet 5.5	Uma segunda revisão com o mesmo modelo
Opus 5.5	Opus 5.5	Uma segunda revisão com Opus
Opus 4.7 ou Opus 4.8	Sonnet 5.5	Uma combinação documentada entre famílias diferentes

Haiku 5.5 como modelo principal ou consultor exige 2.1.293 ou posterior. Sonnet 5.5 como consultor de Opus 4.7 ou Opus 4.8 exige 2.1.287 ou posterior. Haiku 4.5 pode pedir orientação, mas não pode atuar como consultor.

Essas são combinações aceitas, não um ranking garantido de qualidade para seu repositório. A lista de modelos permitidos availableModels da organização ainda pode bloquear uma escolha. Uma seleção proibida ou inválida para --advisor pode interromper a inicialização interativa com erro. Um consultor de classificação inferior ou um ID de modelo não reconhecido pode deixar a sessão principal funcionando sem advisor.

Subagentes herdam a configuração do advisor e verificam a combinação com seus próprios modelos. Inclua as possíveis consultas deles ao avaliar o consumo total.

Como comprovar que o consultor foi chamado?

Use o registro de chamadas da ferramenta como evidência e depois confira o consumo. Um aviso na inicialização ou a afirmação do Claude de que consultou Opus não basta.

Experimente este prompt somente de leitura em um repositório que você conhece. Ele pede uma análise da autenticação, uma pequena refatoração e os testes necessários, sem alterar arquivos:

Inspect this repository's authentication flow without changing files.
Propose one small refactor and identify its main regression risk.
Consult the advisor before presenting the plan.
Include the tests that would check the proposed change.

Esse é um teste sugerido, não uma garantia de chamada. Claude escolhe o momento. Planejamento, erros recorrentes e verificações de conclusão são ocasiões comuns, não três gatilhos fixos.

Não existe uma configuração do advisor no Claude Code para forçar chamadas ou limitar sua quantidade. Instruções em um prompt ou em CLAUDE.md podem pedir mais consultas, mas não criam uma etapa obrigatória de revisão.

Procure Advising com o nome do modelo consultor. Interprete o resultado:

Resultado	O que comprova	Próxima ação
Reviewed	O consultor revisou a conversa	Pressione Ctrl+O se houver orientação legível; examine o plano resultante
Declined	A chamada ocorreu, mas o consultor se recusou a dar orientação	Leia o motivo, se disponível, e reavalie o pedido
Unavailable	A chamada falhou	Confira Advisor unavailable (<error_code>) e investigue essa falha
Nenhuma entrada Advising	Nenhuma consulta observada	Peça uma explicitamente; se nada aparecer, verifique a ativação e o roteamento

Execute /usage depois do teste. O consumo do advisor entra nos totais da sessão, mas um total crescente, por si só, não comprova uma revisão bem-sucedida. Confira também o resultado no registro da sessão.

Quanto custa uma consulta ao advisor?

Inclua no orçamento outra leitura da conversa por um segundo modelo. Os tokens do consultor se somam ao consumo do modelo principal.

Na cobrança por API, os tokens de entrada e saída do advisor usam as tarifas do modelo consultor. No fluxo com Sonnet/Opus por assinatura, as consultas contam para os limites de uso do plano. Não existe uma franquia separada de revisões ilimitadas.

Em 2026-11-06, os preços padrão da Anthropic para Opus 5.5 são $4 por milhão de tokens de entrada e $20 por milhão de tokens de saída.

A seguir está uma estimativa hipotética apenas para o advisor. Considere cobrança direta pela API Anthropic, tarifas globais padrão, 50,000 tokens de entrada sem cache e 2,000 tokens de saída cobrados. A saída cobrada inclui os tokens de raciocínio.

Advisor token cost
= (50,000 × $4 + 2,000 × $20) / 1,000,000
= $0.24

Essa não é uma tarifa fixa por consulta. A conta exclui o trabalho do modelo principal e não calcula o consumo da franquia da assinatura. Um histórico maior ou uma resposta mais longa do consultor aumenta a estimativa.

Para o Claude Code, a documentação do advisor diz que cada consulta relê todo o histórico sem reutilizar o cache do consultor. Ativar ou desativar /advisor mantém o cache de prompt do modelo principal. A orientação recebida pode entrar nesse cache nos turnos seguintes.

Essa regra vale especificamente para o Claude Code. A documentação do uso direto da Messages API agora descreve uma opção caching separada para o advisor. Ela não é uma etapa de configuração deste fluxo na CLI.

Antes de adotar a combinação, compare o custo total da mesma tarefa concluída. Use as mesmas verificações de aceitação e conte as novas tentativas e as tentativas que falharam. Nas sessões com muito contexto, meça quanto contexto o MCP acrescenta antes de atribuir todo aumento ao advisor.

O valor em dólares de /usage é uma estimativa. Confira as cobranças no registro de faturamento do provedor.

Corrija erros 400 e a desativação silenciosa em gateways

Escolha a correção conforme a falha. Falta de ativação, rejeição de uma combinação de modelos e incompatibilidade com a ferramenta no servidor pedem ações diferentes.

Sem aviso de inicialização ou atividade do advisor

Confira as variáveis de ambiente e a seção env das configurações antes de mudar os modelos. CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 desativa o recurso por completo.

Confira também DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Elas podem desativar o mecanismo de feature flags que o advisor exige. Consulte os efeitos documentados, incluindo as condições para a primeira sessão e para as credenciais usadas com um gateway.

Se a organização definiu esses parâmetros intencionalmente, use uma configuração aprovada ou outro fluxo de revisão. Se uma configuração local opcional causou o problema, remova-a de onde foi definida e reinicie o cliente. Repita o prompt de verificação e examine o registro. Alterar uma variável de ambiente, por si só, não comprova que funcionou.

A sessão funciona, mas a combinação de modelos foi rejeitada

Confira os IDs efetivos dos dois modelos e availableModels. Um consultor salvo pode continuar inativo se o modelo principal for incompatível.

Se a API rejeitar uma combinação enviada na requisição, Claude Code tenta novamente sem advisor. A conversa pode continuar sem mostrar erro. Selecione um consultor aceito e use /clear, /compact ou uma nova sessão antes de verificar novamente.

Antes de limpar a conversa, preserve o contexto da tarefa de que ainda precisa. Essa recuperação se aplica à combinação rejeitada, não a qualquer rejeição do gateway.

Aparece Input tag ‘advisor_20260301’

Um erro 400 ou 422 que mencione Input tag 'advisor_20260301' indica que o gateway ou o serviço de destino rejeitou o tipo da ferramenta advisor.

A partir de 2.1.280, Claude Code reconhece essa rejeição e repete a requisição uma vez sem a entrada do advisor e seu valor beta. A sessão de programação pode voltar a funcionar enquanto o advisor continua ausente.

O guia de compatibilidade com gateways define a duração atual desse estado: requisições à mesma URL base omitem advisor até você encerrar Claude Code. O comando /advisor fica indisponível nesse estado. Depois de corrigir a rota, encerre completamente o processo do Claude Code e inicie-o novamente. Apenas /clear não é o procedimento de recuperação documentado.

Se o cliente for antigo, atualize-o primeiro. Se o erro persistir em um cliente atual, peça ao responsável pelo gateway que confira a definição da ferramenta:

• A entrada de tools com tipo advisor_20260301 chega a um serviço Anthropic que oferece suporte ao recurso.
• O valor correspondente do cabeçalho anthropic-beta, advisor-tool-2026-03-01, segue junto com ela.
• Os corpos das respostas de erro preservam a redação que Claude Code usa para reconhecer a rejeição.

Se remover a ferramenta e seu cabeçalho fizer as requisições comuns funcionarem, isso demonstra fallback: a execução continua sem advisor. Esse resultado não comprova compatibilidade com o advisor.

Em 2026-11-06, o BetterToken lista claude-sonnet-5-5 e claude-opus-5-5. Sua configuração para Claude Code usa https://bettertoken.ai em ANTHROPIC_BASE_URL, sem /v1. A disponibilidade dos modelos não confirma suporte ao advisor. Obtenha confirmação para a rota usada e verifique uma consulta real.

Se as requisições Messages comuns também falharem, primeiro teste a conexão isoladamente com o guia de requisição mínima à Claude API. Depois repita o teste específico do advisor.

Desative o advisor

Use o comando da sessão quando quiser interromper as consultas:

/advisor off

Para desativar completamente, defina esta variável no Bash antes de iniciar:

export CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1
claude

Com essa variável definida, /advisor fica indisponível e Claude Code ignora advisorModel. Ele aceita --advisor, mas a opção não tem efeito.