Configuration de Vertex AI — Claude sur Google Cloud (Vertex AI / Agent Platform)

Sur Google Cloud, il n’y a pas de clé API Anthropic : l’identité, les droits et la facturation passent par votre projet Google Cloud. Le cours officiel ramène la préparation à quatre étapes : trouver Claude dans Model Garden, l’activer, installer le CLI gcloud, puis créer les identifiants que le SDK lira. Cette leçon les reprend avec les noms actuels. Google présente désormais Vertex AI sous le nom de Gemini Enterprise Agent Platform, « Agent Platform » en abrégé, mais les noms techniques n’ont pas changé.

Une précision avant de commencer. La documentation d’Anthropic décrit deux offres sur Google Cloud : Claude géré par Google, au sein d’Agent Platform, et Claude géré par Anthropic, facturé via Google Cloud Marketplace, avec sa propre configuration. Ce cours utilise la première, celle du client AnthropicVertex.

Avant tout : le projet et les droits

Il vous faut un projet Google Cloud dont la facturation est activée, et l’API Agent Platform activée sur ce projet. Son identifiant technique reste aiplatform.googleapis.com. Côté droits, chaque action demande son rôle IAM :

Action	Rôle IAM	Identifiant du rôle
Activer une API sur le projet	Service Usage Admin (ou Owner, si vous avez créé le projet)	`roles/serviceusage.serviceUsageAdmin`
Activer un modèle partenaire dans Model Garden	Consumer Procurement Entitlement Manager	`roles/consumerprocurement.entitlementManager`
Appeler Claude, avec la permission `aiplatform.endpoints.predict`	Agent Platform User	`roles/aiplatform.user`

En entreprise, un administrateur règle ces points en amont. Deux blocages possibles relèvent aussi de lui. Si une politique d’organisation restreint les services utilisables, elle doit autoriser l’API Cloud Commerce Consumer Procurement (cloudcommerceconsumerprocurement.googleapis.com). Si une politique restreint les modèles de Model Garden, elle doit autoriser les modèles partenaires. Enfin, Google signale un cas plus rare : un compte de facturation géré par un revendeur que les règles d’Anthropic interdisent ne peut ni accepter les conditions ni activer Claude.

Étape 1 : trouver Claude dans Model Garden

Model Garden est le catalogue de modèles de la plateforme : ceux de Google et ceux de partenaires comme Anthropic.

Ouvrez la console Google Cloud (console.cloud.google.com) et sélectionnez votre projet.
Dans la rubrique Agent Platform, ouvrez Model Garden.
Cherchez « Claude ».
Ouvrez la fiche du modèle voulu, par exemple Claude Haiku 5.5.

La fiche donne l’identifiant à passer au SDK, les points de terminaison qui servent le modèle et ses limites. Pour Claude Haiku 5.5, au 5 novembre 2026 : identifiant claude-haiku-5-5, disponibilité générale, point de terminaison global et multi-régions États-Unis et Europe, un million de tokens en entrée et 128 000 en sortie, retrait pas avant le 7 octobre 2027.

Étape 2 : activer le modèle

Sur la fiche, cliquez sur Enable. Vous acceptez ainsi les conditions propres au modèle, que Google rappelle : les modèles d’Anthropic ne sont pas des produits Google. Si le bouton n’apparaît pas, le modèle est déjà activé pour ce projet. Cette activation explicite plaît en entreprise : ouvrir un modèle partenaire demande le rôle Consumer Procurement Entitlement Manager, ce qui laisse à l’administrateur le choix des modèles disponibles dans chaque projet.

Étape 3 : installer le CLI gcloud

Le CLI gcloud est l’outil en ligne de commande de Google Cloud. C’est lui qui déposera sur votre machine les identifiants que le SDK utilisera. S’il n’est pas installé, suivez le guide officiel, Install the Google Cloud CLI : il existe des installateurs pour Linux, macOS et Windows. Si l’API Agent Platform n’est pas encore activée, le CLI le fait en une commande :

gcloud services enable aiplatform.googleapis.com

Étape 4 : s’authentifier, deux jeux d’identifiants

Le cours officiel enchaîne quatre commandes. Les deux premières connectent le CLI lui-même :

