Il existe deux façons d’utiliser Claude tout en conservant votre contrat et votre facturation Google Cloud. La première est la version Gérée par Google, que Google exploite au sein d’Agent Platform (anciennement Vertex AI). La seconde est la version Gérée par Anthropic, dans laquelle vous utilisez, depuis un projet Google Cloud, l’API Claude exploitée par Anthropic. Elle est disponible en version générale depuis le 22 octobre 2026 (annonce d’Anthropic). Les deux apparaissent sur votre facture Google Cloud, mais elles diffèrent par les fonctionnalités disponibles, les régions, l’entité qui gère les limites d’utilisation et la prise en charge de Claude Code.

En bref : laquelle choisir

Gérée par Google

Activée depuis Model Garden dans Agent Platform (anciennement Vertex AI)

  • Vous voulez utiliser Claude Code sur Google Cloud
  • Vous voulez que seul Google traite vos données, ou l’inférence doit rester dans l’UE
  • Vous voulez gérer les quotas dans la console Google Cloud

Gérée par Anthropic

Souscrite via Google Cloud Marketplace

  • Vous avez besoin de la Files API, des Agent Skills, de Managed Agents, du web fetch, du connecteur MCP et de fonctionnalités similaires
  • Vous voulez le mode rapide (fast mode) d’Opus 5.5
  • Vous voulez les nouvelles fonctionnalités tôt (la politique affichée est une disponibilité le même jour que sur l’API Claude)

Si Claude Code est tout ce dont vous avez besoin, choisissez la version gérée par Google. La documentation de Claude Code ne décrit aucune configuration pour utiliser Claude Code avec la version gérée par Anthropic.

En s’appuyant sur la documentation officielle d’Anthropic et de Google Cloud (vérifiée le 26 octobre 2026), cet article explique les différences entre les deux versions, les tarifs, les régions, la mise en route, la configuration de Claude Code et la gestion des quotas et des erreurs 429. Dans les sections qui traitent des deux versions, elles apparaissent dans l’ordre Gérée par Google → Gérée par Anthropic, avec les mêmes couleurs.

1. Ce qui distingue les deux versions

Les deux portent le nom « Claude Models on Google Cloud », distingué par « Google managed » ou « Anthropic managed » entre parenthèses. Google appelle désormais Vertex AI « Gemini Enterprise Agent Platform », et les titres de sa documentation sont passés à Agent Platform. L’écran de connexion de Claude Code affiche toutefois toujours « Google Vertex AI ».

ÉlémentGérée par GoogleGérée par Anthropic
Exploitée parGoogle (au sein d’Agent Platform)Anthropic
Qui traite les donnéesGoogle CloudAnthropicGoogle assure l’authentification, le routage de l’API, les journaux d’audit et la facturation ; l’inférence et le stockage des données s’exécutent sur l’infrastructure d’Anthropic
Forme de l’APIPoint de terminaison de prédiction d’Agent PlatformLe nom du modèle figure dans l’URLIdentique à l’API ClaudeSeules l’URL de base et l’authentification diffèrent
FacturationGoogle Cloud (comme usage d’Agent Platform)Google Cloud MarketplaceMesurée en Claude Consumption Units (1 CCU = 0,01 $ US)
Limites d’utilisation gérées parGoogle Cloud (quotas)Anthropic
Rôles IAMroles/aiplatform.user et autresroles/claude.user, roles/claude.admin, roles/claude.viewer
Console d’administrationConsole Google Cloud (Model Garden)Claude Console (ouverte depuis la console Google Cloud)
Client SDKAnthropicVertexAnthropicGoogleCloud (bêta)
Nouveaux modèles et fonctionnalitésLivrés selon le calendrier d’Agent Platform et de Model GardenPolitique de disponibilité le même jour que sur l’API Claude

Sources : le tableau comparatif de « Claude Models on Google Cloud » d’Anthropic, ainsi que « Use Claude models on Google Cloud (Anthropic managed) » et « Anthropic Claude models » de Google Cloud. Vérifié le 26 octobre 2026.

Elles ont aussi des points communs. Les deux s’appellent avec des identifiants Google Cloud (y compris les Application Default Credentials, ou ADC), et les frais apparaissent sur votre facture Google Cloud. Pour Claude 4.6 et les versions ultérieures, les ID de modèle sont les mêmes que dans l’API Claude pour les deux versions (par exemple claude-opus-5-5). Pour les modèles plus anciens, seule la version gérée par Google place @ devant la date (par exemple claude-haiku-4-5@20251001).

