Configuração do modelo

​

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:

​

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

# Mudar 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 - Muda automaticamente 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 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.

Nota: ANTHROPIC_SMALL_FAST_MODEL está obsoleto em favor de ANTHROPIC_DEFAULT_HAIKU_MODEL.