Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Platform on AWS è l’API Claude gestita da Anthropic con autenticazione AWS, controllo dell’accesso IAM e fatturazione tramite AWS Marketplace. Le richieste raggiungono direttamente l’API di Anthropic, quindi si ottengono gli stessi modelli e funzionalità dell’API Claude con la stessa pianificazione dei rilasci. L’autenticazione avviene con le credenziali AWS o una chiave API dell’area di lavoro, e il pagamento avviene tramite AWS Marketplace. Utilizzare questa guida per indirizzare Claude Code a un’area di lavoro già fornita tramite Claude Platform on AWS. Per la sottoscrizione AWS e la configurazione dell’area di lavoro che precede questo, consultare la documentazione di Claude Platform on AWS.
L’iscrizione tramite AWS Marketplace fornisce una nuova organizzazione Anthropic collegata al proprio account AWS. Questa organizzazione è separata da qualsiasi organizzazione già presente con Anthropic e le credenziali non si trasferiscono tra loro. Utilizzare l’ID dell’area di lavoro e le chiavi API dall’organizzazione collegata ad AWS, non da un account Claude Console preesistente.

​
Prerequisiti

Prima di configurare Claude Code, è necessario disporre di:
  • Una sottoscrizione attiva a Claude Platform on AWS tramite AWS Marketplace
  • Un’area di lavoro nella propria organizzazione Anthropic collegata ad AWS, con il relativo ID dell’area di lavoro
  • Un principale IAM con autorizzazione per invocare il servizio Anthropic, oppure una chiave API limitata all’area di lavoro
  • Credenziali AWS nel proprio ambiente, in ~/.aws/credentials, o da un ruolo IAM collegato se si desidera l’autenticazione SigV4. L’AWS CLI è richiesta solo per il flusso di accesso SSO.

​
Configurazione

​
1. Configurare le credenziali AWS

Claude Code supporta due metodi di autenticazione per Claude Platform on AWS. Scegliere il metodo che si adatta al modo in cui il team gestisce l’accesso. Opzione A: Credenziali AWS con SigV4 Claude Code firma le richieste con SigV4 utilizzando la catena di credenziali AWS standard: variabili di ambiente, credenziali condivise in ~/.aws/credentials, ruoli IAM, sessioni AWS SSO e qualsiasi altra fonte supportata dall’SDK AWS. Per l’uso locale, accedere con l’AWS CLI prima di avviare Claude Code. L’esempio seguente utilizza un profilo SSO, ma qualsiasi metodo che produce credenziali nelle posizioni standard funziona. 
aws sso login --profile my-profile
export AWS_PROFILE=my-profile
Per CI e automazione, fornire al runner un ruolo IAM con autorizzazione per invocare il servizio Anthropic e impostare AWS_REGION. La catena di credenziali raccoglie il ruolo automaticamente. Se le credenziali SSO scadono durante la sessione, configurare awsAuthRefresh in modo che Claude Code riesegua il comando di accesso e riprovi invece di fallire. Aggiungere il comando al file settings.json: 
{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}
Opzione B: Chiave API dell’area di lavoro Una chiave API dell’area di lavoro è un segreto di lunga durata, utile quando non si desidera gestire credenziali AWS federate. Generarne una nella console AWS in Claude Platform on AWS → API keys e impostarla come ANTHROPIC_AWS_API_KEY: 
export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx
La chiave viene inviata come x-api-key e ha la precedenza su SigV4, quindi qualsiasi credenziale AWS nel proprio ambiente viene ignorata. Le chiavi API da un’organizzazione Claude Console separata non funzioneranno qui. Trattare le chiavi API dell’area di lavoro come qualsiasi altra credenziale di produzione. Il blocco env del file delle impostazioni utente è un modo conveniente per limitare la chiave alla propria macchina senza esportarla globalmente.
I comandi /login e /logout non modificano l’autenticazione di Claude Platform on AWS. L’autenticazione viene eseguita tramite le credenziali AWS o la chiave API dell’area di lavoro, non tramite una sottoscrizione Claude.ai.

​
2. Configurare Claude Code

Impostare le variabili di ambiente che indirizzano Claude Code attraverso Claude Platform on AWS invece dell’API Anthropic predefinita. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1
ANTHROPIC_AWS_WORKSPACE_ID è obbligatorio e viene inviato su ogni richiesta come intestazione anthropic-workspace-id. L’URL di base viene calcolato da AWS_REGION come https://aws-external-anthropic.{region}.api.aws. Per sovrascrivere l’URL direttamente, impostare ANTHROPIC_AWS_BASE_URL. Claude Platform on AWS è facoltativo anche quando le credenziali AWS sono presenti nel proprio ambiente. Bedrock e Foundry hanno la precedenza nel routing dei provider, quindi annullare l’impostazione di CLAUDE_CODE_USE_BEDROCK e CLAUDE_CODE_USE_FOUNDRY se sono impostati.

