Configuration de Vertex AI

Utiliser Claude via Vertex AI change un détail qui conditionne toute la configuration : il n’y a pas de clé API Anthropic. L’authentification, la facturation et les droits d’accès passent intégralement par Google Cloud — votre projet GCP devient le point d’entrée unique. Avant la première requête, quatre étapes sont donc nécessaires : activer les modèles Anthropic dans votre projet, puis équiper votre machine des identifiants Google que le SDK saura utiliser.

Étape 1 : Trouver les modèles Anthropic dans Vertex

Le Model Garden est le catalogue de modèles de Vertex AI — ceux de Google, mais aussi ceux de partenaires comme Anthropic. C’est là que tout commence :

1. Rendez-vous sur la console Google Cloud : https://console.cloud.google.com/vertex-ai/dashboard
2. Dans la navigation de gauche, cliquez sur Model Garden
3. Dans la barre de recherche, tapez Anthropic
4. Cliquez sur le modèle souhaité

La recherche fait apparaître la famille Claude disponible sur Vertex. Chaque fiche modèle documente ses capacités, sa tarification et son identifiant Vertex — celui que vous passerez au SDK dans la prochaine leçon.

Étape 2 : Activer le modèle

Sur la page d’information du modèle, cliquez sur le bouton Enable. Cette activation se fait modèle par modèle et projet par projet : elle matérialise votre acceptation des conditions d’utilisation et ouvre l’accès de facturation correspondant. Si le bouton n’apparaît pas, c’est que le modèle est déjà activé pour ce projet — rien d’autre à faire. Ce mécanisme d’activation explicite est une propriété appréciée en entreprise : un administrateur contrôle précisément quels modèles chaque projet peut consommer.

Étape 3 : Installer le CLI gcloud

Le CLI gcloud est l’outil en ligne de commande de Google Cloud ; c’est lui qui va installer sur votre machine les identifiants que le SDK Anthropic utilisera. S’il n’est pas encore installé, suivez les instructions officielles : https://cloud.google.com/sdk/docs/install — des installateurs existent pour macOS, Linux et Windows.

Étape 4 : Authentification

L’authentification se joue en deux temps, et la distinction entre les deux mérite d’être comprise. D’abord, la connexion classique du CLI :

gcloud init
gcloud auth login

gcloud init configure l’outil et gcloud auth login vous authentifie dans votre navigateur — ces identifiants servent aux commandes gcloud elles-mêmes. Ensuite, la partie qui concerne réellement votre code :

gcloud config set project VOTRE_PROJECT_ID
gcloud auth application-default login

gcloud auth application-default login crée ce que Google appelle les Application Default Credentials (ADC) : un fichier d’identifiants déposé à un emplacement standard de votre machine, que toutes les bibliothèques compatibles Google Cloud savent retrouver seules. C’est le chaînon qui rend la suite du cours si fluide : le SDK Anthropic pour Vertex détecte automatiquement ces identifiants — votre code ne manipulera jamais de secret, ni clé API, ni fichier de credentials à charger explicitement. La commande config set project fixe au passage le projet par défaut, celui qui portera la facturation de vos requêtes.

Un mot sur les prérequis : votre compte doit disposer des droits Vertex AI sur le projet (le rôle IAM « Vertex AI User » suffit pour appeler les modèles) et le projet doit avoir la facturation activée. Dans un cadre d’entreprise, c’est typiquement l’administrateur du projet qui règle ces deux points en amont.

Points clés à retenir

• Pas de clé API Anthropic sur Vertex : authentification, droits et facturation passent par Google Cloud
• Le Model Garden est le catalogue où l’on active les modèles Anthropic, modèle par modèle et projet par projet
• gcloud auth application-default login crée les Application Default Credentials, détectées automatiquement par le SDK
• Votre code ne contiendra aucun secret — c’est l’ADC qui porte l’authentification
• Prérequis côté projet : rôle IAM Vertex AI User et facturation activée