View a markdown version of this page

Requisitos previos - Plataforma Claude en AWS
Habilitar la federación de identidades web salientesObtén tu ID de espacio de trabajo

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Requisitos previos

Antes de realizar llamadas a la API, asegúrate de tener:

  1. Una cuenta de AWS activa con una suscripción a la plataforma Claude en AWS (consulte Configurar su cuenta).

  2. La AWS CLI instalada y configurada.

  3. La federación de identidades web salientes está habilitada en su cuenta de AWS (un paso de configuración único; consulte Habilitar la federación de identidades web salientes).

  4. El ID de su espacio de trabajo (consulte Obtener el ID de su espacio de trabajo).

Habilitar la federación de identidades web salientes

La plataforma Claude en AWS Gateway llama al sts:GetWebIdentityToken lado del servidor para acuñar un JWT y lo reenvía a Anthropic. Esta capacidad de STS está inhabilitada de forma predeterminada en todas las cuentas de AWS. Actívala una vez por cuenta:

aws iam enable-outbound-web-identity-federation

Si la respuesta es[ERROR] (FeatureEnabled) …​ already enabled, la configuración de tu cuenta ya está activada y puedes continuar. Verifica y recupera la URL del emisor de tu cuenta:

aws iam get-outbound-web-identity-federation-info
aviso

Sin este paso, todas las solicitudes se "Outbound web identity federation is disabled for your account" devolverán. Este es el error de configuración más común.

Obtén tu ID de espacio de trabajo

Al registrarte, se aprovisiona automáticamente un espacio de trabajo predeterminado en cada región (consulta Configurar tu cuenta). Los espacios de trabajo están enlazados a una sola región de AWS. Puede encontrar el ID del espacio de trabajo en la consola Claude, en Espacios de trabajo, o en la sección Espacios de trabajo de la página de servicio de la consola de AWS. Consulte los espacios de trabajo para conocer la vinculación de regiones y el alcance de los recursos de IAM.

Configure las variables ANTHROPIC_AWS_WORKSPACE_ID y de AWS_REGION entorno para que los clientes del SDK las lean automáticamente:

export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2'

La región es obligatoria. El cliente del SDK se activa si no se ha establecido ninguna región. Paseaws_region/awsRegional constructor o set AWS_REGION (oAWS_DEFAULT_REGION). Se admiten todas las regiones comerciales de AWS; las regiones de suscripción requieren que primero active la cuenta en la región.