Claude in Amazon Bedrock (Opus 4.7 e versioni successive)

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

Amazon Bedrock definisce criteri di accesso per ciascun modello Claude individualmente. 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, consulta Amazon Bedrock model access nella console AWS. 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.
• L'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 consigliata):



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

from anthropic import AnthropicBedrockMantle

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

message = client.messages.create(
    model="anthropic.claude-opus-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 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
• Thinking
• 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)



Regioni

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

• Global: routing dinamico su tutte le regioni disponibili per la massima disponibilità. Nessun sovrapprezzo.
• Regional: l'endpoint si risolve nella singola regione AWS che specifichi, 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 inference profile (US, EU, JP o AU). Le regioni contrassegnate come In-region only nella tabella supportano il routing diretto su singola regione senza un inference profile.

L'endpoint globale è disponibile per Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 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) 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à 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.