Modelo Padrão do Claude Code: Como Alterar, Trocar e Escolher o Mais Adequado

O modelo padrão do Claude Code é o Sonnet — especificamente a versão mais recente do Sonnet para seu provedor (Sonnet 5 na API Anthropic a partir de meados de 2026). O Sonnet é rápido, lida bem com a maioria das cargas de trabalho de codificação e mantém os custos razoáveis ao longo de sessões longas. Se você não alterou nada, é isso que está usando.

Alterar o modelo leva um comando: /model opus dentro de uma sessão, ou claude --model opus ao iniciar. O restante deste guia aborda quando realmente vale a pena trocar para cada modelo, como os aliases abreviados são resolvidos em diferentes provedores e como usar o endpoint da Novita AI para acessar um conjunto mais amplo de modelos de pesos abertos a um custo menor por token.

Como Alterar o Modelo Rapidamente

Se seu objetivo é simplesmente alterar o modelo do Claude Code, use um destes:

• Execute /model dentro do Claude Code e escolha sonnet, opus, haiku ou outro alias disponível.
• Inicie uma sessão avulsa com claude --model opus.
• Defina "model": "opus" em ~/.claude/settings.json se quiser que o novo modelo persista.

Para a maioria dos usuários, /model sonnet, /model opus e claude --model opus são os únicos comandos necessários. ANTHROPIC_MODEL ainda é útil para scripts e CI, mas as variáveis de ambiente de alias específicas do provedor não são necessárias para a troca comum de modelos.

Qual é o Modelo Padrão no Claude Code?

Quando você inicia o Claude Code sem especificar um modelo, ele começa com o alias sonnet, que resolve para a versão mais recente do Sonnet para seu provedor. Na API Anthropic (o endpoint padrão), isso significa Claude Sonnet 5 a partir de meados de 2026. Usuários dos planos Gratuito e Pro ambos usam o Sonnet 5 por padrão.

A lógica é direta: o Sonnet oferece o melhor equilíbrio entre velocidade e capacidade para o trabalho de codificação do dia a dia. Ele lida com edições de arquivos, refatorações em várias etapas, geração de testes e a maioria das tarefas em escala de repositório sem a latência extra ou o custo do Opus. Na maioria das sessões, trocar para um modelo mais pesado não produz resultados significativamente melhores.

Se sua organização definiu um modelo padrão para toda a organização no console de administração do Claude Code, isso substitui o padrão do sistema e entra em vigor na próxima vez que você iniciar uma sessão. Você ainda pode substituí-lo por sessão com /model ou a flag --model. Para regras de projeto que moldam como os padrões se comportam, veja regras de projeto em CLAUDE.md.

Modelos Disponíveis e Aliases

O Claude Code usa aliases em vez de IDs de modelo completos para a seleção diária de modelos. Um alias como sonnet sempre aponta para a versão recomendada para seu provedor, para que você não precise atualizar sua configuração cada vez que um novo modelo for lançado.

Alias	O que seleciona	Melhor para
sonnet	Sonnet mais recente (Sonnet 5 na API Anthropic)	Padrão — rápido, capaz e eficiente para a maioria dos trabalhos de codificação
opus	Opus mais recente (Opus 4.8 na API Anthropic)	Raciocínio arquitetural complexo, análise de grandes bases de código
haiku	Haiku mais recente (Haiku 4.5)	Tarefas simples e rápidas onde a velocidade importa mais que a profundidade
fable	Claude Fable 5	Sessões autônomas de longa duração, tarefas ambíguas ou abertas
best	Fable 5 se disponível, senão Opus mais recente	Maior capacidade disponível sem especificar manualmente
opusplan	Opus para planejamento, Sonnet para execução	Obter o raciocínio do Opus sobre arquitetura sem pagar as taxas do Opus em cada etapa
sonnet[1m]	Sonnet com janela de contexto de 1M tokens	Sessões muito longas ou bases de código grandes que precisam de contexto estendido
opus[1m]	Opus com janela de contexto de 1M tokens	Tarefas complexas de contexto longo que precisam do raciocínio do Opus
default	Limpa qualquer substituição; retorna ao padrão da conta	Redefinir para o padrão do sistema após testar outros modelos

