Claude Code con i modelli Claude su Google Cloud (gestiti da Anthropic)

Claude Models on Google Cloud (Anthropic managed) è la Claude API, gestita da Anthropic e raggiungibile tramite il tuo progetto Google Cloud. Per usarla da Claude Code, accedi a Google Cloud e imposta tre variabili d’ambiente.

Google Cloud offre Claude anche tramite Agent Platform di Google Cloud, in precedenza Vertex AI, gestita da Google. Se usi Agent Platform, segui invece Claude Code su Agent Platform di Google Cloud. Per scoprire quale delle due usi, consulta Which offering are you using?

Prima di iniziare, installa Claude Code v2.1.307 o successiva. Per controllare la tua versione, esegui claude --version nella shell. Per aggiornare, esegui claude update.

Prerequisiti

Un progetto Google Cloud in cui la configurazione dell’account è completata
Il ruolo IAM roles/claude.user su quel progetto, per ogni account Google o service account che esegue Claude Code
L’ID del tuo progetto e l’ID del tuo workspace, che inizia con wrkspc_
La gcloud CLI, se accedi con un account Google anziché con un file di chiave di un service account

Configurare Claude Code

Crea le Application Default Credentials

Account Google
File di chiave del service account

Esegui questo comando nella shell e accedi con l’account Google che ha il ruolo roles/claude.user:

gcloud auth application-default login

Eseguilo anche se hai già eseguito gcloud auth login.Se GOOGLE_APPLICATION_CREDENTIALS è impostata, rimuovila. Finché quella variabile è impostata, Claude Code usa il file che indica e ignora le credenziali salvate dal comando.

Nella shell o nel job di CI che esegue Claude Code, imposta GOOGLE_APPLICATION_CREDENTIALS sul percorso di un file di chiave del service account. Per altre origini delle credenziali, consulta come eseguire l’autenticazione.

Aggiungi le variabili alle tue impostazioni

Aggiungi tre variabili al blocco env del tuo file di impostazioni utente, ~/.claude/settings.json. Se il file non esiste, crealo con questo contenuto:

{
  "env": {
    "CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD": "1",
    "ANTHROPIC_GOOGLE_CLOUD_PROJECT": "my-project-id",
    "ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID": "wrkspc_01ABCDEFGHIJKLMN"
  }
}

Usa l’ID del tuo progetto e l’ID del tuo workspace al posto di my-project-id e del valore wrkspc_. Per configurare invece una singola shell o un job di CI, imposta le stesse tre variabili in quell’ambiente.Non devi accedere a un account Anthropic, né uscire da uno.

Avvia Claude Code e verifica il provider

Esegui claude nella shell, poi esegui /status nel prompt di Claude Code. La riga API provider contiene on Google Cloud e le righe successive mostrano Workspace ID, GCP project e GCP location. Per stampare le stesse righe dalla shell o da un job di CI, esegui claude auth status --text.Se vedi on Google Cloud, invia un prompt oppure esegui claude -p "hello" in un job di CI. Una risposta conferma che le tue credenziali e il tuo ruolo IAM funzionano. Se non lo vedi, o se Claude Code mostra un errore, risolvi i problemi della configurazione del provider.

Configurare Claude Code per un team

Inserisci il blocco env del passaggio 2 di Configurare Claude Code in un file di impostazioni gestite sulla macchina di ogni sviluppatore. Concedi a ogni sviluppatore il ruolo roles/claude.user sul progetto e fai eseguire a ciascuno gcloud auth application-default login sulla propria macchina.

Fissare le versioni dei modelli

Se distribuisci Claude Code a un team, fissa gli ID dei modelli, in modo che un aggiornamento di Claude Code non sposti tutti contemporaneamente a un modello più recente. Aggiungi queste variabili al blocco env che contiene le tre variabili di Configurare Claude Code:

{
  "env": {
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
  }
}

Usa gli ID dei modelli della Claude API che desideri, presi da Models overview, al posto dei valori di esempio.

Variabili d’ambiente

