在 Google Cloud 使用 Claude 模型 (Anthropic 代管)

Google Cloud 上的 Claude 模型 (Anthropic 代管) 服務可讓您在 Cloud de Confiance by S3NS使用 Anthropic 的 Claude 開發人員平台。您可以使用這個帳戶存取 Anthropic 的最新功能,包括新模型、研究預先發布版和 Claude Console。

本頁面涵蓋下列主題:

主要優點

在 Google Cloud 使用 Claude 模型 (Anthropic 代管) 的主要優點包括:

  • 搶先體驗最新技術:Anthropic 的最新模型、功能、研究預先發布版和 Beta 版一推出,即可立即體驗。
  • Cloud de Confiance by S3NS 帳單和身分整合:充分運用現有的Cloud de Confiance by S3NS 投資。這項服務與 Cloud Billing 和 Identity and Access Management 整合,並根據 Google Google Cloud Marketplace 承諾使用合約提取政策,從您的 Cloud de Confiance by S3NS 承諾使用合約中扣除費用。
  • 統一支援: Cloud de Confiance by S3NS 支援團隊會提供前線支援,協助解決 Agent Platform 相關問題,Anthropic 則會提供代管服務的專業後線支援。
  • Anthropic 的內建體驗:前往 Claude 控制台管理資源及探索新功能。

比較 Anthropic 代管和 Google 代管的 Claude 模型

Google Cloud 上的 Claude 模型 (由 Anthropic 管理) 和 Agent Platform 上的 Claude 模型 (由 Google 管理) 之間,差異在於堆疊、API 介面、功能可用性和資料處理者的營運者不同。

使用 Google Cloud 上的 Claude 模型 (Anthropic 代管) (claude.googleapis.com) 時,API 和基礎平台由 Anthropic 在其系統上管理,並受 Anthropic 商業服務條款規範,包括其中的資料處理條款,其中 Anthropic 為資料處理者。

如果您需要下列任一項目,請使用 Google 代管的 Claude 模型:

  • Google 營運的推論, Cloud de Confiance by S3NS 是唯一的資料處理者
  • 資料和推論結果會保留在 Cloud de Confiance by S3NS的安全邊界內 (使用 VPC Service Controls、客戶自行管理的加密金鑰和區域資料落地)
  • Cloud de Confiance by S3NS 法規遵循計畫涵蓋範圍 (包括 FedRAMP 高影響等級、IL4、IL5、SOC、ISO 和《健康保險流通與責任法案》資格)
  • 內建 Cloud de Confiance by S3NS 配額和計費
  • 內建與 BigQuery、Model Armor 和 Agent Engine 等 Cloud de Confiance by S3NS 服務整合的功能。

功能比較概要

下表列出 Anthropic 代管和 Google 代管 Claude 模型的主要差異:

模型類型 Anthropic 代管 Google 代管
堆疊操作者 Anthropic Google
API 介面 /v1/messages使用claude.googleapis.com Agent Platform 預測端點:/v1/messages
功能適用情況 旨在與第一方 Claude API 保持一致 依 Agent Platform 和 Model Garden 發布時間表
Beta 版功能 使用 anthropic-beta 標頭傳遞 anthropic-beta 標頭支援情形因 Model Garden 版本而異
驗證 Cloud de Confiance by S3NS IAM。應用程式預設憑證、服務帳戶或 gcloud auth print-access-token。沒有x-api-key Cloud de Confiance by S3NS IAM (相同憑證模型)
帳單 Google Cloud Marketplace (以 CCU 為單位) Cloud de Confiance by S3NS (Agent Platform 計費)
基準網址 claude.googleapis.com REGION-aiplatform.googleapis.com
SDK 用戶端 平台專屬用戶端類別 (AnthropicGoogleCloud) Agent Platform 用戶端
控制台 Cloud de Confiance 控制台,用於 IAM、指標和監控,以及 Claude 控制台 (platform.claude.com,透過 Cloud de Confiance by S3NS存取) Cloud de Confiance 控制台 (Agent Platform 和 Model Garden)
頻率限制和配額 您可以直接透過控制台提交配額要求,但頻率限制和配額是由 Anthropic 管理 由 Cloud de Confiance by S3NS 管理(Agent Platform 配額)

