Google Cloud 上的 Claude

在 Google Cloud's Agent Platform 上存取 Claude 的 API 與 Messages API 幾乎完全相同，僅在請求格式上有兩個主要差異：

• 在 Agent Platform 上，model 不會在請求主體中傳遞，而是在 Google Cloud 端點 URL 中指定。
• 在 Agent Platform 上，anthropic_version 是在請求主體中傳遞（而非作為標頭），且必須設定為 vertex-2023-10-16 這個值。

Anthropic 官方的用戶端 SDK 也支援 Agent Platform。本指南將引導您使用 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

生命週期術語（Deprecated「已棄用」、Retired「已淘汰」）的定義請參閱模型棄用。合作夥伴營運平台上的生命週期日期由合作夥伴設定，可能與 Claude API 的時程不同。如需查詢 Agent Platform 上任何模型目前的淘汰日期，請參閱 Google Cloud 關於 Agent Platform 上 Claude 模型的文件。

發出請求

在執行請求之前，您可能需要先執行 gcloud auth application-default login 以向 Google Cloud 進行驗證。

以下範例說明如何透過 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-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
• 提示快取（Prompt caching）
• 思考（Thinking）
• 工具使用（Tool use），包括 Bash 工具、瀏覽器使用工具、電腦使用工具、記憶工具以及文字編輯器工具
• 網頁搜尋工具
• 引用（Citations）
• 結構化輸出（Structured outputs）

不支援的功能

• 輸入來源（圖片與文件的 URL 來源、Files API）
• 伺服器端工具（程式碼執行、網頁擷取、advisor）
• 代理基礎設施（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.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 上具有 1M token 的「context window」（上下文視窗）。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已棄用），則具有 200k token 的上下文視窗。

Agent Platform 將請求負載限制為 30 MB。當傳送大型文件或大量圖片時，您可能會在達到 token 限制之前先達到此限制。

全球、多區域與區域端點

Agent Platform 提供三種端點類型：

• 全球端點： 動態路由以達到最高可用性
• 多區域端點： 在某一地理範圍內（例如美國或歐盟）進行動態路由，兼顧資料落地與高可用性
• 區域端點： 保證資料經由特定地理區域路由

區域端點與多區域端點的定價比全球端點高出 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-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-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 定價詳情： 雲端平台定價