Claude Models on Google Cloud (Google managed)

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:

1. Un progetto Google Cloud che possa usare Agent Platform. Per i passaggi di configurazione, consulta la pagina di Google Cloud Anthropic Claude models on Agent Platform.
2. La gcloud CLI installata, per lo sviluppo locale.
3. 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 Agent Platform partner models.
4. Credenziali Google Cloud per quell'identità. Per gli esempi con gli SDK, potrebbe essere necessario eseguire gcloud auth application-default login per autenticarti con Google Cloud. Gli esempi cURL per Claude Models on Google Cloud (Google managed) ottengono il loro token con gcloud auth print-access-token. Quel comando usa il login proprio della gcloud CLI, non le Application Default Credentials. Per quegli esempi, esegui prima gcloud auth login o gcloud init.

Installa un SDK

Gli SDK client di Anthropic supportano 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 API. Differisce principalmente in due modi:

• Modello: L'URL dell'endpoint specifica il modello. In una richiesta cURL, ometti model dal corpo.
• Versione: In una richiesta cURL, passa anthropic_version nel corpo, non come header. Impostalo su vertex-2023-10-16, oppure sulla versione API 2026-10-21.

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

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 Anthropic Claude models on 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 Anthropic Claude models on Agent Platform. Per il significato di Deprecated e Retired, consulta Deprecazioni dei modelli.

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

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 multi-regione e regionali costano il 10% in più rispetto agli endpoint globali. Tutti e tre i tipi di endpoint accettano traffico pay-as-you-go, mentre il throughput con provisioning 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 API
• "Prompt caching" (cache dei prompt)
• "Thinking" (ragionamento)
• "Tool use" (uso degli strumenti), inclusi questi strumenti:
  • Strumento Bash
  • Strumento di uso del browser
  • Strumento di uso del computer
  • Strumento di memoria
  • Strumento editor di testo
  • Strumento di ricerca web
• Citazioni
• Output strutturati

La panoramica delle funzionalità elenca ogni funzionalità e 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.1
• Claude Fable 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 Quotas for Anthropic Claude models.

Fatturazione

Google Cloud ti fattura per Claude Models on Google Cloud (Google managed). Per i prezzi, consulta la pagina di Google Cloud Generative AI pricing. 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 and zero data retention.

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:

1. 1

   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.

2. 2

   Installa il pacchetto SDK

   Installa il pacchetto che fornisce il client per Claude Models on Google Cloud (Google managed). Consulta Installa un SDK.

3. 3

   Sostituisci l'import e il client

   Modifica il codice che importa e crea il tuo client. Usa AnthropicVertex al posto di AnthropicGoogleCloud. Una richiesta cURL richiede 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 oggi:

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

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

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from 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_ID con 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.

4. 4

   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-20251001 diventa claude-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.
5. 5

   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