比較支援的 API 功能

下表比較 Anthropic 代管和 Google 代管 Claude 模型的各種 API 功能支援等級:

功能 說明 Anthropic 代管 Google 代管
思考 (延伸、適應性) 先推論問題再回答,提高複雜工作的準確度。
提示快取 (自動和明確) 重複使用提示內容,不必重新處理,可降低成本和延遲時間。自動套用或選擇要快取的內容。
任務預算 (Beta 版) 為 Claude 設定工作權杖配額,控管長時間執行代理的支出。Claude 能更妥善地安排工作優先順序並完成工作。
工具使用 (用戶端定義) 連結外部工具,呼叫客戶自己的函式、API 和系統。
參考資料 傳回支持每項論點的確切段落,以驗證答案並顯示來源。
100 萬個詞元的脈絡窗口、圖片/PDF (支援的模型) 每項要求最多可處理 100 萬個詞元,足以處理整個程式碼集或數百份文件。讀取圖片和 PDF。
提示快取 (五分鐘、一小時、自動) 定義快取內容的保留時間 (5 分鐘、1 小時),減少重複性工作的處理時間和費用。
結構化輸出內容 確保 Claude 的回覆一律符合指定的 JSON 結構定義或自訂工具定義,不會重試或發生剖析錯誤。
批次處理 一次提交多項要求,進行非同步處理。適合處理大量資料、追求成本效益,以及不需要立即回應的情況。 使用 Agent Platform 批次推論
服務級別 提供不同級別的服務,可根據應用程式的需求,兼顧可用性、效能和可預測的成本。 優先、標準、批次 佈建輸送量,批次
編輯脈絡 (Beta 版) 隨著對話記錄增加,清除特定內容可降低成本、避免超出限制,並協助代理保持專注及延長執行時間。
Anthropic 定義的工具
網頁搜尋 授予即時網路存取權,以便搜尋最新資訊。回覆會註明引用來源。
網頁擷取 授予即時網路存取權,從特定網頁和 PDF 擷取內容。
遠端 MCP (Beta 版) 直接透過 API,經由遠端 MCP 伺服器連結外部工具和資料。
記憶體 儲存及擷取對話資訊,讓代理逐步累積知識。
Files API 上傳及管理檔案一次,即可與 API 搭配使用,不必每次都重新傳送相同內容。
Computer Use 授予 Claude 桌面環境的螢幕截圖、滑鼠和鍵盤控制權,讓 Claude 自主互動。
技能 可重複使用的資源,能讓 Claude 具備特定領域的專業知識:工作流程、背景資訊和最佳做法,可將一般用途的代理轉變為專家。
執行程式碼 允許 Claude 在沙箱環境中編寫及執行程式碼,以便分析資料、生成檔案,以及反覆調整解決方案。
Managed Agents (Beta 版) 使用預先建構、可設定的代理駕馭系統,在代管基礎架構中執行。最適合長時間執行的工作和非同步作業。
顧問工具 (Beta 版) 讓速度更快、成本更低的執行模型 (Haiku、Sonnet) 在生成過程中,向更聰明的顧問模型 (Opus) 諮詢策略指引,然後再繼續執行工作。

開始使用