Avec la version Gérée par Anthropic, une nouvelle organisation Anthropic est créée pour chaque projet Google Cloud. Elle est distincte de toute organisation que vous utilisez déjà avec l’API Claude ou de Claude Enterprise, et une organisation existante ne peut pas y être transférée. Les clés API, les espaces de travail et les paramètres de la Console ne sont pas repris, et les ressources comme les fichiers et les lots restent dans l’organisation d’origine.

2. Comment choisir : 5 questions

Partez du haut et arrêtez-vous à la première qui s’applique. Si aucune ne s’applique, décidez selon la facilité d’estimation des coûts. La version Gérée par Google publie sa grille tarifaire et ses quotas par défaut : vous pouvez donc estimer budget et limites avant de commencer. L’étendue des fonctionnalités de la version Gérée par Anthropic et son accès anticipé aux nouveautés deviennent un atout si vous pouvez confirmer les tarifs sur la fiche Marketplace et les limites auprès de votre interlocuteur Anthropic.

  • Vous voulez utiliser Claude Code facturé via Google Cloud→Gérée par Google
  • Vous voulez que seul Google traite vos données, ou vous avez besoin de VPC Service Controls, d’un stockage régional des données ou de certifications comme FedRAMP High→Gérée par Google
  • L’inférence doit s’exécuter uniquement dans l’UE→Gérée par Google (multirégion eu)
  • Vous utilisez la Files API, les Agent Skills, Managed Agents, le web fetch, le connecteur MCP, l’exécution de code ou la Message Batches API→Gérée par Anthropic
  • Vous voulez le mode rapide d’Opus 5.5→Gérée par Anthropic

La deuxième question reprend les cas où la documentation de Google Cloud recommande de choisir la version gérée par Google (Use Claude models on Google Cloud (Anthropic managed)).

Vous pouvez aussi utiliser les deux. Par exemple, les développeurs utilisent Claude Code via la version gérée par Google, tandis que votre propre application appelle Managed Agents via la version gérée par Anthropic. Les deux apparaissent sur la même facture Google Cloud, mais les consoles d’administration et la gestion des limites d’utilisation sont séparées.

3. Différences de fonctionnalités

Les plus grandes différences concernent les fonctionnalités côté serveur qu’Anthropic exploite. La version gérée par Google est centrée sur la Messages API, et le stockage de fichiers ainsi que les environnements d’exécution d’agents n’y sont pas disponibles.

FonctionnalitéGérée par GoogleGérée par Anthropic
Messages API, streamingOuiOui
Mise en cache des promptsOuiOui
Réflexion étendue, sorties structuréesOuiOui
Recherche webOuiOui
Computer use (outil de l’API)OuiOuiAbsent de la liste des fonctionnalités de la documentation d’Anthropic, mais présent dans le tableau comparatif de Google Cloud et dans l’annonce d’Anthropic
Web fetch, exécution de code, advisorNonOui
Files APINonOui
Agent Skills, connecteur MCPNonOui
Claude Managed AgentsNonOuiLes tunnels MCP ne sont pas disponibles
Message Batches APINonUtilisez plutôt la prédiction par lots d’Agent PlatformOui
Mode rapide (Opus 5.5)Non préciséAbsent de la liste des fonctionnalités prises en chargeOui

Sources : la section Feature support de « Claude Models on Google Cloud (Anthropic managed) », « Claude Models on Google Cloud (Google managed) » et « Fast mode » d’Anthropic. Le mode rapide sur la version gérée par Google est absent de la liste des fonctionnalités prises en charge dans la documentation d’Anthropic, qui ne dit ni qu’il est disponible ni qu’il ne l’est pas (le tableau des fonctionnalités de Claude Code l’indique comme indisponible sur Agent Platform). Vérifié le 26 octobre 2026.

Pour le fonctionnement de Managed Agents, voir « Que sont les Claude Managed Agents ? » ; pour la vitesse et les tarifs du mode rapide, voir « Présentation de la sortie de Claude Opus 5.5 ».

4. Tarifs : est-ce le même prix que l’API Claude ?

Tarifs de la version Gérée par Google

