Claude in Amazon Bedrock

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



Accesso

Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7 e Claude Haiku 4.5 sono disponibili per tutti i clienti Amazon Bedrock. Claude Mythos Preview richiede un invito; consulta Project Glasswing. Per la disponibilità regionale, consulta Regioni.



Prerequisiti

Prima di iniziare, assicurati di avere:

• Un account AWS con accesso ai modelli Amazon Bedrock 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 Bedrock Marketplace. Il tuo account executive Anthropic può inviare il tuo ID account per l'inserimento nella allowlist (generalmente elaborato entro 24 ore), e AWS invia un'email di benvenuto una volta completato.



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:



Ruoli IAM assunti

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



Bearer token

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



Installa un SDK

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



Effettuare la prima richiesta

L'endpoint segue il pattern https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages. A differenza dell'integrazione basata su InvokeModel, questo endpoint utilizza lo streaming SSE standard e la stessa struttura del corpo della richiesta dell'API first-party di Anthropic.

L'SDK risolve le credenziali e la regione utilizzando la 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 di credenziali (SSO, ruoli assunti, ruolo task ECS, IMDS).



Modelli supportati

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



Supporto delle funzionalità

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



Funzionalità supportate in evidenza

• Messages API (/anthropic/v1/messages)
• Cache dei prompt
• Pensiero esteso
• Uso degli strumenti, inclusi lo strumento Bash, lo strumento Computer use, lo strumento Memory e lo strumento Text editor
• Citazioni
• Output strutturati



Funzionalità non supportate

• 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)



Regioni

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

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

L'endpoint globale è disponibile per Claude Fable 5, Claude Opus 4.8, Claude Opus 4.7 e Claude Haiku 4.5. 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 4 milioni di TPM di input 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 Protezione dei dati 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à per almeno 30 giorni su base continuativa per comprendere i pattern di utilizzo e investigare potenziali problemi.



Supporto

Per il supporto, contatta [email protected]. Includi il tuo ID account AWS e il request-id di eventuali risposte API non riuscite.