Os aliases são atualizados ao longo do tempo. Para fixar uma versão específica — por reprodutibilidade ou para evitar comportamento inesperado após uma atualização de modelo — use o ID completo do modelo:

claude --model claude-sonnet-5
claude --model claude-opus-4-8

Modelos Claude atuais (API Anthropic)

Modelo	ID da API	Contexto	Custo de entrada	Custo de saída
Claude Fable 5	claude-fable-5	1M tokens	$10/MTok	$50/MTok
Claude Opus 4.8	claude-opus-4-8	1M tokens	$5/MTok	$25/MTok
Claude Sonnet 5	claude-sonnet-5	1M tokens	$2/MTok*	$10/MTok*
Claude Haiku 4.5	claude-haiku-4-5-20251001	200k tokens	$1/MTok	$5/MTok

*Preço introdutório do Sonnet 5 até 31 de agosto de 2026; a taxa padrão é $3/$15 por MTok.

Todos os modelos têm uma janela de contexto de 1 milhão de tokens, exceto o Haiku 4.5, que atinge no máximo 200k. Para a maioria dos trabalhos de codificação, o tamanho da janela de contexto só se torna um fator decisivo quando você está carregando repositórios inteiros ou executando sessões agênticas muito longas.

Como Alterar o Modelo no Claude Code

Existem quatro maneiras de configurar o modelo, em ordem de prioridade:

1. Durante uma sessão: /model

Digite /model sem argumentos para abrir o seletor interativo. Digite /model <alias> para trocar imediatamente:

/model opus
/model sonnet
/model haiku
/model fable

A partir do Claude Code v2.1.153, /model salva sua escolha como padrão para sessões futuras. Se você quiser trocar apenas para a sessão atual, pressione s no seletor em vez de Enter. Digitar /model <alias> diretamente salva a escolha (equivalente a Enter).

2. Na inicialização: flag --model

Passe --model ao iniciar o Claude Code para aplicar a seleção apenas naquela sessão:

claude --model opus
claude --model haiku
claude --model claude-sonnet-5   # ID completo do modelo, fixa uma versão específica

Isso não afeta o padrão salvo e não persiste para a próxima inicialização.

3. Variável de ambiente: ANTHROPIC_MODEL

Defina ANTHROPIC_MODEL para aplicar um modelo durante a duração de uma sessão de shell ou script:

export ANTHROPIC_MODEL="opus"

Assim como --model, isso tem escopo de sessão e não grava no arquivo de configurações.

4. Arquivo de configurações (padrão permanente)

Para definir um padrão permanente, adicione o campo model ao arquivo de configurações do Claude Code (geralmente ~/.claude/settings.json):

{
  "model": "opus"
}

Isso se aplica toda vez que você iniciar o Claude Code a partir dessa máquina, a menos que seja substituído por uma flag --model ou pela variável de ambiente ANTHROPIC_MODEL.

Escolhendo o Modelo Certo para Codificação

O nível de modelo que você precisa depende mais do tipo de tarefa do que apenas da complexidade.

Fique com o Sonnet (padrão) para:

• Tarefas diárias de codificação — implementar funcionalidades, escrever testes, refatorar
• Sessões iterativas onde você está revisando diffs e fazendo perguntas de acompanhamento
• A maioria das edições em vários arquivos onde a base de código cabe na janela de contexto
• Casos onde a velocidade importa (Sonnet responde visivelmente mais rápido que Opus)

A principal limitação do Sonnet é a profundidade de raciocínio em questões arquiteturais genuinamente ambíguas. Ele tende a escolher a primeira abordagem razoável em vez de avaliar alternativas. Para decisões onde errar o trade-off custa um tempo significativo de refatoração, vale a pena atualizar para o Opus.

Troque para o Opus para:

• Depuração de causa raiz onde o problema não é óbvio
• Decisões de arquitetura: escolher entre padrões de projeto, avaliar estratégias de refatoração, identificar onde a dívida técnica vai te prejudicar
• Análise de grandes bases de código onde você precisa que o Opus mantenha mais contexto na memória de trabalho
• Sessões autônomas de várias horas onde a degradação acumulada de contexto é um fator

