Claude Code avec les modèles Claude sur Google Cloud (géré par Anthropic)

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.

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. Pour savoir laquelle de ces offres vous utilisez, consultez Which offering are you using?

Avant de commencer, installez 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 est terminée
Le rôle IAM 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, qui commence par wrkspc_
La gcloud CLI, si vous vous connectez avec un compte Google plutôt qu’avec un fichier de clé de compte de service

Configurer Claude Code

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

Compte Google
Fichier de clé de compte de service

Exécutez cette commande dans votre shell, puis connectez-vous avec le compte Google qui dispose du rôle roles/claude.user :

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.

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. Pour les autres sources d’identifiants, consultez comment s’authentifier.

Ajouter les variables à vos paramètres

Ajoutez trois variables au bloc env de votre fichier de paramètres utilisateur, ~/.claude/settings.json. Si le fichier n’existe pas, créez-le avec ce contenu :

{
  "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 à 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.

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.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.

Configurer Claude Code pour une équipe

Placez le bloc env de l’étape 2 de Configurer Claude Code dans un fichier de paramètres gérés 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, 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 :

{
  "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, à 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 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. 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 : vous ne pouvez pas l’activer avec /fast ni avec le paramètre fastMode
Remote Control et sessions cloud
Connecteurs MCP de claude.ai
Canaux
Les commandes /design-sync et /import
Paramètres gérés par le serveur. Pour imposer des paramètres à votre équipe, utilisez plutôt des paramètres gérés 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.

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

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.

`No workspace ID found`

Définissez ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID sur votre ID d’espace de travail, 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, 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. 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. 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
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
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, 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, ou demandez à un administrateur du projet de l’activer

Modèles Claude sur Google Cloud (géré par Anthropic) : 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 : les autres façons de déployer Claude Code, et la configuration des proxys et des passerelles
Configuration des modèles : alias de modèles, épinglage d’une version de modèle et restriction des modèles que les utilisateurs peuvent sélectionner

Configuration et accès

Déploiement

Passerelles

Utilisation et coûts

Sécurité et données

Adoption

Claude Code avec les modèles Claude sur Google Cloud (géré par Anthropic)

Prérequis

Configurer Claude Code

Configurer Claude Code pour une équipe

Épingler les versions des modèles

Variables d’environnement

Fonctionnalités de Claude Code non disponibles

Dépannage

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`

Prérequis

Configurer Claude Code

Configurer Claude Code pour une équipe

Épingler les versions des modèles

Variables d’environnement

Fonctionnalités de Claude Code non disponibles

Dépannage

No workspace ID found

No project was given

Could not load Google Cloud credentials

Google Cloud credentials expired or invalid

Google Cloud authentication failed

Ressources associées

`No workspace ID found`

`No project was given`

`Could not load Google Cloud credentials`

`Google Cloud credentials expired or invalid`

`Google Cloud authentication failed`