Configuração do modelo

Por padrão, o Claude Code usa claude-3-7-sonnet-20250219. Você pode substituir isso usando as seguintes variáveis de ambiente:

# Anthropic API
ANTHROPIC_MODEL='claude-3-7-sonnet-20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-3-7-sonnet@20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

Você também pode definir essas variáveis usando a configuração global:

# Configurar para Anthropic API
claude config set --global env '{"ANTHROPIC_MODEL": "claude-3-7-sonnet-20250219"}'

# Configurar para Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"}'

# Configurar para Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-3-7-sonnet@20250219"}'

Veja nossa referência de nomes de modelos para todos os modelos disponíveis em diferentes provedores.

Uso com APIs de terceiros

O Claude Code requer acesso tanto aos modelos Claude 3.7 Sonnet quanto Claude 3.5 Haiku, independentemente do provedor de API que você usar.

Conectar ao Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

Se você quiser acessar o Claude Code via proxy, você pode usar a variável de ambiente ANTHROPIC_BEDROCK_BASE_URL:

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

Se você não tiver o cache de prompts habilitado, também defina:

DISABLE_PROMPT_CACHING=1

Requer credenciais padrão do AWS SDK (por exemplo, ~/.aws/credentials ou variáveis de ambiente relevantes como AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY). Para configurar as credenciais AWS, execute:

aws configure

Entre em contato com o Amazon Bedrock para cache de prompts para custos reduzidos e limites de taxa mais altos.

Os usuários precisarão ter acesso tanto aos modelos Claude 3.7 Sonnet quanto Claude 3.5 Haiku em sua conta AWS. Se você tiver uma função de acesso ao modelo, pode precisar solicitar acesso a esses modelos se eles ainda não estiverem disponíveis. O acesso ao Bedrock em cada região é necessário porque os perfis de inferência requerem capacidade entre regiões.

Conectar ao Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Se você quiser acessar o Claude Code via proxy, você pode usar a variável de ambiente ANTHROPIC_VERTEX_BASE_URL:

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

Se você não tiver o cache de prompts habilitado, também defina:

DISABLE_PROMPT_CACHING=1

O Claude Code no Vertex AI atualmente suporta apenas a região us-east5. Certifique-se de que seu projeto tenha cota alocada nesta região específica.

Os usuários precisarão ter acesso tanto aos modelos Claude 3.7 Sonnet quanto Claude 3.5 Haiku em seu projeto Vertex AI.

Requer credenciais GCP padrão configuradas através do google-auth-library. Para configurar as credenciais GCP, execute:

gcloud auth application-default login

Para a melhor experiência, entre em contato com o Google para limites de taxa mais elevados.

Conectar através de um proxy

Ao usar o Claude Code com um proxy LLM (como LiteLLM), você pode controlar o comportamento de autenticação usando as seguintes variáveis de ambiente e configurações. Observe que você pode combinar estas com as configurações específicas do Bedrock e Vertex.

Variáveis de ambiente

  • ANTHROPIC_AUTH_TOKEN: Valor personalizado para os cabeçalhos Authorization e Proxy-Authorization (o valor que você definir aqui será prefixado com Bearer )
  • ANTHROPIC_CUSTOM_HEADERS: Cabeçalhos personalizados que você deseja adicionar à requisição (no formato Nome: Valor)
  • HTTP_PROXY: Define a URL do proxy HTTP
  • HTTPS_PROXY: Define a URL do proxy HTTPS

Se você preferir configurar via arquivo em vez de variáveis de ambiente, você pode adicionar qualquer uma dessas variáveis ao objeto env em sua configuração global do Claude (em ~/.claude.json).

Opções de configuração global

  • apiKeyHelper: Um script shell personalizado para obter uma chave de API (invocado uma vez na inicialização e armazenado em cache durante cada sessão)

Was this page helpful?