Claude Platform Docs
MessaggiGoogle Cloud

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:

  1. 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.
  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 Modelli partner di Agent Platform.
  4. 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 da gcloud auth print-access-token. Quel comando usa il login proprio della gcloud CLI, non le Application Default Credentials, quindi esegui gcloud auth login o gcloud init prima 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 model dal corpo.
  • Versione: In una richiesta cURL, passa anthropic_version nel corpo e non come header. Impostalo su vertex-2023-10-16 o sulla versione API 2026-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

ModelloID modello API di Agent Platform
Claude Fable 5.2claude-fable-5-2
Claude Mythos 5.2 (disponibilità limitata)claude-mythos-5-2
Claude Fable 5.1claude-fable-5-1
Claude Mythos 5.1 (disponibilità limitata)claude-mythos-5-1
Claude Fable 5claude-fable-5
Claude Mythos 5 (disponibilità limitata)claude-mythos-5
Claude Opus 5.5claude-opus-5-5
Claude Opus 5claude-opus-5
Claude Opus 4.8claude-opus-4-8
Claude Opus 4.7claude-opus-4-7
Claude Opus 4.6claude-opus-4-6
Claude Opus 4.5claude-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.5claude-sonnet-5-5
Claude Sonnet 5claude-sonnet-5
Claude Sonnet 4.6claude-sonnet-4-6
Claude Sonnet 4.5 (deprecato)claude-sonnet-4-5@20250929
Claude Sonnet 4 (deprecato)claude-sonnet-4@20250514
Claude Haiku 5.5claude-haiku-5-5
Claude Haiku 4.5claude-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 Opus

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.

Tipo di endpointValore di regioneHost
Globale (consigliato)"global"aiplatform.googleapis.com
Multi-regione"us" o "eu"aiplatform.us.rep.googleapis.com
aiplatform.eu.rep.googleapis.com
RegionaleUna 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:

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:

  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. Installa il pacchetto SDK

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

  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 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:

    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.

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