Variabile	Obbligatoria	Descrizione
`CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD`	Sì	Imposta su `1` per inviare le richieste ai modelli a Claude Models on Google Cloud (Anthropic managed)
`ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`	Sì, tranne quando imposti `ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	L’ID del tuo workspace
`ANTHROPIC_GOOGLE_CLOUD_PROJECT`	Consigliata	L’ID del tuo progetto Google Cloud. Senza di essa, Claude Code usa `GOOGLE_CLOUD_PROJECT`
`ANTHROPIC_GOOGLE_CLOUD_LOCATION`	No	La location nell’URL della richiesta. Il valore predefinito è `global`
`ANTHROPIC_GOOGLE_CLOUD_BASE_URL`	No	Sostituisce l’URL di base che Claude Code costruisce a partire da progetto, location e ID del workspace, ad esempio con l’indirizzo di un LLM gateway. Claude Code aggiunge il percorso dell’API, come `/v1/messages`
`CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH`	No	Imposta su `1` quando è un gateway ad allegare le credenziali Google, in modo che Claude Code non invii alcun token di accesso Google

Funzionalità di Claude Code non disponibili

Con Claude Models on Google Cloud (Anthropic managed), le funzionalità che non puoi usare includono:

Modalità veloce: non puoi attivarla con /fast o con l’impostazione fastMode
Remote Control e sessioni cloud
Connettori MCP da claude.ai
Canali
I comandi /design-sync e /import
Impostazioni gestite dal server. Per imporre le impostazioni al tuo team, usa invece le impostazioni gestite su ogni macchina

Per vedere altre funzionalità non disponibili o supportate solo parzialmente, seleziona la scheda Google Cloud (Anthropic managed) nel riepilogo della disponibilità delle funzionalità.

Risoluzione dei problemi

Se Claude Code ti chiede di accedere, o se la riga API provider in /status non contiene on Google Cloud:

Assicurati che CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD sia 1
Assicurati che claude --version stampi 2.1.307 o successiva
Rimuovi CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_FOUNDRY e CLAUDE_CODE_USE_ANTHROPIC_AWS dalla shell e dai tuoi file di impostazioni

CLAUDE_CODE_USE_VERTEX può restare impostata. Dopo aver modificato una variabile, riavvia Claude Code. Se /status non mostra la modifica, consulta Un valore impostato viene ignorato.

`No workspace ID found`

Imposta ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID sull’ID del tuo workspace, poi riavvia Claude Code. Ignora l’opzione del costruttore workspaceId menzionata nel messaggio: è destinata a chi chiama l’SDK di Anthropic dal proprio codice.

`No project was given`

Imposta ANTHROPIC_GOOGLE_CLOUD_PROJECT sull’ID del tuo progetto Google Cloud, poi riavvia Claude Code.

`Could not load Google Cloud credentials`

Ripeti il passaggio 1 di Configurare Claude Code, con una nuova chiave se usi un file di chiave del service account.

`Google Cloud credentials expired or invalid`

Se il messaggio ti chiede di aggiornare le tue credenziali Google Cloud, ripeti il passaggio 1 di Configurare Claude Code. Con un file di chiave del service account, usa una nuova chiave.

`Google Cloud authentication failed`

Segui i passaggi per Google Cloud credentials expired or invalid. Se l’errore persiste:

Progetto: in /status, assicurati che la riga GCP project indichi il tuo progetto. Se indica un altro progetto, o se la riga non c’è, segui No project was given
Workspace: in /status, assicurati che la riga Workspace ID mostri l’ID del tuo workspace. Se ne mostra un altro, segui No workspace ID found
Ruolo IAM: assicurati che l’account Google o il service account che esegue Claude Code abbia roles/claude.user o roles/claude.admin sul progetto indicato nella riga GCP project. Per concedere il ruolo, usa il comando di concessione del servizio oppure chiedi a un amministratore del progetto di concederlo
Servizio: assicurati che il servizio claude.googleapis.com sia abilitato sul progetto indicato nella riga GCP project. Per abilitarlo, segui i passaggi di configurazione dell’account del servizio oppure chiedi a un amministratore del progetto di abilitarlo

Claude Models on Google Cloud (Anthropic managed): configurazione dell’account, ruoli IAM, fatturazione, conservazione dei dati e supporto delle funzionalità
Panoramica della distribuzione enterprise: gli altri modi per distribuire Claude Code e la configurazione di proxy e gateway
Configurazione dei modelli: alias dei modelli, come fissare una versione del modello e limitare i modelli che gli utenti possono selezionare

Configurazione e accesso

Distribuzione

Gateway

Utilizzo e costi

Sicurezza e dati

Adozione

Claude Code con i modelli Claude su Google Cloud (gestiti da Anthropic)

Prerequisiti

Configurare Claude Code

Configurare Claude Code per un team

Fissare le versioni dei modelli

Variabili d’ambiente

Funzionalità di Claude Code non disponibili

Risoluzione dei problemi

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`

Prerequisiti

Configurare Claude Code

Configurare Claude Code per un team

Fissare le versioni dei modelli

Variabili d’ambiente

Funzionalità di Claude Code non disponibili

Risoluzione dei problemi

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

Risorse correlate

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`