Claude su Google Cloud

L'API per accedere a Claude su Agent Platform di Google Cloud è 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 Google Cloud.
• Su Agent Platform, anthropic_version viene passato nel corpo della richiesta (anziché come header) e deve essere impostato al valore vertex-2023-10-16.

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

Nota che questa guida presuppone che tu abbia già un progetto Google Cloud abilitato all'uso di Agent Platform. Consulta Modelli Claude di Anthropic su Agent Platform per maggiori informazioni sulla configurazione richiesta e una guida completa.



Installare un SDK per accedere ad Agent Platform

Per prima cosa, installa l'SDK client di Anthropic per il linguaggio che preferisci.

pip install -U "anthropic[vertex]"



Accedere ad Agent Platform



Disponibilità dei modelli

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



ID modello API

I termini del ciclo di vita (Deprecato, Ritirato) 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 dell'API Claude. 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.

I seguenti esempi 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 gli SDK client 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 raccomanda di registrare la tua attività su base continuativa per almeno 30 giorni, in modo da 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 Panoramica delle funzionalità.



Funzionalità supportate in evidenza

• Messages API
• Cache dei prompt
• Pensiero
• Uso degli strumenti, inclusi lo strumento Bash, 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 (code execution, 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, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Opus 4.6, Claude Sonnet 5 e Claude Sonnet 4.6 hanno una finestra di contesto da 1M 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: routing dinamico per la massima disponibilità
• Endpoint multi-regione: routing dinamico all'interno di un'area geografica (ad esempio, Stati Uniti o Unione Europea) per la residenza dei dati con alta disponibilità
• Endpoint regionali: routing 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 il traffico pay-as-you-go (il throughput con provisioning 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 di 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 il traffico pay-as-you-go (il throughput con provisioning 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 throughput con provisioning
• Supportano sia il traffico pay-as-you-go che il throughput con provisioning
• Il sovrapprezzo del 10% riflette i costi infrastrutturali per la capacità regionale dedicata



Implementazione

Utilizzo degli endpoint globali (consigliato):

Imposta il parametro region su "global" durante l'inizializzazione del 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)

Utilizzo 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 all'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)

Utilizzo 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(
    # Gli endpoint regionali specifici supportano Claude Sonnet 4.6 e versioni 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 sul blog di Google: Endpoint globale per i modelli Claude
• Dettagli sui prezzi di Anthropic: Prezzi delle piattaforme cloud