Sur le point de terminaison global de la version Gérée par Google, les tarifs d’entrée, de sortie et de cache d’Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont les mêmes que ceux de l’API Claude d’Anthropic. Les multirégions us et eu coûtent 10 % de plus que global (les points de terminaison régionaux sont aussi 10 % plus chers, mais ils ne servent que Sonnet 4.6 et les modèles antérieurs ; voir la section 5).

Sources : « Pricing » d’Anthropic, la section Anthropic’s Claude models de « Agent Platform pricing » de Google Cloud, et « Claude Models on Google Cloud (Google managed) » d’Anthropic (les points de terminaison multirégionaux et régionaux coûtent 10 % de plus que global, pour Sonnet 4.5, Haiku 4.5, Opus 4.5 et les modèles ultérieurs). Vérifié le 26 octobre 2026. La version gérée par Anthropic ne figure pas dans le graphique, car ses tarifs par token ne sont pas dans la documentation officielle (voir la section ci-dessous).

ModèleEntréeSortieLectures du cacheÉcritures du cache (5 min / 1 heure)
Opus 5.54 $20 $0,20 $5 $ / 8 $
Sonnet 5.52 $10 $0,10 $2,50 $ / 4 $
Haiku 5.5Entrée jusqu’à 100 000 tokens0,10 $0,50 $0,01 $0,125 $ / 0,20 $
Haiku 5.5Entrée au-delà de 100 000 tokens0,50 $2,50 $0,05 $0,625 $ / 1 $

Dollars US par million de tokens. Tarifs de l’API Claude d’Anthropic et du point de terminaison global de la version gérée par Google (pages de tarifs des deux entreprises, vérifiées le 26 octobre 2026). Les multirégions us/eu coûtent 1,1 fois ces tarifs. Les lectures du cache coûtent 0,05 fois l’entrée pour Opus 5.5 et Sonnet 5.5, et 0,1 fois pour Haiku 5.5 (note de la page de tarifs d’Anthropic). Pour la liste complète des modèles et l’historique des tarifs, voir « Tarifs de Claude comparés par modèle ».

Le Provisioned Throughput, qui réserve de la capacité contre un forfait fixe, n’est pas disponible sur global ni sur les multirégions et exige un point de terminaison régional (documentation de Google Cloud). Les points de terminaison régionaux ne servant que Sonnet 4.6 et les modèles antérieurs, Opus 5.5, Sonnet 5.5 et Haiku 5.5 s’utilisent en paiement à l’usage.

Tarifs de la version Gérée par Anthropic

Avec la version Gérée par Anthropic, Anthropic mesure l’utilisation en Claude Consumption Units (CCU, 1 CCU = 0,01 $ US) et la communique à Google Cloud, et elle apparaît sur votre facture Google Cloud. Anthropic n’envoie pas de facture séparée. Aucune grille tarifaire par token n’est publiée dans la documentation officielle d’Anthropic ni dans celle de Google Cloud (vérifié le 26 octobre 2026). L’approche fiable consiste à vérifier les tarifs sur la fiche Google Cloud Marketplace avant de souscrire, puis, une fois lancé, à faire un petit test et à confirmer le montant réel dans la page Usage de la Claude Console et dans les rapports de facturation de Google Cloud.

Trois points sont officiellement documentés :

  • Le mode rapide d’Opus 5.5 coûte 8 $ en entrée et 40 $ en sortie par million de tokens (page Fast mode et annonce d’Anthropic).
  • Ajouter inference_geo: "us" à une requête pour garder l’inférence aux États-Unis multiplie les prix de toutes les catégories par 1,1 (« Data residency » d’Anthropic).
  • Si vous avez un engagement de dépenses Google Cloud, l’utilisation s’y impute comme les autres achats Marketplace. Si vous avez un accord de remise, contactez votre interlocuteur Anthropic ou Google Cloud avant de commencer (les remises ne s’appliquent pas rétroactivement).

Tarifs des lots

Les deux versions gèrent les lots différemment. La version Gérée par Google utilise la prédiction par lots d’Agent Platform (avec une entrée JSONL depuis BigQuery ou Cloud Storage), et ses tarifs figurent dans la colonne batch de la page de tarifs de Google Cloud. La version Gérée par Anthropic prend en charge la même Message Batches API que l’API Claude, mais ses tarifs de lots ne sont pas non plus dans la documentation officielle. La remise sur les lots de l’API Claude (en direct) est traitée dans « Tarifs de Claude comparés par modèle ».

5. Régions et stockage des données

