As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Pré-requisitos
Antes de fazer chamadas de API, verifique se você tem:
-
Uma conta ativa da AWS com uma assinatura da Claude Platform na AWS (consulte Configurar sua conta).
-
A AWS CLI instalada e configurada.
-
Federação de identidade da web de saída ativada em sua conta da AWS (uma etapa de configuração única; consulte Habilitar federação de identidade da web de saída).
-
Seu ID do espaço de trabalho (consulte Obter seu ID do espaço de trabalho).
Habilitar federação de identidades web de saída
A plataforma Claude no gateway da AWS chama o sts:GetWebIdentityToken lado do servidor para criar um JWT que ele encaminha para a Anthropic. Esse recurso de STS está desativado por padrão em todas as contas da AWS. Ative-o uma vez por conta:
aws iam enable-outbound-web-identity-federation
Se a resposta for[ERROR] (FeatureEnabled) … already enabled, a configuração da sua conta já está ativada e você pode seguir em frente. Verifique e recupere o URL do emissor da sua conta:
aws iam get-outbound-web-identity-federation-info
Atenção
Sem essa etapa, todas as solicitações retornam"Outbound web identity federation is disabled for your account". Esse é o erro de configuração mais comum.
Obtenha seu ID do espaço de trabalho
Um espaço de trabalho padrão é provisionado automaticamente em cada região quando você se inscreve (consulte Configurar sua conta). Os espaços de trabalho estão vinculados a uma única região da AWS. Você pode encontrar o ID do espaço de trabalho no Console Claude, em Espaços de trabalho, ou na seção Espaços de trabalho da página de serviço do Console AWS. Consulte Espaços de trabalho para vinculação de regiões e escopo de recursos do IAM.
Defina as variáveis de AWS_REGION ambiente ANTHROPIC_AWS_WORKSPACE_ID e para que os clientes do SDK as leiam automaticamente:
export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj' export AWS_REGION='us-west-2'
A região é obrigatória. O cliente SDK é lançado se nenhuma região estiver definida. Passeaws_region/awsRegionpara o construtor ou defina AWS_REGION (ouAWS_DEFAULT_REGION). Todas as regiões comerciais da AWS são suportadas; as regiões de inscrição exigem que você primeiro inscreva a conta na região.
