

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Prerequisiti
<a name="prerequisites"></a>

Prima di effettuare chiamate API, assicurati di avere:

1. Un account AWS attivo con un abbonamento a Claude Platform on AWS (vedi [Configurazione dell'account](setup.md)).

1. L'[AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) è stata installata e configurata.

1.  La **federazione delle identità Web in uscita è abilitata** sul tuo account AWS (una sola operazione di configurazione; consulta [Abilitare la federazione delle identità Web in uscita](#enable-outbound-web-identity-federation)).

1. Il tuo ID dello spazio di lavoro (vedi [Ottieni l'ID del tuo](#obtain-your-workspace-id) spazio di lavoro).

## Abilita la federazione delle identità Web in uscita
<a name="enable-outbound-web-identity-federation"></a>

La piattaforma Claude sul gateway AWS chiama `sts:GetWebIdentityToken` lato server per coniare un JWT che inoltra ad Anthropic. Questa funzionalità STS è **disabilitata per impostazione predefinita** su ogni account AWS. Attivala una volta per account:

```
aws iam enable-outbound-web-identity-federation
```

Se la risposta è`[ERROR] (FeatureEnabled) …​ already enabled`, l'impostazione è già attiva per il tuo account e puoi andare avanti. Verifica e recupera l'URL emittente del tuo account:

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

**avvertimento**  
Senza questo passaggio, ogni richiesta viene restituita. `"Outbound web identity federation is disabled for your account"` Questo è l'errore di configurazione più comune.

## Ottieni l'ID del tuo spazio di lavoro
<a name="obtain-your-workspace-id"></a>

Al momento della registrazione viene fornito automaticamente uno spazio di lavoro predefinito in ogni regione (vedi [Configurazione dell'account](setup.md)). Gli spazi di lavoro sono associati a un'unica regione AWS. Puoi trovare l'ID dello spazio di lavoro nella console Claude sotto **Workspaces** o nella sezione Workspaces della **pagina del servizio** della console AWS. Consulta [Workspaces](workspaces.md) per l'associazione delle regioni e l'ambito delle risorse IAM.

Imposta le variabili `ANTHROPIC_AWS_WORKSPACE_ID` e di `AWS_REGION` ambiente in modo che i client SDK le leggano automaticamente:

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

La regione è obbligatoria. Il client SDK viene lanciato se non è impostata alcuna regione. Passa`aws_region`/`awsRegion`al costruttore o imposta `AWS_REGION` (or). `AWS_DEFAULT_REGION` Tutte le regioni commerciali AWS sono supportate; le regioni opt-in richiedono prima l'attivazione dell'account nella regione.