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

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.

​

Configuración avanzada de credenciales

Claude Code soporta actualización automática de credenciales para AWS SSO y proveedores de identidad corporativos. Agrega estas configuraciones a tu archivo de configuración de Claude Code (consulta Configuraciones para ubicaciones de archivos).

Cuando Claude Code detecta que tus credenciales de AWS han expirado (ya sea localmente basado en su marca de tiempo o cuando Bedrock devuelve un error de credenciales), ejecutará automáticamente tus comandos configurados awsAuthRefresh y/o awsCredentialExport para obtener nuevas credenciales antes de reintentar la solicitud.

Ejemplo de configuración

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

Configuraciones explicadas

awsAuthRefresh: Usa esto para comandos que modifican el directorio .aws (por ejemplo, actualizar credenciales, caché SSO, o archivos de configuración). La salida se muestra al usuario (pero la entrada del usuario no es compatible), haciéndolo adecuado para flujos de autenticación basados en navegador donde la CLI muestra un código para ingresar en el navegador.

awsCredentialExport: Solo usa esto si no puedes modificar .aws y debes devolver credenciales directamente. La salida se captura silenciosamente (no se muestra al usuario). El comando debe devolver JSON en este formato:

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value"
  }
}

​

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

Al habilitar Bedrock para Claude Code, ten en cuenta lo siguiente:

• AWS_REGION es una variable de entorno requerida. Claude Code no lee del archivo de configuración .aws para esta configuración.
• Al usar Bedrock, los comandos /login y /logout están deshabilitados ya que la autenticación se maneja a través de credenciales de AWS.
• Puedes usar archivos de configuración para variables de entorno como AWS_PROFILE que no quieres que se filtren a otros procesos. Consulta Configuraciones para más información.

​

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-1-20250805-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

​

5. Configuración de tokens de salida

Al usar Claude Code con Amazon Bedrock, recomendamos las siguientes configuraciones de tokens:

# Configuraciones recomendadas de tokens de salida para Bedrock
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024

Por qué estos valores:

• CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096: La lógica de limitación de burndown de Bedrock establece un mínimo de 4096 tokens como la penalización de max_token. Establecer esto más bajo no reducirá costos pero puede cortar usos largos de herramientas, causando que el bucle del agente Claude Code falle persistentemente. Claude Code típicamente usa menos de 4096 tokens de salida sin pensamiento extendido, pero puede necesitar este margen para tareas que involucran creación significativa de archivos o uso de la herramienta Write.

• MAX_THINKING_TOKENS=1024: Esto proporciona espacio para pensamiento extendido sin cortar respuestas de uso de herramientas, mientras mantiene cadenas de razonamiento enfocadas. Este equilibrio ayuda a prevenir cambios de trayectoria que no siempre son útiles para tareas de codificación específicamente.

​

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 detalles, consulta la documentación de IAM de Bedrock.

​

Solución de problemas

Si encuentras problemas de región:

• Verifica 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

Claude Code utiliza la API Invoke de Bedrock y no soporta la API Converse.

​

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