Configuração do modelo

Aprenda sobre a configuração do modelo Claude Code, incluindo aliases de modelo como opusplan

Modelos disponíveis

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

• Um alias de modelo
• Um nome de modelo completo
• Para Bedrock, um ARN

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 modelo	Comportamento
default	Configuração de modelo recomendada, dependendo do seu tipo de conta
sonnet	Usa o modelo Sonnet mais recente (atualmente Sonnet 4) para tarefas diárias de codificação
opus	Usa o modelo Opus mais capaz (atualmente Opus 4.1) para raciocínio complexo
haiku	Usa 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
opusplan	Modo 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 te 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 a nomes de modelo completos para habilitar uma janela de contexto de 1 milhão de tokens.

# Exemplo de uso de um nome de modelo completo com o sufixo [1m]
/model anthropic.claude-sonnet-4-20250514-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.

Variável de ambiente	Descrição
ANTHROPIC_DEFAULT_OPUS_MODEL	O modelo a usar para opus, ou para opusplan quando o Modo de Planejamento está ativo.
ANTHROPIC_DEFAULT_SONNET_MODEL	O modelo a usar para sonnet, ou para opusplan quando o Modo de Planejamento não está ativo.
ANTHROPIC_DEFAULT_HAIKU_MODEL	O modelo a usar para haiku, ou funcionalidade em segundo plano
CLAUDE_CODE_SUBAGENT_MODEL	O modelo a usar para subagentes

Nota: ANTHROPIC_SMALL_FAST_MODEL está obsoleto em favor de ANTHROPIC_DEFAULT_HAIKU_MODEL.