Seleção de Modelos
~20 min Intermediário Parte 5

Seleção de Modelos

Como escolher o modelo certo para cada tarefa — Opus, Sonnet e Haiku, extended thinking, custos e estratégias de troca dinâmica.

Escolher o modelo correto é uma das decisões mais impactantes para produtividade e custo. O Claude Code suporta toda a família de modelos Anthropic — cada um com perfil diferente de velocidade, capacidade e preço.

Modelos disponíveis

Os três níveis da família Claude e seus casos de uso ideais:

claude-opus-4-6     — mais poderoso, mais lento, mais caro
                      ideal: tarefas complexas, arquitetura, refatorações grandes

claude-sonnet-4-6   — balanceado (padrão recomendado)
                      ideal: desenvolvimento do dia a dia, code review, explicações

claude-haiku-4-5    — mais rápido, mais barato
                      ideal: tarefas simples, completions rápidas, CI/CD

Comparativo de modelos

Modelo Velocidade Custo relativo Melhor para
claude-opus-4-6 Lento Alto Arquitetura, refatorações grandes, análise de segurança profunda
claude-sonnet-4-6 Médio Médio Features normais, bug fixing, code review, documentação
claude-haiku-4-5 Rápido Baixo Completions, reformatação, tarefas mecânicas, CI/CD cost-efficient

Selecionando o modelo

Diferentes formas de selecionar o modelo em uso:

# Na sessão via flag
claude --model claude-opus-4-6

# Permanente no settings.json
{ "model": "claude-sonnet-4-6" }

# Trocando durante a sessão com slash command
/model claude-haiku-4-5

# Via variável de ambiente
export ANTHROPIC_MODEL=claude-sonnet-4-6
claude

Configurando modelo padrão no settings.json

Você pode definir um modelo padrão global e outro para tarefas rápidas (background agents):

{
  "model": "claude-sonnet-4-6",
  "smallModel": "claude-haiku-4-5"
}
O campo smallModel é usado internamente pelo Claude Code para tarefas de baixo custo, como completions de linha e operações de background.

Guia de seleção por tipo de tarefa

Opus:    arquitetura de sistema, migração de codebase inteira,
         análise de segurança profunda, raciocínio complexo

Sonnet:  features normais, bug fixing, code review,
         documentação, explicações, refatorações médias

Haiku:   completions rápidas, reformatação de código,
         tarefas mecânicas repetitivas, pipelines CI/CD

Extended Thinking

Os modelos Opus e Sonnet suportam um modo de raciocínio aprofundado antes de responder. Ative via prompt natural:

Modelos suportam "extended thinking" — Claude pensa antes de responder.
Ativar com: "pense profundamente antes de responder"
Mais lento mas mais preciso em problemas complexos.

Casos de uso ideais para extended thinking:

  • Algoritmos com múltiplas abordagens possíveis
  • Decisões de arquitetura com trade-offs complexos
  • Debug de problemas difíceis de reproduzir
  • Análise de segurança em código crítico

Custo estimado por tarefa

Referência aproximada de custo por tipo de uso com Sonnet como base:

Sessão 1h desenvolvimento normal:  ~$0.10–$0.50  (Sonnet)
Code review completo de PR:        ~$0.05–$0.20  (Sonnet)
Refatoração de módulo grande:      ~$0.20–$1.00  (Opus)
Pipeline CI/CD (análise rápida):   ~$0.01–$0.05  (Haiku)
Agent team com 5 subagentes:       ~$0.50–$2.00  (Sonnet)
Dica de custo: Use Haiku para tarefas repetitivas em CI/CD e reserve Opus para tarefas que realmente exigem raciocínio profundo. O Sonnet cobre ~80% dos casos de uso do dia a dia.

Estratégia de troca dinâmica

Em projetos grandes, trocar de modelo conforme a complexidade da tarefa pode reduzir custos significativamente sem perder qualidade:

# Início do dia — planejamento com Opus
claude --model claude-opus-4-6 "analise o estado do projeto e proponha arquitetura para a nova feature"

# Implementação com Sonnet (padrão)
claude "implemente a feature auth conforme planejado"

# Tarefas rápidas com Haiku
claude --model claude-haiku-4-5 "formate este arquivo JSON"
claude --model claude-haiku-4-5 "renomeie todas as variáveis de snake_case para camelCase em utils.ts"

Exercício: comparar modelos em uma tarefa de refatoração

Objetivo

Compare o resultado de Sonnet vs Opus em uma tarefa de refatoração real:

  • Execute a mesma instrução de refatoração com --model claude-sonnet-4-6
  • Execute novamente com --model claude-opus-4-6
  • Compare qualidade, tempo de resposta e custo via /status
  • Identifique em qual tipo de tarefa a diferença é mais perceptível

Comandos

# Sessão com Sonnet
claude --model claude-sonnet-4-6 "refatore src/auth.ts para usar async/await e adicione tratamento de erros"
/status

# Nova sessão com Opus
claude --model claude-opus-4-6 "refatore src/auth.ts para usar async/await e adicione tratamento de erros"
/status

# Verificar o modelo ativo na sessão
/model
Use /status ao final de cada sessão para ver tokens consumidos e custo estimado. Isso ajuda a calibrar sua escolha de modelo ao longo do tempo.

Recursos

0%