Claude Code no Amazon Bedrock

​

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:

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

Opção D: Chaves API do Bedrock

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

As chaves API do Bedrock fornecem um método de autenticação mais simples sem precisar de credenciais AWS completas. Saiba mais sobre chaves API do Bedrock.

​

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

# Opcional: Substituir a região para o modelo pequeno/rápido (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

​

4. Configuração do modelo

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

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'

# Opcional: Desabilitar cache de prompt se necessário
export DISABLE_PROMPT_CACHING=1

​

Configuração IAM

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*"
      ]
    }
  ]
}

Para permissões mais restritivas, você pode limitar o Resource a ARNs específicos de perfil de inferência.

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

​

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”:

• Especifique o modelo como um ID de perfil de inferência

​

Recursos adicionais

• Documentação do Bedrock
• Preços do Bedrock
• Perfis de inferência do Bedrock
• Claude Code no Amazon Bedrock: Guia de Configuração Rápida