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ツール、コンピュータ使用ツール、メモリツール、テキストエディタツールを含む）
• ウェブ検索ツール
• 引用
• 構造化出力



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

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



コンテキストウィンドウ

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万トークンのコンテキストウィンドウを備えています。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の価格詳細： クラウドプラットフォームの価格