Ir para conteúdo principal

Configuração do Modelo de Código Claude

Atualizado há mais de uma semana

Este guia mostra três maneiras de alterar qual modelo Claude você está usando com o Claude Code: o comando rápido /model para mudanças instantâneas, a flag --model para mudanças de sessão única, e variáveis de ambiente para definir seu modelo preferido como padrão permanente.

Método Mais Fácil: Use o Comando /model

A maneira mais simples de alterar modelos é usar o comando /model diretamente dentro do Claude Code. Isso funciona imediatamente sem reiniciar seu terminal.

  1. Inicie o Claude Code: claude.

  2. Digite /model e escolha seu modelo desejado no menu interativo.

  3. Sua mudança de modelo entra em vigor imediatamente.

Nota: Você pode verificar seu modelo atual a qualquer momento executando /status no Claude Code.

Modelos Suportados

  • Opus 4.1, claude-opus-4-1-20250805

  • Opus 4, claude-opus-4-20250514

  • Sonnet 4, claude-sonnet-4-20250514

  • Sonnet 3.7, claude-3-7-sonnet-20250219

  • Haiku 3.5, claude-3-5-haiku-20241022

⚠️ Acesso ao Modelo: Ao usar um plano Pro com Claude Code, você não poderá usar modelos Opus.

Alterar Modelo Apenas para a Sessão Atual

Use a flag --model ao iniciar o Claude Code.

  1. Inicie uma nova sessão do Terminal.

  2. Digite os seguintes comandos (dependendo do modelo que você gostaria de usar para essa sessão):

    1. Para Opus 4.1: claude --model claude-opus-4-1-20250805

    2. Para Opus 4: claude --model claude-opus-4-20250514

    3. Para Sonnet 4: claude --model claude-sonnet-4-20250514

    4. Para 3.7 Sonnet: claude --model claude-3-7-sonnet-20250219

    5. Para 3.5 Haiku: claude --model claude-3-5-haiku-20241022

Nota: Os modelos Opus estarão indisponíveis para usuários do plano Pro logados no Claude Code.

Alterar Modelo Padrão para Todas as Sessões Futuras

Passo 1) Verifique seu tipo de shell executando: echo $SHELL

  • /bin/zsh → Você está usando zsh (padrão do macOS)

  • /bin/bash → Você está usando bash (padrão do Linux)

Passo 2) Adicione a configuração do modelo ao seu arquivo de configuração do shell:

Para usuários ZSH (macOS):

  • Opus 4.1: echo 'export ANTHROPIC_MODEL="claude-opus-4-1-20250805"' >> ~/.zshrc

  • Opus 4: echo 'export ANTHROPIC_MODEL="claude-opus-4-20250514"' >> ~/.zshrc

  • Sonnet 4: echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514"' >> ~/.zshrc

  • 3.7 Sonnet: echo 'export ANTHROPIC_MODEL="claude-3-7-sonnet-20250219"' >> ~/.zshrc

  • 3.5 Haiku: echo 'export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"' >> ~/.zshrc

Para usuários BASH (Linux):

  • Opus 4.1: echo 'export ANTHROPIC_MODEL="claude-opus-4-1-20250805"' >> ~/.bashrc

  • Opus 4: echo 'export ANTHROPIC_MODEL="claude-opus-4-20250514"' >> ~/.bashrc

  • Sonnet 4: echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514"' >> ~/.bashrc

  • 3.7 Sonnet: echo 'export ANTHROPIC_MODEL="claude-3-7-sonnet-20250219"' >> ~/.bashrc

  • 3.5 Haiku: echo 'export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"' >> ~/.bashrc

Passo 3) Aplique as mudanças:

  • Para ZSH: source ~/.zshrc

  • Para BASH: source ~/.bashrc

Passo 4) Feche o Terminal completamente, depois reabra-o.

Passo 5) Inicie o Claude Code em uma nova sessão do Terminal: claude.

Agora seu modelo escolhido será o padrão para todas as sessões futuras do Claude Code.

Isto respondeu à sua pergunta?