Pour Claude sur Google Cloud, la location que vous appelez détermine où s’exécute l’inférence. La version Gérée par Google propose trois types, tandis que la version Gérée par Anthropic ne propose que global.

global

Gérée par Google Gérée par Anthropic

Exécute l’inférence dans la région qui dispose de capacité. Tarifs identiques à l’API Claude. La version gérée par Anthropic peut limiter une requête aux États-Unis avec inference_geo: "us" (1,1x).

Multirégion us/eu

Gérée par Google

Exécute l’inférence uniquement aux États-Unis ou dans l’UE. Disponible pour Claude 4.7 et les modèles ultérieurs. Tarifs à 1,1x.

Régional

Gérée par Google

Exécute l’inférence uniquement dans la région unique que vous indiquez. Sert Sonnet 4.6 et les modèles antérieurs ; les modèles plus récents utilisent global ou une multirégion.

Sources : « Claude Models on Google Cloud (Google managed) » et « (Anthropic managed) » d’Anthropic, « Agent Platform partner models » de Google Cloud. Vérifié le 26 octobre 2026.

Les lieux de stockage des données diffèrent aussi. La version Gérée par Google stocke les données dans la région ou la multirégion que vous choisissez. Cependant, la page des modèles partenaires de Google Cloud indique aussi que le lieu de traitement peut différer du lieu de stockage. La documentation d’Anthropic, elle, indique que l’inférence multirégionale reste dans us ou eu, et le lien entre ces deux affirmations n’est pas expliqué. Si vous avez des exigences strictes sur le lieu du traitement, vérifiez auprès de Google Cloud avant de signer un contrat. Vous pouvez aussi utiliser la règle d’administration constraints/gcp.restrictEndpointUsage pour bloquer le point de terminaison global et n’autoriser que les multirégions.

Pour la version Gérée par Anthropic, la région de stockage de l’espace de travail est "us" et ne peut pas être modifiée (« Data residency » d’Anthropic).

Au 26 octobre 2026, les multirégions de la documentation officielle des deux versions ne couvrent que les États-Unis et l’UE. Si le traitement ou le stockage doit rester dans un pays précis hors de ces zones, confirmez auprès de Google Cloud ou de votre interlocuteur Anthropic qu’une location adaptée existe avant de signer un contrat.

6. Mise en route

Les deux versions exigent un projet Google Cloud et un compte de facturation avec la facturation activée. Voici les étapes de la documentation officielle pour rendre chaque version disponible, suivies des étapes communes pour s’authentifier et appeler le modèle.

Gérée par Google : mise en route

  1. Activer l’API Agent Platform
    gcloud config set project YOUR-PROJECT-ID
    gcloud services enable aiplatform.googleapis.com
    À faire une fois par projet.
  2. Activer les modèles Claude voulus dans Model GardenLa personne qui les active doit avoir le rôle Consumer Procurement Entitlement Manager (roles/consumerprocurement.entitlementManager). cloudcommerceconsumerprocurement.googleapis.com doit aussi être autorisé par votre règle d’administration. La documentation de Claude Code indique que l’approbation de l’accès peut prendre de 24 à 48 heures (la documentation de Google Cloud ne précise pas la durée).
  3. Attribuer un rôle aux appelantsAttribuez un rôle qui inclut l’autorisation aiplatform.endpoints.predict (roles/aiplatform.user).

Sources : « Claude Models on Google Cloud (Google managed) » d’Anthropic, « Agent Platform partner models » de Google Cloud. Vérifié le 26 octobre 2026.

Blocages fréquents lors de la mise en route (gérée par Google)
  • Impossible d’activer un modèle dans Model Garden : vérifiez que la personne qui l’active a le rôle Consumer Procurement Entitlement Manager et que cloudcommerceconsumerprocurement.googleapis.com est autorisé par votre règle d’administration.
  • Les appels renvoient 404 (modèle introuvable) : vérifiez que vous avez activé le modèle et qu’il existe dans la location choisie (les modèles récents ne sont que sur global ou une multirégion).
  • Les appels renvoient 403 : vérifiez que l’appelant a roles/aiplatform.user.

