Melhor modelo para Claude Code

Para a maioria das tarefas diárias em um repositório, o melhor modelo para Claude Code é o Claude Sonnet 5. Ele é a escolha padrão que prioriza eficiência: rápido, capaz, com uma janela de contexto nativa de 1 milhão de tokens e preço por token menor que Opus ou Fable. Comece com Claude Opus 5 quando a correção for mais importante que o volume de trabalho ou quando a tarefa for ambígua, arquitetural ou cara de errar. Use Claude Haiku 4.5 em trabalhos restritos com uma verificação clara e reserve Claude Fable 5.1 para tarefas exigentes e longas que continuem fora do alcance de Opus.

Essa recomendação é uma política de roteamento, não um ranking universal. O guia geral da Anthropic sugere começar a maioria dos workloads com Opus 5, enquanto os aliases do Claude Code descrevem Sonnet como a opção de código diário e Opus como a opção de raciocínio complexo. Este guia escolhe Sonnet como padrão diário para quem otimiza o custo por mudança aceita. Uma equipe que prioriza capacidade pode começar com Opus de forma igualmente razoável.

Para decidir entre opções econômicas de fornecedores diferentes, leia a comparação de código entre Claude Haiku 4.5 e GPT-5.6 Luna. Ela separa a compatibilidade com o protocolo do Claude Code do preço dos tokens e compara o custo por tarefa aceita sem declarar um vencedor universal.

Para escolher entre os dois modelos 5.5, veja Opus 5.5 vs Sonnet 5.5: preços da API, condições dos testes e esforço. As versões anteriores desta página mantêm a data de verificação indicada.

Melhor modelo para Claude Code em resumo

Os preços estão em dólares por milhão de tokens de entrada e saída, antes de cobranças por prompt cache, contexto longo, fast mode ou ferramentas. Anthropic e OmniaKey são limites de cobrança separados: a coluna OmniaKey mostra a tarifa do gateway no catálogo do repositório verificado em 8 de setembro de 2026. Não é um cálculo a partir do preço atual da Anthropic nem uma franquia de assinatura. Confirme a rota e a tarifa vigentes no catálogo de modelos antes de definir um orçamento de produção.

Se você quiser aplicar uma única regra hoje, use Sonnet 5 como padrão voltado à eficiência e suba de nível conforme a tarefa. O melhor modelo é o menos caro que produz uma mudança aceita de forma confiável, não aquele com o maior número de benchmark.

Por que Sonnet 5 é o melhor padrão diário

A Anthropic descreve o Sonnet 5 como sua melhor combinação de velocidade e inteligência, e o alias sonnet do Claude Code é destinado ao código diário. Ele é um ponto de partida sensato para:

• implementar uma feature delimitada com critérios claros de aceitação;
• rastrear um erro conhecido por alguns arquivos;
• escrever ou atualizar testes junto com uma mudança local;
• revisar um pull request focado;
• transformar em código um design já decidido;
• coordenar uma pesquisa comum no repositório por meio de subagentes.

Sonnet 5 possui contexto nativo de 1M, então escolhê-lo já não significa abrir mão do contexto longo dos modelos Opus e Fable atuais. Capacidade de contexto, porém, não é capacidade do modelo. Um milhão de tokens pode conter mais evidências, mas não garante a arquitetura correta nem a identificação de uma falha sutil.

Use o ID exato do modelo quando quiser fixar uma avaliação:

/model claude-sonnet-5

Os IDs da API Claude 5 sem data também são snapshots fixos. Os aliases do Claude Code ainda podem apontar para modelos diferentes conforme o fornecedor ou mudar com novas recomendações. Por isso, um ID exato torna a avaliação mais fácil de reproduzir.

Quando Claude Opus 5 vale o preço maior

Escolha Claude Opus 5 quando a parte cara da tarefa for raciocinar, e não digitar. Alguns sinais típicos:

• o bug atravessa vários serviços e a explicação óbvia está errada;
• o repositório é desconhecido e o pedido deixa decisões importantes em aberto;
• uma decisão de arquitetura ou migração será cara de reverter;
• uma refatoração ampla precisa preservar comportamentos implícitos em muitos arquivos;
• erros de segurança, cobrança ou integridade de dados custam caro para corrigir;
• Sonnet recebeu o contexto relevante, tentou de verdade e ainda assim errou.

