​
Modelos disponíveis

Para a configuração model no Claude Code, você pode configurar:

​
Aliases de modelo

Os aliases de modelo fornecem uma maneira conveniente de selecionar configurações de modelo sem lembrar números de versão exatos:
Alias do modeloComportamento
defaultConfiguração de modelo recomendada, dependendo do seu tipo de conta
sonnetUsa o modelo Sonnet mais recente (atualmente Sonnet 4.5) para tarefas diárias de codificação
opusUsa o modelo Opus (atualmente Opus 4.1) para tarefas especializadas de raciocínio complexo
haikuUsa o modelo Haiku rápido e eficiente para tarefas simples
sonnet[1m]Usa Sonnet com uma janela de contexto de 1 milhão de tokens para sessões longas
opusplanModo especial que usa opus durante o modo de planejamento, depois muda para sonnet para execução

​
Configurando seu modelo

Você pode configurar seu modelo de várias maneiras, listadas em ordem de prioridade:
  1. Durante a sessão - Use /model <alias|nome> para trocar modelos no meio da sessão
  2. Na inicialização - Inicie com claude --model <alias|nome>
  3. Variável de ambiente - Defina ANTHROPIC_MODEL=<alias|nome>
  4. Configurações - Configure permanentemente no seu arquivo de configurações usando o campo model.
Exemplo de uso: 
# Iniciar com Opus
claude --model opus

# Trocar para Sonnet durante a sessão
/model sonnet
Exemplo de arquivo de configurações: 
{
    "permissions": {
        ...
    },
    "model": "opus"
}

​
Comportamento especial do modelo

​
Configuração do modelo default

O comportamento de default depende do seu tipo de conta. Para certos usuários Max, o Claude Code automaticamente voltará para Sonnet se você atingir um limite de uso com Opus.

​
Configuração do modelo opusplan

O alias de modelo opusplan fornece uma abordagem híbrida automatizada:
  • No modo de planejamento - Usa opus para raciocínio complexo e decisões de arquitetura
  • No modo de execução - Automaticamente muda para sonnet para geração de código e implementação
Isso lhe dá o melhor dos dois mundos: o raciocínio superior do Opus para planejamento, e a eficiência do Sonnet para execução.

​
Contexto estendido com [1m]

Para usuários do Console/API, o sufixo [1m] pode ser adicionado aos nomes completos de modelo para habilitar uma janela de contexto de 1 milhão de tokens. 
# Exemplo de uso de um nome completo de modelo com o sufixo [1m]
/model anthropic.claude-sonnet-4-5-20250929-v1:0[1m]
Nota: Modelos de contexto estendido têm preços diferentes.

​
Verificando seu modelo atual

Você pode ver qual modelo está usando atualmente de várias maneiras:
  1. Na linha de status (se configurada)
  2. Em /status, que também exibe suas informações de conta.

​
Variáveis de ambiente

Você pode usar as seguintes variáveis de ambiente, que devem ser nomes de modelo completos, para controlar os nomes de modelo para os quais os aliases mapeiam.
Var de ambienteDescrição
ANTHROPIC_DEFAULT_OPUS_MODELO modelo a usar para opus, ou para opusplan quando o Modo de Planejamento está ativo.
ANTHROPIC_DEFAULT_SONNET_MODELO modelo a usar para sonnet, ou para opusplan quando o Modo de Planejamento não está ativo.
ANTHROPIC_DEFAULT_HAIKU_MODELO modelo a usar para haiku, ou funcionalidade em segundo plano
CLAUDE_CODE_SUBAGENT_MODELO modelo a usar para subagentes
Nota: ANTHROPIC_SMALL_FAST_MODEL está obsoleto em favor de ANTHROPIC_DEFAULT_HAIKU_MODEL.

​
Configuração de cache de prompt

O Claude Code automaticamente usa cache de prompt para otimizar performance e reduzir custos. Você pode desabilitar o cache de prompt globalmente ou para níveis específicos de modelo:
Var de ambienteDescrição
DISABLE_PROMPT_CACHINGDefina como 1 para desabilitar cache de prompt para todos os modelos (tem precedência sobre configurações por modelo)
DISABLE_PROMPT_CACHING_HAIKUDefina como 1 para desabilitar cache de prompt apenas para modelos Haiku
DISABLE_PROMPT_CACHING_SONNETDefina como 1 para desabilitar cache de prompt apenas para modelos Sonnet
DISABLE_PROMPT_CACHING_OPUSDefina como 1 para desabilitar cache de prompt apenas para modelos Opus
Essas variáveis de ambiente lhe dão controle refinado sobre o comportamento do cache de prompt. A configuração global DISABLE_PROMPT_CACHING tem precedência sobre as configurações específicas de modelo, permitindo que você desabilite rapidamente todo o cache quando necessário. As configurações por modelo são úteis para controle seletivo, como ao depurar modelos específicos ou trabalhar com provedores de nuvem que podem ter implementações de cache diferentes.