Gérée par Anthropic : mise en route

  1. Souscrire dans MarketplaceOuvrez « Claude Models on Google Cloud (Anthropic managed) » dans Google Cloud Marketplace et cliquez sur « Subscribe ». Il vous faut les autorisations d’achat Marketplace sur le compte de facturation.
  2. Activer deux services
    gcloud services enable claude.googleapis.com \
      anthropic-managed-claude.cloudpartnerservices.goog \
      --project=YOUR-PROJECT-ID
    À faire une fois par projet.
  3. Activer l’organisationCliquez sur « Activate » sur la page Claude, puis suivez le lien envoyé à votre adresse e-mail de contact pour saisir le nom de votre organisation, le type d’activité, le pays et le cas d’usage, et accepter les Commercial Terms of Service et l’Usage Policy d’Anthropic. Le rôle roles/claude.admin est requis.
  4. Noter l’ID de l’espace de travailDans la Claude Console (ouverte depuis la console Google Cloud), allez dans « Settings > ; Workspaces » et notez l’ID qui commence par wrkspc_. Il est nécessaire pour les appels.
  5. Attribuer un rôle aux appelantsAttribuez roles/claude.user. Les rôles sont définis par projet : pour séparer des équipes, utilisez des projets distincts (chaque projet devient une organisation Anthropic distincte).

Source : la section Set up your account de « Claude Models on Google Cloud (Anthropic managed) » d’Anthropic (vérifiée le 26 octobre 2026). On ne peut pas se connecter à l’organisation Anthropic avec une adresse e-mail ; la Console s’ouvre depuis la console Google Cloud.

Les deux versions : s’authentifier et appeler

Quelle que soit la version, exécutez gcloud auth application-default login sur la machine appelante pour créer les ADC, et le SDK utilisera ces identifiants (sur les serveurs, utilisez les identifiants d’un compte de service). Appelez ensuite le modèle avec le client SDK de la section 7.

Blocages fréquents lors de la mise en route (gérée par Anthropic)
  • Le service est introuvable : exécutez gcloud avec le compte utilisé pour souscrire dans Marketplace.
  • Erreur d’autorisation au premier appel : vérifiez que claude.googleapis.com est activé et que l’appelant a roles/claude.user.
  • Le bouton reste sur « Finish Setup » : un administrateur n’a pas fini de saisir les informations de l’organisation.
  • L’utilisation n’apparaît pas dans la Console : il faut quelques minutes pour qu’elle s’affiche.

7. Appeler Claude depuis le SDK

Les SDK officiels d’Anthropic prennent en charge les deux versions. Seuls le paquet à installer et le nom du client diffèrent ; messages.create s’écrit de la même façon qu’avec l’API Claude.

Gérée par Google (Python)

# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global")  # "us" ou "eu" fonctionnent aussi
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Bonjour, Claude"}],
)

En TypeScript, utilisez AnthropicVertex de @anthropic-ai/vertex-sdk. Pour appeler en HTTP sans le SDK, l’URL prend la forme https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict ; retirez le nom du modèle du corps de la requête et placez-y "anthropic_version" (vertex-2023-10-16 ou 2026-10-21). Pour le streaming, utilisez :streamRawPredict. Ce qui change avec la nouvelle version d’API 2026-10-21 est traité dans « temperature is deprecated for this model : causes et solutions ».

Gérée par Anthropic (Python)

# pip install -U "anthropic[google_cloud]"
# Variables d’environnement : ANTHROPIC_GOOGLE_CLOUD_PROJECT et
#           ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID (obligatoires)
from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Bonjour, Claude"}],
)

En TypeScript, c’est AnthropicGoogleCloud de @anthropic-ai/google-cloud-sdk (les deux sont en bêta). En HTTP, les corps de requête et de réponse sont les mêmes que pour l’API Claude ; les différences sont les suivantes :

  • URL de base : https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke, qui inclut l’ID de l’espace de travail (n’envoyez pas l’en-tête anthropic-workspace-id).
  • Authentification : envoyez un jeton d’accès Google avec Authorization: Bearer (n’envoyez pas x-api-key).
  • Clés API : impossible d’en créer. Les variables d’environnement ANTHROPIC_API_KEY et ANTHROPIC_BASE_URL sont ignorées.

Sources : « Claude Models on Google Cloud (Anthropic managed) » et « (Google managed) » d’Anthropic. Vérifié le 26 octobre 2026.

8. Utiliser Claude Code sur Google Cloud

Sur Google Cloud, Claude Code prend en charge la version Gérée par Google. Le tableau des fonctionnalités de Claude Code définit Agent Platform comme « exploitée par Google, configurée avec CLAUDE_CODE_USE_VERTEX ». La documentation de Claude Code ne décrit pas comment utiliser Claude Code avec la version Gérée par Anthropic (vérifié le 26 octobre 2026).