Opus 5 custa mais por token, mas o preço por token não é o custo da tarefa concluída. Em trabalhos difíceis, um modelo mais forte pode chegar a um resultado aceito com menos ciclos fracassados e menos correção humana. Em uma edição precisa de um arquivo, essa vantagem talvez nem apareça.

/model claude-opus-5

A abordagem da Anthropic que prioriza capacidade começa a maioria dos workloads com Opus 5 e depois otimiza para baixo. É uma política defensável quando perder um caso extremo sai caro. Para evidências publicadas, comportamento de effort, notas de migração e limites, leia a análise do Claude Opus 5. Para uma decisão direta entre dois modelos, use a comparação entre Claude Opus 5 e Sonnet 5.

Quando Fable 5.1 compensa o valor extra

Claude Fable 5.1 é o modelo mais capaz entre os amplamente lançados pela Anthropic. O Claude Code posiciona a família Fable para trabalhos maiores que uma única sessão: longas execuções autônomas, raciocínio exigente e tarefas que se beneficiam de investigar antes de agir e verificar durante todo o processo.

Isso faz de Fable 5.1 um especialista, não a opção rotineira. Teste-o quando:

• uma investigação de causa raiz continuar sem solução após uma tentativa cuidadosa com Opus 5;
• Opus 5 em xhigh ou max ainda falhar em uma avaliação exigente;
• o trabalho precisar manter coerência por horas entre muitas ferramentas e artefatos;
• a falha for cara o bastante e os seus dados de avaliação justificarem o adicional.

Não pague a tarifa Fable apenas porque um repositório contém muitos arquivos. Escopo claro, contexto focado e um teste de aceitação confiável costumam importar mais que a categoria do modelo. Fable é valioso quando o próprio problema força o limite de Opus, não quando o prompt está mal definido.

/model claude-fable-5-1

Fable 5.1 exige Claude Code v2.1.255 ou mais recente. A menos que seja substituído, o alias fable aponta para Fable 5.1; antes da v2.1.255 ele apontava para Fable 5. O modelo nunca é o padrão de qualquer tipo de conta, e sua aparição no seletor pode depender da organização, do fornecedor e da disponibilidade de usage credits.

A análise e o guia de API do Claude Fable 5.1 cobrem o adaptive thinking sempre ativo, o preço menor de cache read, as restrições de migração e os IDs exatos. A antiga página do modelo Fable 5 e o guia de preços do Fable 5 só continuam úteis quando você avalia deliberadamente o modelo anterior.

Onde Haiku 4.5 se encaixa

Claude Haiku 4.5 é o modelo mais rápido na comparação atual da Anthropic e possui uma janela de contexto de 200K. Ele funciona bem quando a tarefa é estreita, a condição de sucesso é explícita e um erro é barato de detectar:

• localizar arquivos ou símbolos antes que o agente principal comece;
• resumir logs delimitados ou a saída de testes;
• classificar problemas em uma taxonomia conhecida;
• fazer edições repetitivas com um teste determinístico;
• responder a perguntas focadas sobre código já presente no contexto.

Haiku deixa de ser econômico se um pequeno erro gerar várias tentativas caras. Suba de nível quando ele perder relações entre arquivos, entender mal um domínio desconhecido ou exigir correções repetidas. A tabela atual de modelos não oferece o mesmo controle effort para Haiku 4.5, portanto não crie uma política que suponha que ele pode ser ajustado como Sonnet, Opus ou Fable.

Para um subagente leve dedicado, defina o modelo no frontmatter:

---
name: quick-researcher
description: Finds files and summarizes evidence for a scoped repository question
model: haiku
---

Os subagentes do Claude Code herdam o modelo principal quando model é omitido. Fixar haiku para uma pesquisa delimitada evita que cada busca delegada use a categoria Opus ou Fable da sessão principal. Para subagentes de implementação ou revisão, Sonnet é o ponto de partida mais seguro.

Modelo e effort resolvem problemas diferentes

Escolha de modelo e effort corrigem falhas distintas. Fable 5.1, Opus 5 e Sonnet 5 oferecem adaptive thinking e controle de effort; o padrão atual da API Claude é high nos três. Comece nesse ponto e mude uma variável por vez.

