---
title: Claude Models on Google Cloud (Google managed)
url: https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed
description: Googleは、Google Cloud's Agent Platformの一部としてClaude Models on Google Cloud (Google managed)を運用しています。AnthropicのクライアントSDKを使用してClaudeを呼び出すことができます。
---

[Claude Models on Google Cloud](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/overview)では、2つのGoogle Cloudの提供形態を比較しています。また、どちらを使用しているかを確認する方法も示しています。

## API呼び出しを行う前に

Claude Models on Google Cloud (Google managed)を使用するには、以下が必要です。

1. Agent Platformを使用できるGoogle Cloudプロジェクト。セットアップ手順については、Google Cloudの[Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude)ページを参照してください。
2. ローカル開発用にインストールされた[gcloud CLI](https://cloud.google.com/sdk/docs/install)。
3. 呼び出しを行うIDに対する、`aiplatform.endpoints.predict`権限を含むIAMロール（Agent Platform User（`roles/aiplatform.user`）など）。詳細については、Google Cloudの[Agent Platform partner models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models)ページを参照してください。
4. そのIDのGoogle Cloud認証情報。SDKの例では、Google Cloudで認証するために`gcloud auth application-default login`を実行する必要がある場合があります。Claude Models on Google Cloud (Google managed)のcURLの例では、`gcloud auth print-access-token`でトークンを取得します。このコマンドはApplication Default Credentialsではなく、gcloud CLI自体のログインを使用します。これらの例では、先に`gcloud auth login`または`gcloud init`を実行してください。

### SDKをインストールする

Anthropicの[クライアントSDK](https://platform.claude.com/docs/ja/cli-sdks-libraries/overview)は、`AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`)を通じてClaude Models on Google Cloud (Google managed)をサポートしています。これを提供するパッケージをインストールしてください。

<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>

`ant` CLIはClaude Models on Google Cloud (Google managed)をサポートしていません。

## リクエストの送信

Claude Models on Google Cloud (Google managed)へのリクエストは、`:rawPredict`で終わるAgent PlatformのエンドポイントURLに送信されます。ストリーミングリクエストでは、代わりに`:streamRawPredict`を使用します。

リクエストは[Messages API](https://platform.claude.com/docs/ja/api/messages/create)のリクエストとほぼ同じです。主な違いは2点です。

* **モデル：** エンドポイントURLでモデルを指定します。cURLリクエストでは、本文から`model`を省略してください。
* **バージョン：** cURLリクエストでは、`anthropic_version`をヘッダーではなく本文で渡します。値は`vertex-2023-10-16`、または[APIバージョン`2026-10-21`](https://platform.claude.com/docs/ja/api/migration-2026-10-21)に設定してください。

以下の例ではグローバルエンドポイントを使用しています。その他のエンドポイントタイプについては、[グローバル、マルチリージョン、リージョナルエンドポイント](https://platform.claude.com/docs/ja/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">
    `ant` CLIは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";

  // 標準の `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"
  )
  // ...
  	// デフォルトの Google Cloud 認証情報を使用します
  	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>

### APIモデルID

| 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/ja/about-claude/model-deprecations))   | `claude-opus-4-1@20250805`   |
| Claude Opus 4 ([deprecated](https://platform.claude.com/docs/ja/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/ja/about-claude/model-deprecations)) | `claude-sonnet-4-5@20250929` |
| Claude Sonnet 4 ([deprecated](https://platform.claude.com/docs/ja/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/ja/about-claude/model-deprecations))  | `claude-3-5-haiku@20241022`  |

Claude Models on Google Cloud (Google managed)は、リージョンごとに異なるClaudeモデルを提供しています。リージョンで提供されているモデルを確認するには、[Model Garden](https://cloud.google.com/model-garden)で「Claude」を検索するか、Google Cloudの[Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude)ページを参照してください。

Claude Models on Google Cloud (Google managed)が提供するモデルのライフサイクル日程はGoogleが設定します。これらの日程はClaude APIのスケジュールと異なる場合があります。モデルの現在の廃止日については、Google Cloudの[Anthropic Claude models on Agent Platform](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude)ページを参照してください。非推奨（Deprecated）と廃止済み（Retired）の意味については、[モデルの非推奨化](https://platform.claude.com/docs/ja/about-claude/model-deprecations)を参照してください。

<Note>
  Claude Mythos Previewはリサーチプレビューです。Claude Models on Google Cloud (Google managed)では、招待された顧客に提供されています。詳細については、[Project Glasswing](https://anthropic.com/glasswing)を参照してください。
</Note>

<Tip>
  新しいClaudeモデルにアップグレードしますか？Claude Codeの[Claude APIスキル](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model)は、コードベース全体にモデルIDの置き換えと互換性のないパラメータ変更を適用します。

  Claude Codeにコードの移行を任せる

  ```text
  /claude-api migrate このプロジェクトを最新のClaude Opusモデルに移行してください
  ```

  このスキルは、コードが対象としているクラウドプラットフォームを検出し、そのプラットフォームに合わせてモデルIDの形式と機能の変更を調整します。
</Tip>

## グローバル、マルチリージョン、リージョナルエンドポイント

Claude Models on Google Cloud (Google managed)は3種類のエンドポイントタイプを提供しています。クライアントの作成時に渡すリージョン値でいずれかを選択します。cURLリクエストでは、エンドポイントタイプによってホストとURLの`locations`セグメントが決まります。

| エンドポイントタイプ    | リージョン値               | ホスト                                                                        |
| ------------- | -------------------- | -------------------------------------------------------------------------- |
| **グローバル**（推奨） | `"global"`           | `aiplatform.googleapis.com`                                                |
| **マルチリージョン**  | `"us"`または`"eu"`      | `aiplatform.us.rep.googleapis.com`<br />`aiplatform.eu.rep.googleapis.com` |
| **リージョナル**    | `"us-east5"`などのリージョン | `{region}-aiplatform.googleapis.com`                                       |

エンドポイントタイプによって、リクエストの送信先が異なります。

* **グローバル：** リクエストは利用可能な容量がある任意のリージョンに送信されます。最大限の可用性が必要で、データレジデンシーに柔軟性がある場合に使用してください。
* **マルチリージョン：** リクエストは米国（`"us"`）または欧州連合（`"eu"`）内の任意のリージョンに送信されます。広い地理的範囲内でのデータレジデンシーと、単一リージョンよりも高い可用性が必要な場合に使用してください。
* **リージョナル：** リクエストは`"us-east5"`や`"europe-west1"`など、指定したリージョンにのみ送信されます。単一リージョンでのデータレジデンシーが必要な場合や、厳格なコンプライアンス要件を満たす必要がある場合に使用してください。

マルチリージョンおよびリージョナルエンドポイントは、グローバルエンドポイントより10%高くなります。3種類のエンドポイントタイプはすべて従量課金のトラフィックを受け付け、プロビジョニングされたスループットにはリージョナルエンドポイントが必要です。

リージョナルエンドポイントは、Claude Sonnet 4.6以前のモデルのみを提供します。より新しいモデルには、グローバルまたはマルチリージョンエンドポイントを使用してください。

<Note>
  マルチリージョンおよびリージョナルエンドポイントの割増料金は、Claude Sonnet 4.5（非推奨）以降のモデルにのみ適用されます。以前の料金が維持されるモデルについては、[クラウドプラットフォームの料金](https://platform.claude.com/docs/ja/about-claude/pricing#cloud-platform-pricing)を参照してください。リージョナルエンドポイントの場合、割増料金は専用のリージョナル容量のインフラストラクチャコストを反映しています。
</Note>

以下の例では`us`マルチリージョンエンドポイントを使用しています。ハイライトされた行でリージョンを設定しています。グローバルエンドポイントでの完全なリクエストについては、[リクエストの送信](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#accessing-vertex-ai)を参照してください。

<CodeGroup exclude="shell:CLI">
  ```bash cURL
  # マルチリージョン識別子（"us" または "eu"）は、ホスト名とパスの両方に含まれます
  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">
    `ant` CLIは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"
  )
  // ...
  	// マルチリージョン識別子: "us" または "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 {
      // マルチリージョン識別子: "us" または "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>

## 機能のサポート

Claude Models on Google Cloud (Google managed)でサポートされている機能には、以下が含まれます。

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

* [プロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching)

* [思考](https://platform.claude.com/docs/ja/build-with-claude/thinking)

* [ツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/overview)（以下のツールを含む）：

  * [Bashツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/bash-tool)
  * [ブラウザ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool)
  * [コンピュータ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool)
  * [メモリツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/memory-tool)
  * [テキストエディタツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/text-editor-tool)
  * [Web検索ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool)

* [引用](https://platform.claude.com/docs/ja/build-with-claude/citations)

* [構造化出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs)

[機能の概要](https://platform.claude.com/docs/ja/build-with-claude/overview)には、すべての機能と、それぞれをClaude Models on Google Cloud (Google managed)がサポートしているかどうかが記載されています。

### サポートされていない機能

Claude Models on Google Cloud (Google managed)は以下をサポートしていません。

* **入力ソース：** 画像およびドキュメントのURLソース、Files API
* **サーバーサイドツール：** コード実行、Webフェッチ、アドバイザー
* **エージェントインフラストラクチャ：** Agent Skills、MCPコネクタ、プログラマティックツール呼び出し
* **APIエンドポイント：** Message Batches API、Models API、Admin API、Compliance API、Usage and Cost API
* **Claude Managed Agents**
* **サーバーサイドフォールバック：** [`fallbacks`パラメータ](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback#server-side-fallback)

サーバーサイドフォールバックの代わりに、[クライアントサイドフォールバックパターン](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback#client-side-fallback)を使用してください。

### コンテキストウィンドウ

Claude Models on Google Cloud (Google managed)は、以下のモデルで[100万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows)を提供しています。

* 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

その他のClaudeモデルのコンテキストウィンドウは20万トークンです。これにはClaude Sonnet 4.5（非推奨）およびClaude Sonnet 4（非推奨）が含まれます。

Agent Platformはリクエストペイロードを30 MBに制限しています。大きなドキュメントや多数の画像を送信する場合、トークン制限より先にこの制限に達する可能性があります。

## 請求、レート制限、ログ記録

### レート制限

Claude Models on Google Cloud (Google managed)のレート制限とクォータはGoogle Cloudが管理します。クォータの引き上げをリクエストする方法を含む詳細については、Google Cloudの[Quotas for Anthropic Claude models](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/claude/quotas)ページを参照してください。

### 請求

Claude Models on Google Cloud (Google managed)の請求はGoogle Cloudが行います。料金については、Google Cloudの[Generative AI pricing](https://cloud.google.com/vertex-ai/generative-ai/pricing#claude-models)ページを参照してください。料金はエンドポイントタイプによっても異なります。[グローバル、マルチリージョン、リージョナルエンドポイント](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#global-multi-region-and-regional-endpoints)を参照してください。

### データ保持

Claude Models on Google Cloud (Google managed)のデータの取り扱いはGoogle Cloudが管理します。詳細については、[Agent Platform and zero data retention](https://cloud.google.com/vertex-ai/generative-ai/docs/data-governance)を参照してください。

### モニタリングとログ記録

Claude Models on Google Cloud (Google managed)のプロンプトと補完をログに記録するには、Agent Platformの[リクエスト・レスポンスログ記録サービス](https://cloud.google.com/vertex-ai/generative-ai/docs/multimodal/request-response-logging)を使用してください。

Anthropicは、少なくとも直近30日分のログを保持することを推奨しています。ログは、アクティビティの把握や不正使用の可能性の調査に役立ちます。

<Note>
  このサービスを有効にしても、GoogleやAnthropicがお客様のコンテンツにアクセスできるようになることはありません。
</Note>

## Claude Models on Google Cloud (Anthropic managed)からの移行

移行時に何が変わるかについては、[2つのGoogle Cloudの提供形態の違い](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/overview#how-the-two-google-cloud-offerings-differ)を参照してください。Claude Models on Google Cloud (Google managed)に移行するには、以下の手順に従ってください。

<Steps>
  <Step title="アクセスを設定する">
    プロジェクトと呼び出しを行うIDが、[API呼び出しを行う前に](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#before-making-api-calls)の要件を満たしていることを確認してください。
  </Step>

  <Step title="SDKパッケージをインストールする">
    Claude Models on Google Cloud (Google managed)用のクライアントを提供するパッケージをインストールしてください。[SDKをインストールする](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#install-an-sdk-for-accessing-vertex-ai)を参照してください。
  </Step>

  <Step title="インポートとクライアントを置き換える">
    クライアントをインポートして作成するコードを変更します。`AnthropicGoogleCloud` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`)の代わりに`AnthropicVertex` (csharp: `AnthropicVertexClient`; go: `vertex.WithGoogleAuth`; java: `VertexBackend`; php: `Anthropic\Vertex\Client`; ruby: `Anthropic::VertexClient`)を使用してください。cURLリクエストでは、新しいURL、新しいヘッダー、新しい本文が必要です。以下のコードは、現在使用しているClaude Models on Google Cloud (Anthropic managed)用のクライアントを作成します。

    <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>

    以下のコードは、Claude Models on Google Cloud (Google managed)用のクライアントを作成します。グローバルエンドポイントを使用しています。その他のエンドポイントタイプについては、[グローバル、マルチリージョン、リージョナルエンドポイント](https://platform.claude.com/docs/ja/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">
        `ant` CLIはClaude Models on Google Cloud (Google managed)をサポートしていません。代わりにcURLまたは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"
      )
      // ...
      	// デフォルトの Google Cloud 認証情報を使用します
      	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>

    このコードは、クライアントの作成時にプロジェクトIDとリージョンを渡します。`MY_PROJECT_ID`をご自身のプロジェクトIDに置き換えてください。クライアントで行うMessages APIの呼び出しはそのままで構いません。例外は、次のステップで説明するモデルIDと機能です。
  </Step>

  <Step title="モデルIDと機能を確認する">
    * **モデルID：** Claude 4.6より前のモデルを使用している場合は、ID内のスナップショット日付の前にあるハイフンを`@`に置き換えてください。たとえば、`claude-haiku-4-5-20251001`は`claude-haiku-4-5@20251001`になります。モデルとそのIDについては、[APIモデルID](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#api-model-ids)を参照してください。
    * **機能：** コードで使用している機能が[サポートされていない機能](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#features-not-supported)に記載されていないことを確認してください。
  </Step>

  <Step title="テストリクエストを実行する">
    [リクエストの送信](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#accessing-vertex-ai)のリクエストを実行して、セットアップが機能することを確認してください。その後、ご自身のコードを実行してください。本番トラフィックを移行する前に、[Claude Models on Google Cloud (Google managed)のレート制限](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/google-managed#rate-limits)についてお読みください。
  </Step>
</Steps>

## 次のステップ

<CardGroup cols={2}>
  <Card title="機能の概要" icon="stack" href="https://platform.claude.com/docs/ja/build-with-claude/overview">
    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">
    各リージョンで提供されているClaudeモデルとその廃止日を確認できます。
  </Card>

  <Card title="Agent Platformドキュメント" icon="book" href="https://cloud.google.com/vertex-ai/docs">
    Google CloudのAgent Platformドキュメントをお読みください。
  </Card>

  <Card title="Claudeモデル向けグローバルエンドポイント" icon="link" href="https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai">
    Claudeモデル向けグローバルエンドポイントに関するGoogle Cloudのブログ記事をお読みください。
  </Card>
</CardGroup>