Deux façons de le configurer

  1. Le configurer avec l’assistantLancez claude et, sur l’écran de connexion, choisissez « 3rd-party platform » → « Google Vertex AI » (si vous êtes déjà connecté, utilisez /login). L’assistant demande la méthode d’authentification, le projet et la région, et permet de vérifier quels modèles sont disponibles et de les épingler. Le résultat est enregistré dans env de vos paramètres utilisateur (~/.claude/settings.json), et vous pouvez le rouvrir plus tard avec /setup-vertex.
  2. Le configurer avec des variables d’environnementCette méthode convient à la CI et au déploiement dans une équipe. Après avoir activé les modèles dans Model Garden, définissez ce qui suit.
    export CLAUDE_CODE_USE_VERTEX=1
    export CLOUD_ML_REGION=global
    export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
    
    # Épingler les modèles
    # Modèle principal : Sonnet limite les coûts. Pour Opus, utilisez claude-opus-5-5
    export ANTHROPIC_MODEL=claude-sonnet-5-5
    export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
    export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
    export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5
    Les raisons d’épingler les modèles sont expliquées dans l’avertissement ci-dessous.

Dans les deux cas, exécutez /status après la configuration. Si « API provider » affiche Google Vertex AI et que des lignes pour le projet GCP, la région et le modèle apparaissent, la configuration a fonctionné.

Sources : « Claude Code on Google Cloud’s Agent Platform » et « Environment variables » de Claude Code. Vérifié le 26 octobre 2026.

Deux précautions si vous n’épinglez pas les modèles

  • Coût : sur Agent Platform, le modèle principal par défaut quand rien n’est épinglé est Opus 5.5. La documentation de Claude Code avertit que, sans épinglage, vous êtes facturé au tarif d’Opus.
  • Dérive des alias : l’alias sonnet pointe vers Sonnet 4.5 et haiku vers Haiku 4.5, ce qui diffère des alias utilisés avec l’API Claude. Pour éviter que le modèle de chaque utilisateur ne change à la sortie de nouveaux modèles, épinglez-les avec les quatre variables ci-dessus si vous déployez auprès de plusieurs personnes.

Le fonctionnement des alias est aussi expliqué dans « Qu’est-ce que opusplan dans Claude Code ? »

Si un modèle n’est pas disponible dans la location de CLOUD_ML_REGION, vous pouvez remplacer la région pour ce seul modèle, comme dans VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5 (cet exemple n’appelle que Haiku 4.5 dans la région us-east5). CLOUD_ML_REGION accepte global, us ou eu, ou un nom de région comme us-east5. Le Claude Agent SDK utilise lui aussi la version gérée par Google avec les mêmes variables d’environnement (voir « Qu’est-ce que le Claude Agent SDK ? »).

Actualisation automatique des identifiants, cache et contexte de 1M
  • Pour actualiser automatiquement les ADC à leur expiration, ajoutez "gcpAuthRefresh": "gcloud auth application-default login" à vos paramètres (l’actualisation est considérée comme échouée si la commande d’authentification ne se termine pas en 3 minutes).
  • La mise en cache des prompts s’applique automatiquement. Pour la désactiver, définissez DISABLE_PROMPT_CACHING=1 ; pour un cache d’une heure, définissez ENABLE_PROMPT_CACHING_1H=1 (le tarif d’écriture est plus élevé).
  • Des modèles comme Sonnet 5 et ultérieurs ou Opus 4.7 et ultérieurs utilisent par défaut un contexte de 1M de tokens. Pour utiliser 200K, définissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1.
  • La documentation de Claude Code recommande de créer un projet dédié à Claude Code afin de suivre ses coûts séparément.

Fonctionnalités de Claude Code prises en charge sur Agent Platform

StatutFonctionnalités
IndisponibleFonctionnalités qui exigent un abonnement Claude (sessions cloud, Slack, /schedule, Ultrareview, Code Review, Remote Control, l’extension Chrome, computer use, Artifacts, saisie vocale), mode rapide, Advisor, Channels, tableau de bord analytique, paramètres gérés par le serveur, /logout
PartielRecherche web (Opus 4, Sonnet 4, Haiku 4.5 et ultérieurs), mode auto (Sonnet 5 et ultérieurs, Opus 4.7 et ultérieurs, Haiku 5.5, Claude Fable), zero data retention (selon votre accord avec Google Cloud)
DisponibleGitHub Actions, GitLab CI/CD, MCP tool search (Opus 4.5, Sonnet 4.5, Haiku 4.5 et ultérieurs)

