O modelo predefinido do Claude Code é o Sonnet — especificamente a versão mais recente do Sonnet para o seu fornecedor (Sonnet 5 na API Anthropic em meados de 2026). O Sonnet é rápido, lida bem com a maioria das cargas de trabalho de programação e mantém os custos razoáveis em sessões longas. Se não alterou nada, é isso que está a usar.
Alterar o modelo requer um comando: /model opus dentro de uma sessão, ou claude --model opus ao iniciar. O resto deste guia aborda quando vale a pena mudar para cada modelo, para que os aliases abreviados resolvem em diferentes fornecedores, e como usar o endpoint da Novita AI para aceder a um conjunto mais amplo de modelos open-weight a um custo por token mais baixo.
Qual é o Modelo Predefinido no Claude Code?
Quando 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 o seu fornecedor. Na API Anthropic (o endpoint predefinido), isso significa Claude Sonnet 5 a partir de meados de 2026. Utilizadores dos planos Free e Pro usam o Sonnet 5 por predefinição.
A lógica é direta: o Sonnet oferece o melhor equilíbrio entre velocidade e capacidade para o trabalho de programação do dia a dia. Lida com edições de ficheiros, refactorações com vários passos, geração de testes e a maioria das tarefas à escala do repositório sem a latência extra ou o custo associados ao Opus. Para a maioria das sessões, mudar para um modelo mais pesado não produz resultados significativamente melhores.
Se a sua organização definiu um modelo predefinido a nível organizacional na consola de administração do Claude Code, isso substitui a predefinição do sistema e tem efeito na próxima vez que iniciar uma sessão. Pode sempre substituí-lo por sessão com /model ou a flag --model.
Modelos e Aliases Disponíveis
O Claude Code usa aliases em vez de IDs de modelo completos para a seleção diária de modelos. Um alias como sonnet aponta sempre para a versão recomendada para o seu fornecedor, para que não tenha de atualizar a sua configuração cada vez que um novo modelo é lançado.
| Alias | O que seleciona | Melhor para |
|---|---|---|
sonnet |
Último Sonnet (Sonnet 5 na API Anthropic) | Predefinição — rápido, capaz e eficiente para a maioria dos trabalhos de programação |
opus |
Último Opus (Opus 4.8 na API Anthropic) | Raciocínio arquitetural complexo, análise de grandes bases de código |
haiku |
Último Haiku (Haiku 4.5) | Tarefas simples e rápidas onde a velocidade importa mais que a profundidade |
fable |
Claude Fable 5 | Sessões autónomas longas, tarefas ambíguas ou abertas |
best |
Fable 5 se disponível, caso contrário o último Opus | Maior capacidade disponível sem especificar manualmente |
opusplan |
Opus para planeamento, Sonnet para execução | Obter o raciocínio do Opus sobre arquitetura sem pagar as taxas do Opus em cada passo |
sonnet[1m] |
Sonnet com janela de contexto de 1M de tokens | Sessões muito longas ou bases de código grandes que precisam de contexto alargado |
opus[1m] |
Opus com janela de contexto de 1M de tokens | Tarefas complexas de contexto longo que precisam do raciocínio do Opus |
default |
Limpa qualquer substituição; retorna à predefinição da conta | Repor a predefinição do sistema depois de 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 do 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 programação, o tamanho da janela de contexto só se torna um fator decisivo quando está a carregar repositórios inteiros ou a executar sessões de agente muito longas.
Como Alterar o Modelo no Claude Code
Existem quatro formas de configurar o modelo, por ordem de prioridade:
1. Durante uma sessão: /model
Digite /model sem argumentos para abrir o seletor interativo. Digite /model <alias> para mudar imediatamente:
/model opus
/model sonnet
/model haiku
/model fable```
A partir do Claude Code v2.1.153, `/model` guarda a sua escolha como predefinição para futuras sessões. Se quiser mudar apenas para a sessão atual, prima `s` no seletor em vez de `Enter`. Digitar `/model <alias>` diretamente guarda a escolha (equivalente a `Enter`).
### 2. Ao iniciar: flag `--model`
Passe `--model` quando iniciar o Claude Code para aplicar a seleção apenas nessa sessão:
```bash
claude --model opus
claude --model haiku
claude --model claude-sonnet-5 # ID completo do modelo, fixa uma versão específica
Isto não afeta a predefinição guardada e não persiste para o próximo início.
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"
Tal como --model, isto tem âmbito de sessão e não escreve no seu ficheiro de definições.
4. Ficheiro de definições (predefinição permanente)
Para definir uma predefinição permanente, adicione o campo model ao seu ficheiro de definições do Claude Code (normalmente ~/.claude/settings.json):
{
"model": "opus"
}
Isto aplica-se sempre que 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.
Variáveis de ambiente por alias
Se quiser que o alias opus resolva para uma versão específica em qualquer ambiente, defina ANTHROPIC_DEFAULT_OPUS_MODEL. O mesmo padrão aplica-se a outras famílias:
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
export ANTHROPIC_DEFAULT_FABLE_MODEL="claude-fable-5"
Isto é útil em configurações de CI/CD ou equipa onde quer uma resolução de modelo reprodutível sem ter de fixar IDs de modelo completos em todo o lado.
Escolher o Modelo Certo para Programação
O nível de modelo de que precisa depende mais do tipo de tarefa do que apenas da complexidade.
Mantenha-se no Sonnet (predefinição) para:
- Tarefas diárias de programação — implementar funcionalidades, escrever testes, refatorar
- Sessões iterativas onde está a rever diferenças e a fazer perguntas de acompanhamento
- A maioria das edições em vários ficheiros onde a base de código cabe na janela de contexto
- Casos onde a velocidade é importante (o Sonnet responde visivelmente mais rápido que o Opus)
A principal limitação do Sonnet é a profundidade de raciocínio em questões arquiteturais genuinamente ambíguas. Tendem a escolher a primeira abordagem razoável em vez de avaliar alternativas. Para decisões onde errar a escolha custa tempo significativo de refatoração, atualizar para o Opus vale a pena.
Mude para Opus para:
- Depuração de causa raiz onde o problema não é óbvio
- Decisões de arquitetura: escolher entre padrões de design, avaliar estratégias de refatoração, identificar onde a dívida técnica o vai afetar
- Análise de grandes bases de código onde precisa que o Opus mantenha mais contexto na memória de trabalho
- Sessões autónomas de várias horas onde a degradação do contexto acumulado é 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 planeamento (onde o raciocínio mais profundo compensa) e volta ao Sonnet para implementação (onde a taxa de transferência é mais importante).
Use Haiku para:
- Formatação de código, limpeza de comentários, renomeação simples de variáveis
- Tarefas onde quer respostas rápidas para alterações mínimas
- Casos de uso scriptados de alto volume onde o custo por token é mais importante
O Haiku 4.5 é o modelo mais rápido e o mais barato a $1/$5 por MTok, mas não iguala o Sonnet ou Opus em raciocínio com múltiplos passos ou bases de código complexas.
Use Fable 5 para:
- Depuração de falhas e investigação de incidentes
- Execuções de agente longas e abertas onde quer que o modelo investigue antes de agir
- Problemas ambíguos onde normalmente dividiria o trabalho em várias sessões
O Fable 5 não é a predefinição porque a maioria das sessões de programação não precisa dele. É mais lento e custa o dobro do Opus. Onde justifica o seu custo é em trabalho sustentado genuinamente complexo: verifica as suas próprias saídas mais minuciosamente, lida com sequências de chamadas de ferramentas sem perder o fio à meada, e toma menos decisões que exigem correção por prompting. Para trabalho de funcionalidades típico, é exagerado.
Seleção de Modelos no Bedrock, Vertex e Outros Fornecedores
Os aliases resolvem de forma diferente dependendo do fornecedor de API que está a usar. Se estiver a encaminhar o Claude Code através do Amazon Bedrock, Google Cloud Agent Platform ou Microsoft Foundry, a resolução do alias é mais antiga por predefinição:
| Fornecedor | Alias opus resolve para |
Alias sonnet resolve para |
|---|---|---|
| API Anthropic (predefiniçã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 para o ARN do modelo específico do fornecedor ou nome da implementação para a versão que deseja.
Como Aceder a Mais Modelos Através da Novita AI
O Claude Code lê ANTHROPIC_BASE_URL para determinar para qual endpoint da API enviar os pedidos. Aponte-o para o endpoint compatível com Anthropic da Novita AI para usar modelos open-weight — incluindo variantes DeepSeek, Qwen, GLM, Kimi e MiniMax — mantendo o fluxo de trabalho de agente do Claude Code intacto.
Isto é útil quando:
- Quer experimentar um modelo open-weight específico (Qwen3-Coder, GLM-4.7, MiniMax M2.7) na sua base de código real
- O custo por token é uma restrição e está a executar sessões de agente de alto volume
- Está a avaliar a qualidade do modelo nas suas próprias tarefas antes de se comprometer com gastos na API
Configuração
- Registe-se em novita.ai para obter créditos de teste gratuitos.
- Vá a Key Management, crie uma nova chave e copie-a.
- 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 depois de definir as variáveis. O seletor /model refletirá os modelos hospedados na Novita que configurou em vez da lista de aliases da Anthropic.
Nota sobre ANTHROPIC_BASE_URL vs seleção de modelo
ANTHROPIC_BASE_URL altera para onde os pedidos vão, não qual modelo da Anthropic responde. Ao apontar para a Novita AI, o nome do modelo que definir em ANTHROPIC_MODEL deve ser um ID de modelo hospedado na 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 próprio endpoint da Anthropic.
Modelos representativos disponíveis na Novita AI
| Modelo | ID do modelo Novita | Força |
|---|---|---|
| MiniMax M2.7 | minimax/minimax-m2.7 |
Chamada de ferramentas de agente, 97% de precisão de 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 programação e agente |
Verifique novita.ai/llm-api para a lista atual de modelos e IDs de modelo verificados antes de configurar — a disponibilidade e nomenclatura dos modelos podem mudar.
FAQ
Qual é o modelo predefinido no Claude Code?
Sonnet — especificamente a versão mais recente do Sonnet para o seu fornecedor de API. Na API Anthropic, é o Claude Sonnet 5 a partir de meados de 2026. Se a sua organização definiu uma predefinição a nível organizacional, essa tem precedência.
Como mudo o modelo no Claude Code?
A forma mais rápida é /model <alias> durante uma sessão ativa. Para o definir permanentemente, adicione "model": "opus" (ou o seu alias preferido) ao seu ficheiro de definições em ~/.claude/settings.json. Use --model ao iniciar para uma substituição de sessão única.
O que faz o alias opusplan?
Usa o Opus durante a fase de planeamento do Claude Code e muda para o Sonnet para execução. Isto dá-lhe o raciocínio mais profundo do Opus em decisões arquiteturais sem pagar as taxas do Opus por cada edição de ficheiro durante a implementação. É uma boa predefinição se achar que quer regularmente o Opus para a parte de “descobrir o que fazer” mas não para a parte de “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 ficheiro de definições ou defina ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 no 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 ficheiros, execução bash, pesquisa web, MCP e o resto. 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 ficheiro de definições ao nível do projeto (.claude/settings.json na raiz do seu projeto). Isso substitui a sua predefinição de nível de utilizador para sessões iniciadas nesse diretório. Também pode usar ANTHROPIC_MODEL num ficheiro .env ou script específico do projeto.
O que acontece se o modelo que selecionei for descontinuado ou estiver indisponível?
O Claude Code mostra um aviso no arranque a nomear o modelo solicitado e o que foi substituído. A sessão começa com a predefinição do sistema. Para evitar substituições inesperadas, mude para o alias recomendado atual ou atualize a sua definição para um ID de modelo não descontinuado.
Artigos Recomendados
- Use MiniMax M2.7 in Claude Code via Novita AI
- Claude Code CLI Documentation: Setup, Slash Commands, and LLM API Integration
- Use Qwen3-Coder-480B-A35B-Instruct in Claude Code: A Practical Guide
Fontes verificadas em 10 de julho de 2026: Documentação de configuração de modelo do Claude Code, Visão geral dos modelos Anthropic, API LLM da Novita AI.