O Opus 4.8 custa 2,5x mais que o Sonnet 5 por token, e é mais lento. Para tarefas curtas, a diferença na qualidade do raciocínio muitas vezes não justifica o custo. O alias opusplan é um meio-termo prático: usa Opus durante a fase de planejamento (onde um raciocínio mais profundo compensa) e cai para Sonnet na implementação (onde a taxa de transferência importa mais).

Use o Haiku para:

• Formatação de código, limpeza de comentários, renomeações simples de variáveis
• Tarefas onde você quer respostas rápidas para mudanças mínimas
• Casos de uso com script de alto volume onde o custo por token importa mais

O Haiku 4.5 é o modelo mais rápido e o mais barato a $1/$5 por MTok, mas não alcançará o Sonnet ou Opus em raciocínio em várias etapas ou bases de código complexas. Para o lado da política de equipe desse trade-off, leia Modo automático do Claude Code para equipes sensíveis a custos.

Use o Fable 5 para:

• Depuração de interrupções e investigação de incidentes
• Execuções agênticas longas e abertas onde você quer que o modelo investigue antes de agir
• Problemas ambíguos onde você normalmente dividiria o trabalho em várias sessões

O Fable 5 não é o padrão porque a maioria das sessões de codificação não precisa dele. É mais lento e custa o dobro do Opus. Onde ele se destaca é em trabalhos genuinamente complexos e sustentados: ele verifica suas próprias saídas mais minuciosamente, lida com sequências de chamadas de ferramentas sem perder o fio da meada e toma menos decisões que exigem correção por prompt. Para trabalho de funcionalidades típico, é exagero.

Seleção de Modelo no Bedrock, Vertex e Outros Provedores

Os aliases são resolvidos de forma diferente dependendo do provedor de API que você está usando. Se você estiver roteando o Claude Code através do Amazon Bedrock, Google Cloud Agent Platform ou Microsoft Foundry, a resolução do alias é mais antiga por padrão:

Provedor	Alias opus resolve para	Alias sonnet resolve para
API Anthropic (padrão)	Opus 4.8	Sonnet 5
Claude Platform na AWS	Opus 4.7	Sonnet 4.6
Amazon Bedrock	Opus 4.6	Sonnet 4.5
Google Cloud Agent Platform	Opus 4.6	Sonnet 4.5
Microsoft Foundry	Opus 4.6	Sonnet 4.5

Para obter modelos mais recentes no Bedrock, Vertex ou Foundry, use o ID completo do modelo explicitamente ou defina as variáveis de ambiente ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL com o ARN do modelo específico do provedor ou nome da implantação para a versão desejada.

Como Acessar Mais Modelos via Novita AI

O Claude Code lê ANTHROPIC_BASE_URL para determinar qual endpoint de API enviar as requisições. Aponte-o para o endpoint compatível com Anthropic da Novita AI para usar modelos de pesos abertos — incluindo variantes DeepSeek, Qwen, GLM, Kimi e MiniMax — enquanto mantém o fluxo de trabalho agêntico do Claude Code intacto.

Isso é útil quando:

• Você quer experimentar um modelo específico de pesos abertos (Qwen3-Coder, GLM-4.7, MiniMax M2.7) contra sua base de código real
• O custo por token é uma restrição e você está executando sessões agênticas de alto volume
• Você está avaliando a qualidade do modelo em suas próprias tarefas antes de se comprometer com gastos de API

Configuração

1. Cadastre-se em novita.ai para obter créditos de teste gratuitos.
2. Vá para Gerenciamento de Chaves, crie uma nova chave e copie-a.
3. Defina estas variáveis de ambiente antes de iniciar o Claude Code:

macOS / Linux:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<sua chave da API Novita>"
export ANTHROPIC_MODEL="minimax/minimax-m2.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="minimax/minimax-m2.7"

Windows (Command Prompt):

set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<sua chave da API Novita>
set ANTHROPIC_MODEL=minimax/minimax-m2.7
set ANTHROPIC_DEFAULT_HAIKU_MODEL=minimax/minimax-m2.7

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL = "https://api.novita.ai/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<sua chave da API Novita>"
$env:ANTHROPIC_MODEL = "minimax/minimax-m2.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "minimax/minimax-m2.7"

Inicie o Claude Code normalmente após definir as variáveis. O seletor /model refletirá os modelos hospedados na Novita que você configurou, em vez da lista de aliases da Anthropic.