Dans ce tableau, computer use désigne la fonctionnalité de Claude Code (qui exige un abonnement), et non l’outil computer use de l’API de la section 3. Source : « Feature availability » de Claude Code (/logout et MCP tool search proviennent de « Claude Code on Google Cloud’s Agent Platform »). Vérifié le 26 octobre 2026. Les connecteurs claude.ai ne sont pas chargés non plus (voir « Les connecteurs claude.ai sont désactivés dans Claude Code »).

Erreurs fréquentes de Claude Code et solutions (gérée par Google)
  • Could not load the default credentials : exécutez gcloud auth application-default login, ou définissez GOOGLE_APPLICATION_CREDENTIALS sur le chemin d’un fichier de clé.
  • Modèle introuvable (404) : vérifiez que vous avez activé le modèle dans Model Garden et qu’il existe dans la location choisie (les modèles récents ne sont que sur global ou une multirégion).
  • 429 : si vous avez indiqué une région, vérifiez que le modèle principal et le petit modèle y sont tous deux disponibles, et envisagez CLOUD_ML_REGION=global.

9. Quotas et erreurs 429

Gérée par Google : quotas par famille de modèles

Les modèles sortis après le 26 mai 2026 (Opus 5.5, Sonnet 5.5, Haiku 5.5 et d’autres) utilisent des quotas partagés au sein de la famille de modèles (pour les modèles plus anciens, consultez les quotas par modèle sur la même page de Google Cloud). Par exemple, quelle que soit la version d’Opus que vous appelez sur global, elle puise dans le même quota anthropic-claude-opus, et vous n’avez pas besoin de redemander un quota à la sortie d’une nouvelle version. global et chaque multirégion ont des quotas distincts.

Modèleglobal (par minute)Multirégion us/eu (chacune, par minute)
Opus 5.52 000 requêtes / 20 M de tokens d’entrée / 2 M de tokens de sortie1 000 requêtes / 10 M de tokens d’entrée / 1 M de tokens de sortie
Sonnet 5.52 500 requêtes / 25 M de tokens d’entrée / 2,5 M de tokens de sortie1 250 requêtes / 12,5 M de tokens d’entrée / 1,25 M de tokens de sortie
Haiku 5.53 000 requêtes / 30 M de tokens d’entrée / 3 M de tokens de sortie1 500 requêtes / 15 M de tokens d’entrée / 1,5 M de tokens de sortie

Source : quotas par défaut dans « Quotas for Anthropic Claude models » de Google Cloud (vérifié le 26 octobre 2026). L’entrée correspond au total des tokens non mis en cache et des écritures du cache. Google précise que les limites varient selon le compte et peuvent être restreintes.

Consultez les quotas et demandez des augmentations sur la page Quotas & ; System Limits de la console Google Cloud. Filtrer par base_model (par exemple anthropic-claude-opus) aide à les trouver. Les nombres de tokens de cette page peuvent être inexacts en raison du fonctionnement des estimations et des remboursements ; pour des chiffres exacts, utilisez l’API de comptage de tokens ou token_count dans Metrics Explorer.

Quand vous dépassez un quota, vous obtenez une erreur 429 avec ce message :

Resource exhausted, please try again later.

C’est le message pour une utilisation en paiement à l’usage (« Error code 429 » de Google Cloud). Avec le Provisioned Throughput, il s’agit de « Too many requests. Exceeded the Provisioned Throughput. »

  1. Utiliser global si vous n’avez pas d’exigence sur le lieu d’inférenceSes quotas sont plus élevés que ceux des multirégions, et le traitement a lieu dans la région qui dispose de capacité. Dans Claude Code, définissez CLOUD_ML_REGION=global. Si vous avez une exigence comme garder l’inférence dans l’UE, sautez cette étape et demandez d’abord une augmentation (étape 3).
  2. Attendre et réessayerRéessayez avec un backoff exponentiel plafonné, et évitez les pics soudains de volume.
  3. Demander une augmentation de quotaFaites la demande depuis la page Quotas & ; System Limits mentionnée plus haut.

Sources : « Error code 429 » de Google Cloud, section de dépannage de « Claude Code on Google Cloud’s Agent Platform » de Claude Code.

Gérée par Anthropic : limites gérées par Anthropic

