Claude Models on Google Cloud (Google managed)
Configura Claude Models on Google Cloud (Google managed), che Google gestisce come parte di Google Cloud’s Agent Platform. Poi, chiama Claude con l’Anthropic SDK o cURL.
Claude Models on Google Cloud confronta le due offerte di Google Cloud. Mostra anche come capire quale delle due utilizzi.
Prima di effettuare chiamate API
Per usare Claude Models on Google Cloud (Google managed), hai bisogno di:
- Un progetto Google Cloud che possa usare Agent Platform. Per i passaggi di configurazione, consulta la pagina di Google Cloud Modelli Anthropic Claude su Agent Platform.
- La gcloud CLI installata, per lo sviluppo locale.
- Per l’identità che effettua le chiamate, un ruolo IAM che includa l’autorizzazione
aiplatform.endpoints.predict, come Agent Platform User (roles/aiplatform.user). Per i dettagli, consulta la pagina di Google Cloud Modelli partner di Agent Platform. - Credenziali Google Cloud per quell’identità. Per autenticare l’SDK con Google Cloud, potrebbe essere necessario eseguire
gcloud auth application-default login. Una richiesta cURL a Claude Models on Google Cloud (Google managed) può ottenere il suo token dagcloud auth print-access-token. Quel comando usa il login proprio della gcloud CLI, non le Application Default Credentials, quindi eseguigcloud auth loginogcloud initprima di usarlo.
Installa un SDK
L’SDK client supporta Claude Models on Google Cloud (Google managed) tramite AnthropicVertex. Installa il pacchetto che lo fornisce:
pip install -U "anthropic[vertex]"La CLI ant non supporta Claude Models on Google Cloud (Google managed).
Effettuare richieste
Le richieste a Claude Models on Google Cloud (Google managed) vengono inviate a un URL di endpoint di Agent Platform che termina con :rawPredict. Le richieste in streaming usano invece :streamRawPredict.
Una richiesta è quasi identica a una richiesta della Messages APIAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro). Differisce principalmente in due modi:
- Modello: L’URL dell’endpoint specifica il modello. In una richiesta cURL, ometti
modeldal corpo. - Versione: In una richiesta cURL, passa
anthropic_versionnel corpo e non come header. Impostalo suvertex-2023-10-16o sulla versione API2026-10-21.
L’SDK gestisce entrambe le differenze per te. Sposta il valore di model nell’URL e imposta anthropic_version sulla versione API che usa con la Claude API. Per gli ID dei modelli da passare, consulta ID dei modelli API.
Negli esempi seguenti, il client SDK si autentica con le Application Default Credentials. Per configurare le Application Default Credentials, consulta Prima di effettuare chiamate API.
Gli esempi seguenti usano l’endpoint globale. Per gli altri tipi di endpoint, consulta Endpoint globali, multi-regione e regionali.
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "global"
client = AnthropicVertex(project_id=project_id, region=region)
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=100,
messages=[
{
"role": "user",
"content": "Hey Claude!",
}
],
)
print(message)ID dei modelli API
| Modello | ID modello API di Agent Platform |
|---|---|
| Claude Fable 5.2 | claude-fable-5-2 |
| Claude Mythos 5.2 (disponibilità limitata(si apre in una nuova scheda)) | claude-mythos-5-2 |
| Claude Fable 5.1 | claude-fable-5-1 |
| Claude Mythos 5.1 (disponibilità limitata(si apre in una nuova scheda)) | claude-mythos-5-1 |
| Claude Fable 5 | claude-fable-5 |
| Claude Mythos 5 (disponibilità limitata(si apre in una nuova scheda)) | claude-mythos-5 |
| Claude Opus 5.5 | claude-opus-5-5 |
| Claude Opus 5 | claude-opus-5 |
| Claude Opus 4.8 | claude-opus-4-8 |
| Claude Opus 4.7 | claude-opus-4-7 |
| Claude Opus 4.6 | claude-opus-4-6 |
| Claude Opus 4.5 | claude-opus-4-5@20251101 |
| Claude Opus 4.1 (deprecato) | claude-opus-4-1@20250805 |
| Claude Opus 4 (deprecato) | claude-opus-4@20250514 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 |
| Claude Sonnet 5 | claude-sonnet-5 |
| Claude Sonnet 4.6 | claude-sonnet-4-6 |
| Claude Sonnet 4.5 (deprecato) | claude-sonnet-4-5@20250929 |
| Claude Sonnet 4 (deprecato) | claude-sonnet-4@20250514 |
| Claude Haiku 5.5 | claude-haiku-5-5 |
| Claude Haiku 4.5 | claude-haiku-4-5@20251001 |
Claude Models on Google Cloud (Google managed) offre modelli Claude diversi in regioni diverse. Per verificare quali modelli offre una regione, cerca “Claude” in Model Garden oppure consulta la pagina di Google Cloud Modelli Anthropic Claude su Agent Platform.
Google stabilisce le date del ciclo di vita dei modelli serviti da Claude Models on Google Cloud (Google managed). Queste date possono differire dal calendario della Claude API. Per la data di ritiro attuale di un modello, consulta la pagina di Google Cloud Modelli Anthropic Claude su Agent Platform. Per il significato di Deprecato e Ritirato, consulta Deprecazioni dei modelli.
Claude Code
Lascia che Claude Code migri il tuo codice a un modello più recente
/claude-api migrate questo progetto all'ultimo modello Claude OpusEndpoint globali, multi-regione e regionali
Claude Models on Google Cloud (Google managed) offre tre tipi di endpoint. Ne scegli uno con il valore di regione che passi quando crei il client. In una richiesta cURL, il tipo di endpoint determina l’host e il segmento locations dell’URL.
| Tipo di endpoint | Valore di regione | Host |
|---|---|---|
| Globale (consigliato) | "global" | aiplatform.googleapis.com |
| Multi-regione | "us" o "eu" | aiplatform.us.rep.googleapis.comaiplatform.eu.rep.googleapis.com |
| Regionale | Una regione, come "us-east5" | {region}-aiplatform.googleapis.com |
I tipi di endpoint differiscono per la destinazione a cui inviano le richieste:
- Globale: Le richieste vengono inviate a qualsiasi regione con capacità disponibile. Usalo quando desideri la massima disponibilità e la residenza dei dati è flessibile.
- Multi-regione: Le richieste vengono inviate a qualsiasi regione negli Stati Uniti (
"us") o nell’Unione Europea ("eu"). Usalo quando hai bisogno della residenza dei dati all’interno di un’ampia area geografica e di una disponibilità maggiore rispetto a una singola regione. - Regionale: Le richieste vengono inviate solo alla regione che specifichi, come
"us-east5"o"europe-west1". Usalo quando hai bisogno della residenza dei dati in una singola regione o devi rispettare requisiti di conformità rigorosi.
Gli endpoint multiregione e regionali costano il 10 percento in più rispetto agli endpoint globali. Tutti e tre i tipi di endpoint accettano traffico pay-as-you-go, mentre il “provisioned throughput” (throughput riservato) richiede un endpoint regionale.
Gli endpoint regionali servono solo Claude Sonnet 4.6 e i modelli precedenti. Per i modelli più recenti, usa un endpoint globale o multi-regione.
Gli esempi seguenti usano l’endpoint multi-regione us. Le righe evidenziate impostano la regione. Per una richiesta completa sull’endpoint globale, consulta Effettuare richieste.
from anthropic import AnthropicVertex
project_id = "MY_PROJECT_ID"
region = "us" # Multi-region identifier: "us" or "eu"
client = AnthropicVertex(project_id=project_id, region=region)Funzionalità supportate
Le funzionalità supportate su Claude Models on Google Cloud (Google managed) includono le seguenti:
- Messages APIAnteprima disponibile con link al riferimento API (premi Tab finché il focus non entra nella scheda, Esc per tornare indietro)
- “Prompt caching” (cache dei prompt)
- “Thinking” (ragionamento)
- “Tool use” (uso degli strumenti), inclusi questi strumenti:
- Citazioni
- Output strutturati
- “Fast mode” (modalità veloce) sui modelli supportati
La panoramica delle funzionalità elenca ogni funzionalità. La pagina di ciascuna funzionalità indica se Claude Models on Google Cloud (Google managed) la supporta.
Funzionalità non supportate
Claude Models on Google Cloud (Google managed) non supporta quanto segue:
- Sorgenti di input: Sorgenti URL per immagini e documenti, e la Files API
- Strumenti lato server: Esecuzione di codice, web fetch e advisor
- Infrastruttura per agenti: Agent Skills, connettore MCP e chiamata programmatica degli strumenti
- Endpoint API: Message Batches API, Models API, Admin API, Compliance API e Usage and Cost API
- Claude Managed Agents
- Fallback lato server: Il parametro
fallbacks
Invece del fallback lato server, usa il pattern di fallback lato client.
Finestra di contesto
Claude Models on Google Cloud (Google managed) offre una “context window” (finestra di contesto) da 1M di token per questi modelli:
- Claude Fable 5.2
- Claude Mythos 5.2
- Claude Fable 5.1
- Claude Mythos 5.1
- Claude Fable 5
- Claude Mythos 5
- Claude Opus 5.5
- Claude Opus 5
- Claude Opus 4.8
- Claude Opus 4.7
- Claude Opus 4.6
- Claude Sonnet 5.5
- Claude Sonnet 5
- Claude Sonnet 4.6
- Claude Haiku 5.5
Gli altri modelli Claude hanno una finestra di contesto da 200k token. Tra questi ci sono Claude Sonnet 4.5 (deprecato) e Claude Sonnet 4 (deprecato).
Agent Platform limita i payload delle richieste a 30 MB. Quando invii documenti di grandi dimensioni o molte immagini, potresti raggiungere questo limite prima del limite di token.
Fatturazione, limiti di velocità e logging
Limiti di velocità
Google Cloud gestisce i “rate limits” (limiti di velocità) e le quote per Claude Models on Google Cloud (Google managed). Per i dettagli, incluso come richiedere un aumento della quota, consulta la pagina di Google Cloud Quote per i modelli Anthropic Claude.
Fatturazione
Google Cloud ti fattura per Claude Models on Google Cloud (Google managed). Per i prezzi, consulta la pagina di Google Cloud Prezzi dell’IA generativa. I prezzi dipendono anche dal tipo di endpoint. Consulta Endpoint globali, multi-regione e regionali.
Conservazione dei dati
Google Cloud regola la gestione dei dati per Claude Models on Google Cloud (Google managed). Per i dettagli, consulta Agent Platform e conservazione zero dei dati.
Monitoraggio e logging
Per registrare prompt e completamenti per Claude Models on Google Cloud (Google managed), usa il servizio di logging di richieste e risposte di Agent Platform.
Anthropic consiglia di conservare almeno gli ultimi 30 giorni di log. I log ti aiutano a comprendere la tua attività e a indagare su possibili usi impropri.
Migrazione da Claude Models on Google Cloud (Anthropic managed)
Per sapere cosa cambia con il passaggio, consulta In cosa differiscono le due offerte di Google Cloud. Per passare a Claude Models on Google Cloud (Google managed), segui questi passaggi:
Configura l’accesso
Verifica che il tuo progetto e l’identità che effettua le chiamate soddisfino i requisiti indicati in Prima di effettuare chiamate API.
Installa il pacchetto SDK
Installa il pacchetto che fornisce il client per Claude Models on Google Cloud (Google managed). Consulta Installa un SDK.
Sostituisci l’import e il client
Modifica il codice che importa e crea il tuo client. Usa
AnthropicVertexal posto diAnthropicGoogleCloud. Una richiesta cURL necessita di un nuovo URL, nuovi header e un nuovo corpo. Il codice seguente crea il client per Claude Models on Google Cloud (Anthropic managed) che usi attualmente:Pythonfrom anthropic import AnthropicGoogleCloud client = AnthropicGoogleCloud()Il codice seguente crea il client per Claude Models on Google Cloud (Google managed). Usa l’endpoint globale. Per gli altri tipi di endpoint, consulta Endpoint globali, multi-regione e regionali.
Pythonfrom anthropic import AnthropicVertex project_id = "MY_PROJECT_ID" region = "global" client = AnthropicVertex(project_id=project_id, region=region)Questo codice passa l’ID del tuo progetto e una regione quando crea il client. Sostituisci
MY_PROJECT_IDcon l’ID del tuo progetto. Le chiamate alla Messages API che effettui con il client restano invariate. Le eccezioni sono gli ID dei modelli e le funzionalità indicati nel passaggio successivo.Verifica gli ID dei modelli e le funzionalità
- ID dei modelli: Se usi un modello precedente a Claude 4.6, sostituisci il trattino prima della data dello snapshot nel suo ID con
@. Ad esempio,claude-haiku-4-5-20251001diventaclaude-haiku-4-5@20251001. Per i modelli e i relativi ID, consulta ID dei modelli API. - Funzionalità: Verifica che le funzionalità usate dal tuo codice non siano elencate in Funzionalità non supportate.
- ID dei modelli: Se usi un modello precedente a Claude 4.6, sostituisci il trattino prima della data dello snapshot nel suo ID con
Esegui una richiesta di prova
Esegui la richiesta in Effettuare richieste per verificare che la tua configurazione funzioni. Poi esegui il tuo codice. Prima di spostare il traffico di produzione, leggi le informazioni sui limiti di velocità per Claude Models on Google Cloud (Google managed).
Passaggi successivi
Esplora le funzionalità di Claude.
Verifica quali modelli Claude offre ciascuna regione e le relative date di ritiro.
Leggi la documentazione di Google Cloud’s Agent Platform.
Leggi il post del blog di Google Cloud sull’endpoint globale per i modelli Claude.
Questa pagina ti è stata utile?