Vai al contenuto principale

​
Prerequisiti

Prima di configurare Claude Code con Bedrock, assicurati di avere:
  • Un account AWS con accesso a Bedrock abilitato
  • Accesso ai modelli Claude desiderati (ad es. Claude Sonnet 4.5) in Bedrock
  • AWS CLI installato e configurato (facoltativo - necessario solo se non hai un altro meccanismo per ottenere le credenziali)
  • Autorizzazioni IAM appropriate

​
Configurazione

​
1. Invia i dettagli del caso d’uso

Gli utenti per la prima volta dei modelli Anthropic devono inviare i dettagli del caso d’uso prima di invocare un modello. Questo viene fatto una volta per account.
  1. Assicurati di avere le giuste autorizzazioni IAM (vedi di seguito per ulteriori informazioni)
  2. Accedi alla console di Amazon Bedrock
  3. Seleziona Chat/Text playground
  4. Scegli qualsiasi modello Anthropic e ti verrà chiesto di compilare il modulo del caso d’uso

​
2. Configura le credenziali AWS

Claude Code utilizza la catena di credenziali predefinita dell’SDK AWS. Configura le tue credenziali utilizzando uno di questi metodi: Opzione A: Configurazione AWS CLI 
aws configure
Opzione B: Variabili di ambiente (chiave di accesso) 
export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token
Opzione C: Variabili di ambiente (profilo SSO) 
aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name
Opzione D: Chiavi API Bedrock 
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key
Le chiavi API Bedrock forniscono un metodo di autenticazione più semplice senza necessità di credenziali AWS complete. Scopri di più sulle chiavi API Bedrock.

​
Configurazione avanzata delle credenziali

Claude Code supporta l’aggiornamento automatico delle credenziali per AWS SSO e provider di identità aziendali. Aggiungi queste impostazioni al file di impostazioni di Claude Code (vedi Impostazioni per i percorsi dei file). Quando Claude Code rileva che le tue credenziali AWS sono scadute (sia localmente in base al loro timestamp che quando Bedrock restituisce un errore di credenziale), eseguirà automaticamente i tuoi comandi awsAuthRefresh e/o awsCredentialExport configurati per ottenere nuove credenziali prima di riprovare la richiesta.
Configurazione di esempio
{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}
Impostazioni di configurazione spiegate
awsAuthRefresh: Usa questo per i comandi che modificano la directory .aws (ad es. aggiornamento delle credenziali, cache SSO o file di configurazione). L’output viene mostrato all’utente (ma l’input dell’utente non è supportato), rendendolo adatto per flussi di autenticazione basati su browser in cui la CLI visualizza un codice da inserire nel browser. awsCredentialExport: Usa questo solo se non puoi modificare .aws e devi restituire direttamente le credenziali. L’output viene acquisito silenziosamente (non mostrato all’utente). Il comando deve restituire JSON in questo formato: 
{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value"
  }
}

​
3. Configura Claude Code

Imposta le seguenti variabili di ambiente per abilitare Bedrock: 
# Abilita integrazione Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # o la tua regione preferita

# Facoltativo: Sovrascrivi la regione per il modello piccolo/veloce (Haiku)
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2
Quando abiliti Bedrock per Claude Code, tieni presente quanto segue:
  • AWS_REGION è una variabile di ambiente obbligatoria. Claude Code non legge dal file di configurazione .aws per questa impostazione.
  • Quando si utilizza Bedrock, i comandi /login e /logout sono disabilitati poiché l’autenticazione viene gestita tramite credenziali AWS.
  • Puoi utilizzare file di impostazioni per variabili di ambiente come AWS_PROFILE che non desideri perdere in altri processi. Vedi Impostazioni per ulteriori informazioni.

​
4. Configurazione del modello

Claude Code utilizza questi modelli predefiniti per Bedrock:
Tipo di modelloValore predefinito
Modello primarioglobal.anthropic.claude-sonnet-4-5-20250929-v1:0
Modello piccolo/veloceus.anthropic.claude-haiku-4-5-20251001-v1:0
Per gli utenti di Bedrock, Claude Code non eseguirà automaticamente l’aggiornamento da Haiku 3.5 a Haiku 4.5. Per passare manualmente a un modello Haiku più recente, imposta la variabile di ambiente ANTHROPIC_DEFAULT_HAIKU_MODEL sul nome completo del modello (ad es. us.anthropic.claude-haiku-4-5-20251001-v1:0).
Per personalizzare i modelli, utilizza uno di questi metodi: 
# Utilizzo dell'ID del profilo di inferenza
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

# Utilizzo dell'ARN del profilo di inferenza dell'applicazione
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

# Facoltativo: Disabilita la memorizzazione nella cache del prompt se necessario
export DISABLE_PROMPT_CACHING=1
La memorizzazione nella cache del prompt potrebbe non essere disponibile in tutte le regioni

​
5. Configurazione del token di output

Quando utilizzi Claude Code con Amazon Bedrock, consigliamo le seguenti impostazioni di token: 
# Impostazioni consigliate dei token di output per Bedrock
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024
Perché questi valori:
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096: La logica di throttling del burndown di Bedrock imposta un minimo di 4096 token come penalità max_token. Impostare questo valore più basso non ridurrà i costi ma potrebbe interrompere gli usi degli strumenti lunghi, causando il fallimento persistente del loop dell’agente Claude Code. Claude Code in genere utilizza meno di 4096 token di output senza il pensiero esteso, ma potrebbe aver bisogno di questo spazio di manovra per attività che coinvolgono la creazione significativa di file o l’utilizzo dello strumento Write.
  • MAX_THINKING_TOKENS=1024: Questo fornisce spazio per il pensiero esteso senza interrompere le risposte di utilizzo degli strumenti, mantenendo comunque catene di ragionamento focalizzate. Questo equilibrio aiuta a prevenire cambiamenti di traiettoria che non sono sempre utili per attività di codifica specifiche.

​
Configurazione IAM

Crea una politica IAM con le autorizzazioni richieste per Claude Code: 
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}
Per autorizzazioni più restrittive, puoi limitare la Resource agli ARN del profilo di inferenza specifici. Per i dettagli, vedi Documentazione IAM di Bedrock.
Consigliamo di creare un account AWS dedicato per Claude Code per semplificare il tracciamento dei costi e il controllo degli accessi.

​
Risoluzione dei problemi

Se riscontri problemi di regione:
  • Controlla la disponibilità del modello: aws bedrock list-inference-profiles --region your-region
  • Passa a una regione supportata: export AWS_REGION=us-east-1
  • Considera l’utilizzo di profili di inferenza per l’accesso tra regioni
Se ricevi un errore “on-demand throughput isn’t supported”: Claude Code utilizza l’API Invoke di Bedrock e non supporta l’API Converse.

​
Risorse aggiuntive