Claude en Amazon Bedrock (Opus 4.7 y posteriores)

Esta guía te explica cómo configurar y realizar llamadas a la API de Claude en Amazon Bedrock. Claude en Amazon Bedrock se ejecuta en infraestructura administrada por AWS con cero acceso de operador (el personal de Anthropic no tiene acceso a la infraestructura de inferencia), lo que te permite crear aplicaciones sensibles completamente dentro del límite de seguridad de AWS mientras usas la misma estructura de la Messages API que usas con la API propia de Anthropic.



Acceso

Amazon Bedrock establece criterios de acceso para cada modelo de Claude de forma individual. Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 y Claude Haiku 4.5 están abiertos a todos los clientes de Amazon Bedrock; para conocer los criterios actuales de cualquier otro modelo, consulta Acceso a modelos de Amazon Bedrock en la consola de AWS. Claude Mythos Preview requiere una invitación; consulta Project Glasswing. Para la disponibilidad por región, consulta Regiones.



Requisitos previos

Antes de comenzar, asegúrate de tener:

• Una cuenta de AWS con acceso a modelos de Amazon Bedrock habilitado para los modelos de Claude que planeas usar.
• La AWS CLI instalada y configurada (opcional, para la gestión de credenciales).

Claude Mythos Preview requiere además una cuenta de AWS dedicada que haya sido incluida en la lista de permitidos por el equipo de Bedrock Marketplace. Tu ejecutivo de cuenta de Anthropic puede enviar tu ID de cuenta para su inclusión en la lista de permitidos (normalmente se procesa en 24 horas), y AWS envía un correo electrónico de bienvenida una vez completado.



Autenticación

Claude en Amazon Bedrock admite tres rutas de autenticación. Elige la que mejor se adapte a tus requisitos de seguridad.



Rol de servicio de Bedrock (recomendado)

Usa un rol de servicio de Bedrock con claves administradas por AWS para obtener el acceso más seguro y de larga duración:



Roles asumidos de IAM

Para acceso federado por identidad con una sesión máxima de 12 horas:



Tokens de portador

Para acceso a corto plazo sin roles de IAM (máximo de 12 horas, opción menos recomendada):



Instalar un SDK

Los SDK de cliente de Anthropic admiten Claude en Amazon Bedrock a través de un paquete o módulo específico para Bedrock.

pip install -U "anthropic[bedrock]"



Realizar tu primera solicitud

El endpoint sigue el patrón https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. A diferencia de la integración basada en InvokeModel, este endpoint usa streaming SSE estándar y la misma estructura de cuerpo de solicitud que la API propia de Anthropic.

El SDK resuelve las credenciales y la región usando la precedencia estándar de AWS: argumentos del constructor, luego variables de entorno (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), luego el archivo de configuración de AWS y la cadena de credenciales (SSO, roles asumidos, rol de tarea de ECS, IMDS).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))



Modelos compatibles

Los ID de modelo en Claude en Amazon Bedrock llevan un prefijo de proveedor anthropic.. Las capacidades y comportamientos de los modelos están documentados en la página Descripción general de modelos.



Compatibilidad de funcionalidades

Para ver la lista completa de funcionalidades con disponibilidad en Amazon Bedrock, consulta Descripción general de funcionalidades.



Funcionalidades compatibles destacadas

• Messages API (/anthropic/v1/messages)
• Almacenamiento en caché de prompts
• Pensamiento
• Uso de herramientas, incluyendo la herramienta Bash, la herramienta de uso de computadora, la herramienta de memoria y la herramienta de editor de texto
• Citas



Funcionalidades no compatibles

• Salidas estructuradas
• Fuentes de entrada (fuentes URL para imágenes y documentos, Files API)
• Herramientas del lado del servidor (ejecución de código, búsqueda web, obtención web, advisor)
• Infraestructura de agentes (Agent Skills, conector MCP, llamadas programáticas a herramientas)
• Endpoints de API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback del lado del servidor (el parámetro fallbacks; usa el patrón de fallback del lado del cliente en su lugar)



Regiones

Claude en Amazon Bedrock está disponible en las siguientes regiones de AWS. Amazon Bedrock ofrece dos tipos de endpoint:

• Global: enrutamiento dinámico entre todas las regiones disponibles para máxima disponibilidad. Sin recargo de precio.
• Regional: el endpoint se resuelve a la única región de AWS que especifiques, para requisitos de residencia de datos. Los endpoints regionales tienen un recargo de precio del 10% sobre los endpoints globales. Para enrutar entre varias regiones dentro de una geografía, usa un perfil de inferencia (US, EU, JP o AU). Las regiones marcadas como Solo en región en la tabla admiten enrutamiento directo a una sola región sin un perfil de inferencia.

El endpoint global está disponible para Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 y Claude Haiku 4.5. Claude Mythos Preview es solo regional y está disponible en us-east-1.



Cuotas

La cuota predeterminada es de 2 millones de tokens de entrada por minuto (TPM). Puedes solicitar hasta 4 millones de TPM de entrada sin aprobación adicional de Anthropic. AWS aplica límites de solicitudes por minuto (RPM) del lado de Bedrock; contacta al soporte de AWS para ajustes de RPM.



Retención de datos

El manejo de datos para esta oferta está regido por Amazon Bedrock. Para más detalles, consulta Protección de datos en Amazon Bedrock.



Monitoreo y registro

Claude en Amazon Bedrock emite registros tanto a CloudWatch como a CloudTrail. Anthropic recomienda conservar los registros de actividad durante al menos 30 días de forma continua para comprender los patrones de uso e investigar posibles problemas.



Soporte

Para soporte, contacta a [email protected]. Incluye tu ID de cuenta de AWS y el request-id de cualquier respuesta de API fallida.