Mude o modelo quando o problema for difícil demais. Se Claude tem os arquivos, as ferramentas e as instruções relevantes, investiga a tarefa corretamente e ainda chega à conclusão errada, passe de Haiku para Sonnet, de Sonnet para Opus ou de Opus para Fable.

Aumente o effort quando o modelo escolhido precisar raciocinar mais. Use um nível maior quando a tarefa exigir mais planejamento, análise de longo prazo ou verificação. Isso pode melhorar a conclusão, mas também aumentar a latência e o custo dos tokens de saída.

Corrija o contexto antes de ambos. Um pedido vago, um CLAUDE.md desatualizado, documentação ausente ou uma ferramenta indisponível não se corrigem de forma confiável gastando mais tokens. Primeiro disponibilize o critério de sucesso e as evidências necessárias.

O guia atual da Anthropic diz que ajustar o effort costuma ser uma alavanca melhor que trocar de modelo. Teste isso no seu workload: se Opus com effort maior ainda não passar no teste de aceitação, Fable 5.1 se torna o próximo nível de capacidade.

O que best, fable e opusplan realmente selecionam

Os aliases do Claude Code são convenientes, mas nem todos são IDs fixos de modelo.

Na API Anthropic direta, opus e sonnet apontam atualmente para Opus 5 e Sonnet 5. Outros fornecedores podem resolver esses aliases para versões anteriores. Um gateway muda o destino e pode definir opções próprias de modelo; ele não transforma um alias em garantia entre fornecedores.

Use aliases pela conveniência em uma sessão interativa. Use IDs exatos em avaliações, automações, reprodução de incidentes e qualquer registro que precise informar qual modelo foi realmente executado.

Uma política prática de roteamento

Troque nos limites das tarefas, não a cada poucas interações:

1. Comece features e manutenção rotineiras com Sonnet 5 no effort padrão.
2. Use Haiku 4.5 em subagentes pequenos e isolados, com saída determinística.
3. Comece com Opus 5 quando ambiguidade, escopo arquitetural ou custo de falha já forem altos.
4. Tente aumentar o effort de Opus antes de pagar Fable se faltar profundidade de raciocínio.
5. Use Fable 5.1 quando uma tarefa exigente ou seu conjunto de avaliações justificar o adicional.
6. Volte a Sonnet quando a decisão difícil estiver resolvida e a execução se tornar mecânica.

Trocar o modelo no meio de uma conversa longa pode reduzir o reaproveitamento de prompt cache e deixar a próxima interação mais lenta e cara. Troque em um limite claro sempre que possível. Para um trabalho sem relação, /clear costuma ser melhor que levar uma sessão antiga para outro modelo.

Compare mudanças aceitas, não impressões

Para gerenciar o contexto e a sessão por trás dessa métrica, consulte o guia para reduzir o uso de tokens do Claude Code. Ele explica como diminuir o contexto repetido sem tornar a avaliação artificialmente fácil.

Uma avaliação local justa precisa do mesmo estado do repositório, prompt, ferramentas, permissões, effort e teste de aceitação para cada modelo. Monte um conjunto pequeno que represente seu trabalho real:

Execute cada tarefa mais de uma vez porque os resultados do agente variam. Registre resultado aceito, minutos de correção humana, tempo decorrido, tokens de entrada, cache e saída e chamadas de ferramentas. Um modelo cujo token custa o dobro ainda pode ser mais barato por mudança aceita; se o modelo econômico passar no mesmo teste, ele é a melhor escolha para essa classe de tarefa.

Não mude o modelo e o effort juntos na primeira comparação. Mantenha o effort padrão ao comparar modelos e depois varie o effort naquele que pretende usar. Caso contrário, você não saberá se a diferença veio da capacidade ou do orçamento de raciocínio.

Como trocar de modelo na OmniaKey

As etapas de conexão estão no guia de configuração do Claude Code. Depois de configurar o endpoint compatível com Anthropic, use /model com um ID exato suportado:

/model claude-haiku-4-5
/model claude-sonnet-5
/model claude-opus-5
/model claude-fable-5-1

Atualize o Claude Code se um modelo atual não aparecer: Sonnet 5 exige v2.1.197 ou mais recente, Opus 5 exige v2.1.219 ou mais recente e Fable 5.1 exige v2.1.255 ou mais recente. Execute claude update, reabra o seletor e confirme a rota no catálogo atual.

