Claude in Amazon Bedrock (anteprima di ricerca)

Questa guida ti guida attraverso la configurazione e l'esecuzione di chiamate API a Claude in Amazon Bedrock. Claude in Amazon Bedrock viene eseguito su infrastruttura gestita da AWS con accesso zero dell'operatore (il personale di Anthropic non ha accesso all'infrastruttura di inferenza), permettendoti di creare applicazioni sensibili interamente all'interno del confine di sicurezza AWS mentre utilizzi la stessa forma di Messages API che usi con l'API di prima parte di Anthropic.

Questa pagina copre l'anteprima di ricerca della nuova offerta Claude in Amazon Bedrock, che espone l'API Messages su /anthropic/v1/messages. Per l'integrazione Bedrock esistente (le API InvokeModel e Converse con identificatori di modello con versione ARN e codifica event-stream AWS), vedi Claude on Amazon Bedrock.

Anteprima di ricerca

L'endpoint Claude in Amazon Bedrock è in anteprima di ricerca, disponibile nella regione US East (N. Virginia) us-east-1. Contatta il tuo account executive di Anthropic per richiedere l'accesso.

Prerequisiti

Prima di iniziare, assicurati di avere:

Un nuovo account AWS in us-east-1. L'anteprima di ricerca richiede un account dedicato per l'isolamento. Il tuo account executive di Anthropic invierà il tuo ID account al team Bedrock Marketplace per l'inserimento in whitelist (generalmente elaborato entro 24 ore).
L'AWS CLI installata e configurata (facoltativo, per la gestione delle credenziali)
Dopo l'inserimento in whitelist, AWS invia un'email di benvenuto con ulteriori dettagli di configurazione.

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:

Admin: provisioning del ruolo di servizio
Un amministratore AWS provisioning un ruolo di servizio Bedrock e concede ai sviluppatori il permesso iam:PassRole sull'ARN del ruolo di servizio.
Developer: passare il ruolo
Quando chiami l'API, Bedrock assume il ruolo di servizio per tuo conto. Vedi la documentazione di Amazon Bedrock per come associare il ruolo alle tue richieste.

Ruoli IAM assunti

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

Admin: configurare il ruolo IAM
Crea un ruolo IAM limitato ai tuoi modelli Claude. La politica di trust nomina il tuo provider di identità (SAML, OIDC o AWS Identity Center). La politica di autorizzazioni concede bedrock-mantle:CreateInference solo sugli ARN del modello consentiti.
Developer: autenticarsi e assumere
Autentica tramite il tuo provider di identità aziendale, quindi assumi il ruolo IAM. AWS STS emette credenziali temporanee che l'SDK o CLI utilizza per firmare le richieste.

Token Bearer

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

Admin: limitare i tipi di token
Blocca le chiavi di lunga durata allegando una politica che nega bedrock:CallWithBearerToken a meno che la condizione bedrock:BearerTokenType corrisponda a un token a breve termine.
Developer: creare un token
Usa la CLI aws-bedrock-token-generator per creare un token bearer. Passalo nell'intestazione x-api-key su ogni richiesta.

Installa un SDK

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

Effettuare la tua 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 forma di corpo della richiesta dell'API di prima parte di Anthropic.

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

Puoi anche usare il client Anthropic standard: imposta base_url su https://bedrock-mantle.{region}.api.aws/anthropic e passa il tuo token bearer come api_key. Questo percorso supporta solo l'autenticazione con token bearer. La firma SigV4 richiede il client dedicato.

Modelli supportati

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

Modello	ID Modello
Claude Opus 4.7	`anthropic.claude-opus-4-7`
Claude Mythos Preview	`anthropic.claude-mythos-preview`
Claude Haiku 4.5	`anthropic.claude-haiku-4-5`

Disponibilità delle funzionalità

Claude in Amazon Bedrock supporta funzionalità che vengono eseguite all'interno del modello. Le funzionalità che richiedono infrastruttura gestita da Anthropic non sono disponibili.

Supportate:

API Messages (/v1/messages)
Prompt caching
Extended thinking
Tool use (strumenti definiti dal client)
Citations
Structured outputs
Inferenza in-region (le richieste rimangono in una singola regione AWS)

Non supportate:

Strumenti definiti da Anthropic (Web Search, Web Fetch, Remote MCP, Memory, Files API, Computer Use, Skills, Code Execution)
Claude Managed Agents
Message Batches API
Endpoint /v1/users

Regioni

L'anteprima di ricerca è disponibile solo in us-east-1 (IAD).

Quote

La quota predefinita è 2 milioni di token di input al minuto (TPM). Puoi richiedere fino a 4 milioni di TPM di input senza approvazione aggiuntiva di Anthropic. AWS applica limiti di richieste al minuto (RPM) sul lato Bedrock; contatta il supporto AWS per gli adeguamenti RPM.

Conservazione dei dati

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

La conservazione zero dei dati (ZDR) è disponibile. Per abilitare ZDR per il tuo account, contatta il supporto AWS.

Osservabilità

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

Supporto

Per il supporto dell'anteprima di ricerca, contatta [email protected]. Includi il tuo ID account AWS e il request-id da qualsiasi risposta API non riuscita.

Claude Mythos Preview è un modello di anteprima di ricerca disponibile per i clienti invitati su Amazon Bedrock. Per ulteriori informazioni, vedi Project Glasswing.