Claude in Amazon Bedrock (Opus 4.7 e successivi)

Questa guida ti accompagna nella configurazione e nell'esecuzione di chiamate API a Claude in Amazon Bedrock. Claude in Amazon Bedrock viene eseguito su un'infrastruttura gestita da AWS con zero accesso da parte degli operatori (il personale di Anthropic non ha alcun accesso all'infrastruttura di inferenza), consentendoti di creare applicazioni sensibili interamente all'interno del perimetro di sicurezza AWS, utilizzando la stessa struttura della Messages API che usi con l'API di prima parte di Anthropic.

Accesso

Amazon Bedrock stabilisce i criteri di accesso per ciascun modello Claude individualmente. Claude Fable 5.1, Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5, Claude Opus 4.7 e Claude Haiku 4.5 sono aperti a tutti i clienti Amazon Bedrock. Per i criteri attuali di qualsiasi altro modello, controlla Amazon Bedrock model access nella console AWS. Claude Mythos Preview richiede un invito tramite Project Glasswing. Per la disponibilità nelle regioni, consulta Regioni.

Prerequisiti

Prima di iniziare, assicurati di avere:

• Un account AWS con Amazon Bedrock model access abilitato per i modelli Claude che intendi utilizzare.
• La AWS CLI installata e configurata (opzionale, per la gestione delle credenziali).

Claude Mythos Preview richiede inoltre un account AWS dedicato che sia stato inserito nella allowlist dal team di Bedrock Marketplace. Il tuo account executive di Anthropic può inviare l'ID del tuo account per l'inserimento nella allowlist (in genere elaborato entro 24 ore), e AWS invia un'email di benvenuto una volta completata l'operazione.

Autenticazione

Claude in Amazon Bedrock supporta tre percorsi di autenticazione. Scegli quello che meglio si adatta ai tuoi requisiti di sicurezza.

Ruolo di servizio Bedrock (consigliato)

Usa un ruolo di servizio Bedrock con chiavi gestite da AWS per l'accesso più sicuro e di lunga durata:

1. 1

   Amministratore: predisponi il ruolo di servizio

   Un amministratore AWS predispone un ruolo di servizio Bedrock e concede agli sviluppatori il permesso iam:PassRole sull'ARN del ruolo di servizio.

2. 2

   Sviluppatore: passa il ruolo

   Quando chiami l'API, Bedrock assume il ruolo di servizio per tuo conto. Consulta la documentazione di Amazon Bedrock per sapere come associare il ruolo alle tue richieste.

Ruoli IAM assunti

Per l'accesso federato tramite identità con una sessione massima di 12 ore:

1. 1

   Amministratore: configura il ruolo IAM

   Crea un ruolo IAM con ambito limitato ai tuoi modelli Claude. La trust policy indica il tuo identity provider (SAML, OIDC o AWS Identity Center). La permissions policy concede bedrock-mantle:CreateInference solo sugli ARN dei modelli consentiti.

2. 2

   Sviluppatore: autenticati e assumi il ruolo

   Autenticati tramite l'identity provider aziendale, quindi assumi il ruolo IAM. AWS STS emette credenziali temporanee che l'SDK o la CLI utilizza per firmare le richieste.

Bearer token

Per l'accesso a breve termine senza ruoli IAM (massimo 12 ore, opzione meno preferibile):

1. 1

   Amministratore: limita i tipi di token

   Blocca le chiavi a lungo termine allegando una policy che nega bedrock:CallWithBearerToken a meno che la condizione bedrock:BearerTokenType non corrisponda a un token a breve termine.

2. 2

   Sviluppatore: genera un token

   Usa la CLI aws-bedrock-token-generator per generare un bearer token. Passalo nell'header x-api-key in ogni richiesta.

Installa un SDK

Gli SDK client di Anthropic supportano Claude in Amazon Bedrock tramite un pacchetto o modulo specifico per Bedrock.

pip install -U "anthropic[bedrock]"

Effettuare la prima richiesta

L'endpoint segue lo schema https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. A differenza dell'integrazione basata su InvokeModel, questo endpoint utilizza lo "streaming" (trasmissione in flusso) SSE standard e la stessa struttura del corpo della richiesta dell'API di prima parte di Anthropic.

L'SDK risolve le credenziali e la regione utilizzando l'ordine di precedenza standard di AWS: argomenti del costruttore, poi variabili d'ambiente (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_SESSION_TOKEN, AWS_REGION), poi il file di configurazione AWS e la catena delle credenziali (SSO, ruoli assunti, ruolo del task ECS, IMDS).

from anthropic import AnthropicBedrockMantle

client = AnthropicBedrockMantle(aws_region="us-east-1")

message = client.messages.create(
    model="anthropic.claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(next(block.text for block in message.content if block.type == "text"))

Modelli supportati

Gli ID dei modelli in Claude in Amazon Bedrock hanno il prefisso del provider anthropic.. Le capacità e i comportamenti dei modelli sono documentati nella pagina Panoramica dei modelli.

Usa la versione più recente di Claude Code con Claude in Amazon Bedrock; esegui claude update per aggiornare.

Supporto delle funzionalità

Per l'elenco completo delle funzionalità con la disponibilità su Amazon Bedrock, consulta la Panoramica delle funzionalità.

Funzionalità supportate principali

• Messages API (/anthropic/v1/messages)
• Prompt caching (cache dei prompt)
• Thinking (ragionamento)
• Tool use (uso degli strumenti), inclusi lo strumento Bash, lo strumento Computer use, lo strumento Memory e lo strumento Text editor
• Citazioni

Funzionalità non supportate

• Output strutturati
• Sorgenti di input (sorgenti URL per immagini e documenti, Files API)
• Strumenti lato server (esecuzione di codice, ricerca web, web fetch, advisor)
• Infrastruttura per agenti (Agent Skills, connettore MCP, chiamata programmatica degli strumenti)
• Endpoint API (Message Batches, Models, Admin, Compliance, Usage and Cost)
• Claude Managed Agents
• Fallback lato server (il parametro fallbacks; usa invece il pattern di fallback lato client)
• Toolset Computer use e browser use (computer_toolset_20260801 e browser_toolset_20260801 non sono attualmente disponibili su Amazon Bedrock; le versioni beta dello strumento computer use rimangono disponibili)

Regioni

Claude in Amazon Bedrock è disponibile nelle seguenti regioni AWS. Amazon Bedrock offre due tipi di endpoint:

• Globale: instradamento dinamico tra tutte le regioni disponibili per la massima disponibilità. Nessun sovrapprezzo.
• Regionale: l'endpoint si risolve nella singola regione AWS che specifichi, per i requisiti di residenza dei dati. Gli endpoint regionali comportano un sovrapprezzo del 10% rispetto agli endpoint globali. Per instradare tra più regioni all'interno di un'area geografica, usa un "inference profile" (profilo di inferenza) (US, EU, JP o AU). Le regioni contrassegnate con Solo nella regione nella tabella supportano l'instradamento diretto in una singola regione senza un profilo di inferenza.

L'endpoint globale è disponibile per Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5.5, Claude Sonnet 5, Claude Haiku 5.5 e Claude Haiku 4.5. Per Claude Fable 5.1, gli endpoint regionali sono attualmente disponibili solo in us-east-1. Claude Mythos Preview è solo regionale ed è disponibile in us-east-1.

Quote

La quota predefinita è di 2 milioni di token di input al minuto (TPM). Puoi richiedere fino a 5 milioni di TPM di input e 500.000 TPM di output senza ulteriore approvazione da parte di Anthropic. AWS applica limiti di richieste al minuto (RPM) sul lato Bedrock; contatta il supporto AWS per modifiche agli RPM.

Conservazione dei dati

La gestione dei dati per questa offerta è regolata da Amazon Bedrock. Per i dettagli, consulta Data protection in Amazon Bedrock.

Monitoraggio e logging

Claude in Amazon Bedrock emette log sia su CloudWatch che su CloudTrail. Anthropic consiglia di conservare i log delle attività su base continuativa di almeno 30 giorni per comprendere i modelli di utilizzo e indagare su potenziali problemi.

Supporto

Per il supporto, contatta bedrock-ant-eap@amazon.com. Includi l'ID del tuo account AWS e il request-id di eventuali risposte API non riuscite.