​
Prerequisiti

Prima di configurare Claude Code con Bedrock, assicurati di avere:

  • Un account AWS con accesso Bedrock abilitato
  • Accesso ai modelli Claude desiderati (ad esempio, Claude Sonnet 4) in Bedrock
  • AWS CLI installato e configurato (opzionale - necessario solo se non hai un altro meccanismo per ottenere le credenziali)
  • Permessi IAM appropriati

​
Setup

​
1. Abilita l’accesso al modello

Prima, assicurati di avere accesso ai modelli Claude richiesti nel tuo account AWS:

  1. Naviga alla console Amazon Bedrock
  2. Vai a Model access nella navigazione di sinistra
  3. Richiedi l’accesso ai modelli Claude desiderati (ad esempio, Claude Sonnet 4)
  4. Attendi l’approvazione (solitamente istantanea per la maggior parte delle regioni)

​
2. Configura le credenziali AWS

Claude Code utilizza la catena di credenziali predefinita dell’AWS SDK. Configura le tue credenziali utilizzando uno di questi metodi:

Claude Code attualmente non supporta la gestione dinamica delle credenziali (come chiamare automaticamente aws sts assume-role). Dovrai eseguire aws configure, aws sso login, o impostare le variabili d’ambiente AWS_ da solo.

Opzione A: Configurazione AWS CLI

aws configure

Opzione B: Variabili d’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 d’ambiente (profilo SSO)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

​
3. Configura Claude Code

Imposta le seguenti variabili d’ambiente per abilitare Bedrock:

# Abilita l'integrazione Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # o la tua regione preferita

AWS_REGION è una variabile d’ambiente richiesta. Claude Code non legge dal file di configurazione .aws per questa impostazione.

​
4. Configurazione del modello

Claude Code utilizza questi modelli predefiniti per Bedrock:

Tipo di modelloValore predefinito
Modello primarious.anthropic.claude-3-7-sonnet-20250219-v1:0
Modello piccolo/veloceus.anthropic.claude-3-5-haiku-20241022-v1:0

Per personalizzare i modelli, utilizza uno di questi metodi:

# Utilizzando l'ID del profilo di inferenza
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Utilizzando l'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'

​
Configurazione IAM

Crea una policy IAM con i permessi richiesti per Claude Code.

Per i dettagli, vedi documentazione IAM di Bedrock.

Raccomandiamo di creare un account AWS dedicato per Claude Code per semplificare il tracciamento dei costi e il controllo degli accessi.

​
Risoluzione dei problemi

Se incontri 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 cross-region

Se ricevi un errore “on-demand throughput isn’t supported”:

​
Risorse aggiuntive