Para um trabalho reproduzível, solicite o modelo exato e inspecione o modelo e o uso retornados, em vez de presumir o comportamento de um alias ou um fallback silencioso. A disponibilidade varia por fornecedor, organização e rota. Um erro deve interromper a execução e não é evidência de que outro modelo concluiu a tarefa.

Claude Code foi projetado para modelos Claude. A Anthropic informa que um gateway pode encaminhar formatos de API suportados, mas não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude. Se a decisão for entre Claude, GPT ou Gemini, escolha um agente compatível com o protocolo necessário. O guia de famílias de modelos para agentes de programação cobre essa questão mais ampla, enquanto Claude Code vs Codex compara os produtos.

Para a decisão direta entre modelos cotidianos de fornecedores diferentes, use a comparação de código entre Claude Sonnet 5 e GPT-5.6 Terra. Ela separa a escolha do modelo da escolha do agente entre Claude Code e Codex.

Recomendação final

Para a maioria dos desenvolvedores que otimiza volume diário e custo, Claude Sonnet 5 é o melhor modelo padrão para Claude Code. Comece com Opus 5 se a tarefa já for ambígua ou cara de errar, use Haiku 4.5 em apoio delimitado e passe para Fable 5.1 apenas em trabalhos exigentes e longos que Opus não consegue aprovar com um effort adequado.

Trate isso como uma base de roteamento. Seus próprios dados de mudanças aceitas devem definir os limites finais.

Perguntas frequentes

Qual é o melhor modelo para Claude Code?

Claude Sonnet 5 é o melhor padrão voltado à eficiência para a maioria do código diário. Claude Opus 5 é o melhor ponto inicial voltado à capacidade para arquitetura complexa, depuração sutil e falhas caras. Fable 5.1 atende o trabalho longo mais difícil, enquanto Haiku 4.5 serve para tarefas simples e delimitadas.

Opus é melhor que Sonnet no Claude Code?

Opus é mais capaz em trabalhos difíceis e ambíguos, mas Sonnet é mais rápido e barato em tarefas rotineiras. O guia geral da Anthropic começa a maioria dos workloads com Opus; o Claude Code rotula Sonnet para código diário. Escolha pelo custo da falha e meça mudanças aceitas.

Devo usar Fable 5.1 ou Fable 5?

Use Fable 5.1 em novas avaliações. É a versão mais recente, o alias fable aponta para ela nos clientes atuais compatíveis e o preço-base de entrada e saída é mantido enquanto cache reads custam menos. Fixe Fable 5 apenas quando precisar reproduzir um resultado do modelo anterior.

Todo repositório grande deve usar Fable 5.1?

Não. O tamanho do repositório por si só não justifica Fable. Forneça contexto focado e experimente primeiro Sonnet ou Opus; depois teste Fable quando o problema for realmente longo, ambíguo e estiver fora do alcance dos modelos mais baratos.

Qual modelo os subagentes do Claude Code devem usar?

Use Haiku em buscas, classificações ou resumos delimitados com verificações claras. Use Sonnet em implementação, revisão e coordenação. Deixe um subagente herdar Opus ou Fable somente quando sua própria tarefa exigir essa capacidade.

Um effort maior equivale a um modelo melhor?

Não. O modelo controla a capacidade fundamental; o effort controla quanto raciocínio um modelo compatível aplica. Suba de modelo se ele falhar mesmo com effort adequado. Aumente primeiro o effort quando a tarefa apenas exigir uma análise mais profunda.

Claude Code pode usar modelos GPT ou Gemini?

Não. A Anthropic documenta o Claude Code como uma ferramenta feita para modelos Claude e não oferece suporte ao roteamento para outros modelos por gateway. Use Codex, Cursor, Cline, aider ou outro agente compatível para GPT ou Gemini.

Fontes verificadas

Todas as fontes oficiais abaixo estão publicadas em inglês.

• Anthropic: configuração de modelos no Claude Code
• Anthropic: como escolher o modelo Claude correto
• Anthropic: visão geral dos modelos Claude
• Anthropic: preços da API
• Anthropic: visão geral do Claude Fable 5.1
• Anthropic: gerenciamento de custos do Claude Code
• Anthropic: subagentes do Claude Code
• Anthropic: prompt cache do Claude Code
• Anthropic: gateways LLM