Claude Code en Amazon Bedrock

​

Prerrequisitos

Antes de configurar Claude Code con Bedrock, asegúrate de tener:

• Una cuenta de AWS con acceso a Bedrock habilitado
• Acceso a los modelos de Claude deseados (por ejemplo, Claude Sonnet 4) en Bedrock
• AWS CLI instalado y configurado (opcional - solo necesario si no tienes otro mecanismo para obtener credenciales)
• Permisos de IAM apropiados

​

Configuración

​

1. Habilitar acceso al modelo

Primero, asegúrate de tener acceso a los modelos de Claude requeridos en tu cuenta de AWS:

1. Navega a la consola de Amazon Bedrock
2. Ve a Acceso al modelo en la navegación izquierda
3. Solicita acceso a los modelos de Claude deseados (por ejemplo, Claude Sonnet 4)
4. Espera la aprobación (generalmente instantánea para la mayoría de las regiones)

​

2. Configurar credenciales de AWS

Claude Code utiliza la cadena de credenciales predeterminada del SDK de AWS. Configura tus credenciales usando uno de estos métodos:

Opción A: Configuración de AWS CLI

aws configure

Opción B: Variables de entorno (clave de acceso)

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

Opción C: Variables de entorno (perfil SSO)

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

export AWS_PROFILE=your-profile-name

Opción D: Claves API de Bedrock

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Las claves API de Bedrock proporcionan un método de autenticación más simple sin necesidad de credenciales completas de AWS. Aprende más sobre las claves API de Bedrock.

​

3. Configurar Claude Code

Establece las siguientes variables de entorno para habilitar Bedrock:

# Habilitar integración con Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # o tu región preferida

# Opcional: Anular la región para el modelo pequeño/rápido (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

​

4. Configuración del modelo

Claude Code utiliza estos modelos predeterminados para Bedrock:

Para personalizar modelos, usa uno de estos métodos:

# Usando ID de perfil de inferencia
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 de perfil de inferencia de aplicación
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Opcional: Deshabilitar caché de prompts si es necesario
export DISABLE_PROMPT_CACHING=1

​

Configuración de IAM

Crea una política de IAM con los permisos requeridos para 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 permisos más restrictivos, puedes limitar el Resource a ARNs específicos de perfiles de inferencia.

Para más detalles, consulta la documentación de IAM de Bedrock.

​

Solución de problemas

Si encuentras problemas de región:

• Verifica la disponibilidad del modelo: aws bedrock list-inference-profiles --region your-region
• Cambia a una región compatible: export AWS_REGION=us-east-1
• Considera usar perfiles de inferencia para acceso entre regiones

Si recibes un error “on-demand throughput isn’t supported”:

• Especifica el modelo como un ID de perfil de inferencia

​

Recursos adicionales

• Documentación de Bedrock
• Precios de Bedrock
• Perfiles de inferencia de Bedrock
• Claude Code en Amazon Bedrock: Guía de Configuración Rápida