Claude Models on Google Cloud (Google managed)

Claude Models on Google Cloudでは、2つのGoogle Cloudの提供形態を比較しています。また、どちらを使用しているかを確認する方法も示しています。

API呼び出しを行う前に

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

1. Agent Platformを使用できるGoogle Cloudプロジェクト。セットアップ手順については、Google CloudのAnthropic Claude models on Agent Platformページを参照してください。
2. ローカル開発用にインストールされたgcloud CLI。
3. 呼び出しを行うIDに対する、aiplatform.endpoints.predict権限を含むIAMロール（Agent Platform User（roles/aiplatform.user）など）。詳細については、Google CloudのAgent Platform 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は、AnthropicVertexを通じてClaude Models on Google Cloud (Google managed)をサポートしています。これを提供するパッケージをインストールしてください。

pip install -U "anthropic[vertex]"

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

リクエストの送信

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

リクエストはMessages APIのリクエストとほぼ同じです。主な違いは2点です。

• モデル： エンドポイントURLでモデルを指定します。cURLリクエストでは、本文からmodelを省略してください。
• バージョン： cURLリクエストでは、anthropic_versionをヘッダーではなく本文で渡します。値はvertex-2023-10-16、またはAPIバージョン2026-10-21に設定してください。

以下の例ではグローバルエンドポイントを使用しています。その他のエンドポイントタイプについては、グローバル、マルチリージョン、リージョナルエンドポイントを参照してください。

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)

APIモデルID

Claude Models on Google Cloud (Google managed)は、リージョンごとに異なるClaudeモデルを提供しています。リージョンで提供されているモデルを確認するには、Model Gardenで「Claude」を検索するか、Google CloudのAnthropic Claude models on Agent Platformページを参照してください。

Claude Models on Google Cloud (Google managed)が提供するモデルのライフサイクル日程はGoogleが設定します。これらの日程はClaude APIのスケジュールと異なる場合があります。モデルの現在の廃止日については、Google CloudのAnthropic Claude models on Agent Platformページを参照してください。非推奨（Deprecated）と廃止済み（Retired）の意味については、モデルの非推奨化を参照してください。

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

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

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

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

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

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

以下の例ではusマルチリージョンエンドポイントを使用しています。ハイライトされた行でリージョンを設定しています。グローバルエンドポイントでの完全なリクエストについては、リクエストの送信を参照してください。

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)

機能のサポート

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

• Messages API
• プロンプトキャッシング
• 思考
• ツール使用（以下のツールを含む）：
  • Bashツール
  • ブラウザ使用ツール
  • コンピュータ使用ツール
  • メモリツール
  • テキストエディタツール
  • Web検索ツール
• 引用
• 構造化出力

機能の概要には、すべての機能と、それぞれを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パラメータ

サーバーサイドフォールバックの代わりに、クライアントサイドフォールバックパターンを使用してください。

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

Claude Models on Google Cloud (Google managed)は、以下のモデルで100万トークンのコンテキストウィンドウを提供しています。

• 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ページを参照してください。

請求

Claude Models on Google Cloud (Google managed)の請求はGoogle Cloudが行います。料金については、Google CloudのGenerative AI pricingページを参照してください。料金はエンドポイントタイプによっても異なります。グローバル、マルチリージョン、リージョナルエンドポイントを参照してください。

データ保持

Claude Models on Google Cloud (Google managed)のデータの取り扱いはGoogle Cloudが管理します。詳細については、Agent Platform and zero data retentionを参照してください。

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

Claude Models on Google Cloud (Google managed)のプロンプトと補完をログに記録するには、Agent Platformのリクエスト・レスポンスログ記録サービスを使用してください。

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

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

移行時に何が変わるかについては、2つのGoogle Cloudの提供形態の違いを参照してください。Claude Models on Google Cloud (Google managed)に移行するには、以下の手順に従ってください。

1. 1

   アクセスを設定する

   プロジェクトと呼び出しを行うIDが、API呼び出しを行う前にの要件を満たしていることを確認してください。

2. 2

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

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

3. 3

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

   クライアントをインポートして作成するコードを変更します。AnthropicGoogleCloudの代わりにAnthropicVertexを使用してください。cURLリクエストでは、新しいURL、新しいヘッダー、新しい本文が必要です。以下のコードは、現在使用しているClaude Models on Google Cloud (Anthropic managed)用のクライアントを作成します。

   cURLCLIPythonTypeScriptC#GoJavaPHPRuby

   Python

   

   from anthropic import AnthropicGoogleCloud
   
   client = AnthropicGoogleCloud()

   以下のコードは、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)

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

4. 4

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

   • モデルID： Claude 4.6より前のモデルを使用している場合は、ID内のスナップショット日付の前にあるハイフンを@に置き換えてください。たとえば、claude-haiku-4-5-20251001はclaude-haiku-4-5@20251001になります。モデルとそのIDについては、APIモデルIDを参照してください。
   • 機能： コードで使用している機能がサポートされていない機能に記載されていないことを確認してください。
5. 5

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

   リクエストの送信のリクエストを実行して、セットアップが機能することを確認してください。その後、ご自身のコードを実行してください。本番トラフィックを移行する前に、Claude Models on Google Cloud (Google managed)のレート制限についてお読みください。

次のステップ