gcloud init              # configure le CLI, vous connecte et choisit un projet
gcloud auth login        # seulement si vous n'êtes pas encore connecté

Les deux suivantes concernent votre code :

gcloud config set project VOTRE_PROJET
gcloud auth application-default login

La dernière crée les Application Default Credentials (ADC) : un fichier d’identifiants rangé à un emplacement connu de toutes les bibliothèques Google Cloud.

Système	Emplacement du fichier ADC
Linux, macOS	`$HOME/.config/gcloud/application_default_credentials.json`
Windows	`%APPDATA%\gcloud\application_default_credentials.json`

Google insiste sur un point : ces identifiants sont distincts de ceux du CLI. gcloud auth login sert aux commandes gcloud, gcloud auth application-default login sert aux bibliothèques. Le SDK d’Anthropic appartient au second camp : AnthropicVertex appelle la fonction google.auth.default de la bibliothèque google-auth, qui cherche des identifiants dans cet ordre.

La variable d’environnement GOOGLE_APPLICATION_CREDENTIALS, si elle désigne un fichier.
Le fichier ADC créé par gcloud auth application-default login.
Le compte de service attaché à la ressource, sur Cloud Run, Compute Engine ou un autre service Google Cloud.

Votre code ne contiendra donc aucun secret. En production sur Google Cloud, Google recommande la troisième voie : un compte de service attaché, doté des rôles les plus restreints possible. Les clés de compte de service, elles, sont déconseillées : une clé compromise suffit à un attaquant, sans autre information.

La commande gcloud config set project sert aussi au SDK. Si vous ne lui passez pas d’identifiant de projet, il prend celui de la variable ANTHROPIC_VERTEX_PROJECT_ID, puis celui que trouve google-auth : la variable GOOGLE_CLOUD_PROJECT si elle existe, sinon, sur un poste de développement, le projet par défaut du CLI. Le cours passe malgré tout le projet explicitement : c’est plus lisible.

Deux précautions. Le fichier ADC contient un jeton de rafraîchissement, et quiconque peut le lire obtient des jetons d’accès en votre nom : il ne se copie pas et ne se commite jamais. Quand vous n’en avez plus besoin, révoquez-le :

gcloud auth application-default revoke

Et si un appel échoue plus tard avec un message sur une API non activée ou sur l’absence de « quota project », Google indique de désigner le projet qui portera quotas et facturation :

gcloud auth application-default set-quota-project VOTRE_PROJET

D'après la leçon « Vertex AI Setup » (Claude Academy, Claude on Google Cloud), la documentation Claude (Google managed) et la documentation Google Cloud sur les ADC.

À vous de jouer

Préparez votre poste. Suivez les quatre étapes sur votre projet, puis vérifiez trois choses :

gcloud config list affiche le bon compte et le bon projet.
Le fichier application_default_credentials.json existe à l’emplacement prévu pour votre système.
La fiche Claude Haiku 5.5 de Model Garden n’affiche plus de bouton Enable.

Notez enfin l’identifiant de votre projet : il remplacera votre-projet dans le code de la leçon suivante.

Sources officielles : Vertex AI Setup (Claude Academy) · Claude Models on Google Cloud (Google managed) (documentation Claude : prérequis) · Gemini Enterprise Agent Platform partner models for MaaS (Google Cloud : rôles et politiques) · Anthropic’s Claude Haiku 5.5 on Google Cloud (fiche du modèle) · How Application Default Credentials works (Google Cloud) · Troubleshoot your ADC setup (Google Cloud : quota project)

Points clés à retenir

Pas de clé API Anthropic : identité, droits et facturation passent par votre projet Google Cloud.
Le projet doit avoir la facturation et l’API Agent Platform (aiplatform.googleapis.com) activées.
On active Claude sur sa fiche Model Garden, avec le rôle Consumer Procurement Entitlement Manager. L’appeler demande le rôle Agent Platform User.
gcloud auth application-default login crée les ADC, que le SDK lit seul. Les identifiants du CLI forment un autre jeu.
Le fichier ADC donne accès à votre compte : il ne se partage pas et se révoque quand il ne sert plus.