Claude su Google Cloud

L'API per accedere a Claude su Google Cloud's Agent Platform è quasi identica alla Messages API, con due differenze chiave nel formato della richiesta:

• Su Agent Platform, model non viene passato nel corpo della richiesta. Viene invece specificato nell'URL dell'endpoint di Google Cloud.
• Su Agent Platform, anthropic_version viene passato nel corpo della richiesta (anziché come header) e deve essere impostato sul valore vertex-2023-10-16.

Agent Platform è supportato anche dai client SDK ufficiali di Anthropic. Questa guida ti accompagna nell'effettuare una richiesta a Claude su Agent Platform utilizzando uno dei client SDK di Anthropic.

Nota che questa guida presuppone che tu disponga già di un progetto Google Cloud in grado di utilizzare Agent Platform. Consulta Modelli Anthropic Claude su Agent Platform per maggiori informazioni sulla configurazione richiesta e una procedura guidata completa.

Installa un SDK per accedere ad Agent Platform

Per prima cosa, installa il client SDK di Anthropic per il linguaggio di tua scelta.

pip install -U "anthropic[vertex]"

Accesso ad Agent Platform

Disponibilità dei modelli

Nota che la disponibilità dei modelli Anthropic varia in base alla regione. Cerca "Claude" nel Model Garden oppure vai a Modelli Anthropic Claude per le informazioni più aggiornate.

ID dei modelli API

I termini del ciclo di vita (Deprecated, Retired) sono definiti in Deprecazioni dei modelli. Le date del ciclo di vita sulle piattaforme gestite dai partner sono stabilite dal partner e possono differire dal calendario della Claude API. Per la data di ritiro attuale di qualsiasi modello su Agent Platform, consulta la documentazione di Google Cloud per i modelli Claude su Agent Platform.

Effettuare richieste

Prima di eseguire le richieste potrebbe essere necessario eseguire gcloud auth application-default login per autenticarti con Google Cloud.

Gli esempi seguenti mostrano come generare testo da Claude su Agent Platform:

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Consulta i client SDK e la documentazione ufficiale di Agent Platform per maggiori dettagli.

Claude è disponibile anche tramite Amazon Bedrock, Claude Platform su AWS e Microsoft Foundry.

Conservazione dei dati

La gestione dei dati per questa offerta è regolata da Google Cloud. Per i dettagli, consulta Agent Platform e zero data retention.

Registrazione delle attività

Agent Platform fornisce un servizio di registrazione richiesta-risposta che ti consente di registrare i prompt e i completamenti associati al tuo utilizzo.

Anthropic consiglia di registrare la tua attività su base continuativa di almeno 30 giorni per comprendere la tua attività e indagare su eventuali usi impropri.

Supporto delle funzionalità

Per l'elenco completo delle funzionalità con la disponibilità su Google Cloud, consulta la Panoramica delle funzionalità.

Funzionalità supportate principali

• Messages API
• Cache dei prompt
• Thinking
• Uso degli strumenti, inclusi lo strumento Bash, lo strumento Browser use, lo strumento Computer use, lo strumento Memory e lo strumento Text editor
• Strumento Web search
• Citazioni
• Output strutturati

Funzionalità non supportate

• Sorgenti di input (sorgenti URL per immagini e documenti, Files API)
• Strumenti lato server (esecuzione di codice, 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)

Finestra di contesto

Claude Fable 5.1, Claude Fable 5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 e Claude Sonnet 4.6 dispongono di una "context window" (finestra di contesto) da 1M di token su Agent Platform. Gli altri modelli Claude, inclusi Sonnet 4.5 e Sonnet 4 (deprecato), hanno una finestra di contesto da 200k token.

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.

Endpoint globali, multi-regione e regionali

Agent Platform offre tre tipi di endpoint:

• Endpoint globali: instradamento dinamico per la massima disponibilità
• Endpoint multi-regione: instradamento dinamico all'interno di un'area geografica (ad esempio, gli Stati Uniti o l'Unione Europea) per la residenza dei dati con alta disponibilità
• Endpoint regionali: instradamento dei dati garantito attraverso regioni geografiche specifiche

Gli endpoint regionali e multi-regione includono un sovrapprezzo del 10% rispetto agli endpoint globali.

Quando usare ciascuna opzione

Endpoint globali (consigliati):

• Forniscono la massima disponibilità e uptime
• Instradano dinamicamente le richieste verso regioni con capacità disponibile
• Nessun sovrapprezzo
• Ideali per applicazioni in cui la residenza dei dati è flessibile
• Supportano solo traffico pay-as-you-go (il provisioned throughput richiede endpoint regionali)

Endpoint multi-regione:

• Instradano dinamicamente le richieste tra regioni all'interno di un'area geografica (attualmente us ed eu)
• Utili quando hai bisogno della residenza dei dati all'interno di un'ampia area geografica ma desideri una disponibilità maggiore rispetto a una singola regione
• Sovrapprezzo del 10% rispetto agli endpoint globali
• Supportano solo traffico pay-as-you-go (il provisioned throughput richiede endpoint regionali)

Endpoint regionali:

• Instradano il traffico attraverso regioni geografiche specifiche
• Necessari per la residenza dei dati in una singola regione, requisiti di conformità rigorosi o provisioned throughput
• Supportano sia pay-as-you-go sia provisioned throughput
• Il sovrapprezzo del 10% riflette i costi di infrastruttura per la capacità regionale dedicata

Implementazione

Uso degli endpoint globali (consigliato):

Imposta il parametro region su "global" quando inizializzi il client:

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Uso degli endpoint multi-regione:

Imposta il parametro region su un identificatore multi-regione: "us" per gli Stati Uniti o "eu" per l'Unione Europea. L'SDK instrada le richieste verso l'endpoint multi-regione corrispondente (https://aiplatform.us.rep.googleapis.com o https://aiplatform.eu.rep.googleapis.com), che bilancia dinamicamente il traffico tra le regioni all'interno di quell'area geografica.

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)

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Uso degli endpoint regionali:

Specifica una regione specifica come "us-east5" o "europe-west1":

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    # Endpoint regionali specifici supportano Claude Sonnet 4.6 e precedenti; i modelli più recenti usano gli endpoint globali o multi-regione
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

Risorse aggiuntive

• Prezzi di Agent Platform: Prezzi dell'IA generativa su cloud.google.com
• Documentazione dei modelli Claude: Claude su Agent Platform
• Post del blog di Google: Endpoint globale per i modelli Claude
• Dettagli sui prezzi di Anthropic: Prezzi delle piattaforme cloud