在 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

生命週期術語（已棄用、已停用）的定義請參閱模型棄用。合作夥伴營運平台上的生命週期日期由合作夥伴設定，可能與 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",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "Hey Claude!",
        }
    ],
)
print(message)

如需更多詳細資訊，請參閱用戶端 SDK 和官方 Agent Platform 文件。

Claude 也可透過 Amazon Bedrock、AWS 上的 Claude Platform 和 Microsoft Foundry 取得。



資料保留

此服務的資料處理由 Google Cloud 管理。如需詳細資訊，請參閱 Agent Platform 與零資料保留。



活動記錄

Agent Platform 提供請求-回應記錄服務，讓您可以記錄與您的使用情況相關的提示和完成內容。

Anthropic 建議您至少以 30 天滾動方式記錄您的活動，以便了解您的活動並調查任何潛在的濫用情況。



功能支援

如需完整的功能清單及其在 Google Cloud 上的可用性，請參閱功能總覽。



支援的功能重點

• Messages API
• 提示快取
• 思考
• 工具使用，包括 Bash 工具、電腦使用工具、記憶體工具和文字編輯器工具
• 網頁搜尋工具
• 引用
• 結構化輸出



不支援的功能

• 輸入來源（圖片和文件的 URL 來源、Files API）
• 伺服器端工具（程式碼執行、網頁擷取、advisor）
• 代理基礎架構（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 萬 token 的上下文視窗。其他 Claude 模型，包括 Sonnet 4.5 和 Sonnet 4（已棄用），則具有 20 萬 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",
    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 定價詳情： 雲端平台定價