> ## 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 avec les modèles Claude sur Google Cloud (géré par Anthropic)

> Configurez Claude Code pour utiliser l'API Claude qu'Anthropic exécute via votre projet Google Cloud, avec les identifiants Google Cloud, IAM et la facturation Marketplace.

Les modèles Claude sur Google Cloud (géré par Anthropic) correspondent à l'API Claude, exécutée par Anthropic et accessible via votre projet Google Cloud. Pour l'utiliser depuis Claude Code, connectez-vous à Google Cloud et définissez trois variables d'environnement.

> [!NOTE]
>
> Google Cloud propose également Claude via l'Agent Platform de Google Cloud, anciennement Vertex AI, gérée par Google. Si vous utilisez Agent Platform, suivez plutôt [Claude Code sur l'Agent Platform de Google Cloud](https://code.claude.com/docs/fr/google-vertex-ai.md). Pour savoir laquelle de ces offres vous utilisez, consultez [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)

Avant de commencer, [installez Claude Code](https://code.claude.com/docs/fr/setup.md#install-claude-code) v2.1.307 ou une version ultérieure. Pour vérifier votre version, exécutez `claude --version` dans votre shell. Pour effectuer la mise à jour, exécutez `claude update`.

## Prérequis

* Un projet Google Cloud dont la [configuration du compte](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account) est terminée
* Le [rôle IAM](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles) `roles/claude.user` sur ce projet, pour chaque compte Google ou compte de service qui exécute Claude Code
* Votre ID de projet et votre [ID d'espace de travail](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), qui commence par `wrkspc_`
* La [gcloud CLI](https://cloud.google.com/sdk/docs/install), si vous vous connectez avec un compte Google plutôt qu'avec un fichier de clé de compte de service

## Configurer Claude Code

**1. Créer les identifiants par défaut de l'application**

> [tab] Compte Google
>
> Exécutez cette commande dans votre shell, puis connectez-vous avec le compte Google qui dispose du rôle `roles/claude.user` :
>
> ```bash theme={null}
> gcloud auth application-default login
> ```
>
> Exécutez-la même si vous avez déjà exécuté `gcloud auth login`.
>
> Si `GOOGLE_APPLICATION_CREDENTIALS` est définie, supprimez-la. Tant que cette variable est définie, Claude Code utilise le fichier qu'elle désigne et ignore les identifiants enregistrés par la commande.

> [tab] Fichier de clé de compte de service
>
> Dans le shell ou le job CI qui exécute Claude Code, définissez `GOOGLE_APPLICATION_CREDENTIALS` sur le chemin d'un [fichier de clé de compte de service](https://docs.cloud.google.com/iam/docs/keys-create-delete). Pour les autres sources d'identifiants, consultez [comment s'authentifier](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication).

**2. Ajouter les variables à vos paramètres**

Ajoutez trois variables au bloc `env` de votre [fichier de paramètres utilisateur](https://code.claude.com/docs/fr/settings.md), `~/.claude/settings.json`. Si le fichier n'existe pas, créez-le avec ce contenu :

```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"
  }
}
```

Utilisez votre propre ID de projet et votre [ID d'espace de travail](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) à la place de `my-project-id` et de la valeur `wrkspc_`. Pour configurer plutôt un seul shell ou un job CI, définissez ces trois mêmes variables dans cet environnement.

Vous n'avez pas besoin de vous connecter à un compte Anthropic, ni de vous en déconnecter.

**3. Démarrer Claude Code et vérifier le fournisseur**

Exécutez `claude` dans votre shell, puis exécutez `/status` dans l'invite de Claude Code. La ligne `API provider` contient `on Google Cloud`, et les lignes suivantes affichent votre `Workspace ID`, votre `GCP project` et votre `GCP location`. Pour afficher ces mêmes lignes depuis votre shell ou un job CI, exécutez [`claude auth status --text`](https://code.claude.com/docs/fr/cli-reference).

Si vous voyez `on Google Cloud`, envoyez un prompt, ou exécutez `claude -p "hello"` dans un job CI. Une réponse confirme que vos identifiants et votre rôle IAM fonctionnent. Si vous ne le voyez pas, ou si Claude Code affiche une erreur, [dépannez la configuration du fournisseur](#troubleshooting).

### Configurer Claude Code pour une équipe

Placez le bloc `env` de l'étape 2 de [Configurer Claude Code](#set-up-claude-code) dans un fichier de [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) sur la machine de chaque développeur. Accordez à chaque développeur le rôle `roles/claude.user` sur le projet, et demandez à chacun d'exécuter `gcloud auth application-default login` sur sa propre machine.

## Épingler les versions des modèles

Si vous déployez pour une équipe, [épinglez les ID de modèles](https://code.claude.com/docs/fr/model-config.md#pin-models-for-third-party-deployments), afin qu'une mise à jour de Claude Code ne fasse pas passer tout le monde à un modèle plus récent en même temps. Ajoutez ces variables au bloc `env` qui contient les trois variables de [Configurer 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"
  }
}
```

Utilisez les ID de modèles de l'API Claude de votre choix, issus de [Models overview](https://platform.claude.com/docs/en/about-claude/models/overview), à la place des valeurs d'exemple.

## Variables d'environnement

| Variable | Obligatoire | Description |
| - | - | - |
| `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` | Oui | Définissez-la sur `1` pour envoyer les requêtes de modèle aux modèles Claude sur Google Cloud (géré par Anthropic) |
| `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` | Oui, sauf si vous définissez `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` | Votre ID d'espace de travail |
| `ANTHROPIC_GOOGLE_CLOUD_PROJECT` | Recommandée | Votre ID de projet Google Cloud. Sans elle, Claude Code utilise `GOOGLE_CLOUD_PROJECT` |
| `ANTHROPIC_GOOGLE_CLOUD_LOCATION` | Non | L'[emplacement](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) dans l'URL de la requête. Valeur par défaut : `global` |
| `ANTHROPIC_GOOGLE_CLOUD_BASE_URL` | Non | Remplace l'URL de base que Claude Code construit à partir du projet, de l'emplacement et de l'ID d'espace de travail, par exemple par l'adresse d'une [passerelle LLM](https://code.claude.com/docs/fr/llm-gateway). Claude Code ajoute le chemin de l'API, tel que `/v1/messages` |
| `CLAUDE_CODE_SKIP_ANTHROPIC_GOOGLE_CLOUD_AUTH` | Non | Définissez-la sur `1` lorsqu'une passerelle joint elle-même les identifiants Google, afin que Claude Code n'envoie aucun jeton d'accès Google |

## Fonctionnalités de Claude Code non disponibles

Avec Claude Models on Google Cloud (géré par Anthropic), les fonctionnalités que vous ne pouvez pas utiliser sont les suivantes :

* [Mode rapide](https://code.claude.com/docs/fr/fast-mode.md) : vous ne pouvez pas l'activer avec `/fast` ni avec le paramètre `fastMode`
* [Remote Control](https://code.claude.com/docs/fr/remote-control.md) et [sessions cloud](https://code.claude.com/docs/fr/claude-code-on-the-web.md)
* [Connecteurs MCP de claude.ai](https://code.claude.com/docs/fr/mcp.md#use-mcp-servers-from-claude-ai)
* [Canaux](https://code.claude.com/docs/fr/channels.md)
* Les [commandes `/design-sync` et `/import`](https://code.claude.com/docs/fr/commands#all-commands)
* [Paramètres gérés par le serveur](https://code.claude.com/docs/fr/server-managed-settings.md). Pour imposer des paramètres à votre équipe, utilisez plutôt des [paramètres gérés](https://code.claude.com/docs/fr/managed-settings.md) sur chaque machine

Pour voir les autres fonctionnalités non disponibles ou partiellement prises en charge, sélectionnez l'onglet **Google Cloud (Anthropic managed)** dans le [récapitulatif de disponibilité des fonctionnalités](https://code.claude.com/docs/fr/feature-availability.md#summary-by-provider).

## Dépannage

Si Claude Code vous demande de vous connecter, ou si la ligne `API provider` dans `/status` ne contient pas `on Google Cloud` :

* Vérifiez que `CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD` vaut `1`
* Vérifiez que `claude --version` affiche 2.1.307 ou une version ultérieure
* Supprimez `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_FOUNDRY` et `CLAUDE_CODE_USE_ANTHROPIC_AWS` de votre shell et de vos [fichiers de paramètres](https://code.claude.com/docs/fr/settings.md#find-or-create-your-settings-files)

`CLAUDE_CODE_USE_VERTEX` peut rester définie. Après avoir modifié une variable, redémarrez Claude Code. Si `/status` n'affiche pas la modification, consultez [Une valeur que vous avez définie est ignorée](https://code.claude.com/docs/fr/settings.md#a-value-you-set-is-ignored).

### `No workspace ID found`

Définissez `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` sur votre [ID d'espace de travail](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id), puis redémarrez Claude Code. Ignorez l'option de constructeur `workspaceId` mentionnée dans le message : elle est destinée aux personnes qui appellent le SDK d'Anthropic depuis leur propre code.

### `No project was given`

Définissez `ANTHROPIC_GOOGLE_CLOUD_PROJECT` sur votre ID de projet Google Cloud, puis redémarrez Claude Code.

### `Could not load Google Cloud credentials`

Répétez l'étape 1 de [Configurer Claude Code](#set-up-claude-code), avec une nouvelle clé si vous utilisez un fichier de clé de compte de service.

### `Google Cloud credentials expired or invalid`

Si le message vous demande d'actualiser vos identifiants Google Cloud, répétez l'étape 1 de [Configurer Claude Code](#set-up-claude-code). Avec un fichier de clé de compte de service, utilisez une nouvelle clé.

### `Google Cloud authentication failed`

Suivez les étapes de [`Google Cloud credentials expired or invalid`](#google-cloud-credentials-expired-or-invalid). Si cela ne résout pas l'erreur :

* **Projet** : dans `/status`, vérifiez que la ligne `GCP project` indique votre projet. Si elle indique un autre projet, ou si cette ligne est absente, suivez [`No project was given`](#no-project-was-given)
* **Espace de travail** : dans `/status`, vérifiez que la ligne `Workspace ID` affiche votre ID d'espace de travail. Si elle en affiche un autre, suivez [`No workspace ID found`](#no-workspace-id-found)
* **Rôle IAM** : vérifiez que le compte Google ou le compte de service qui exécute Claude Code dispose de `roles/claude.user` ou `roles/claude.admin` sur le projet indiqué dans la ligne `GCP project`. Pour accorder ce rôle, utilisez [la commande d'attribution du service](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls), ou demandez à un administrateur du projet de l'accorder
* **Service** : vérifiez que le service `claude.googleapis.com` est activé sur le projet indiqué dans la ligne `GCP project`. Pour l'activer, suivez [les étapes de configuration du compte du service](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account), ou demandez à un administrateur du projet de l'activer

## Ressources associées

* [Modèles Claude sur Google Cloud (géré par Anthropic)](https://platform.claude.com/docs/en/build-with-claude/claude-models-on-google-cloud/anthropic-managed) : configuration du compte, rôles IAM, facturation, conservation des données et prise en charge des fonctionnalités
* [Vue d'ensemble du déploiement en entreprise](https://code.claude.com/docs/fr/third-party-integrations.md) : les autres façons de déployer Claude Code, et la configuration des proxys et des passerelles
* [Configuration des modèles](https://code.claude.com/docs/fr/model-config.md) : alias de modèles, épinglage d'une version de modèle et restriction des modèles que les utilisateurs peuvent sélectionner