Google Cloud上のClaude

Google Cloud's Agent Platform上のClaudeにアクセスするためのAPIは、Messages APIとほぼ同じですが、リクエスト形式に2つの重要な違いがあります。

• Agent Platformでは、modelはリクエストボディで渡されません。代わりに、Google CloudのエンドポイントURLで指定されます。
• Agent Platformでは、anthropic_versionは（ヘッダーとしてではなく）リクエストボディで渡され、値vertex-2023-10-16に設定する必要があります。

Agent Platformは、Anthropicの公式クライアントSDKでもサポートされています。このガイドでは、AnthropicのクライアントSDKのいずれかを使用して、Agent Platform上のClaudeにリクエストを行う手順を説明します。

なお、このガイドは、Agent Platformを使用できるGoogle Cloudプロジェクトをすでにお持ちであることを前提としています。必要なセットアップの詳細と完全な手順については、Agent Platform上のAnthropic Claudeモデルを参照してください。

Agent PlatformにアクセスするためのSDKをインストールする

まず、お好みの言語向けのAnthropicのクライアントSDKをインストールします。

pip install -U "anthropic[vertex]"

Agent Platformへのアクセス

モデルの提供状況

Anthropicモデルの提供状況はリージョンによって異なることに注意してください。最新情報については、Model Gardenで「Claude」を検索するか、Anthropic Claudeモデルを参照してください。

APIモデルID

ライフサイクル用語（非推奨、廃止済み）はモデルの非推奨化で定義されています。パートナーが運営するプラットフォームにおけるライフサイクルの日付はパートナーによって設定され、Claude APIのスケジュールとは異なる場合があります。Agent Platform上の各モデルの現在の廃止日については、Agent Platform上のClaudeモデルに関するGoogle Cloudのドキュメントを参照してください。

リクエストの実行

リクエストを実行する前に、Google Cloudで認証するためにgcloud auth application-default loginを実行する必要がある場合があります。

以下の例は、Agent Platform上のClaudeからテキストを生成する方法を示しています。

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

詳細については、クライアントSDKおよび公式のAgent Platformドキュメントを参照してください。

Claudeは、Amazon Bedrock、Claude Platform on AWS、およびMicrosoft Foundryを通じても利用できます。

データ保持

この提供サービスにおけるデータの取り扱いはGoogle Cloudによって管理されます。詳細については、Agent Platformとゼロデータ保持を参照してください。

アクティビティログ

Agent Platformは、使用に関連するプロンプトと補完をログに記録できるリクエスト・レスポンスログサービスを提供しています。

Anthropicは、アクティビティを把握し、潜在的な不正使用を調査するために、少なくとも30日間のローリングベースでアクティビティをログに記録することを推奨します。

機能サポート

Google Cloudでの提供状況を含む完全な機能一覧については、機能概要を参照してください。

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

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

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

• 入力ソース（画像およびドキュメントのURLソース、Files API）
• サーバーサイドツール（コード実行、Webフェッチ、アドバイザー）
• エージェントインフラストラクチャ（Agent Skills、MCPコネクタ、プログラムによるツール呼び出し）
• APIエンドポイント（Message Batches、Models、Admin、Compliance、Usage and Cost）
• Claude Managed Agents
• サーバーサイドフォールバック（fallbacksパラメータ。代わりにクライアントサイドフォールバックパターンを使用してください）

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

Claude Fable 5.1、Claude Fable 5、Claude Opus 5、Claude Opus 4.8、Claude Opus 4.7、Claude Opus 4.6、Claude Sonnet 5、およびClaude Sonnet 4.6は、Agent Platform上で100万トークンの「context window」（コンテキストウィンドウ）を備えています。Sonnet 4.5およびSonnet 4（非推奨）を含むその他のClaudeモデルは、20万トークンのコンテキストウィンドウを備えています。

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

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

Agent Platformは3種類のエンドポイントを提供しています。

• グローバルエンドポイント： 最大限の可用性を実現する動的ルーティング
• マルチリージョンエンドポイント： 高可用性を備えたデータレジデンシーのための、地理的エリア内（例：米国または欧州連合）での動的ルーティング
• リージョナルエンドポイント： 特定の地理的リージョンを経由するデータルーティングの保証

リージョナルエンドポイントおよびマルチリージョンエンドポイントには、グローバルエンドポイントに対して10%の価格プレミアムが含まれます。

各オプションを使用する場面

グローバルエンドポイント（推奨）：

• 最大限の可用性と稼働時間を提供
• 利用可能なキャパシティのあるリージョンにリクエストを動的にルーティング
• 価格プレミアムなし
• データレジデンシーに柔軟性があるアプリケーションに最適
• 従量課金トラフィックのみをサポート（プロビジョンドスループットにはリージョナルエンドポイントが必要）

マルチリージョンエンドポイント：

• 地理的エリア内（現在はusおよびeu）のリージョン間でリクエストを動的にルーティング
• 広範な地域内でのデータレジデンシーが必要だが、単一リージョンよりも高い可用性を求める場合に有用
• グローバルエンドポイントに対して10%の価格プレミアム
• 従量課金トラフィックのみをサポート（プロビジョンドスループットにはリージョナルエンドポイントが必要）

リージョナルエンドポイント：

• 特定の地理的リージョンを経由してトラフィックをルーティング
• 単一リージョンのデータレジデンシー、厳格なコンプライアンス要件、またはプロビジョンドスループットに必要
• 従量課金とプロビジョンドスループットの両方をサポート
• 10%の価格プレミアムは、専用のリージョナルキャパシティのインフラストラクチャコストを反映

実装

グローバルエンドポイントの使用（推奨）：

クライアントを初期化する際に、regionパラメータを"global"に設定します。

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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

マルチリージョンエンドポイントの使用：

regionパラメータをマルチリージョン識別子に設定します。米国の場合は"us"、欧州連合の場合は"eu"です。SDKはリクエストを対応するマルチリージョンエンドポイント（https://aiplatform.us.rep.googleapis.comまたはhttps://aiplatform.eu.rep.googleapis.com）にルーティングし、そのエンドポイントが当該地域内のリージョン間でトラフィックを動的に分散します。

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)

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

リージョナルエンドポイントの使用：

"us-east5"や"europe-west1"などの特定のリージョンを指定します。

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "us-east5"  # Specify a specific region

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

message = client.messages.create(
    # 特定のリージョンエンドポイントはClaude Sonnet 4.6以前をサポートします。新しいモデルはグローバルまたはマルチリージョンエンドポイントを使用します
    model="claude-sonnet-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

追加リソース

• Agent Platformの価格： cloud.google.comの生成AI価格
• Claudeモデルのドキュメント： Agent Platform上のClaude
• Googleブログ記事： Claudeモデル向けグローバルエンドポイント
• Anthropicの価格詳細： クラウドプラットフォームの価格