Nota sobre ANTHROPIC_BASE_URL vs seleção de modelo

ANTHROPIC_BASE_URL muda para onde as requisições vão, não qual modelo da Anthropic as responde. Ao apontar para a Novita AI, o nome do modelo que você define em ANTHROPIC_MODEL deve ser um ID de modelo hospedado pela Novita (como minimax/minimax-m2.7 ou deepseek/deepseek-v4-flash), não um alias da Anthropic como sonnet ou opus. Os aliases da Anthropic só resolvem corretamente contra o endpoint da própria Anthropic.

Modelos representativos disponíveis na Novita AI

Modelo	ID do modelo Novita	Pontos fortes
MiniMax M2.7	minimax/minimax-m2.7	Chamada de ferramentas agêntica, 97% de precisão em ferramentas
DeepSeek V4 Flash	deepseek/deepseek-v4-flash	Rápido e econômico para tarefas iterativas
Qwen3-Coder 480B	qwen/qwen3-coder-480b-a35b-instruct	Geração de código, contexto grande
GLM-4.7	zai-org/glm-4.7	Tarefas de codificação e agênticas

Verifique novita.ai/llm-api para a lista atual de modelos e IDs de modelo verificados antes de configurar — a disponibilidade e a nomenclatura dos modelos podem mudar.

Perguntas Frequentes

Qual é o modelo padrão no Claude Code?

Sonnet — especificamente a versão mais recente do Sonnet para seu provedor de API. Na API Anthropic, isso é o Claude Sonnet 5 a partir de meados de 2026. Se sua organização definiu um padrão para toda a organização, isso tem precedência.

Como troco o modelo no Claude Code?

A maneira mais rápida é /model <alias> durante uma sessão ativa. Para defini-lo permanentemente, adicione "model": "opus" (ou seu alias preferido) ao arquivo de configurações em ~/.claude/settings.json. Use --model na inicialização para uma substituição de sessão avulsa.

O que o alias opusplan faz?

Ele usa Opus durante a fase de planejamento do Claude Code e troca para Sonnet na execução. Isso te dá o raciocínio mais profundo do Opus em decisões arquiteturais sem pagar as taxas do Opus em cada edição de arquivo durante a implementação. É um bom padrão se você frequentemente deseja o Opus para a parte “descobrir o que fazer”, mas não para a parte “escrever o código”.

Posso fixar uma versão específica do modelo?

Sim. Passe o ID completo do modelo em vez de um alias: claude --model claude-sonnet-5 ou claude --model claude-opus-4-8. Para uma fixação permanente, adicione o ID completo ao seu arquivo de configurações ou defina ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 em seu ambiente.

O modelo afeta as ferramentas e capacidades do Claude Code?

Não. Todos os modelos têm acesso ao mesmo conjunto de ferramentas do Claude Code: leitura e edição de arquivos, execução de bash, pesquisa na web, MCP e o restante. O nível do modelo afeta a qualidade do raciocínio, não quais ferramentas estão disponíveis.

Posso usar modelos diferentes para projetos diferentes?

Sim. Adicione um campo model a um arquivo de configurações no nível do projeto (.claude/settings.json na raiz do projeto). Isso substitui seu padrão de nível de usuário para sessões iniciadas nesse diretório. Você também pode usar ANTHROPIC_MODEL em um arquivo .env específico do projeto ou script.

O que acontece se o modelo que selecionei foi descontinuado ou está indisponível?

O Claude Code mostra um aviso na inicialização informando o modelo solicitado e o que foi substituído. A sessão começa com o padrão do sistema. Para evitar substituições inesperadas, troque para o alias atualmente recomendado ou atualize sua configuração para um ID de modelo não descontinuado.

Artigos Recomendados

• Roteador Claude Code: Use Modelos e Provedores Alternativoos no Claude Code
• Claude Sonnet vs Opus: Qual Modelo Faze Sentido no Claude Code?
• Documentação da CLI do Claude Code: Configuração, Comandos de Barra e Integração com API LLM

---

Fontees veerificadaas em 10 de julho de 2026: Documentação de configuração de modelo do Claude Code, Visão geral dos modelos Claude, API LLM da Novita AI.