​
3. Fissare le versioni dei modelli

Claude Platform on AWS utilizza gli stessi ID modello dell’API Claude diretta. Gli alias predefiniti opus, sonnet e haiku si risolvono alle versioni più recenti disponibili nell’area di lavoro. Se si distribuisce Claude Code a un team, fissare esplicitamente gli ID modello in modo che un nuovo rilascio non sposti tutti contemporaneamente: 
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
Per l’elenco completo degli ID modello e degli alias, consultare Panoramica dei modelli. Per altre variabili relative ai modelli, consultare Configurazione del modello. Prompt caching è abilitato automaticamente. Le scritture della cache di 1 ora vengono fatturate a una tariffa più alta rispetto alle scritture di 5 minuti. Per richiedere un TTL della cache di 1 ora invece del valore predefinito di 5 minuti, impostare ENABLE_PROMPT_CACHING_1H=1.

​
Utilizzare l’Agent SDK

L’Agent SDK legge le stesse variabili di ambiente della CLI, quindi qualsiasi programma che genera il sottoprocesso Claude Code può indirizzare Claude Platform on AWS esportando CLAUDE_CODE_USE_ANTHROPIC_AWS, ANTHROPIC_AWS_WORKSPACE_ID e ANTHROPIC_AWS_API_KEY o credenziali AWS prima della chiamata. 
import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}
Questo esempio si basa sulla catena di credenziali AWS ambientale per SigV4. Per autenticarsi con una chiave API dell’area di lavoro, impostare ANTHROPIC_AWS_API_KEY allo stesso modo. Per la superficie più ampia dell’Agent SDK, consultare Panoramica dell’Agent SDK.

​
Instradare attraverso un proxy aziendale

Per instradare il traffico attraverso un proxy o un gateway LLM, impostare ANTHROPIC_AWS_BASE_URL all’indirizzo del proxy. Claude Code invia richieste a quell’URL con le stesse intestazioni di area di lavoro e autenticazione, quindi qualsiasi gateway che le inoltri invariate funziona. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com
Se il gateway firma le richieste stesso, impostare CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1 in modo che Claude Code invii richieste non firmate e lasci che il gateway aggiunga intestazioni SigV4 prima di inoltrarle ad AWS. Se il gateway richiede il proprio token, impostarlo in ANTHROPIC_AUTH_TOKEN. 
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

​
Troubleshooting

Eseguire /status per visualizzare il provider risolto e qualsiasi ID dell’area di lavoro configurato esplicitamente, override della regione, override dell’URL di base e impostazione di skip dell’autenticazione. Questo è il modo più veloce per confermare che Claude Code sta indirizzando Claude Platform on AWS.

​
403 Forbidden o AccessDenied su ogni richiesta

Il principale IAM che Claude Code ha risolto probabilmente manca dell’autorizzazione per invocare il servizio Anthropic nell’area di lavoro. Controllare il ruolo collegato al profilo AWS o al runner che ha avviato Claude Code e verificare che disponga delle azioni aws-external-anthropic documentate nel riferimento delle azioni IAM. Se è stato impostato ANTHROPIC_AWS_API_KEY, la chiave ha la precedenza su SigV4 e una chiave obsoleta produce lo stesso errore. Rigenerare la chiave nella console AWS in Claude Platform on AWS → API keys o annullare l’impostazione della variabile per tornare alle credenziali AWS.

​
Le richieste non riescono con un errore di area di lavoro mancante

ANTHROPIC_AWS_WORKSPACE_ID è probabilmente non impostato o vuoto. Ogni richiesta di Claude Platform on AWS deve includere l’ID dell’area di lavoro. Non è implicito dalle credenziali AWS. Trovare l’ID in Workspaces nella pagina del servizio della console AWS ed esportarlo prima di avviare Claude Code.

​
Le richieste vanno ancora a api.anthropic.com

CLAUDE_CODE_USE_ANTHROPIC_AWS è probabilmente non impostato o impostato su un valore che non viene analizzato come veritiero. Impostarlo su 1 ed eseguire /status per confermare il provider risolto. Se è impostato anche CLAUDE_CODE_USE_BEDROCK o CLAUDE_CODE_USE_FOUNDRY, questi hanno la precedenza su Claude Platform on AWS.

​
Risorse aggiuntive

La sottoscrizione a Claude Platform on AWS, la configurazione dell’area di lavoro e IAM che precede la configurazione di Claude Code è coperta nella documentazione della piattaforma: