Claude Models on Google Cloud (Anthropic managed)

Claude Models on Google Cloud (Anthropic managed) のアクセスと請求は Google Cloud が処理します。2 つの Google Cloud の提供形態を比較する場合や、どちらを使用しているかを確認する場合は、Claude Models on Google Cloud を参照してください。

アカウントを設定する

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

• 請求先アカウントで Google Cloud Marketplace から購入する権限
• プロジェクトでサービスを有効にする権限
• ステップ 4 で必要となる、Claude Console を開くことができる IAM ロール

これらの手順により、Google Cloud プロジェクト用の新しい Anthropic 組織が作成されます。これは、会社がすでに持っている Anthropic 組織とは別のものです。Claude Enterprise 組織も同様です。既存の組織から移行する場合は、既存の Anthropic 組織からの移行を参照してください。

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

1. 1

   Marketplace でサブスクライブする

   1. Google Cloud 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 を選択します。

2. 2

   サービスを有効にする

   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 サービスです。

   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 を実行し、両方の名前を探します。

3. 3

   Anthropic 組織を設定する

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

   連絡先アドレスは、セットアップとサービスに関するお知らせにのみ使用されます。セットアップ後にユーザーが Claude Console を開く方法については、Claude Console の使用を参照してください。

4. 4

   Claude Console を開く

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

   Claude Console にいる間に、ワークスペース ID を見つけてコピーしてください。Claude Models on Google Cloud (Anthropic managed) を呼び出すすべての人がこれを必要とします。開発者に共有してください。

別のプロジェクトを追加するには、そのプロジェクトでステップ 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 ロールを参照してください。新しい付与や新たに有効にしたサービスが反映されるまでには少し時間がかかる場合があります。
• セットアップリンクを開いた後に「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 ロールがあります。ロールはプロジェクトに対して付与します。

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

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 権限を参照してください。

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

Claude Console の使用

Claude Models on Google Cloud (Anthropic managed) では、メールアドレスを使用して Anthropic 組織にサインインすることはできません。代わりに、Google Cloud コンソールの Claude ページで Open Claude Console を選択します。Claude Console を開くことができるユーザーは Google Cloud IAM によって制御されます。3 つの事前定義された IAM ロールのうち、Claude Console を開くことができるのは、プロジェクトに対する roles/claude.admin のみです。

ワークスペース

Claude Models on Google Cloud (Anthropic managed) では、セットアップによって 1 つのワークスペース (Default Workspace) を持つ Anthropic 組織が作成されます。さらにワークスペースを作成するには、Claude Console を開き、Settings > Workspaces に移動します。同じページで、Default Workspace 以外の任意のワークスペースの名前を変更したり、アーカイブしたりできます。各ワークスペースには独自のワークスペース ID があります。ファイル、スキル、バッチ、Claude Managed Agents セッション、およびその他のワークスペースリソースは、リクエストに設定した ID のワークスペースに属します。

IAM ロールはプロジェクトに対して付与するため、ロールはそのプロジェクト内のすべてのワークスペースに適用されます。チームごとに個別のアクセスが必要な場合は、各チームに独自の Google Cloud プロジェクトを割り当ててください。各プロジェクトには独自の Anthropic 組織があるため、各プロジェクトでステップ 2 からセットアップ手順を繰り返してください。

API 呼び出しを行う前に

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

1. 有効なサブスクリプションと、セットアップが完了した Anthropic 組織を持つ Google Cloud プロジェクト。アカウントを設定するを参照してください。
2. ローカル開発用にインストールされた gcloud CLI。
3. 呼び出しを行う ID に対してプロジェクトで付与された roles/claude.user ロール。
4. その ID の Application Default Credentials。認証を参照してください。
5. プロジェクト ID とワークスペース ID。

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

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 ロールを参照してください。

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

Claude Models on Google Cloud (Anthropic managed) のワークスペース ID を見つけるには、Claude Console を開き、Settings > Workspaces に移動します。ID は wrkspc_ で始まります。Claude Console を開けない場合は、開くことができる人に ID を送ってもらうよう依頼してください。

SDK クライアントと ant 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 クライアントは AnthropicGoogleCloud です。クライアントは Google の認証情報を解決します。また、プロジェクト、ロケーション、およびワークスペース ID からベース URL を構築します。

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

pip install -U "anthropic[google_cloud]"

代わりに ant CLI を使用する場合は、最新バージョンにインストールまたは更新してください。Claude Models on Google Cloud (Anthropic managed) をサポートしていないバージョンは、ANTHROPIC_GOOGLE_CLOUD_* 変数を無視します。その場合、次のいずれかの動作になります。

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

リクエストを行う

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

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

パスが /v1/organizations/ で始まる組織レベルのルートは、ワークスペースを含まないベース URL を使用します。

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