Les limites d’utilisation sont gérées par Anthropic, et les valeurs par défaut ne figurent pas dans la documentation officielle. Pour les augmenter, adressez-vous à votre interlocuteur Anthropic ou au service commercial. La documentation d’Anthropic recommande de confirmer vos limites avant de basculer le trafic de production. Les erreurs ont la même forme que dans l’API Claude : dépasser une limite renvoie une erreur 429 rate_limit_error, et une surcharge renvoie une erreur 529 overloaded_error. S’il manque des autorisations IAM, Google Cloud renvoie 403.

  1. Attendre et réessayerRéessayez avec un backoff exponentiel, et évitez les pics soudains de volume (comme pour la version gérée par Google).
  2. Confirmer les limites avant la productionAvant de migrer, indiquez à votre interlocuteur Anthropic le volume nécessaire et confirmez vos limites.
  3. Demander une augmentation de limiteAdressez-vous à votre interlocuteur Anthropic ou au service commercial. Les limites ne peuvent pas être relevées depuis la page des quotas de Google Cloud.

Sources : la section Rate limits de « Claude Models on Google Cloud (Anthropic managed) » d’Anthropic, et « Errors ». Vérifié le 26 octobre 2026.

Récapitulatif

  • Claude sur Google Cloud existe en deux versions : gérée par Google (Agent Platform, anciennement Vertex AI) et gérée par Anthropic. Les deux apparaissent sur votre facture Google Cloud.
  • Pour Claude Code, utilisez la version gérée par Google. Définissez CLAUDE_CODE_USE_VERTEX=1 et les variables associées, et épinglez les modèles avec les quatre variables si vous déployez auprès de plusieurs personnes.
  • Pour la Files API, les Agent Skills, Managed Agents, le web fetch, le connecteur MCP et autres, ou pour le mode rapide d’Opus 5.5, utilisez la version gérée par Anthropic.
  • La version gérée par Google sur global a les mêmes tarifs que l’API Claude pour Opus 5.5, Sonnet 5.5 et Haiku 5.5. Les multirégions us/eu coûtent 1,1x. La version gérée par Anthropic est mesurée en CCU, et aucune grille tarifaire par token ne figure dans la documentation officielle.
  • Les quotas de la version gérée par Google sont partagés par famille de modèles ; les dépasser renvoie une erreur 429 « Resource exhausted, please try again later. » ; pour y remédier, utilisez global, réessayez et demandez une augmentation. Les limites de la version gérée par Anthropic sont gérées par Anthropic.
  • La version gérée par Anthropic crée une nouvelle organisation Anthropic par projet, et les organisations existantes ne peuvent pas y être transférées.
  • Les seules multirégions de la documentation officielle des deux versions sont us et eu ; confirmez les exigences de résidence dans d’autres pays avant de signer un contrat.

FAQ

Q. Claude sur Vertex AI coûte-t-il plus cher que l’API Claude ?

Sur le point de terminaison global de la version gérée par Google, les tarifs d’entrée, de sortie et de cache d’Opus 5.5, Sonnet 5.5 et Haiku 5.5 sont identiques. Les multirégions us et eu coûtent 10 % de plus (pages de tarifs d’Anthropic et de Google Cloud, vérifiées le 26 octobre 2026). Pour la version gérée par Anthropic, les tarifs par token ne figurent pas dans la documentation officielle : consultez la fiche Google Cloud Marketplace.

Q. Puis-je utiliser une clé API Claude ?

Les deux versions s’appellent avec l’authentification Google Cloud (ADC ou compte de service), et non avec une clé API créée dans la Claude Console. La version gérée par Anthropic ne permet pas de créer de clés API, et la définition de ANTHROPIC_API_KEY est ignorée.

Q. Puis-je utiliser Claude Code avec la version gérée par Anthropic ?

La documentation de Claude Code ne décrit pas de configuration pour la version gérée par Anthropic (vérifié le 26 octobre 2026). Le paramètre Google Cloud de Claude Code (CLAUDE_CODE_USE_VERTEX) concerne la version gérée par Google.

Q. Puis-je passer mon organisation Anthropic actuelle à la facturation Google Cloud ?

Non. La version gérée par Anthropic crée une nouvelle organisation par projet, et les organisations existantes ne peuvent pas être converties. Les clés API, les espaces de travail et les paramètres de la Console ne sont pas repris : vous les recréez dans la nouvelle organisation.