您可以通过两种方式在您的 Google Cloud 项目中使用 Claude:
- Claude Models on Google Cloud (Anthropic managed): 由 Anthropic 运营 Claude API。
- Claude Models on Google Cloud (Google managed): 由 Google 将 Claude 模型作为 Google Cloud’s Agent Platform 的一部分进行运营。
两种 Google Cloud 产品的区别
下表比较了 Claude Models on Google Cloud (Anthropic managed) 与 Claude Models on Google Cloud (Google managed)。
| 方面 | Claude Models on Google Cloud (Anthropic managed) | Claude Models on Google Cloud (Google managed) |
|---|---|---|
| API 接口 | Claude API 端点/v1/{endpoint} |
Agent Platform 预测端点 |
| 请求格式 | 与 Claude API 相同model 位于请求体中anthropic-version 标头 |
model 位于 URL 中anthropic_version 位于请求体中 |
| Streaming(流式传输) | 在请求体中设置 "stream": true |
单独的 :streamRawPredict 端点 |
| 位置 | global请参阅项目、位置和工作区解析。 |
全球、多区域或区域端点 请参阅全球、多区域和区域端点。 |
| 早于 Claude 4.6 的模型的模型 ID | Claude API ID 示例: claude-haiku-4-5-20251001 |
Claude API ID,将快照日期前的连字符替换为 @示例: claude-haiku-4-5@20251001请参阅模型 ID 和版本控制。 |
| 需要在项目中启用的服务 | 请参阅设置您的账户。 | Agent Platform APIaiplatform.googleapis.com |
| Anthropic 组织 | 为您的项目创建一个新的 Anthropic 组织 | 无 |
| 计费 | Google Cloud Marketplace | Google Cloud,作为 Agent Platform 用量计费 |
| Rate limits(速率限制) | 由 Anthropic 管理 | 由 Google Cloud 管理 |
两种产品的共同点
-
凭据: 两种产品都使用 Google Cloud 凭据,包括 Application Default Credentials。您需要通过各自的 IAM 角色分别授予对每种产品的访问权限。
-
计费: 两种产品的费用都会显示在您的 Google Cloud 账单上。
-
模型 ID: Claude 4.6 及更高版本的模型在两种产品上都使用其 Claude API ID。请参阅模型 ID 和版本控制。
-
SDK: Anthropic 的客户端 SDK 支持两种产品。
在两种产品之间迁移
请按照您要迁移到的产品对应的步骤操作:
- 迁移到 Claude Models on Google Cloud (Anthropic managed) 的步骤
- 迁移到 Claude Models on Google Cloud (Google managed) 的步骤
您使用的是哪种产品?
下表列出了用于识别 Claude Models on Google Cloud (Anthropic managed) 和 Claude Models on Google Cloud (Google managed) 的值。找到一个您已有的值。例如,查看您请求 URL 中的主机名或代码中的 SDK 客户端。该值所在列的标题就是您使用的产品。
| 检查项 | Claude Models on Google Cloud (Anthropic managed) | Claude Models on Google Cloud (Google managed) |
|---|---|---|
| 请求发送的目标 | claude.googleapis.comURL 中包含您的工作区 ID。 URL 以 Claude API 路径结尾,例如 .../invoke/v1/messages。 |
以下 Agent Platform 主机之一:aiplatform.googleapis.comaiplatform.us.rep.googleapis.comaiplatform.eu.rep.googleapis.com{region}-aiplatform.googleapis.comURL 路径包含 .../publishers/anthropic/models/{model}。URL 以 :rawPredict 或 :streamRawPredict 结尾。 |
| 代码中的 SDK 客户端 | AnthropicGoogleCloud (csharp: AnthropicGoogleCloudClient; go: googlecloud.NewClient(); java: GoogleCloudBackend; php: Anthropic\GoogleCloud\Client; ruby: Anthropic::GoogleCloudClient)在每个 SDK 中,客户端名称都包含 GoogleCloud(在 Go 中全部为小写)。 |
AnthropicVertex (csharp: AnthropicVertexClient; go: vertex.WithGoogleAuth(); java: VertexBackend; php: Anthropic\Vertex\Client; ruby: Anthropic::VertexClient)在每个 SDK 中,客户端名称都包含 Vertex(在 Go 中全部为小写)。 |
| 授予访问权限的 IAM 角色 | roles/claude.adminroles/claude.userroles/claude.viewer |
Agent Platform IAM 角色 |
| 管理控制台 | Claude Console,位于 platform.claude.com您可以从 Google Cloud 控制台打开它。 |
Google Cloud 控制台 |
| 每种产品在 Google Cloud 控制台中的位置 | 标记为 Anthropic managed 的选项 请参阅设置您的账户。 |
Model Garden 中的 Claude 模型 |
如果您使用 API 密钥调用 api.anthropic.com,则您未使用这两种产品中的任何一种。要将这些调用迁移到 Claude Models on Google Cloud (Anthropic managed),请参阅从现有 Anthropic 组织迁移。
后续步骤
-
Claude Models on Google Cloud (Anthropic managed):设置您的账户并发出您的第一个请求。
-
Claude Models on Google Cloud (Google managed):安装 SDK 并发出您的第一个请求。
-
Claude Models on Google Cloud (Anthropic managed) 的 IAM 权限:查找权限、角色和审计日志类型。