ベース URL を設定しない場合、SDK クライアントはリクエストごとにこれら 2 つのいずれかを選択します。

ベース URL に Claude API のパスを追加します。たとえば、Messages API は .../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 呼び出しを行う前にの手順を完了してください。

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)

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

API モデル ID

Claude Models on Google Cloud (Anthropic managed) は、Claude API と同じモデル ID (たとえば claude-opus-5-5) を使用します。モデルとその ID については、モデルの概要を参照してください。

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 と workspace_id を渡します。

ロケーションは global のままにしてください。ロケーションは推論が実行される場所とは別のものです。そのため、米国内のみでの推論を行うには、データレジデンシーで説明されているように、各リクエストで 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 ロールを参照してください。

SDK クライアントは、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 が機能していることを確認します。

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 として渡すトークンプロバイダー。これはアクセストークンを返す関数またはトークンソースです。クライアントはリクエストごとにトークンを要求します。トークンのキャッシュと更新はユーザー側で行う必要があります。
2. クライアント作成時に credentials として渡す Google 認証情報オブジェクト。Go SDK にはこのオプションはありません。
3. Application Default Credentials。

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

• Go: オプション 1 では、クライアントは oauth2.TokenSource を受け取ります。トークンの有効期限が切れるまでトークンをキャッシュします。
• Java: GoogleCloudBackend.fromEnv() を使用して、Application Default Credentials とプロジェクト、ロケーション、およびワークスペースの解決の環境変数を読み取ります。

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

リクエストがトークンを付加するプロキシを経由する場合は、skip_auth を設定します。これにより、クライアントは 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 が認証に使用できる構成プロファイルを指定している場合の --profile または ANTHROPIC_PROFILE
• Anthropic のフェデレーション変数のいずれか:
  • ANTHROPIC_FEDERATION_RULE_ID
  • ANTHROPIC_ORGANIZATION_ID
  • ANTHROPIC_SERVICE_ACCOUNT_ID
  • ANTHROPIC_IDENTITY_TOKEN
  • ANTHROPIC_IDENTITY_TOKEN_FILE

いずれかが設定されている場合、CLI はワークスペース 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。

• ベータ機能: Claude API でベータ版が選択された組織に限定されている場合、セットアップによって作成された Anthropic 組織にも同じアクセス権が必要です。
• ツール: ツール使用。次のものを含みます。
  • Web 検索
  • Web フェッチ
  • コード実行
  • メモリツール
  • アドバイザーツール
  • MCP コネクター
• スキルとファイル: Agent Skills と Files API。
• モデルの機能:
  • プロンプトキャッシング
  • 拡張思考
  • サーバーサイドフォールバック
  • ストリーミング
  • 構造化出力
  • トークンカウント
• バッチとモデル: Message Batches API と Models API。

セットアップによって作成された Anthropic 組織で Compliance API をオンまたはオフにするには、Claude Console を開き、Settings > Compliance に移動して、Compliance API トグルを使用します。

「customer-managed encryption keys」（顧客管理の暗号鍵）、すなわち CMEK は、Google Cloud KMS キーで利用できます。セットアップによって作成された Anthropic 組織で CMEK を有効にするには、顧客管理の暗号鍵を参照してください。キーを設定するには、CMEK 用に Google Cloud KMS を構成するに従ってください。その後、セットアップページの Claude Console タブの説明に従って、Claude Console でキーを登録、検証、およびアタッチします。

Claude Managed Agents

Claude Managed Agents は、Claude Models on Google Cloud (Anthropic managed) を通じて利用でき、次のものが含まれます。

• エージェント
• 環境
• セッション
• 認証情報ボールト
• メモリストア
• スケジュールされたデプロイメント
• セルフホスト型サンドボックス

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

• 実行中のセッションは実行を続けます。 セッションを作成した ID から Google Cloud のアクセス権を取り消しても、セッションは停止しません。停止するには、user.interrupt イベントを単独で送信します。セッションが idle になった後、アーカイブまたは削除できます。
• スケジュールされたデプロイメントは実行を続けます。 デプロイメントは、スケジュールされた実行ごとに作成者のアクセス権を再チェックしません。停止するには、一時停止、更新、またはアーカイブします。

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

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

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

• APIキー: 認証は Google Cloud の認証情報のみで行われます。
• MCPトンネル: MCPトンネルは Claude Models on Google Cloud (Anthropic managed) では利用できません。
• セルフホスト環境上のメモリストア: セルフホスト環境上のセッションでは、メモリストアはサポートされていません。
• 構築済みのセルフホスト型サンドボックスワーカー: ant CLI および Python、TypeScript、Go SDK のセルフホスト型ワーカーは、Claude Models on Google Cloud (Anthropic managed) をサポートしていません。代わりに、Environments Work エンドポイントを直接呼び出す独自のワーカーを実装してください。ワーカーに必要なロールと権限については、環境の IAM 権限を参照してください。

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

