​
Prérequis

Avant de configurer Claude Code avec Vertex AI, assurez-vous d’avoir :

  • Un compte Google Cloud Platform (GCP) avec facturation activée
  • Un projet GCP avec l’API Vertex AI activée
  • Accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4)
  • Google Cloud SDK (gcloud) installé et configuré
  • Quota alloué dans la région GCP souhaitée

Vertex AI peut ne pas prendre en charge les modèles par défaut de Claude Code sur les régions autres que us-east5. Assurez-vous d’utiliser us-east5 et d’avoir un quota alloué, ou passez à des modèles pris en charge.

​
Configuration

​
1. Activer l’API Vertex AI

Activez l’API Vertex AI dans votre projet GCP :

# Définir votre ID de projet
gcloud config set project YOUR-PROJECT-ID

# Activer l'API Vertex AI
gcloud services enable aiplatform.googleapis.com

​
2. Demander l’accès au modèle

Demandez l’accès aux modèles Claude dans Vertex AI :

  1. Naviguez vers le Jardin de modèles Vertex AI
  2. Recherchez les modèles “Claude”
  3. Demandez l’accès aux modèles Claude souhaités (par exemple, Claude Sonnet 4)
  4. Attendez l’approbation (peut prendre 24-48 heures)

​
3. Configurer les identifiants GCP

Claude Code utilise l’authentification Google Cloud standard.

Pour plus d’informations, consultez la documentation d’authentification Google Cloud.

​
4. Configurer Claude Code

Définissez les variables d’environnement suivantes :

# Activer l'intégration Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

# Optionnel : Désactiver la mise en cache des invites si non activée
export DISABLE_PROMPT_CACHING=1

Pour des limites de taux élevées et l’activation de la mise en cache des invites, contactez le support Google Cloud. Une fois activé, supprimez le paramètre DISABLE_PROMPT_CACHING.

​
5. Configuration du modèle

Claude Code utilise ces modèles par défaut pour Vertex AI :

Type de modèleValeur par défaut
Modèle principalclaude-sonnet-4@20250514
Modèle petit/rapideclaude-3-5-haiku@20241022

Pour personnaliser les modèles :

export ANTHROPIC_MODEL='claude-opus-4@20250514'
export ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

​
Configuration IAM

Accordez les rôles IAM requis pour Claude Code.

Pour plus de détails, consultez la documentation IAM Vertex.

Nous recommandons de créer un projet GCP dédié pour Claude Code afin de simplifier le suivi des coûts et le contrôle d’accès.

​
Dépannage

Si vous rencontrez des problèmes de quota :

  • Vérifiez les quotas actuels ou demandez une augmentation de quota via la Console Cloud

Si vous rencontrez des erreurs 404 “modèle non trouvé” :

  • Vérifiez que vous avez accès à la région spécifiée
  • Confirmez que le modèle est Activé dans le Jardin de modèles

Si vous rencontrez des erreurs 429 :

  • Assurez-vous que le modèle principal et le modèle petit/rapide sont pris en charge dans votre région sélectionnée

​
Ressources supplémentaires