Qual modelo usar no Claude Code: Opus, Sonnet ou Haiku para cada tarefa

Opus, Sonnet e Haiku no Claude Code: qual a diferença?

O Claude Code expõe as três famílias como apelidos (aliases). A documentação de configuração de modelo descreve o opus como o Opus mais recente para raciocínio complexo, o sonnet como o Sonnet do dia a dia de código e o haiku como o modelo rápido e econômico para tarefas simples. Na API da Anthropic esses apelidos apontam para Opus 5.5, Sonnet 5.5 e Haiku 5.5; em outros provedores podem apontar para versões mais antigas.

Confira qual modelo o apelido haiku roda na sua versão antes de usar estes preços: no Claude Code 2.1.289 (observado em 2026-10-15) ele rodava o Claude Haiku 4.5, com preço de tabela de US$ 1 de entrada e US$ 5 de saída por MTok. O modelo que o subagente realmente usou aparece em /model e na visão de sessão.

Preços de tabela em dólar, da página de preços da Anthropic, conferidos em 2026-10-24. São preços de API: no plano Pro ou Max você gasta cota, não dólar, mas a proporção entre os modelos mostra a velocidade com que cada subagente consome essa cota. Preço muda; confira a página antes de fazer conta.

Mais do que o valor absoluto, olhe a proporção. A entrada do Opus custa o dobro da do Sonnet e 40 vezes a do Haiku em prompt curto. Subagente que lê uma árvore grande de arquivos paga quase tudo em entrada, então o modelo em que ele roda define quase toda a conta.

Qual modelo usar no Claude Code para cada tarefa?

A tabela abaixo é uma regra prática montada a partir da descrição que a própria Anthropic dá a cada apelido e da política de risco que o Downshift já traz. Não é benchmark: não tenho nota de qualidade por modelo para mostrar e não vou inventar uma.

A lógica por trás: só desça de modelo quando a tarefa for estreita e verificável ao mesmo tempo. Faltou uma das duas, fique onde está.

Haiku ou Sonnet no Claude Code: quando o mais barato dá conta?

O Haiku se paga quando quem confere o resultado não é o próprio modelo: uma suíte de testes, o type-checker, um diff que você lê em segundos. Rename, passada de comentários e inventário de arquivos entram aqui. No preço de tabela, o Sonnet custa 20 vezes o Haiku por token de entrada em prompt curto, então é nesse tipo de tarefa que a economia aparece.

Suba para o Sonnet assim que o subagente precisar escolher entre abordagens, ler código para o qual ninguém apontou ou explicar por que algo falha. Dois cuidados da página de preços: prompt do Haiku 5.5 acima de 100 mil tokens paga a faixa mais cara da tabela, e fora da API da Anthropic o apelido haiku pode cair num Haiku mais antigo, com outro preço.

Como o Claude Code escolhe o modelo do subagente?

A documentação de sub-agents define esta ordem; vale a primeira que existir:

1. O parâmetro model que o Claude passa ao iniciar o subagente.
2. O campo model: na definição do agente, em que inherit significa o modelo da conversa principal.
3. A variável de ambiente CLAUDE_CODE_SUBAGENT_MODEL.
4. O modelo da conversa principal, que é o que sobra quando nada acima está definido.

---
name: log-reader
description: Read logs and list the failing tests
model: haiku
---

Dois detalhes pegam muita gente. Sozinha, a CLAUDE_CODE_SUBAGENT_MODEL não muda os subagentes embutidos Explore e Plan; a documentação manda somar CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 para forçar um modelo em todos. E antes da versão 2.1.251 do Claude Code a variável vinha primeiro e passava por cima do arquivo do agente, então a ordem depende da sua versão.

Por que um modelo fixo por agente não basta

Todas as opções acima escolhem um modelo para o agente inteiro. Um subagente de uso geral recebe um rename na segunda e uma migração de pagamento na terça, e a linha model: dele não distingue uma coisa da outra. O opusplan também não resolve: ele troca por modo, Opus no planejamento e Sonnet na execução, e nunca olha o que foi pedido a cada subagente.

Onde o Downshift entra

O Downshift é um hook PreToolUse local. Quando o Claude Code vai iniciar um subagente, ele lê o texto da tarefa, pontua com regras fixas e define o modelo e o esforço de raciocínio só daquela chamada. Não existe LLM no meio do caminho e o texto da tarefa nunca vai para o disco.

• Por subagente: o rename desce, o desenho entre pacotes continua no topo.
• Na dúvida, fica o seu modelo: se o classificador não tem confiança, o subagente roda no modelo que pediu.
• Área de risco nunca desce: autenticação, pagamento, segredos, criptografia, dados pessoais e operação destrutiva ficam fora do modelo pequeno.

Guias relacionados

• Qual modelo cada subagente usa no Claude Code
• Como economizar tokens no Claude Code, sem mito
• O limite de uso do Claude Code acaba rápido: de onde vem o consumo

Fontes

1. Documentação da Anthropicmeasured
   platform.claude.com/docs/en/about-claude/pricing
   Preços por modelo e faixas do Haiku 5.5 por tamanho de prompt (conferido em 2026-10-24)
2. Documentação da Anthropicmeasured
   code.claude.com/docs/en/model-config
   Apelidos opus, sonnet, haiku, opusplan e modelo padrão (conferido em 2026-10-24)
3. Documentação da Anthropicmeasured
   code.claude.com/docs/en/sub-agents
   Ordem de escolha do modelo do subagente, CLAUDE_CODE_SUBAGENT_MODEL e FORCE (conferido em 2026-10-24)
4. Documentação da Anthropicmeasured
   code.claude.com/docs/en/costs
   Choose the right model
5. Documentação da Anthropicmeasured
   code.claude.com/docs/en/prompt-caching
   Cada modelo tem o próprio cache
6. Repositório do Downshiftmeasured
   docs/evidence/four-arm-mechanical-2026-10-21.md
   Bateria de quatro braços, 46 execuções, intervalos