Claude en Amazon Bedrock (vista previa de investigación)

Esta guía te ayuda a configurar y realizar llamadas a la API de Claude en Amazon Bedrock. Claude en Amazon Bedrock se ejecuta en infraestructura administrada por AWS sin acceso de operadores (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 forma de API de Messages que usas con la API de primera parte de Anthropic.

Esta página cubre la vista previa de investigación de la nueva oferta de Claude en Amazon Bedrock, que expone la API de Messages en /anthropic/v1/messages. Para la integración existente de Bedrock (las APIs InvokeModel y Converse con identificadores de modelo versionados por ARN y codificación de flujo de eventos de AWS), consulta Claude en Amazon Bedrock.

Vista previa de investigación

El endpoint de Claude en Amazon Bedrock está en vista previa de investigación, disponible en la región US East (N. Virginia) us-east-1. Contacta a tu ejecutivo de cuenta de Anthropic para solicitar acceso.

Requisitos previos

Antes de comenzar, asegúrate de tener:

Una nueva cuenta de AWS en us-east-1. La vista previa de investigación requiere una cuenta dedicada para aislamiento. Tu ejecutivo de cuenta de Anthropic enviará tu ID de cuenta al equipo de Bedrock Marketplace para incluirlo en la lista de permitidos (típicamente procesado dentro de 24 horas).
La AWS CLI instalada y configurada (opcional, para la gestión de credenciales)
Después de incluirse en la lista de permitidos, AWS envía un correo de bienvenida con detalles de configuración adicionales.

Autenticación

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

Rol de servicio de Bedrock (recomendado)

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

Admin: provisionar el rol de servicio
Un administrador de AWS provisiona un rol de servicio de Bedrock y otorga a los desarrolladores permiso iam:PassRole en el ARN del rol de servicio.
Developer: pasar el rol
Al llamar a la API, Bedrock asume el rol de servicio en tu nombre. Consulta la documentación de Amazon Bedrock para saber cómo asociar el rol con tus solicitudes.

Roles asumidos de IAM

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

Admin: configurar el rol de IAM
Crea un rol de IAM limitado a tus modelos de Claude. La política de confianza nombra tu proveedor de identidad (SAML, OIDC o AWS Identity Center). La política de permisos otorga bedrock-mantle:CreateInference solo en los ARN de modelo permitidos.
Developer: autenticar y asumir
Autentica a través de tu proveedor de identidad corporativo, luego asume el rol de IAM. AWS STS emite credenciales temporales que el SDK o CLI usa para firmar solicitudes.

Tokens portadores

Para acceso a corto plazo sin roles de IAM (máximo 12 horas, menos preferido):

Admin: restringir tipos de token
Bloquea claves de larga duración adjuntando una política que niega bedrock:CallWithBearerToken a menos que la condición bedrock:BearerTokenType coincida con un token a corto plazo.
Developer: crear un token
Usa la CLI aws-bedrock-token-generator para crear un token portador. Pásalo en el encabezado x-api-key en cada solicitud.

Instalar un SDK

Los SDKs de cliente de Anthropic admiten Claude en Amazon Bedrock a través de un paquete o módulo específico de 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 forma de cuerpo de solicitud que la API de primera parte de Anthropic.

El SDK resuelve credenciales y 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).

También puedes usar el cliente Anthropic estándar: establece base_url en https://bedrock-mantle.{region}.api.aws/anthropic y pasa tu token portador como api_key. Esta ruta solo admite autenticación de token portador. La firma SigV4 requiere el cliente dedicado.

Modelos admitidos

Los IDs de modelo en Claude en Amazon Bedrock llevan un prefijo de proveedor anthropic.. Las capacidades y comportamientos del modelo se documentan en la página Descripción general de modelos.

Modelo	ID de modelo
Claude Opus 4.7	`anthropic.claude-opus-4-7`
Claude Mythos Preview	`anthropic.claude-mythos-preview`
Claude Haiku 4.5	`anthropic.claude-haiku-4-5`

Disponibilidad de características

Claude en Amazon Bedrock admite características que se ejecutan dentro del modelo. Las características que requieren infraestructura operada por Anthropic no están disponibles.

Admitidas:

API de Messages (/v1/messages)
Almacenamiento en caché de prompts
Pensamiento extendido
Uso de herramientas (herramientas definidas por el cliente)
Citas
Salidas estructuradas
Inferencia en región (las solicitudes permanecen en una única región de AWS)

No admitidas:

Herramientas definidas por Anthropic (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
Claude Managed Agents
API de Message Batches
Endpoint /v1/users

Regiones

La vista previa de investigación está disponible solo en us-east-1 (IAD).

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) en el lado de Bedrock; contacta al soporte de AWS para ajustes de RPM.

Retención de datos

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

La retención de datos cero (ZDR) está disponible. Para habilitar ZDR en tu cuenta, contacta al soporte de AWS.

Observabilidad

Claude en Amazon Bedrock emite registros tanto a CloudWatch como a CloudTrail. Anthropic recomienda retener registros de actividad en al menos una base móvil de 30 días para comprender patrones de uso e investigar posibles problemas.

Soporte

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

Claude Mythos Preview es un modelo de vista previa de investigación disponible para clientes invitados en Amazon Bedrock. Para obtener más información, consulta Project Glasswing.