> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Configura Claude Code per usare la Claude API che Anthropic esegue tramite il tuo progetto Google Cloud, con credenziali Google Cloud, IAM e fatturazione tramite Marketplace.

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.

> [!NOTE]
>
> 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](https://code.claude.com/docs/it/google-vertex-ai.md). Per scoprire quale delle due usi, consulta [Which offering are you using?](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/overview#which-offering-are-you-using)

Prima di iniziare, [installa Claude Code](https://code.claude.com/docs/it/setup.md#install-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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) è completata
* Il [ruolo IAM](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) `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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), che inizia con `wrkspc_`
* La [gcloud CLI](https://cloud.google.com/sdk/docs/install), se accedi con un account Google anziché con un file di chiave di un service account

## Configurare Claude Code

**1. Crea le Application Default Credentials**

> [tab] Account Google
>
> Esegui questo comando nella shell e accedi con l'account Google che ha il ruolo `roles/claude.user`:
>
> ```bash theme={null}
> 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.

> [tab] File di chiave del service account
>
> 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](https://docs.cloud.google.com/iam/docs/keys-create-delete). Per altre origini delle credenziali, consulta [come eseguire l'autenticazione](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).

**2. Aggiungi le variabili alle tue impostazioni**

Aggiungi tre variabili al blocco `env` del tuo [file di impostazioni utente](https://code.claude.com/docs/it/settings.md), `~/.claude/settings.json`. Se il file non esiste, crealo con questo contenuto:

```json theme={null}
{
  "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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) 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.

**3. 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`](https://code.claude.com/docs/it/cli-reference).

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](#troubleshooting).

### Configurare Claude Code per un team

Inserisci il blocco `env` del passaggio 2 di [Configurare Claude Code](#set-up-claude-code) in un file di [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) 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](https://code.claude.com/docs/it/model-config.md#pin-models-for-third-party-deployments), 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](#set-up-claude-code):

```json theme={null}
{
  "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](https://platform.claude.com/docs/en/about-claude/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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) 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](https://code.claude.com/docs/it/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](https://code.claude.com/docs/it/fast-mode.md): non puoi attivarla con `/fast` o con l'impostazione `fastMode`
* [Remote Control](https://code.claude.com/docs/it/remote-control.md) e [sessioni cloud](https://code.claude.com/docs/it/claude-code-on-the-web.md)
* [Connettori MCP da claude.ai](https://code.claude.com/docs/it/mcp.md#use-mcp-servers-from-claude-ai)
* [Canali](https://code.claude.com/docs/it/channels.md)
* I [comandi `/design-sync` e `/import`](https://code.claude.com/docs/it/commands#all-commands)
* [Impostazioni gestite dal server](https://code.claude.com/docs/it/server-managed-settings.md). Per imporre le impostazioni al tuo team, usa invece le [impostazioni gestite](https://code.claude.com/docs/it/managed-settings.md) 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à](https://code.claude.com/docs/it/feature-availability.md#summary-by-provider).

## 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](https://code.claude.com/docs/it/settings.md#find-or-create-your-settings-files)

`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](https://code.claude.com/docs/it/settings.md#a-value-you-set-is-ignored).

### `No workspace ID found`

Imposta `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` sull'[ID del tuo workspace](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), 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](#set-up-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](#set-up-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`](#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`](#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`](#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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls) 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](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) oppure chiedi a un amministratore del progetto di abilitarlo

## Risorse correlate

* [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed): configurazione dell'account, ruoli IAM, fatturazione, conservazione dei dati e supporto delle funzionalità
* [Panoramica della distribuzione enterprise](https://code.claude.com/docs/it/third-party-integrations.md): gli altri modi per distribuire Claude Code e la configurazione di proxy e gateway
* [Configurazione dei modelli](https://code.claude.com/docs/it/model-config.md): alias dei modelli, come fissare una versione del modello e limitare i modelli che gli utenti possono selezionare