​
Pré-requisitos

Antes de configurar o Claude Code com Bedrock, certifique-se de ter:

  • Uma conta AWS com acesso ao Bedrock habilitado
  • Acesso aos modelos Claude desejados (por exemplo, Claude Sonnet 4) no Bedrock
  • AWS CLI instalado e configurado (opcional - necessário apenas se você não tiver outro mecanismo para obter credenciais)
  • Permissões IAM apropriadas

​
Configuração

​
1. Habilitar acesso ao modelo

Primeiro, certifique-se de ter acesso aos modelos Claude necessários em sua conta AWS:

  1. Navegue até o console do Amazon Bedrock
  2. Vá para Acesso ao modelo na navegação à esquerda
  3. Solicite acesso aos modelos Claude desejados (por exemplo, Claude Sonnet 4)
  4. Aguarde a aprovação (geralmente instantânea para a maioria das regiões)

​
2. Configurar credenciais AWS

O Claude Code usa a cadeia de credenciais padrão do AWS SDK. Configure suas credenciais usando um destes métodos:

O Claude Code atualmente não suporta gerenciamento dinâmico de credenciais (como chamar automaticamente aws sts assume-role). Você precisará executar aws configure, aws sso login, ou definir as variáveis de ambiente AWS_ você mesmo.

Opção A: Configuração AWS CLI

aws configure

Opção B: Variáveis de ambiente (chave de acesso)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

Opção C: Variáveis de ambiente (perfil SSO)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

​
3. Configurar Claude Code

Defina as seguintes variáveis de ambiente para habilitar o Bedrock:

# Habilitar integração Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # ou sua região preferida

AWS_REGION é uma variável de ambiente obrigatória. O Claude Code não lê do arquivo de configuração .aws para esta configuração.

​
4. Configuração do modelo

O Claude Code usa estes modelos padrão para Bedrock:

Tipo de modeloValor padrão
Modelo primárious.anthropic.claude-3-7-sonnet-20250219-v1:0
Modelo pequeno/rápidous.anthropic.claude-3-5-haiku-20241022-v1:0

Para personalizar modelos, use um destes métodos:

# Usando ID do perfil de inferência
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Usando ARN do perfil de inferência da aplicação
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

​
Configuração IAM

Crie uma política IAM com as permissões necessárias para o Claude Code.

Para detalhes, consulte a documentação IAM do Bedrock.

Recomendamos criar uma conta AWS dedicada para o Claude Code para simplificar o rastreamento de custos e controle de acesso.

​
Solução de problemas

Se você encontrar problemas de região:

  • Verifique a disponibilidade do modelo: aws bedrock list-inference-profiles --region your-region
  • Mude para uma região suportada: export AWS_REGION=us-east-1
  • Considere usar perfis de inferência para acesso entre regiões

Se você receber um erro “throughput sob demanda não é suportado”:

​
Recursos adicionais