---
title: Claude Models on Google Cloud (Google managed)
url: https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed
description: Google exploite Claude Models on Google Cloud (Google managed) dans le cadre de Google Cloud's Agent Platform. Vous pouvez appeler Claude avec les SDK clients d'Anthropic.
---

[Claude Models on Google Cloud](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/overview) compare les deux offres Google Cloud. Elle indique également comment savoir laquelle vous utilisez.

## Avant d'effectuer des appels API

Pour utiliser Claude Models on Google Cloud (Google managed), vous avez besoin de :

1. Un projet Google Cloud pouvant utiliser Agent Platform. Pour les étapes de configuration, consultez la page [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) de Google Cloud.
2. La [CLI gcloud](https://cloud.google.com/sdk/docs/install) installée, pour le développement local.
3. Pour l'identité qui effectue les appels, un rôle IAM incluant l'autorisation `aiplatform.endpoints.predict`, tel qu'Agent Platform User (`roles/aiplatform.user`). Pour plus de détails, consultez la page [Agent Platform partner models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models) de Google Cloud.
4. Des identifiants Google Cloud pour cette identité. Pour les exemples de SDK, vous devrez peut-être exécuter `gcloud auth application-default login` pour vous authentifier auprès de Google Cloud. Les exemples cURL pour Claude Models on Google Cloud (Google managed) obtiennent leur jeton avec `gcloud auth print-access-token`. Cette commande utilise la connexion propre à la CLI gcloud, et non les Application Default Credentials. Pour ces exemples, exécutez d'abord `gcloud auth login` ou `gcloud init`.

### Installer un SDK

Les [SDK clients](https://platform.claude.com/docs/fr/cli-sdks-libraries/overview) d'Anthropic prennent en charge Claude Models on Google Cloud (Google managed) via `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`). Installez le paquet qui le fournit :

<Tabs>
  <Tab title="Python">
    ```bash
    pip install -U "anthropic[vertex]"
    ```
  </Tab>

  <Tab title="TypeScript">
    ```bash
    npm install @anthropic-ai/vertex-sdk
    ```
  </Tab>

  <Tab title="C#">
    ```bash
    dotnet add package Anthropic.Vertex
    ```
  </Tab>

  <Tab title="Go">
    ```bash
    go get github.com/anthropics/anthropic-sdk-go
    ```
  </Tab>

  <Tab title="Java">
    <CodeGroup exclude="shell, python, typescript, csharp, go, php, ruby">
      ```groovy Gradle
      implementation("com.anthropic:anthropic-java:3.1.0")
      implementation("com.anthropic:anthropic-java-vertex:3.1.0")
      ```

      ```xml Maven
      <dependency>
          <groupId>com.anthropic</groupId>
          <artifactId>anthropic-java</artifactId>
          <version>3.1.0</version>
      </dependency>
      <dependency>
          <groupId>com.anthropic</groupId>
          <artifactId>anthropic-java-vertex</artifactId>
          <version>3.1.0</version>
      </dependency>
      ```
    </CodeGroup>
  </Tab>

  <Tab title="PHP">
    ```bash
    composer require anthropic-ai/sdk google/auth
    ```
  </Tab>

  <Tab title="Ruby">
    ```bash
    # Gemfile
    gem "anthropic"
    gem "googleauth"
    ```
  </Tab>
</Tabs>

La CLI `ant` ne prend pas en charge Claude Models on Google Cloud (Google managed).

## Effectuer des requêtes

Les requêtes vers Claude Models on Google Cloud (Google managed) sont envoyées à une URL de point de terminaison Agent Platform qui se termine par `:rawPredict`. Les requêtes en « streaming » (transmission en flux) utilisent plutôt `:streamRawPredict`.

Une requête est presque identique à une requête de l'[API Messages](https://platform.claude.com/docs/fr/api/messages/create). Elle en diffère de deux manières principales :

* **Modèle :** L'URL du point de terminaison désigne le modèle. Dans une requête cURL, omettez `model` du corps.
* **Version :** Dans une requête cURL, transmettez `anthropic_version` dans le corps, et non comme en-tête. Définissez-le sur `vertex-2023-10-16`, ou sur la [version d'API `2026-10-21`](https://platform.claude.com/docs/fr/api/migration-2026-10-21).

Les exemples suivants utilisent le point de terminaison global. Pour les autres types de points de terminaison, consultez [Points de terminaison globaux, multirégionaux et régionaux](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints).

<CodeGroup exclude="shell:CLI">
  ```bash cURL
  curl https://aiplatform.googleapis.com/v1/projects/MY_PROJECT_ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "anthropic_version": "vertex-2023-10-16",
      "messages": [{"role": "user", "content": "Hey Claude!"}],
      "max_tokens": 100
    }'
  ```

  <CodeGroupItem language="CLI">
    La CLI `ant` ne prend pas en charge Claude Models on Google Cloud (Google managed).
  </CodeGroupItem>

  ```python Python
  from anthropic import AnthropicVertex

  project_id = "MY_PROJECT_ID"
  region = "global"

  client = AnthropicVertex(project_id=project_id, region=region)

  message = client.messages.create(
      model="claude-opus-5-5",
      max_tokens=100,
      messages=[
          {
              "role": "user",
              "content": "Hey Claude!",
          }
      ],
  )
  print(message)
  ```

  ```typescript TypeScript
  import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

  const projectId = "MY_PROJECT_ID";
  const region = "global";

  // Passe par le flux standard de `google-auth-library`.
  const client = new AnthropicVertex({
    projectId,
    region
  });

  const result = await client.messages.create({
    model: "claude-opus-5-5",
    max_tokens: 100,
    messages: [
      {
        role: "user",
        content: "Hey Claude!"
      }
    ]
  });
  console.log(JSON.stringify(result, null, 2));
  ```

  ```csharp C#
  using Anthropic.Models.Messages;
  using Anthropic.Vertex;

  var projectId = "MY_PROJECT_ID";
  var region = "global";

  var client = new AnthropicVertexClient(new AnthropicVertexCredentials(region, projectId));

  var parameters = new MessageCreateParams
  {
      Model = Model.ClaudeOpus5_5,
      MaxTokens = 100,
      Messages = [new UserMessageParam { Content = "Hey Claude!" }]
  };

  var message = await client.Messages.Create(parameters);
  Console.WriteLine(message);
  ```

  ```go Go
  import (
  	"context"
  	"fmt"

  	"github.com/anthropics/anthropic-sdk-go"
  	"github.com/anthropics/anthropic-sdk-go/vertex"
  )
  // ...
  	// Utilise les identifiants Google Cloud par défaut.
  	client := anthropic.NewClient(
  		vertex.WithGoogleAuth(context.Background(), "global", "MY_PROJECT_ID"),
  	)

  	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
  		Model:     anthropic.ModelClaudeOpus5_5,
  		MaxTokens: 100,
  		Messages: []anthropic.MessageParam{
  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hey Claude!")),
  		},
  	})
  	if err != nil {
  		panic(err)
  	}
  	fmt.Printf("%+v\n", message)
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.models.messages.Message;
  import com.anthropic.models.messages.MessageCreateParams;
  import com.anthropic.models.messages.Model;
  import com.anthropic.vertex.backends.VertexBackend;
  import com.google.auth.oauth2.GoogleCredentials;

  void main() throws Exception {
      AnthropicClient client = AnthropicOkHttpClient.builder()
          .backend(
              VertexBackend.builder()
                  .googleCredentials(GoogleCredentials.getApplicationDefault())
                  .region("global")
                  .project("MY_PROJECT_ID")
                  .build()
          )
          .build();

      Message message = client
          .messages()
          .create(
              MessageCreateParams.builder()
                  .model(Model.CLAUDE_OPUS_5_5)
                  .maxTokens(100)
                  .addUserMessage("Hey Claude!")
                  .build()
          );

      IO.println(message);
  }
  ```

  ```php PHP
  <?php

  use Anthropic\Messages\TextBlock;
  use Anthropic\Vertex;

  $client = Vertex\Client::fromEnvironment(
      region: 'global',
      projectId: 'MY_PROJECT_ID',
  );

  $message = $client->messages->create(
      maxTokens: 100,
      messages: [
          ['role' => 'user', 'content' => 'Hey Claude!']
      ],
      model: 'claude-opus-5-5',
  );

  foreach ($message->content as $block) {
      if ($block instanceof TextBlock) {
          echo $block->text . PHP_EOL;
      }
  }
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::VertexClient.new(
    region: "global",
    project_id: "MY_PROJECT_ID"
  )

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

  puts message.content.find { it.type == :text }.text
  ```
</CodeGroup>

### ID de modèles de l'API

| Model                                                                                                 | Agent Platform API model ID  |
| :---------------------------------------------------------------------------------------------------- | :--------------------------- |
| Claude Fable 5.1                                                                                      | `claude-fable-5-1`           |
| Claude Mythos 5.1 ([limited availability](https://support.claude.com/en/articles/14604842))           | `claude-mythos-5-1`          |
| Claude Fable 5                                                                                        | `claude-fable-5`             |
| Claude Mythos 5 ([limited availability](https://support.claude.com/en/articles/14604842))             | `claude-mythos-5`            |
| Claude Opus 5.5                                                                                       | `claude-opus-5-5`            |
| Claude Opus 5                                                                                         | `claude-opus-5`              |
| Claude Opus 4.8                                                                                       | `claude-opus-4-8`            |
| Claude Opus 4.7                                                                                       | `claude-opus-4-7`            |
| Claude Opus 4.6                                                                                       | `claude-opus-4-6`            |
| Claude Opus 4.5                                                                                       | `claude-opus-4-5@20251101`   |
| Claude Opus 4.1 ([deprecated](https://platform.claude.com/docs/fr/about-claude/model-deprecations))   | `claude-opus-4-1@20250805`   |
| Claude Opus 4 ([deprecated](https://platform.claude.com/docs/fr/about-claude/model-deprecations))     | `claude-opus-4@20250514`     |
| Claude Sonnet 5.5                                                                                     | `claude-sonnet-5-5`          |
| Claude Sonnet 5                                                                                       | `claude-sonnet-5`            |
| Claude Sonnet 4.6                                                                                     | `claude-sonnet-4-6`          |
| Claude Sonnet 4.5 ([deprecated](https://platform.claude.com/docs/fr/about-claude/model-deprecations)) | `claude-sonnet-4-5@20250929` |
| Claude Sonnet 4 ([deprecated](https://platform.claude.com/docs/fr/about-claude/model-deprecations))   | `claude-sonnet-4@20250514`   |
| Claude Haiku 5.5                                                                                      | `claude-haiku-5-5`           |
| Claude Haiku 4.5                                                                                      | `claude-haiku-4-5@20251001`  |
| Claude Haiku 3.5 ([deprecated](https://platform.claude.com/docs/fr/about-claude/model-deprecations))  | `claude-3-5-haiku@20241022`  |

Claude Models on Google Cloud (Google managed) propose différents modèles Claude selon les régions. Pour vérifier quels modèles une région propose, recherchez « Claude » dans [Model Garden](https://cloud.google.com/model-garden) ou consultez la page [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) de Google Cloud.

Google fixe les dates de cycle de vie des modèles servis par Claude Models on Google Cloud (Google managed). Ces dates peuvent différer du calendrier de l'API Claude. Pour connaître la date de retrait actuelle d'un modèle, consultez la page [Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude) de Google Cloud. Pour la signification de « déprécié » et « retiré », consultez [Dépréciations de modèles](https://platform.claude.com/docs/fr/about-claude/model-deprecations).

<Note>
  Claude Mythos Preview est une préversion de recherche. Claude Models on Google Cloud (Google managed) la propose aux clients invités. Pour plus d'informations, consultez [Project Glasswing](https://anthropic.com/glasswing).
</Note>

<Tip>
  Vous passez à un modèle Claude plus récent ? La [skill Claude API](https://platform.claude.com/docs/fr/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model) dans Claude Code applique les remplacements d'identifiants de modèle et les changements de paramètres non rétrocompatibles dans l'ensemble de votre base de code :

  Laissez Claude Code migrer votre code pour vous

  ```text
  /claude-api migrate ce projet vers le dernier modèle Claude Opus
  ```

  La skill détecte la plateforme cloud ciblée par votre code et ajuste les formats d'identifiants de modèle ainsi que les changements de fonctionnalités pour cette plateforme.
</Tip>

## Points de terminaison globaux, multirégionaux et régionaux

Claude Models on Google Cloud (Google managed) propose trois types de points de terminaison. Vous en choisissez un avec la valeur de région que vous transmettez lors de la création du client. Dans une requête cURL, le type de point de terminaison détermine l'hôte et le segment `locations` de l'URL.

| Type de point de terminaison | Valeur de région                   | Hôte                                                                       |
| ---------------------------- | ---------------------------------- | -------------------------------------------------------------------------- |
| **Global** (recommandé)      | `"global"`                         | `aiplatform.googleapis.com`                                                |
| **Multirégional**            | `"us"` ou `"eu"`                   | `aiplatform.us.rep.googleapis.com`<br />`aiplatform.eu.rep.googleapis.com` |
| **Régional**                 | Une région, telle que `"us-east5"` | `{region}-aiplatform.googleapis.com`                                       |

Les types de points de terminaison diffèrent selon l'endroit où ils envoient les requêtes :

* **Global :** Les requêtes sont envoyées vers n'importe quelle région disposant de capacité disponible. Utilisez-le lorsque vous souhaitez une disponibilité maximale et que la résidence des données est flexible.
* **Multirégional :** Les requêtes sont envoyées vers n'importe quelle région des États-Unis (`"us"`) ou de l'Union européenne (`"eu"`). Utilisez-le lorsque vous avez besoin d'une résidence des données au sein d'une vaste zone géographique et d'une disponibilité supérieure à celle d'une seule région.
* **Régional :** Les requêtes sont envoyées uniquement vers la région que vous indiquez, telle que `"us-east5"` ou `"europe-west1"`. Utilisez-le lorsque vous avez besoin d'une résidence des données dans une seule région ou devez respecter des exigences de conformité strictes.

Les points de terminaison multirégionaux et régionaux coûtent 10 % de plus que les points de terminaison globaux. Les trois types de points de terminaison acceptent le trafic à l'usage, et le débit provisionné nécessite un point de terminaison régional.

Les points de terminaison régionaux servent uniquement Claude Sonnet 4.6 et les modèles antérieurs. Pour les modèles plus récents, utilisez un point de terminaison global ou multirégional.

<Note>
  Le supplément pour les points de terminaison multirégionaux et régionaux s'applique uniquement à Claude Sonnet 4.5 (déprécié) et aux modèles ultérieurs. Pour les modèles qui conservent leur tarification antérieure, consultez [Tarification des plateformes cloud](https://platform.claude.com/docs/fr/about-claude/pricing#cloud-platform-pricing). Pour les points de terminaison régionaux, le supplément reflète les coûts d'infrastructure liés à une capacité régionale dédiée.
</Note>

Les exemples suivants utilisent le point de terminaison multirégional `us`. Les lignes mises en évidence définissent la région. Pour une requête complète sur le point de terminaison global, consultez [Effectuer des requêtes](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#accessing-vertex-ai).

<CodeGroup exclude="shell:CLI">
  ```bash cURL
  # L'identifiant multirégion, "us" ou "eu", apparaît dans le nom d'hôte et dans le chemin.
  curl https://aiplatform.us.rep.googleapis.com/v1/projects/MY_PROJECT_ID/locations/us/publishers/anthropic/models/claude-opus-5-5:rawPredict \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "anthropic_version": "vertex-2023-10-16",
      "messages": [{"role": "user", "content": "Hey Claude!"}],
      "max_tokens": 100
    }'
  ```

  <CodeGroupItem language="CLI">
    La CLI `ant` ne prend pas en charge Claude Models on Google Cloud (Google managed).
  </CodeGroupItem>

  ```python Python
  from anthropic import AnthropicVertex

  project_id = "MY_PROJECT_ID"
  region = "us"  # Multi-region identifier: "us" or "eu"

  client = AnthropicVertex(project_id=project_id, region=region)
  ```

  ```typescript TypeScript
  import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

  const projectId = "MY_PROJECT_ID";
  const region = "us"; // Multi-region identifier: "us" or "eu"

  const client = new AnthropicVertex({
    projectId,
    region
  });
  ```

  ```csharp C#
  using Anthropic.Vertex;

  var projectId = "MY_PROJECT_ID";
  var region = "us"; // Multi-region identifier: "us" or "eu"

  var client = new AnthropicVertexClient(new AnthropicVertexCredentials(region, projectId));
  ```

  ```go Go
  import (
  	"context"

  	"github.com/anthropics/anthropic-sdk-go"
  	"github.com/anthropics/anthropic-sdk-go/vertex"
  )
  // ...
  	// Identifiant multirégion : "us" ou "eu"
  	client := anthropic.NewClient(
  		vertex.WithGoogleAuth(context.Background(), "us", "MY_PROJECT_ID"),
  	)
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.vertex.backends.VertexBackend;
  import com.google.auth.oauth2.GoogleCredentials;

  void main() throws Exception {
      // Identifiant multirégion : "us" ou "eu"
      AnthropicClient client = AnthropicOkHttpClient.builder()
          .backend(
              VertexBackend.builder()
                  .googleCredentials(GoogleCredentials.getApplicationDefault())
                  .region("us")
                  .project("MY_PROJECT_ID")
                  .build()
          )
          .build();
  }
  ```

  ```php PHP
  use Anthropic\Vertex;

  $client = Vertex\Client::fromEnvironment(
      region: 'us', // Multi-region identifier: "us" or "eu"
      projectId: 'MY_PROJECT_ID',
  );
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::VertexClient.new(
    region: "us", # Multi-region identifier: "us" or "eu"
    project_id: "MY_PROJECT_ID"
  )
  ```
</CodeGroup>

## Fonctionnalités prises en charge

Les fonctionnalités prises en charge sur Claude Models on Google Cloud (Google managed) incluent les suivantes :

* [API Messages](https://platform.claude.com/docs/fr/api/messages/create)

* [« Prompt caching » (mise en cache des prompts)](https://platform.claude.com/docs/fr/build-with-claude/prompt-caching)

* [« Thinking » (réflexion)](https://platform.claude.com/docs/fr/build-with-claude/thinking)

* [« Tool use » (utilisation d'outils)](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/overview), y compris ces outils :

  * [Outil Bash](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/bash-tool)
  * [Outil d'utilisation du navigateur](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/browser-use-tool)
  * [Outil d'utilisation de l'ordinateur](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/computer-use-tool)
  * [Outil de mémoire](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/memory-tool)
  * [Outil d'édition de texte](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/text-editor-tool)
  * [Outil de recherche web](https://platform.claude.com/docs/fr/agents-and-tools/tool-use/web-search-tool)

* [Citations](https://platform.claude.com/docs/fr/build-with-claude/citations)

* [Sorties structurées](https://platform.claude.com/docs/fr/build-with-claude/structured-outputs)

La [vue d'ensemble des fonctionnalités](https://platform.claude.com/docs/fr/build-with-claude/overview) répertorie chaque fonctionnalité et indique si Claude Models on Google Cloud (Google managed) la prend en charge.

### Fonctionnalités non prises en charge

Claude Models on Google Cloud (Google managed) ne prend pas en charge les éléments suivants :

* **Sources d'entrée :** Les sources URL pour les images et les documents, ainsi que la Files API
* **Outils côté serveur :** L'exécution de code, la récupération web et l'advisor
* **Infrastructure d'agents :** Agent Skills, le connecteur MCP et l'appel d'outils programmatique
* **Points de terminaison de l'API :** Message Batches API, Models API, Admin API, Compliance API et Usage and Cost API
* **Claude Managed Agents**
* **Repli côté serveur :** Le [paramètre `fallbacks`](https://platform.claude.com/docs/fr/build-with-claude/refusals-and-fallback#server-side-fallback)

Au lieu du repli côté serveur, utilisez le [modèle de repli côté client](https://platform.claude.com/docs/fr/build-with-claude/refusals-and-fallback#client-side-fallback).

### Fenêtre de contexte

Claude Models on Google Cloud (Google managed) offre une [« context window » (fenêtre de contexte) de 1M tokens](https://platform.claude.com/docs/fr/build-with-claude/context-windows) pour ces modèles :

* Claude Fable 5.1
* Claude Fable 5
* Claude Opus 5.5
* Claude Opus 5
* Claude Opus 4.8
* Claude Opus 4.7
* Claude Opus 4.6
* Claude Sonnet 5.5
* Claude Sonnet 5
* Claude Sonnet 4.6
* Claude Haiku 5.5

Les autres modèles Claude disposent d'une fenêtre de contexte de 200k tokens. Ceux-ci incluent Claude Sonnet 4.5 (déprécié) et Claude Sonnet 4 (déprécié).

Agent Platform limite la taille des charges utiles des requêtes à 30 Mo. Lorsque vous envoyez des documents volumineux ou de nombreuses images, vous pourriez atteindre cette limite avant la limite de tokens.

## Facturation, limites de débit et journalisation

### Limites de débit

Google Cloud gère les « rate limits » (limites de débit) et les quotas pour Claude Models on Google Cloud (Google managed). Pour plus de détails, notamment sur la manière de demander une augmentation de quota, consultez la page [Quotas for Anthropic Claude models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude/quotas) de Google Cloud.

### Facturation

Google Cloud vous facture Claude Models on Google Cloud (Google managed). Pour les prix, consultez la page [Generative AI pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing#claude-models) de Google Cloud. Les prix dépendent également du type de point de terminaison. Consultez [Points de terminaison globaux, multirégionaux et régionaux](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints).

### Conservation des données

Google Cloud régit le traitement des données pour Claude Models on Google Cloud (Google managed). Pour plus de détails, consultez [Agent Platform and zero data retention](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance).

### Surveillance et journalisation

Pour journaliser les prompts et les complétions pour Claude Models on Google Cloud (Google managed), utilisez le [service de journalisation des requêtes et réponses](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/request-response-logging) d'Agent Platform.

Anthropic vous recommande de conserver au moins les 30 derniers jours de journaux. Les journaux vous aident à comprendre votre activité et à enquêter sur d'éventuels abus.

<Note>
  L'activation de ce service ne donne ni à Google ni à Anthropic un quelconque accès à votre contenu.
</Note>

## Migrer depuis Claude Models on Google Cloud (Anthropic managed)

Pour savoir ce qui change lors de la migration, consultez [Différences entre les deux offres Google Cloud](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/overview#how-the-two-google-cloud-offerings-differ). Pour passer à Claude Models on Google Cloud (Google managed), suivez ces étapes :

<Steps>
  <Step title="Configurer l'accès">
    Vérifiez que votre projet et l'identité qui effectue les appels répondent aux exigences de la section [Avant d'effectuer des appels API](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#before-making-api-calls).
  </Step>

  <Step title="Installer le paquet SDK">
    Installez le paquet qui fournit le client pour Claude Models on Google Cloud (Google managed). Consultez [Installer un SDK](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#install-an-sdk-for-accessing-vertex-ai).
  </Step>

  <Step title="Remplacer l'import et le client">
    Modifiez le code qui importe et crée votre client. Utilisez `AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`) à la place de `AnthropicGoogleCloud` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`). Une requête cURL nécessite une nouvelle URL, de nouveaux en-têtes et un nouveau corps. Le code suivant crée le client pour Claude Models on Google Cloud (Anthropic managed) que vous utilisez aujourd'hui :

    <CodeGroup>
      ```bash cURL
      curl "https://claude.googleapis.com/v1/projects/$ANTHROPIC_GOOGLE_CLOUD_PROJECT/locations/global/workspaces/$ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID/invoke/v1/messages" \
        -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
        -H "content-type: application/json" \
        -H "anthropic-version: 2023-06-01" \
        -d '{
          "model": "claude-opus-5-5",
          "max_tokens": 1024,
          "messages": [
            {"role": "user", "content": "Hello, Claude"}
          ]
        }'
      ```

      ```bash CLI
      ant messages create \
        --model claude-opus-5-5 \
        --max-tokens 1024 \
        --message '{role: user, content: "Hello, Claude"}'
      ```

      ```python Python
      from anthropic import AnthropicGoogleCloud

      client = AnthropicGoogleCloud()
      ```

      ```typescript TypeScript
      import { AnthropicGoogleCloud } from "@anthropic-ai/google-cloud-sdk";

      const client = new AnthropicGoogleCloud();
      ```

      ```csharp C#
      using Anthropic.GoogleCloud;

      var client = new AnthropicGoogleCloudClient();
      ```

      ```go Go
      import (
      	"context"

      	"github.com/anthropics/anthropic-sdk-go"
      	"github.com/anthropics/anthropic-sdk-go/googlecloud"
      )
      // ...
      	client, err := googlecloud.NewClient(context.Background(), googlecloud.ClientConfig{})
      	if err != nil {
      		panic(err)
      	}
      ```

      ```java Java
      import com.anthropic.client.AnthropicClient;
      import com.anthropic.client.okhttp.AnthropicOkHttpClient;
      import com.anthropic.googlecloud.backends.GoogleCloudBackend;

      void main() {
          AnthropicClient client = AnthropicOkHttpClient.builder()
              .backend(GoogleCloudBackend.fromEnv())
              .build();
      }
      ```

      ```php PHP
      use Anthropic\GoogleCloud\Client;

      $client = new Client();
      ```

      ```ruby Ruby
      require "anthropic"

      client = Anthropic::GoogleCloudClient.new
      ```
    </CodeGroup>

    Le code suivant crée le client pour Claude Models on Google Cloud (Google managed). Il utilise le point de terminaison global. Pour les autres types de points de terminaison, consultez [Points de terminaison globaux, multirégionaux et régionaux](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints).

    <CodeGroup exclude="shell:CLI">
      ```bash cURL
      curl https://aiplatform.googleapis.com/v1/projects/MY_PROJECT_ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -d '{
          "anthropic_version": "vertex-2023-10-16",
          "messages": [{"role": "user", "content": "Hey Claude!"}],
          "max_tokens": 100
        }'
      ```

      <CodeGroupItem language="CLI">
        La CLI `ant` ne prend pas en charge Claude Models on Google Cloud (Google managed). Utilisez plutôt cURL ou un SDK.
      </CodeGroupItem>

      ```python Python
      from anthropic import AnthropicVertex

      project_id = "MY_PROJECT_ID"
      region = "global"

      client = AnthropicVertex(project_id=project_id, region=region)
      ```

      ```typescript TypeScript
      import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

      const projectId = "MY_PROJECT_ID";
      const region = "global";

      const client = new AnthropicVertex({
        projectId,
        region
      });
      ```

      ```csharp C#
      using Anthropic.Vertex;

      var projectId = "MY_PROJECT_ID";
      var region = "global";

      var client = new AnthropicVertexClient(new AnthropicVertexCredentials(region, projectId));
      ```

      ```go Go
      import (
      	"context"

      	"github.com/anthropics/anthropic-sdk-go"
      	"github.com/anthropics/anthropic-sdk-go/vertex"
      )
      // ...
      	// Utilise les identifiants Google Cloud par défaut.
      	client := anthropic.NewClient(
      		vertex.WithGoogleAuth(context.Background(), "global", "MY_PROJECT_ID"),
      	)
      ```

      ```java Java
      import com.anthropic.client.AnthropicClient;
      import com.anthropic.client.okhttp.AnthropicOkHttpClient;
      import com.anthropic.vertex.backends.VertexBackend;
      import com.google.auth.oauth2.GoogleCredentials;

      void main() throws Exception {
          AnthropicClient client = AnthropicOkHttpClient.builder()
              .backend(
                  VertexBackend.builder()
                      .googleCredentials(GoogleCredentials.getApplicationDefault())
                      .region("global")
                      .project("MY_PROJECT_ID")
                      .build()
              )
              .build();
      }
      ```

      ```php PHP
      use Anthropic\Vertex;

      $client = Vertex\Client::fromEnvironment(
          region: 'global',
          projectId: 'MY_PROJECT_ID',
      );
      ```

      ```ruby Ruby
      require "anthropic"

      client = Anthropic::VertexClient.new(
        region: "global",
        project_id: "MY_PROJECT_ID"
      )
      ```
    </CodeGroup>

    Ce code transmet l'ID de votre projet et une région lors de la création du client. Remplacez `MY_PROJECT_ID` par l'ID de votre projet. Les appels à l'API Messages que vous effectuez avec le client restent inchangés. Les exceptions sont les ID de modèles et les fonctionnalités abordés à l'étape suivante.
  </Step>

  <Step title="Vérifier les ID de modèles et les fonctionnalités">
    * **ID de modèles :** Si vous utilisez un modèle antérieur à Claude 4.6, remplacez le trait d'union précédant la date de l'instantané dans son ID par `@`. Par exemple, `claude-haiku-4-5-20251001` devient `claude-haiku-4-5@20251001`. Pour les modèles et leurs ID, consultez [ID de modèles de l'API](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#api-model-ids).
    * **Fonctionnalités :** Vérifiez que les fonctionnalités utilisées par votre code ne figurent pas dans [Fonctionnalités non prises en charge](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#features-not-supported).
  </Step>

  <Step title="Exécuter une requête de test">
    Exécutez la requête de la section [Effectuer des requêtes](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#accessing-vertex-ai) pour vérifier que votre configuration fonctionne. Exécutez ensuite votre propre code. Avant de migrer le trafic de production, renseignez-vous sur les [limites de débit pour Claude Models on Google Cloud (Google managed)](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/google-managed#rate-limits).
  </Step>
</Steps>

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Vue d'ensemble des fonctionnalités" icon="stack" href="https://platform.claude.com/docs/fr/build-with-claude/overview">
    Explorez les fonctionnalités de Claude.
  </Card>

  <Card title="Anthropic Claude models on Agent Platform" icon="book" href="https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude">
    Vérifiez quels modèles Claude chaque région propose, ainsi que leurs dates de retrait.
  </Card>

  <Card title="Documentation d'Agent Platform" icon="book" href="https://cloud.google.com/vertex-ai/docs">
    Consultez la documentation de Google Cloud's Agent Platform.
  </Card>

  <Card title="Point de terminaison global pour les modèles Claude" icon="link" href="https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai">
    Lisez l'article de blog de Google Cloud sur le point de terminaison global pour les modèles Claude.
  </Card>
</CardGroup>
