Chiamare Claude tramite Bedrock differisce leggermente da come chiameresti Claude quando usi gli SDK client di Anthropic. Questa guida ti guiderà attraverso il processo di completamento di una chiamata API a Claude su Bedrock in Python o TypeScript.

Nota che questa guida presuppone che tu abbia già registrato un account AWS e configurato l’accesso programmatico.

Installa e configura l’AWS CLI

  1. Installa una versione dell’AWS CLI alla versione 2.13.23 o più recente
  2. Configura le tue credenziali AWS utilizzando il comando AWS configure (vedi Configura l’AWS CLI) o trova le tue credenziali navigando su “Command line or programmatic access” nel tuo dashboard AWS e seguendo le istruzioni nel popup modale.
  3. Verifica che le tue credenziali funzionino:
Shell
aws sts get-caller-identity

Installa un SDK per accedere a Bedrock

Gli SDK client di Anthropic supportano Bedrock. Puoi anche utilizzare direttamente un SDK AWS come boto3.

pip install -U "anthropic[bedrock]"

Accesso a Bedrock

Iscriviti ai modelli Anthropic

Vai alla Console AWS > Bedrock > Accesso ai Modelli e richiedi l’accesso ai modelli Anthropic. Nota che la disponibilità dei modelli Anthropic varia per regione. Vedi la documentazione AWS per le informazioni più aggiornate.

Nomi dei modelli API

ModelloNome del modello API Bedrock
Claude Opus 4.1anthropic.claude-opus-4-1-20250805-v1:0
Claude Opus 4anthropic.claude-opus-4-20250514-v1:0
Claude Sonnet 4anthropic.claude-sonnet-4-20250514-v1:0
Claude Sonnet 3.7anthropic.claude-3-7-sonnet-20250219-v1:0
Claude Haiku 3.5anthropic.claude-3-5-haiku-20241022-v1:0
Claude Sonnet 3.5anthropic.claude-3-5-sonnet-20241022-v2:0
Claude Opus 3 anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3 anthropic.claude-3-sonnet-20240229-v1:0
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0

Elenca i modelli disponibili

I seguenti esempi mostrano come stampare un elenco di tutti i modelli Claude disponibili tramite Bedrock:

aws bedrock list-foundation-models --region=us-west-2 --by-provider anthropic --query "modelSummaries[*].modelId"

Effettuare richieste

I seguenti esempi mostrano come generare testo da Claude su Bedrock:

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    # Autenticati fornendo le chiavi qui sotto o usa i provider di credenziali AWS predefiniti, come
    # utilizzando ~/.aws/credentials o le variabili d'ambiente "AWS_SECRET_ACCESS_KEY" e "AWS_ACCESS_KEY_ID".
    aws_access_key="<access key>",
    aws_secret_key="<secret key>",
    # Le credenziali temporanee possono essere utilizzate con aws_session_token.
    # Leggi di più su https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html.
    aws_session_token="<session_token>",
    # aws_region cambia la regione aws a cui viene effettuata la richiesta. Per impostazione predefinita, leggiamo AWS_REGION,
    # e se non è presente, utilizziamo us-east-1 come predefinito. Nota che non leggiamo ~/.aws/config per la regione.
    aws_region="us-west-2",
)

message = client.messages.create(
    model="anthropic.claude-opus-4-1-20250805-v1:0",
    max_tokens=256,
    messages=[{"role": "user", "content": "Ciao, mondo"}]
)
print(message.content)

Vedi i nostri SDK client per maggiori dettagli, e la documentazione ufficiale di Bedrock qui.

Registrazione delle attività

Bedrock fornisce un servizio di registrazione delle invocazioni che consente ai clienti di registrare i prompt e i completamenti associati al tuo utilizzo.

Anthropic raccomanda di registrare la tua attività almeno su base continuativa di 30 giorni per comprendere la tua attività e investigare qualsiasi potenziale uso improprio.

L’attivazione di questo servizio non dà ad AWS o Anthropic alcun accesso ai tuoi contenuti.

Supporto delle funzionalità

Puoi trovare tutte le funzionalità attualmente supportate su Bedrock qui.

Supporto PDF su Bedrock

Il supporto PDF è disponibile su Amazon Bedrock tramite sia l’API Converse che l’API InvokeModel. Per informazioni dettagliate sulle capacità e limitazioni di elaborazione PDF, vedi la documentazione del supporto PDF.

Considerazioni importanti per gli utenti dell’API Converse:

  • L’analisi visiva dei PDF (grafici, immagini, layout) richiede che le citazioni siano abilitate
  • Senza citazioni, è disponibile solo l’estrazione di testo di base
  • Per il controllo completo senza citazioni forzate, usa l’API InvokeModel

Per maggiori dettagli sui due modi di elaborazione dei documenti e le loro limitazioni, fai riferimento alla guida del supporto PDF.

Finestra di contesto di 1M token

Claude Sonnet 4 supporta la finestra di contesto di 1M token su Amazon Bedrock.

La finestra di contesto di 1M token è attualmente in beta. Per utilizzare la finestra di contesto estesa, includi l’header beta context-1m-2025-08-07 nelle tue richieste API Bedrock.