Como escolher modelos do Claude para programação: guia da Anthropic e ajustes do Claude Code

A Anthropic publicou um guia completo para escolher entre Fable 5.2, Opus 5.5, Sonnet e Haiku. É possível pedir ao Fable 5.2 que verifique sua configuração do Claude Code conforme as recomendações deste guia.

Antes, o subagente integrado Explore no Claude Code sempre rodava no Haiku. Agora, ele usa o modelo principal. Se esse modelo for Opus 5.5 ou se você acabou de mudar para Fable 5.2, o Explore desperdiça a cota de um modelo mais poderoso sempre que lê arquivos ou busca código.

Por isso, vale criar um subagente próprio chamado Explore e definir model: haiku.

Prompt para verificar a configuração

Leia este guia: https://claude.dev/blog/which-claude-model-should-you-build-with/

Depois, verifique minha configuração do Claude Code conforme as recomendações: configurações de usuário e de projeto, subagentes em ~/.claude/agents e .claude/agents, além do arquivo CLAUDE.md.

Encontre três categorias de problemas.

1. Subagentes usando modelos inadequados

Encontre subagentes que apenas buscam arquivos, leem logs ou executam testes, mas não têm um modelo explícito, portanto usam o modelo principal.

Se não houver um subagente Explore próprio com model: haiku, considere isso também um problema.

Verifique também a situação inversa: subagentes que editam código ou tomam decisões devem permanecer no modelo principal. Certifique-se de que a variável CLAUDE_CODE_SUBAGENT_MODEL não os força a usar um modelo mais fraco. Verifique apenas essa variável: no bloco env das configurações e no ambiente do shell.

2. Modelo ou nível de esforço não corresponde à tarefa

Use a tabela do guia:

• Opus 5.5 com nível de esforço medium para desenvolvimento e depuração cotidianos.
• Sonnet 5.5 para tarefas bem definidas, como corrigir um bug ou implementar uma função conforme especificação.
• Fable 5.2 para refatorações grandes, migrações e coordenação de muitos subagentes.

Marque níveis de esforço acima de high se estiverem definidos como padrão, e sugira primeiro tentar um modelo mais poderoso com nível de esforço menor.

Marque também opusplan se estiver selecionado como padrão, porque nesse modo a edição de código é executada no Sonnet.

3. Não há como verificar os resultados no projeto

Verifique se CLAUDE.md indica como executar testes e builds, e se existe alguma verificação que possa ser executada.

O guia recomenda esta ordem: primeiro garantir que o resultado possa ser verificado, depois aumentar o nível de esforço em um passo e só então migrar para um modelo mais poderoso.

Para cada problema encontrado

• Cite a configuração correspondente e a linha do guia.
• Explique a quais custos isso leva e em quais situações criará problemas.
• Proponha uma correção mínima como uma configuração pronta para copiar.

Depois, estude o código do projeto e os últimos commits. Crie uma tabela mostrando quais tipos de tarefas neste projeto são melhor executados com quais modelos e com qual nível de esforço.

Por fim, explique como usar /model e /usage para executar uma tarefa da minha lista em dois modelos diferentes e comparar os custos.

Mostre primeiro as recomendações. Ainda não altere nada.