Chiamare Claude tramite Bedrock differisce leggermente da come chiameresti Claude quando utilizzi gli SDK client di Anthropic. Questa guida ti accompagnerà nel 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.

Installare e configurare AWS CLI

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

Installare 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]"

Accedere a Bedrock

Sottoscrivere ai modelli Anthropic

Vai alla Console AWS > Bedrock > Model Access e richiedi l’accesso ai modelli Anthropic. Nota che la disponibilità dei modelli Anthropic varia in base alla regione. Consulta la documentazione AWS per le informazioni più aggiornate.

Nomi dei modelli API

ModelloNome modello API Bedrock
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 3anthropic.claude-3-opus-20240229-v1:0
Claude Sonnet 3anthropic.claude-3-sonnet-20240229-v1:0
Claude Haiku 3anthropic.claude-3-haiku-20240307-v1:0

Elencare 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 sottostanti o utilizzando 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, il valore predefinito è us-east-1. Nota che non leggiamo ~/.aws/config per la regione.
    aws_region="us-west-2",
)

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

Consulta 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 consiglia di registrare la tua attività su base continuativa di almeno 30 giorni per comprendere la tua attività e investigare su potenziali usi impropri.

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