Google Cloud 上的 Claude 模型（Anthropic 管理）是一项服务，可让您在 Cloud de Confiance by S3NS中使用 Anthropic 的 Claude 开发者平台。您可以使用它来访问 Anthropic 的最新功能（包括新模型和研究预览版）以及 Claude 控制台。
本页面涵盖以下主题：
- Google Cloud 上的 Claude 模型（Anthropic 托管）的主要优势
- Anthropic 托管和 Google 托管的 Claude 模型对比
- 如何开始使用
- 如何进行 API 调用
主要优势
在 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 High、IL4、IL5、SOC、ISO 和 HIPAA 资格）涵盖的范围
- 内置 Cloud de Confiance by S3NS 配额和结算
- 与 BigQuery、Model Armor 和 Agent Engine 等 Cloud de Confiance by S3NS 服务内置集成。
对比一览表
下表概述了 Anthropic 管理的 Claude 模型与 Google 管理的 Claude 模型之间的主要区别：
| 模型类型 | Anthropic 托管 | 由 Google 管理 |
|---|---|---|
| 谁来操作堆栈 | Anthropic | |
| 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 设置任务 token 额度，轻松管理长时间运行的智能体的支出。Claude 可以更好地确定工作优先级并完成工作。 | ||
| 工具使用（客户端定义） | 连接到外部工具，调用客户自己的函数、API 和系统。 | ||
| 引用 | 返回支持每项陈述的确切段落，以验证答案并显示来源。 | ||
| 100 万上下文、图片/PDF（受支持的模型） | 每个请求最多可处理 100 万个 token（足以处理整个代码库或数百个文档）。读取图片和 PDF。 | ||
| 提示缓存（5 分钟、1 小时、自动） | 定义缓存内容的保留时长（5 分钟、1 小时），以减少重复性任务的处理时间和费用。 | ||
| 结构化输出 | 确保 Claude 的回答始终符合指定的 JSON 架构或自定义工具定义，无需重试，也不会出现解析错误。 | ||
| 批处理 | 同时提交多个请求以进行异步处理。适用于大量数据、优化成本效益以及不需要立即响应的情况。 | 使用 Agent Platform 批量推理 | |
| 服务层级 | 提供不同层级的服务，以便根据应用的需求平衡可用性、性能和可预测的费用。 | 优先、标准、批量 | 预配吞吐量，批量 |
| 上下文编辑（Beta 版） | 随着对话记录的增加，清除其中的特定内容，以优化费用、保持在限制范围内，并帮助智能体保持专注和运行更长时间。 | ||
| Anthropic 定义的工具 | |||
| Google 网页搜索 | 授予实时网络访问权限，以便搜索最新信息。回答中包含引用。 | ||
| Web 提取 | 授予实时网络访问权限，以便从特定网页和 PDF 中提取内容。 | ||
| 远程 MCP（Beta 版） | 直接通过 API，借助远程 MCP 服务器连接到外部工具和数据。 | ||
| 内存 | 在对话中保存和检索信息，让智能体不断积累知识。 | ||
| Files API | 只需上传和管理文件一次，即可与 API 搭配使用，而无需每次都重新发送相同的内容。 | ||
| 计算机使用 | 授予 Claude 对桌面环境的屏幕截图、鼠标和键盘控制权限，以便其自主交互。 | ||
| 技能 | 可重复使用的资源，可为 Claude 提供特定领域的专业知识：工作流、上下文和最佳实践，可将通用智能体转变为专家。 | ||
| 代码执行 | 允许 Claude 在沙盒环境中编写和运行代码，以分析数据、生成文件并迭代解决方案。 | ||
| 托管式智能体（Beta 版） | 使用在代管式基础架构中运行的预构建、可配置的智能体 Harness。最适合长时间运行的任务和异步工作。 | ||
| Advisor 工具（Beta 版） | 让速度更快、成本更低的执行者模型（Haiku、Sonnet）在生成过程中咨询更智能的顾问模型 (Opus)，以获得战略指导，然后再由执行者模型继续执行任务。 | ||
开始使用
如需开始在 Google Cloud 上使用 Claude 模型（Anthropic 托管），请按照以下步骤为您的项目启用 Google Cloud 上的 Claude 模型（Anthropic 托管）：
在 Cloud de Confiance 控制台中，前往 Claude 模型页面：
在管理器选项列表中，选择 Anthropic 托管。
如果您尚未为项目启用 Claude API，请在启用 Claude API 部分中点击启用 API，然后按照说明操作。
在购买产品部分，点击通过 Marketplace 购买。 系统会将您重定向到 Marketplace 页面。您可以选择按定价购买产品，也可以通过协商折扣或非公开优惠购买。成功购买产品后，点击在控制台中管理以返回 Model Garden 页面。
在激活 Claude 控制台部分中，点击激活，为您的 Cloud de Confiance by S3NS 项目预配新的 Anthropic 组织。输入一次性联系邮箱以接收设置链接，从该收件箱打开链接，填写组织详细信息表单（组织名称、实体类型、国家/地区和预期用途），并接受 Anthropic 的商业服务条款和使用政策。请注意，这会创建一个单独的 Anthropic 组织：现有第一方 Anthropic 组织的 API 密钥、工作区、HIPAA 控制、零数据保留 (ZDR) 和设置不会沿用。
在 Google Cloud 上使用 Claude 模型（Anthropic 托管）
启用 Claude API 并购买产品后，您可以通过 Claude 控制台或使用 Claude API 在 Google Cloud（Anthropic 管理）上使用 Claude 模型。
Claude 控制台
如需使用 Claude 控制台，请执行以下操作：
授予
roles/claude.admin（Claude 平台管理员）角色：如需使用 Claude 控制台，您必须先为项目授予roles/claude.admin（Claude 平台管理员）Identity and Access Management (IAM) 角色。在 Cloud de Confiance 控制台中，前往 Google Cloud 上的 Claude 模型（由 Anthropic 管理）页面：
在启用 Claude 控制台部分，点击打开 Claude 控制台。
Claude API
您可以使用标准 Cloud de Confiance by S3NS身份验证与 Google Cloud 上的 Claude 模型（由 Anthropic 管理）进行交互。API 端点为 https://claude.googleapis.com/。
授予
roles/claude.user（Claude 平台用户）角色：如需进行 API 调用，您必须先为项目授予roles/claude.user（Claude 平台用户）Identity and Access Management (IAM) 角色。使用 Cloud de Confiance by S3NS进行身份验证：如果您使用的是客户端库或 Google Cloud CLI，则系统会自动处理身份验证。对于直接 API 调用，请确保您已通过身份验证并可以获取 OAuth 2.0 令牌。您可以使用 Google Cloud CLI 获取令牌：
gcloud auth print-access-token调用 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 路径（例如 .../invoke/v1/files）之前使用 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/workspaces/ANTHROPIC_WORKSPACE_ID/invoke 作为基础网址。对于组织级端点（例如 /v1/organizations/workspaces），请使用 https://claude.googleapis.com/v1/projects/PROJECT_ID/locations/global/claudeOrganization/invoke 作为基础网址。