如要開始使用 Google Cloud (Anthropic 代管) 的 Claude 模型,請按照下列步驟為專案啟用 Google Cloud (Anthropic 代管) 的 Claude 模型:

  1. 前往 Cloud de Confiance 控制台的「Claude models」(Claude 模型) 頁面:

    開啟 Cloud de Confiance 控制台

  2. 在管理員選項清單中,選取「Anthropic managed」(Anthropic 代管)。

  3. 如果尚未為專案啟用 Claude API,請在「Enable the Claude API」(啟用 Claude API) 專區中,按一下「Enable API」(啟用 API),然後按照操作說明操作。

  4. 在「Purchase the product」(購買產品) 區段中,按一下「Purchase via Marketplace」(透過 Marketplace 購買)。系統會將您重新導向至 Marketplace 頁面。您可以選擇以定價購買產品,或透過議定折扣或私密優惠購買。成功購買產品後,請按一下「Manage on Console」(在控制台管理),返回 Model Garden 頁面。

  5. 在「Activate Claude Console」部分,按一下「Activate」,為 Cloud de Confiance by S3NS 專案佈建新的 Anthropic 組織。輸入一次性聯絡電子郵件地址,以便接收設定連結。接著,從該收件匣開啟連結,填寫機構詳細資料表單 (機構名稱、實體類型、國家/地區和預期用途),並接受 Anthropic 的《商業服務條款》和《使用政策》。請注意,這會建立獨立的 Anthropic 組織:現有第一方 Anthropic 組織的 API 金鑰、工作區、HIPAA 控制項、零資料保留 (ZDR) 和設定不會轉移。

在 Google Cloud 使用 Claude 模型 (Anthropic 代管)

啟用 Claude API 並購買產品後,即可透過 Claude Console 或 Claude API,在 Google Cloud (Anthropic 代管) 使用 Claude 模型。

Claude Console

如何使用 Claude Console:

  1. 授予 roles/claude.admin (Claude 平台管理員) 角色:如要使用 Claude 控制台,您必須先為專案授予 roles/claude.admin (Claude 平台管理員) Identity and Access Management (IAM) 角色。

  2. 前往 Cloud de Confiance 控制台的「Claude models on Google Cloud (Anthropic managed)」(Google Cloud 上的 Claude 模型 (Anthropic 代管)) 頁面:

    開啟 Cloud de Confiance 控制台

  3. 在「Activate Claude Console」(啟用 Claude Console) 部分,按一下「Open Claude Console」(開啟 Claude Console)。

Claude API

您可以使用標準 Cloud de Confiance by S3NS驗證,在 Google Cloud (Anthropic 代管) 與 Claude 模型互動。API 端點為 https://claude.googleapis.com/。

  1. 授予 roles/claude.user (Claude 平台使用者) 角色:如要發出 API 呼叫,您必須先為專案授予 roles/claude.user (Claude 平台使用者) Identity and Access Management (IAM) 角色。

  2. 使用 Cloud de Confiance by S3NS進行驗證:如果您使用用戶端程式庫或 Google Cloud CLI,系統會自動處理驗證。如果是直接呼叫 API,請確認您已通過驗證,且可取得 OAuth 2.0 權杖。您可以使用 Google Cloud CLI 取得權杖:

    gcloud auth print-access-token
    
  3. 呼叫 Messages API:API 結構與 Anthropic Messages API 相同。您可以使用 Anthropic 的 Cloud de Confiance by S3NS用戶端 SDK (AnthropicGoogleCloud) 提出要求,或直接向 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke/v1/messages 下的工作區範圍端點提出要求。

    以下是使用 curl 的範例:

    curl -X POST "https://claude.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/workspaces/${ANTHROPIC_WORKSPACE_ID}/invoke/v1/messages" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "anthropic-version: 2023-06-01" \
    -H "content-type: application/json" \
    -d '{
      "model": "claude-haiku-4-5",
      "max_tokens": 1024,
      "messages": [
        {"role": "user", "content": "Hello, Claude"}
      ]
    }'
    

API 參考資料

如需訊息、檔案和技能的詳細 API 參考資料,請參閱 Anthropic API 說明文件。

如要直接對工作區範圍的端點 (例如 /v1/messages、/v1/files 或 /v1/skills) 進行 REST 呼叫,請在 Anthropic API 路徑前使用 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke 做為基準網址 (例如 .../invoke/v1/files)。如果是組織層級的端點 (例如 /v1/organizations/workspaces),請使用 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/claudeOrganization/invoke 做為基準網址。