​
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 (usualmente 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:

Claude Code actualmente no admite la gestión dinámica de credenciales (como llamar automáticamente a aws sts assume-role). Necesitarás ejecutar aws configure, aws sso login, o establecer las variables de entorno AWS_ tú mismo.

Opción A: Configuración de AWS CLI

aws configure

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

export AWS_ACCESS_KEY_ID=tu-id-de-clave-de-acceso
export AWS_SECRET_ACCESS_KEY=tu-clave-de-acceso-secreta
export AWS_SESSION_TOKEN=tu-token-de-sesión

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

aws sso login --profile=<nombre-de-tu-perfil>

export AWS_PROFILE=nombre-de-tu-perfil

​
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

AWS_REGION es una variable de entorno requerida. Claude Code no lee del archivo de configuración .aws para esta configuración.

​
4. Configuración del modelo

Claude Code utiliza estos modelos predeterminados para Bedrock:

Tipo de modeloValor predeterminado
Modelo principalus.anthropic.claude-3-7-sonnet-20250219-v1:0
Modelo pequeño/rápidous.anthropic.claude-3-5-haiku-20241022-v1:0

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:tu-id-de-cuenta:application-inference-profile/tu-id-de-modelo'

​
Configuración de IAM

Crea una política de IAM con los permisos requeridos para Claude Code.

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

Recomendamos crear una cuenta de AWS dedicada para Claude Code para simplificar el seguimiento de costos y el control de acceso.

​
Solución de problemas

Si encuentras problemas de región:

  • Verifica la disponibilidad del modelo: aws bedrock list-inference-profiles --region tu-región
  • 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 “el rendimiento bajo demanda no es compatible”:

​
Recursos adicionales