Claude Models on Google Cloud (Anthropic managed) のコンテキストウィンドウのサイズは、Claude API と同じです。各モデルの上限については、コンテキストウィンドウを参照してください。

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

レート制限

Claude Models on Google Cloud (Anthropic managed) のレート制限は Anthropic が管理します。より高い制限をリクエストするには、Anthropic のアカウント担当者にお問い合わせいただくか、営業担当にお問い合わせください。レート制限の測定方法と報告方法については、レート制限を参照してください。

請求

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

使用量とコストのデータは、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 とデータ保持を参照してください。「Zero Data Retention」（ゼロデータ保持）、すなわち ZDR はリクエストに応じて利用できます。Anthropic のアカウント担当者にお問い合わせください。

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

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

Cloud Audit Logs は、プロジェクト内の 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 権限を参照してください。

リクエスト ID

Claude Models on Google Cloud (Anthropic managed) からの成功したレスポンスには、request-id ヘッダーが含まれます。

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

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

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

• 最初に新しい組織を作成します。 アカウントを設定するに従ってください。
• アクセスと構成を再作成します。 APIキー、ワークスペース、および Claude Console の設定は引き継がれません。APIキーを作成する代わりに、プロジェクトで IAM ロールを付与してください。ワークスペースを再作成するには、ワークスペースを参照してください。ZDR の取り決めについては、データ保持を参照してください。
• 保存されたリソースについて計画します。 ファイル、スキル、バッチ、および Claude Managed Agents リソースは既存の組織に残ります。
• 統合を更新します。 変更される点と変わらない点については、リクエストを行うを参照してください。サポートされていない機能については、サポートされていない機能を参照してください。
• 独自のスケジュールで切り替えます。 2 つの組織は独立しており、並行してトラフィックを処理できます。ワークロードを段階的に移行できます。既存の組織は現在の請求方法を維持します。本番トラフィックを移行する前に、レート制限を確認してください。

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

Claude Models on Google Cloud (Anthropic managed) に移行するには、以下の手順を完了してください。ZDR の取り決めに依存するワークロードを移行する前に、データ保持を参照してください。移行時に何が変わるかについては、2つの Google Cloud オファリングの違いを参照してください。

1. 1

   アカウントを設定する

   アカウントを設定するのすべての手順を完了してください。

2. 2

   アクセスを設定する

   Claude Models on Google Cloud (Anthropic managed) を呼び出す各 ID に roles/claude.user を付与します。プロジェクトとワークスペース ID を環境変数として設定します。どちらについても、API 呼び出しを行う前にを参照してください。

3. 3

   SDK パッケージをインストールする

   Claude Models on Google Cloud (Anthropic managed) 用のクライアントを提供するパッケージをインストールします。SDK をインストールするを参照してください。

4. 4

   インポートとクライアントを置き換える

   クライアントをインポートして作成するコードを変更します。AnthropicVertex の代わりに AnthropicGoogleCloud を使用します。cURL リクエストでは、URL、ヘッダー、本文を変更します。現在のコードは Claude Models on Google Cloud (Google managed) 用のクライアントを作成しています。たとえば、次のコードはグローバルエンドポイントでそのクライアントを作成します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicVertex
   
   project_id = "MY_PROJECT_ID"
   region = "global"
   
   client = AnthropicVertex(project_id=project_id, region=region)

   次のコードは Claude Models on Google Cloud (Anthropic managed) 用のクライアントを作成します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   新しいクライアントは、ワークスペース ID を確認するで設定した環境変数からプロジェクトとワークスペース ID を読み取ります。クライアントの作成時にこれらを渡す必要はありません。Messages API の呼び出しは、次の手順で説明するモデル ID と機能を除き、そのままで構いません。

5. 5

   モデル ID と機能を確認する

   • モデル ID： Claude 4.6 より前のモデルを使用している場合は、ID 内のスナップショット日付の前にある @ をハイフンに置き換えてください。たとえば、claude-haiku-4-5@20251001 は claude-haiku-4-5-20251001 になります。モデルとその ID については、API モデル IDを参照してください。
   • 機能： コードで使用している各機能について、機能サポートを確認してください。
   • ロケーション： 現在マルチリージョンまたはリージョンエンドポイントを使用している場合は、Claude Models on Google Cloud (Anthropic managed) がどのロケーションを使用するかを確認してください。プロジェクト、ロケーション、ワークスペースの解決を参照してください。
6. 6

   テストリクエストを実行する

   リクエストの送信のリクエストを実行して、セットアップが機能することを確認します。その後、独自のコードを実行します。呼び出しが権限エラーで失敗する場合は、アカウント設定のトラブルシューティングを参照してください。本番トラフィックを移行する前に、レート制限を確認してください。

次のステップ