---
title: Claude Models on Google Cloud (Anthropic managed)
url: https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed
description: Claude Models on Google Cloud (Anthropic managed) は、Anthropic が運用し、お使いの Google Cloud プロジェクトを通じてアクセスする Claude API です。
---

Claude Models on Google Cloud (Anthropic managed) のアクセスと請求は Google Cloud が処理します。2 つの Google Cloud の提供形態を比較する場合や、どちらを使用しているかを確認する場合は、[Claude Models on Google Cloud](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/overview) を参照してください。

## アカウントを設定する

Claude Models on Google Cloud (Anthropic managed) 用にアカウントを設定するには、次のものが必要です。

* 請求先アカウントで Google Cloud Marketplace から購入する権限
* プロジェクトでサービスを有効にする権限
* ステップ 4 で必要となる、[Claude Console を開くことができる IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console)

これらの手順により、Google Cloud プロジェクト用の新しい Anthropic 組織が作成されます。これは、会社がすでに持っている Anthropic 組織とは別のものです。Claude Enterprise 組織も同様です。既存の組織から移行する場合は、[既存の Anthropic 組織からの移行](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#moving-from-an-existing-anthropic-organization)を参照してください。

既存の割引がある場合は、これらの手順を開始する前に Anthropic または Google Cloud のアカウント担当者にお問い合わせください。割引は過去の使用量には適用できません。

<Steps>
  <Step title="Marketplace でサブスクライブする">
    1. [Google Cloud Marketplace](https://console.cloud.google.com/marketplace) を開き、**Claude Models on Google Cloud (Anthropic managed)** のリスティングを見つけます。
    2. **Subscribe** を選択し、購入フローを完了します。
    3. リスティングに戻り、**Manage on Console** を選択します。これにより、Google Cloud コンソールの Claude ページが開きます。

    後で Claude ページに戻るには、Google Cloud コンソールでプロジェクトを選択します。次に **Agent Platform > Models > Claude Platform** に移動し、**Anthropic managed** を選択します。
  </Step>

  <Step title="サービスを有効にする">
    Claude Models on Google Cloud (Anthropic managed) を呼び出すすべてのプロジェクトで、2 つのサービスを有効にします。

    * `claude.googleapis.com` は、Claude Models on Google Cloud (Anthropic managed) の API を提供します。このサービスは IAM 権限も定義します。これがないと呼び出しは失敗します。
    * `anthropic-managed-claude.cloudpartnerservices.goog` は、プロジェクトの使用量をサブスクリプションに帰属させる Marketplace サービスです。

    ```bash CLI
    gcloud services enable claude.googleapis.com \
      anthropic-managed-claude.cloudpartnerservices.goog \
      --project=my-project-id
    ```

    `my-project-id` をプロジェクト ID に置き換えてください。

    Claude ページまたは **APIs & Services** から両方を有効にすることもできます。有効化はプロジェクトごとに 1 回だけ行う手順です。両方のサービスが有効になっていることを確認するには、`gcloud services list --enabled --project=my-project-id` を実行し、両方の名前を探します。
  </Step>

  <Step title="Anthropic 組織を設定する">
    1. Claude ページで **Activate** を選択します。
    2. Anthropic のセットアップフローで、連絡先メールアドレスを入力します。
    3. そのアドレスに送信されたセットアップリンクを開きます。
    4. 組織の名前、事業体の種類、国、および使用目的を入力します。
    5. Anthropic の商用利用規約と利用ポリシーに同意します。

    連絡先アドレスは、セットアップとサービスに関するお知らせにのみ使用されます。セットアップ後にユーザーが Claude Console を開く方法については、[Claude Console の使用](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console)を参照してください。
  </Step>

  <Step title="Claude Console を開く">
    Anthropic 組織が有効になると、Claude ページのボタンが **Open Claude Console** に変わります。これを選択します。Google Cloud が IAM アクセスを確認します。その後、ブラウザが `platform.claude.com` にリダイレクトされます。新しい組織にサインインした状態になります。

    Claude Console にいる間に、[ワークスペース ID を見つけて](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id)コピーしてください。Claude Models on Google Cloud (Anthropic managed) を呼び出すすべての人がこれを必要とします。開発者に共有してください。
  </Step>
</Steps>

別のプロジェクトを追加するには、そのプロジェクトでステップ 2 からこれらの手順を繰り返します。

### アカウント設定のトラブルシューティング

Claude Models on Google Cloud (Anthropic managed) の設定中に次のいずれかの問題が発生した場合は、その対処法を適用してください。

* **`gcloud services enable` が `anthropic-managed-claude.cloudpartnerservices.goog` を見つけられない:** Marketplace での購入を完了したアカウントとしてコマンドを実行するか、Anthropic のアカウント担当者にお問い合わせください。
* **最初の API 呼び出しで権限エラーが発生する:** 呼び出し先のプロジェクトで `claude.googleapis.com` が有効になっていることを確認してください。呼び出し元がそのプロジェクトで `roles/claude.user` または `roles/claude.admin` を持っていることを確認してください。各ロールで許可される内容については、[IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)を参照してください。新しい付与や新たに有効にしたサービスが反映されるまでには少し時間がかかる場合があります。
* **セットアップリンクを開いた後に「Signed in as a different account」と表示される:** **Log out and continue** を選択します。その後、ステップ 3 で入力したメールアドレスを使用してください。
* **ボタンに「Open Claude Console」ではなく「Finish Setup」と表示される:** Anthropic 組織は存在しますが、セットアップが完了していません。管理者が組織の詳細フォームを完了する必要があります。
* **最初の API 呼び出し後に Usage ページにデータが表示されない:** 使用量データが Claude Console に表示されるまでに数分かかる場合があります。

## アクセスを管理する

### IAM ロール

Claude Models on Google Cloud (Anthropic managed) には、3 つの事前定義された IAM ロールがあります。ロールはプロジェクトに対して付与します。

| ロール                   | 表示名           | 許可される内容                                                                                                                                            |
| --------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `roles/claude.viewer` | Claude Viewer | ワークスペースリソースに対するすべての `get` および `list` 権限<br />このロールは読み取り専用です。                                                                                       |
| `roles/claude.user`   | Claude User   | `roles/claude.viewer` で許可されるすべての操作に加え、ワークスペースリソースの作成と変更<br />これにはメッセージの送信とトークンのカウントが含まれます。また、バッチ、ファイル、スキル、および Claude Managed Agents リソースの管理も含まれます。 |
| `roles/claude.admin`  | Claude Admin  | `roles/claude.user` で許可されるすべての操作に加え、Anthropic 組織に対してチェックされる権限<br />組織レベルのルートは、1 つのワークスペースではなく、Anthropic 組織全体に対して作用します。                             |

たとえば、次のコマンドを使用すると、サービスアカウントが Claude Models on Google Cloud (Anthropic managed) を呼び出せるようになります。

```bash CLI
gcloud projects add-iam-policy-binding my-project-id \
  --member="serviceAccount:my-app@my-project-id.iam.gserviceaccount.com" \
  --role="roles/claude.user"
```

権限、事前定義ロール、および監査ログの種類については、[Claude Models on Google Cloud (Anthropic managed) の IAM 権限](https://platform.claude.com/docs/ja/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions)を参照してください。

`claude.googleapis.com` を有効にすると、プロジェクト用のサービスエージェントが作成されます。そのロール付与を削除しないでください。削除すると、そのプロジェクトで Claude Models on Google Cloud (Anthropic managed) が動作しなくなります。

### Claude Console の使用

Claude Models on Google Cloud (Anthropic managed) では、メールアドレスを使用して Anthropic 組織にサインインすることはできません。代わりに、Google Cloud コンソールの [Claude ページ](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)で **Open Claude Console** を選択します。Claude Console を開くことができるユーザーは Google Cloud IAM によって制御されます。3 つの事前定義された [IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)のうち、Claude Console を開くことができるのは、プロジェクトに対する `roles/claude.admin` のみです。

### ワークスペース

Claude Models on Google Cloud (Anthropic managed) では、セットアップによって 1 つのワークスペース (Default Workspace) を持つ Anthropic 組織が作成されます。さらにワークスペースを作成するには、[Claude Console を開き](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console)、**Settings > Workspaces** に移動します。同じページで、Default Workspace 以外の任意のワークスペースの名前を変更したり、アーカイブしたりできます。各ワークスペースには独自の[ワークスペース ID](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id) があります。ファイル、スキル、バッチ、Claude Managed Agents セッション、およびその他のワークスペースリソースは、[リクエストに設定した](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution) ID のワークスペースに属します。

[IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)はプロジェクトに対して付与するため、ロールはそのプロジェクト内のすべてのワークスペースに適用されます。チームごとに個別のアクセスが必要な場合は、各チームに独自の Google Cloud プロジェクトを割り当ててください。各プロジェクトには独自の Anthropic 組織があるため、各プロジェクトでステップ 2 から[セットアップ手順](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)を繰り返してください。

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

Claude Models on Google Cloud (Anthropic managed) を呼び出すには、次のものが必要です。

1. 有効なサブスクリプションと、セットアップが完了した Anthropic 組織を持つ Google Cloud プロジェクト。[アカウントを設定する](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)を参照してください。
2. ローカル開発用にインストールされた [gcloud CLI](https://cloud.google.com/sdk/docs/install)。
3. 呼び出しを行う ID に対してプロジェクトで付与された `roles/claude.user` ロール。
4. その ID の Application Default Credentials。[認証](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#authentication)を参照してください。
5. プロジェクト ID と[ワークスペース ID](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id)。

ローカル開発のために自分のアカウントにロールを付与するには、次のコマンドを実行します。プロジェクトの IAM ポリシーを変更する権限が必要です。

```bash CLI
gcloud projects add-iam-policy-binding my-project-id \
  --member="user:you@example.com" \
  --role="roles/claude.user"
```

`my-project-id` をプロジェクト ID に置き換えてください。`you@example.com` を Google アカウントのメールアドレスに置き換えてください。gcloud が使用しているプロジェクトを確認するには、`gcloud config get-value project` を実行します。サービスアカウントとその他のロールについては、[IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)を参照してください。

### ワークスペース ID を見つける

Claude Models on Google Cloud (Anthropic managed) のワークスペース ID を見つけるには、[Claude Console を開き](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console)、**Settings > Workspaces** に移動します。ID は `wrkspc_` で始まります。Claude Console を開けない場合は、開くことができる人に ID を送ってもらうよう依頼してください。

SDK クライアントと [`ant` CLI](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/quickstart) が読み取れるように、プロジェクトとワークスペースを環境変数として設定します。

```bash CLI
export ANTHROPIC_GOOGLE_CLOUD_PROJECT="my-project-id"
export ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID="wrkspc_01AbCdEf23GhIj"
```

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

Claude Models on Google Cloud (Anthropic managed) 用の [SDK クライアント](https://platform.claude.com/docs/ja/cli-sdks-libraries/overview)は `AnthropicGoogleCloud` (csharp: `AnthropicGoogleCloudClient`; go: `googlecloud.NewClient`; java: `GoogleCloudBackend`; php: `Anthropic\GoogleCloud\Client`; ruby: `Anthropic::GoogleCloudClient`) です。クライアントは Google の認証情報を解決します。また、プロジェクト、ロケーション、およびワークスペース ID からベース URL を構築します。

<Note>
  Claude Models on Google Cloud (Anthropic managed) 用の SDK クライアントはベータ版です。
</Note>

クライアントを提供するパッケージをインストールします。

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

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

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

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

  <Tab title="Java">
    ```kotlin Gradle
    implementation("com.anthropic:anthropic-java:3.1.0")
    implementation("com.anthropic:anthropic-java-google-cloud: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-google-cloud</artifactId>
      <version>3.1.0</version>
    </dependency>
    ```
  </Tab>

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

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

代わりに `ant` CLI を使用する場合は、最新バージョンに[インストールまたは更新](https://platform.claude.com/docs/ja/cli-sdks-libraries/cli/quickstart#installation)してください。Claude Models on Google Cloud (Anthropic managed) をサポートしていないバージョンは、`ANTHROPIC_GOOGLE_CLOUD_*` 変数を無視します。その場合、次のいずれかの動作になります。

* 設定済みの他の認証情報を使用して、リクエストを Claude API に送信する
* 認証エラーで失敗する

## リクエストを行う

Claude Models on Google Cloud (Anthropic managed) は、プロジェクト、ロケーション、およびワークスペースを指定するベース URL の下で Claude API エンドポイントを提供します。

```text wrap
https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke
```

パスが `/v1/organizations/` で始まる[組織レベルのルート](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)は、ワークスペースを含まないベース URL を使用します。

```text wrap
https://claude.googleapis.com/v1/projects/{project}/locations/global/claudeOrganization/invoke
```

[ベース URL を設定](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution)しない場合、SDK クライアントはリクエストごとにこれら 2 つのいずれかを選択します。

ベース URL に Claude API のパスを追加します。たとえば、[Messages API](https://platform.claude.com/docs/ja/api/messages/create) は `.../invoke/v1/messages` にあります。Claude API へのリクエストとは次の 3 点が異なります。

* **ベース URL:** `https://api.anthropic.com` の代わりに、前述のプロジェクトスコープの URL を使用します。
* **認証:** Google アクセストークンを含む `Authorization: Bearer` ヘッダーを使用します。`x-api-key` ヘッダーは送信しないでください。
* **ワークスペース:** ワークスペース ID は URL の一部です。`anthropic-workspace-id` ヘッダーは送信しないでください。

その他はすべて Claude API と同じで、次のものが含まれます。

* `anthropic-version` および `anthropic-beta` ヘッダー
* リクエストボディ
* ストリーミング
* レスポンス

このドキュメントの他の箇所にあるコードサンプルは、Claude API クライアントを作成し、APIキーを読み取ります。それらを Claude Models on Google Cloud (Anthropic managed) で実行するには、インポートとクライアントコンストラクターを次の例のものに置き換えてください。cURL サンプルの場合は、前述の 3 つの違いを適用してください。

これらの例を実行する前に、[API 呼び出しを行う前に](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls)の手順を完了してください。

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

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

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

  const client = new AnthropicGoogleCloud();

  const message = await client.messages.create({
    model: "claude-opus-5-5",
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello, Claude" }]
  });
  console.log(message);
  ```

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

  var client = new AnthropicGoogleCloudClient();

  var parameters = new MessageCreateParams
  {
      Model = Model.ClaudeOpus5_5,
      MaxTokens = 1024,
      Messages = [new UserMessageParam { Content = "Hello, 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/googlecloud"
  )

  func main() {
  	client, err := googlecloud.NewClient(context.Background(), googlecloud.ClientConfig{})
  	if err != nil {
  		panic(err)
  	}

  	message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
  		Model:     anthropic.ModelClaudeOpus5_5,
  		MaxTokens: 1024,
  		Messages: []anthropic.MessageParam{
  			anthropic.NewUserMessage(anthropic.NewTextBlock("Hello, Claude")),
  		},
  	})
  	if err != nil {
  		panic(err)
  	}

  	fmt.Println(message)
  }
  ```

  ```java Java
  import com.anthropic.client.AnthropicClient;
  import com.anthropic.client.okhttp.AnthropicOkHttpClient;
  import com.anthropic.googlecloud.backends.GoogleCloudBackend;
  import com.anthropic.models.messages.Message;
  import com.anthropic.models.messages.MessageCreateParams;
  import com.anthropic.models.messages.Model;

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

      Message message = client.messages().create(
          MessageCreateParams.builder()
              .model(Model.CLAUDE_OPUS_5_5)
              .maxTokens(1024)
              .addUserMessage("Hello, Claude")
              .build()
      );

      IO.println(message);
  }
  ```

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

  $client = new Client();

  $message = $client->messages->create(
      model: Model::CLAUDE_OPUS_5_5,
      maxTokens: 1024,
      messages: [['role' => 'user', 'content' => 'Hello, Claude']],
  );

  echo $message;
  ```

  ```ruby Ruby
  require "anthropic"

  client = Anthropic::GoogleCloudClient.new

  message = client.messages.create(
    model: Anthropic::Model::CLAUDE_OPUS_5_5,
    max_tokens: 1024,
    messages: [{ role: "user", content: "Hello, Claude" }]
  )

  puts message
  ```
</CodeGroup>

cURL の例では、gcloud に Application Default Credentials のトークンを要求します。アクセストークンの有効期間は短いです。保存するのではなく、セッションごとに生成してください。

### API モデル ID

Claude Models on Google Cloud (Anthropic managed) は、Claude API と同じモデル ID (たとえば `claude-opus-5-5`) を使用します。モデルとその ID については、[モデルの概要](https://platform.claude.com/docs/ja/models/overview)を参照してください。

Claude Models on Google Cloud (Anthropic managed) では、Anthropic 組織で利用できないモデルをリクエストするとエラーが返されます。エラーメッセージは `Model {model} is not available for this organization's inference configuration.` です。

## プロジェクト、ロケーション、およびワークスペースの解決

Claude Models on Google Cloud (Anthropic managed) のクライアントは、次の表の設定を受け取ります。クライアント作成時に渡した値は、環境変数よりも優先されます。プロジェクトとワークスペース ID を明示的に設定するには、`project` (go: `Project`; java: `.project()`; csharp: `GoogleCloudClientOptions.Project`; cli: `--google-cloud-project`) と `workspace_id` (typescript, php: `workspaceId`; go: `WorkspaceID`; java: `.workspaceId()`; csharp: `GoogleCloudClientOptions.WorkspaceId`; cli: `--google-cloud-workspace-id`) を渡します。

| 設定         | 環境変数                                                       | 未設定の場合                                                                                                                                                                             |
| ---------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| プロジェクト ID  | `ANTHROPIC_GOOGLE_CLOUD_PROJECT`、次に `GOOGLE_CLOUD_PROJECT` | 認証情報の種類がプロジェクトを保持している場合、Application Default Credentials が報告するプロジェクト                                                                                                                |
| ワークスペース ID | `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID`                      | ベース URL を設定しない限り、クライアントはエラーを発生させます。[組織レベルのルート](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)にはワークスペース ID は不要です。 |
| ロケーション     | `ANTHROPIC_GOOGLE_CLOUD_LOCATION`                          | `global`                                                                                                                                                                           |
| ベース URL    | `ANTHROPIC_GOOGLE_CLOUD_BASE_URL`                          | プロジェクト、ロケーション、およびワークスペース ID から導出                                                                                                                                                   |

ロケーションは `global` のままにしてください。ロケーションは推論が実行される場所とは別のものです。そのため、米国内のみでの推論を行うには、[データレジデンシー](https://platform.claude.com/docs/ja/manage-claude/data-residency#inference-geo)で説明されているように、各リクエストで `inference_geo: "us"` を設定してください。

`ant` CLI は、同じ設定をフラグとして受け取ります。

* **プロジェクト ID:** `--google-cloud-project`
* **ワークスペース ID:** `--google-cloud-workspace-id`
* **ロケーション:** `--google-cloud-location`
* **ベース URL:** `--google-cloud-base-url`

CLI は、プロジェクト、ワークスペース ID、またはロケーションが設定されている場合に Claude Models on Google Cloud (Anthropic managed) を使用します。`GOOGLE_CLOUD_PROJECT`、ベース URL、またはその両方を設定するだけでは不十分です。

## 認証

Claude Models on Google Cloud (Anthropic managed) への各リクエストは、`Authorization: Bearer` ヘッダーに Google OAuth 2.0 アクセストークンを含みます。トークンには `https://www.googleapis.com/auth/cloud-platform` スコープがあります。

アクセスは Google Cloud が処理します。`claude.googleapis.com` にあるそのゲートウェイは、各リクエストに対して次の処理を行います。

1. Google Cloud の認証情報を確認します。
2. 呼び出し元がリクエストに必要な IAM 権限を持っていることを確認します。持っていない場合、Google Cloud は HTTP 403 エラーを返します。
3. リクエストを Anthropic に転送します。Anthropic がリクエストを検証します。

権限を付与するには、[IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)を参照してください。

SDK クライアントは、[Application Default Credentials](https://cloud.google.com/docs/authentication/application-default-credentials) (ADC) からトークンを取得します。ADC がサポートする任意の認証情報ソースが使用できます。

* **ローカル開発:** `gcloud auth application-default login` を実行します。
* **Google Cloud 上:** クライアントは、Compute Engine、GKE、Cloud Run などでワークロードにアタッチされたサービスアカウントを自動的に使用します。
* **サービスアカウントキーファイル:** `GOOGLE_APPLICATION_CREDENTIALS` にそのパスを設定します。
* **Workload Identity Federation とサービスアカウントの権限借用:** 他の Google Cloud API と同様に構成します。

ADC が機能していることを確認します。

```bash CLI
gcloud auth application-default print-access-token
```

Claude Models on Google Cloud (Anthropic managed) は APIキーを使用しません。Claude Console では、セットアップによって作成された Anthropic 組織の APIキーを作成することはできません。Claude Models on Google Cloud (Anthropic managed) 用の SDK クライアントは、次の環境変数を無視します。

* `ANTHROPIC_API_KEY`
* `ANTHROPIC_AUTH_TOKEN`
* `ANTHROPIC_BASE_URL`

### 認証情報の優先順位

Claude Models on Google Cloud (Anthropic managed) 用の SDK クライアントは、次の順序で認証情報を確認します。クライアントは最初に見つかったものを使用します。

1. クライアント作成時に `token_provider` (typescript: `bearerTokenProvider`; csharp: `GoogleCloudClientOptions.TokenProvider`; go: `TokenSource`; java: `.bearerTokenSupplier()`; php: `tokenProvider`) として渡すトークンプロバイダー。これはアクセストークンを返す関数またはトークンソースです。クライアントはリクエストごとにトークンを要求します。トークンのキャッシュと更新はユーザー側で行う必要があります。
2. クライアント作成時に `credentials` (typescript: `googleAuth`; csharp: `GoogleCloudClientOptions.GoogleCredential`; java: `.googleCredentials()`; php: `googleCredentials`; ruby: `google_credentials`) として渡す Google 認証情報オブジェクト。Go SDK にはこのオプションはありません。
3. Application Default Credentials。

Go と Java は他の SDK と異なります。

* **Go:** オプション 1 では、クライアントは `oauth2.TokenSource` を受け取ります。トークンの有効期限が切れるまでトークンをキャッシュします。
* **Java:** `GoogleCloudBackend.fromEnv()` を使用して、Application Default Credentials と[プロジェクト、ロケーション、およびワークスペースの解決](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution)の環境変数を読み取ります。

クライアントには、認証情報用の独自の環境変数はありません。代わりに ADC の `GOOGLE_APPLICATION_CREDENTIALS` を使用してください。

リクエストがトークンを付加するプロキシを経由する場合は、`skip_auth` (typescript, php: `skipAuth`; go: `SkipAuth`; java: `.skipAuth()`; csharp: `GoogleCloudClientOptions.SkipAuth`) を設定します。これにより、クライアントは `Authorization` ヘッダーを送信しなくなります。この設定を前述の認証情報オプションと組み合わせることはできません。

`ant` CLI が Claude Models on Google Cloud (Anthropic managed) を使用する場合、常に Application Default Credentials からトークンを取得します。トークンプロバイダー、認証情報オブジェクト、または skip-auth 設定は受け取りません。

Claude Models on Google Cloud (Anthropic managed) で `ant` を使用する前に、次のいずれも設定されていないことを確認してください。

* APIキー

* 認証トークン

* CLI が認証に使用できる[構成プロファイル](https://platform.claude.com/docs/ja/manage-claude/wif-reference#profile-configuration-file)を指定している場合の `--profile` または `ANTHROPIC_PROFILE`

* Anthropic のフェデレーション変数のいずれか:

  * `ANTHROPIC_FEDERATION_RULE_ID`
  * `ANTHROPIC_ORGANIZATION_ID`
  * `ANTHROPIC_SERVICE_ACCOUNT_ID`
  * `ANTHROPIC_IDENTITY_TOKEN`
  * `ANTHROPIC_IDENTITY_TOKEN_FILE`

いずれかが設定されている場合、CLI は[ワークスペース ID を見つける](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-id)の Google Cloud 設定ではなく、その認証情報を使用します。フェデレーション変数の一部のみが設定されている場合、CLI はエラーで停止します。複数の認証情報が設定されている場合、CLI は使用する認証情報を示すメモを出力します。

また、`ANTHROPIC_WORKSPACE_ID` と `--workspace-id` フラグも未設定のままにしてください。CLI はその値を `anthropic-workspace-id` ヘッダーとして送信し続けます。Claude Models on Google Cloud (Anthropic managed) へのリクエストにはそのヘッダーを含めてはいけません。代わりに、`--google-cloud-workspace-id` または `ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID` でワークスペースを設定してください。

SDK クライアントと同様に、CLI は Claude Models on Google Cloud (Anthropic managed) 向けのリクエストを `--base-url` や `ANTHROPIC_BASE_URL` に送信しません。

## 機能のサポート

このセクションでは、Claude Models on Google Cloud (Anthropic managed) で動作する機能と、サポートされていない機能を示します。すべての Claude API 機能を網羅しているわけではなく、記載されていない機能が動作するかどうかについては言及していません。

次の機能は、Claude Models on Google Cloud (Anthropic managed) でも Claude API と同様に動作します。

* **Fast mode（高速モード）：** Claude Opus 5.5向けの[Fast mode](https://platform.claude.com/docs/ja/build-with-claude/fast-mode)。

- **ベータ機能:** Claude API でベータ版が選択された組織に限定されている場合、セットアップによって作成された Anthropic 組織にも同じアクセス権が必要です。

- **ツール:** [ツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/overview)。次のものを含みます。

  * Web 検索
  * Web フェッチ
  * コード実行
  * メモリツール
  * アドバイザーツール
  * MCP コネクター

- **スキルとファイル:** [Agent Skills](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview) と [Files API](https://platform.claude.com/docs/ja/build-with-claude/files)。

- **モデルの機能:**

  * [プロンプトキャッシング](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/build-with-claude/refusals-and-fallback#server-side-fallback)
  * [ストリーミング](https://platform.claude.com/docs/ja/build-with-claude/streaming)
  * [構造化出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs)
  * [トークンカウント](https://platform.claude.com/docs/ja/build-with-claude/token-counting)

- **バッチとモデル:** [Message Batches API](https://platform.claude.com/docs/ja/build-with-claude/batch-processing) と Models API。

セットアップによって作成された Anthropic 組織で [Compliance API](https://platform.claude.com/docs/ja/manage-claude/compliance-api) をオンまたはオフにするには、[Claude Console を開き](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console)、**Settings > Compliance** に移動して、**Compliance API** トグルを使用します。

「customer-managed encryption keys」（顧客管理の暗号鍵）、すなわち CMEK は、Google Cloud KMS キーで利用できます。セットアップによって作成された Anthropic 組織で CMEK を有効にするには、[顧客管理の暗号鍵](https://platform.claude.com/docs/ja/manage-claude/cmek)を参照してください。キーを設定するには、[CMEK 用に Google Cloud KMS を構成する](https://platform.claude.com/docs/ja/manage-claude/cmek-google-cloud-kms)に従ってください。その後、セットアップページの **Claude Console** タブの説明に従って、[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console) でキーを登録、検証、およびアタッチします。

### Claude Managed Agents

[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview) は、Claude Models on Google Cloud (Anthropic managed) を通じて利用でき、次のものが含まれます。

* [エージェント](https://platform.claude.com/docs/ja/managed-agents/agent-setup)
* [環境](https://platform.claude.com/docs/ja/managed-agents/environments)
* [セッション](https://platform.claude.com/docs/ja/managed-agents/sessions)
* [認証情報ボールト](https://platform.claude.com/docs/ja/managed-agents/vaults)
* [メモリストア](https://platform.claude.com/docs/ja/managed-agents/memory)
* [スケジュールされたデプロイメント](https://platform.claude.com/docs/ja/managed-agents/scheduled-deployments)
* [セルフホスト型サンドボックス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes)

アクセスは、セッションまたはデプロイメントの作成時にチェックされ、実行中にはチェックされません。

* **実行中のセッションは実行を続けます。** セッションを作成した ID から Google Cloud のアクセス権を取り消しても、セッションは停止しません。停止するには、[`user.interrupt` イベント](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming#integrating-events)を単独で送信します。セッションが `idle` になった後、アーカイブまたは削除できます。
* **スケジュールされたデプロイメントは実行を続けます。** デプロイメントは、スケジュールされた実行ごとに作成者のアクセス権を再チェックしません。停止するには、一時停止、更新、またはアーカイブします。

ユーザーを削除したり、サービスアカウントをローテーションしたりする場合は、その ID が作成したセッションとデプロイメントを確認してください。

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

次のものは、Claude Models on Google Cloud (Anthropic managed) ではサポートされていません。

* **APIキー:** 認証は Google Cloud の認証情報のみで行われます。
* **MCPトンネル:** [MCPトンネル](https://platform.claude.com/docs/ja/agents-and-tools/mcp-tunnels/overview)は Claude Models on Google Cloud (Anthropic managed) では利用できません。
* **[セルフホスト環境上のメモリストア](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory):** セルフホスト環境上のセッションでは、メモリストアはサポートされていません。
* **構築済みのセルフホスト型サンドボックスワーカー:** `ant` CLI および Python、TypeScript、Go SDK の[セルフホスト型ワーカー](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-workers)は、Claude Models on Google Cloud (Anthropic managed) をサポートしていません。代わりに、[Environments Work エンドポイント](https://platform.claude.com/docs/ja/api/beta/environments/work)を直接呼び出す独自のワーカーを実装してください。ワーカーに必要なロールと権限については、[環境の IAM 権限](https://platform.claude.com/docs/ja/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions#environments)を参照してください。

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

Claude Models on Google Cloud (Anthropic managed) のコンテキストウィンドウのサイズは、Claude API と同じです。各モデルの上限については、[コンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows)を参照してください。

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

### レート制限

Claude Models on Google Cloud (Anthropic managed) のレート制限は Anthropic が管理します。より高い制限をリクエストするには、Anthropic のアカウント担当者にお問い合わせいただくか、[営業担当にお問い合わせ](https://claude.com/contact-sales)ください。レート制限の測定方法と報告方法については、[レート制限](https://platform.claude.com/docs/ja/api/rate-limits)を参照してください。

### 請求

Claude Models on Google Cloud (Anthropic managed) は、Google Cloud Marketplace を通じて請求されます。Anthropic が使用量を計測します。使用量は Claude Consumption Units で Google Cloud に報告されます。料金は Google Cloud の請求書に表示されます。Anthropic から別途請求書が送付されることはありません。

使用量とコストのデータは、[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#using-the-claude-console) の **Usage** ページと **Cost** ページで確認できます。

Google Cloud の支出コミットメントがある場合、使用量は他の Marketplace での購入と同様にそのコミットメントに計上されます。

### データ保持

Claude Models on Google Cloud (Anthropic managed) のデータ処理者は Anthropic です。Anthropic の信頼性と安全性のシステムなど、一部のサポートサービスは Google Cloud の外部でデータを処理します。

Claude Models on Google Cloud (Anthropic managed) は、Claude API と同じデータ保持ポリシーに従います。[API とデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention)を参照してください。「Zero Data Retention」（ゼロデータ保持）、すなわち ZDR はリクエストに応じて利用できます。Anthropic のアカウント担当者にお問い合わせください。

別の Anthropic 組織での ZDR の取り決めは、Claude Models on Google Cloud (Anthropic managed) 用の組織には引き継がれません。

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

[Cloud Audit Logs](https://cloud.google.com/logging/docs/audit) は、プロジェクト内の Claude Models on Google Cloud (Anthropic managed) の API アクティビティを記録します。エントリは `claude.googleapis.com` サービスの下に表示されます。各 API ルートは、2 つのログタイプのいずれかに属します。

* **データアクセスログ:** メッセージ、バッチ、ファイル、スキル、モデル、およびほとんどの Claude Managed Agents リソースを含む、ほとんどのルートを対象とします。デフォルトではオフです。
* **管理アクティビティログ:** 暗号鍵のルートやほとんどの認証情報ボールトのルートを含む、その他のルートを対象とします。例外は `vaults.verify` のルートで、これはデータアクセスです。管理アクティビティログは常にオンです。

リクエストの記録を保持するには、プロジェクトの監査ログ設定で `claude.googleapis.com` のデータアクセスログをオンにしてください。

ルートごとの監査ログの種類については、[Claude Models on Google Cloud (Anthropic managed) の IAM 権限](https://platform.claude.com/docs/ja/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions)を参照してください。

#### リクエスト ID

Claude Models on Google Cloud (Anthropic managed) からの成功したレスポンスには、[`request-id`](https://platform.claude.com/docs/ja/api/errors#request-id) ヘッダーが含まれます。

## 既存の Anthropic 組織からの移行

既存の Anthropic 組織を Claude Models on Google Cloud (Anthropic managed) 用の組織に変換することはできません。Claude API で直接使用している組織も同様です。

移行は、新しい組織への切り替えとして計画してください。

* **最初に新しい組織を作成します。** [アカウントを設定する](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)に従ってください。
* **アクセスと構成を再作成します。** APIキー、ワークスペース、および Claude Console の設定は引き継がれません。APIキーを作成する代わりに、プロジェクトで [IAM ロール](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#iam-roles)を付与してください。ワークスペースを再作成するには、[ワークスペース](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#workspaces)を参照してください。ZDR の取り決めについては、[データ保持](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#data-retention)を参照してください。
* **保存されたリソースについて計画します。** ファイル、スキル、バッチ、および Claude Managed Agents リソースは既存の組織に残ります。
* **統合を更新します。** 変更される点と変わらない点については、[リクエストを行う](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#making-requests)を参照してください。サポートされていない機能については、[サポートされていない機能](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#features-not-supported)を参照してください。
* **独自のスケジュールで切り替えます。** 2 つの組織は独立しており、並行してトラフィックを処理できます。ワークロードを段階的に移行できます。既存の組織は現在の請求方法を維持します。本番トラフィックを移行する前に、[レート制限](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#rate-limits)を確認してください。

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

Claude Models on Google Cloud (Anthropic managed) に移行するには、以下の手順を完了してください。ZDR の取り決めに依存するワークロードを移行する前に、[データ保持](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#data-retention)を参照してください。移行時に何が変わるかについては、[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)を参照してください。

<Steps>
  <Step title="アカウントを設定する">
    [アカウントを設定する](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#set-up-your-account)のすべての手順を完了してください。
  </Step>

  <Step title="アクセスを設定する">
    Claude Models on Google Cloud (Anthropic managed) を呼び出す各 ID に `roles/claude.user` を付与します。プロジェクトとワークスペース ID を環境変数として設定します。どちらについても、[API 呼び出しを行う前に](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#before-making-api-calls)を参照してください。
  </Step>

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

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

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

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

    次のコードは 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>

    新しいクライアントは、[ワークスペース ID を確認する](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#find-your-workspace-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/anthropic-managed#api-model-ids)を参照してください。
    * **機能：** コードで使用している各機能について、[機能サポート](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#feature-support)を確認してください。
    * **ロケーション：** 現在マルチリージョンまたはリージョンエンドポイントを使用している場合は、Claude Models on Google Cloud (Anthropic managed) がどのロケーションを使用するかを確認してください。[プロジェクト、ロケーション、ワークスペースの解決](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#project-location-and-workspace-resolution)を参照してください。
  </Step>

  <Step title="テストリクエストを実行する">
    [リクエストの送信](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#making-requests)のリクエストを実行して、セットアップが機能することを確認します。その後、独自のコードを実行します。呼び出しが権限エラーで失敗する場合は、[アカウント設定のトラブルシューティング](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-managed#troubleshooting-account-setup)を参照してください。本番トラフィックを移行する前に、[レート制限](https://platform.claude.com/docs/ja/build-with-claude/claude-models-on-google-cloud/anthropic-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="IAM 権限" icon="lock" href="https://platform.claude.com/docs/ja/api/claude-models-on-google-cloud-anthropic-managed-iam-permissions">
    権限、ロール、監査ログの種類を調べます。
  </Card>

  <Card title="モデルの非推奨化" icon="arrow-clockwise" href="https://platform.claude.com/docs/ja/about-claude/model-deprecations">
    より安全で高性能なモデルのリリースに伴い、Anthropic は古いモデルを定期的に廃止しています。すべての API の非推奨化と推奨される代替モデルを確認できます。
  </Card>

  <Card title="Google Cloud Marketplace" icon="coins" href="https://console.cloud.google.com/marketplace">
    サブスクリプションと請求を管理します。
  </Card>
</CardGroup>
