在 Vertex AI 上使用 Claude：价格、Claude Code 设置、配额及两种托管版的区别

在保留 Google Cloud 合同与账单的前提下使用 Claude，有两种方式。一种是 Google 托管版，由 Google 作为 Agent Platform（原 Vertex AI）的一部分提供。另一种是 Anthropic 托管版，即从 Google Cloud 项目使用由 Anthropic 运营的 Claude API。后者已于 2026年10月22日正式发布（Anthropic 的公告）。两者都计入 Google Cloud 账单，但在可用功能、区域、由谁管理用量上限以及对 Claude Code 的支持上各不相同。

本文依据 Anthropic 和 Google Cloud 的官方文档（2026年10月26日确认），说明两个版本的区别、价格、区域、开通步骤、Claude Code 设置，以及配额和 429 错误的处理方法。在同时涉及两个版本的章节中，按 Google 托管 → Anthropic 托管 的顺序排列，并使用相同的颜色。

1. 两个版本的区别

两者都叫“Claude Models on Google Cloud”，靠括号里的“Google managed”或“Anthropic managed”来区分。Google 现在把 Vertex AI 称为“Gemini Enterprise Agent Platform”，文档标题也改成了 Agent Platform。不过，Claude Code 的登录界面上仍显示“Google Vertex AI”。

来源：Anthropic“Claude Models on Google Cloud”中的对比表，以及 Google Cloud“Use Claude models on Google Cloud (Anthropic managed)”和“Anthropic Claude models”。2026年10月26日确认。

两者也有共同点。都使用 Google Cloud 凭据（包括 Application Default Credentials，即 ADC）调用，费用都计入 Google Cloud 账单。对于 Claude 4.6 及之后的模型，两个版本的模型 ID 都与 Claude API 相同（例如 claude-opus-5-5）。对于更早的模型，只有 Google 托管版在日期前加 @（例如 claude-haiku-4-5@20251001）。

使用 Anthropic 托管版时，每个 Google Cloud 项目都会创建一个新的 Anthropic 组织。它与你在 Claude API 或 Claude Enterprise 中已经使用的组织相互独立，现有组织无法迁移过来。API 密钥、工作区和 Console 设置不会继承，文件、批处理等资源也留在原组织中。

2. 如何选择：5 个问题

从上往下看，找到第一个符合的条件。如果都不符合，就看费用是否容易估算。Google 托管版公开了价目表和默认配额，开始前就能估算预算和上限。如果能在 Marketplace 商品页上确认费率、向 Anthropic 销售代表确认上限，那么 Anthropic 托管版功能更全、新功能来得更早的特点就会成为优势。

• 想通过 Google Cloud 计费使用 Claude Code→Google 托管
• 希望数据只由 Google 处理，或需要 VPC Service Controls、区域内数据存储、FedRAMP High 等认证→Google 托管
• 需要推理只在欧盟境内进行→Google 托管（eu 多区域）
• 要用 Files API、Agent Skills、Managed Agents、web fetch、MCP connector、code execution 或 Message Batches API→Anthropic 托管
• 想使用 Opus 5.5 的 fast mode→Anthropic 托管

第二个问题列出的是 Google Cloud 文档建议选择 Google 托管版的情形（Use Claude models on Google Cloud (Anthropic managed)）。

也可以两者并用。例如，开发人员通过 Google 托管版使用 Claude Code，而自家应用通过 Anthropic 托管版调用 Managed Agents。两者计入同一张 Google Cloud 账单，但管理控制台和用量上限的管理是分开的。

3. 功能差异

最大的差异在于 Anthropic 运营的服务端功能。Google 托管版以 Messages API 为核心，没有文件存储和智能体运行环境。

来源：Anthropic“Claude Models on Google Cloud (Anthropic managed)”“Claude Models on Google Cloud (Google managed)”中的 Feature support，以及“Fast mode”。Google 托管版的 fast mode 不在 Anthropic 文档的支持功能列表中，文档既没有说可用，也没有说不可用（Claude Code 的功能表将其列为在 Agent Platform 上不可用）。2026年10月26日确认。

Managed Agents 的工作原理见“什么是 Claude Managed Agents？”；fast mode 的速度和价格见“Claude Opus 5.5 发布概览”。

4. 价格：和 Claude API 一样吗？

Google 托管版的价格

在 Google 托管版的 global 端点上，Opus 5.5、Sonnet 5.5 和 Haiku 5.5 的输入、输出和缓存费率与 Anthropic 的 Claude API 相同。us 和 eu 多区域比 global 贵 10%（区域端点同样贵 10%，但只提供 Sonnet 4.6 及更早的模型，见第 5 节）。

来源：Anthropic“Pricing”、Google Cloud“Agent Platform pricing”中 Anthropic 的 Claude 模型部分，以及 Anthropic“Claude Models on Google Cloud (Google managed)”（对于 Sonnet 4.5、Haiku 4.5、Opus 4.5 及之后的模型，多区域和区域端点比 global 贵 10%）。2026年10月26日确认。图中没有 Anthropic 托管版，是因为官方文档中没有它的按 token 费率（见下一节）。

单位为每百万 token 的美元价格。为 Anthropic 的 Claude API 和 Google 托管版 global 端点的费率（两家公司的价格页面，2026年10月26日确认）。us/eu 多区域为这些费率的 1.1 倍。缓存读取费用对 Opus 5.5 和 Sonnet 5.5 为输入的 0.05 倍，对 Haiku 5.5 为 0.1 倍（Anthropic 价格页面的注释）。完整的模型列表和费率变化见“Claude 各模型价格对比”。

以固定费用预留容量的 Provisioned Throughput 在 global 和多区域上不可用，需要使用区域端点（Google Cloud 文档）。区域端点只提供 Sonnet 4.6 及更早的模型，因此 Opus 5.5、Sonnet 5.5 和 Haiku 5.5 都按量付费使用。

Anthropic 托管版的价格

在 Anthropic 托管版中，Anthropic 以 Claude Consumption Units（CCU，1 CCU = 0.01 美元）计量用量并报告给 Google Cloud，费用出现在 Google Cloud 账单上。Anthropic 不会另开发票。Anthropic 和 Google Cloud 的官方文档中都没有公布按 token 计的价目表（2026年10月26日确认）。稳妥的做法是：订阅前在 Google Cloud Marketplace 商品页上确认费率，开始使用后先做小规模测试，再在 Claude Console 的 Usage 页面和 Google Cloud 的结算报告中核对实际金额。

官方文档写明的有三点：

• Opus 5.5 的 fast mode 为每百万 token 输入 $8、输出 $40（Anthropic 的 Fast mode 页面和公告）。
• 在请求中加入 inference_geo: "us" 使推理留在美国境内时，所有类别的价格乘以 1.1（Anthropic“Data residency”）。
• 如果你有 Google Cloud 的消费承诺，用量会像其他 Marketplace 购买一样计入其中。如果你有折扣协议，请在开始前联系 Anthropic 或 Google Cloud 的销售代表（折扣不会追溯适用）。

批处理的价格

两个版本处理批量任务的方式不同。Google 托管版使用 Agent Platform 的批量预测（输入为来自 BigQuery 或 Cloud Storage 的 JSONL），费率见 Google Cloud 价格页面的 batch 一栏。Anthropic 托管版支持与 Claude API 相同的 Message Batches API，但其批处理费率同样不在官方文档中。Claude API（直接使用）的批处理折扣见“Claude 各模型价格对比”。

5. 区域与数据存储

在 Google Cloud 上使用 Claude 时，调用的 location 决定推理在哪里运行。Google 托管版提供三种类型，Anthropic 托管版只有 global。

来源：Anthropic“Claude Models on Google Cloud (Google managed)”和“(Anthropic managed)”，Google Cloud“Agent Platform partner models”。2026年10月26日确认。

数据存储位置也不同。Google 托管版将数据存储在你选择的区域或多区域中。不过，Google Cloud 的合作伙伴模型页面同时写道，处理位置可能与存储位置不同。而 Anthropic 的文档则说多区域推理会留在 us 或 eu 之内，两种说法之间的关系并未解释。如果你对处理位置有严格要求，请在签约前向 Google Cloud 确认。此外，还可以用组织政策 constraints/gcp.restrictEndpointUsage 屏蔽 global 端点，只允许多区域。

对于 Anthropic 托管版，工作区的存储区域为 "us"，且无法更改（Anthropic“Data residency”）。

截至 2026年10月26日，两个版本的官方文档中的多区域都只涵盖美国和欧盟。如果处理或存储必须留在这两个地区以外的某个国家境内，请在签约前向 Google Cloud 或 Anthropic 销售代表确认是否有合适的 location。

6. 开通步骤

两个版本都需要一个 Google Cloud 项目和一个已启用结算的结算账号。下面先按官方文档列出让各版本可用的步骤，再介绍共通的身份验证和调用步骤。

Google 托管：开通步骤

1. 启用 Agent Platform API

   gcloud config set project YOUR-PROJECT-ID
   gcloud services enable aiplatform.googleapis.com

   每个项目只需做一次。
2. 在 Model Garden 中启用要用的 Claude 模型执行启用的人需要 Consumer Procurement Entitlement Manager 角色（roles/consumerprocurement.entitlementManager）。组织政策还必须允许 cloudcommerceconsumerprocurement.googleapis.com。Claude Code 文档称访问审批可能需要 24 到 48 小时（Google Cloud 文档未说明需要多久）。
3. 为调用方授予角色授予包含 aiplatform.endpoints.predict 权限的角色（roles/aiplatform.user）。

来源：Anthropic“Claude Models on Google Cloud (Google managed)”，Google Cloud“Agent Platform partner models”。2026年10月26日确认。

Anthropic 托管：开通步骤

1. 在 Marketplace 中订阅在 Google Cloud Marketplace 中打开“Claude Models on Google Cloud (Anthropic managed)”，点击 Subscribe。需要具备该结算账号的 Marketplace 购买权限。
2. 启用两项服务

   gcloud services enable claude.googleapis.com \
     anthropic-managed-claude.cloudpartnerservices.goog \
     --project=YOUR-PROJECT-ID

   每个项目只需做一次。
3. 激活组织在 Claude 页面点击 Activate，然后通过发送到联系邮箱的链接，填写组织名称、业务类型、国家和用途，并接受 Anthropic 的 Commercial Terms of Service 和 Usage Policy。这一步需要 roles/claude.admin。
4. 记下工作区 ID在 Claude Console（从 Google Cloud 控制台打开）中进入 Settings > Workspaces，记下以 wrkspc_ 开头的 ID。调用时需要用到它。
5. 为调用方授予角色授予 roles/claude.user。角色以项目为单位，因此如果想按团队分开，就使用不同的项目（每个项目都会成为一个独立的 Anthropic 组织）。

来源：Anthropic“Claude Models on Google Cloud (Anthropic managed)”中的 Set up your account（2026年10月26日确认）。无法用电子邮件地址登录该 Anthropic 组织；Console 需从 Google Cloud 控制台打开。

两个版本通用：身份验证与调用

无论哪个版本，都在发起调用的机器上运行 gcloud auth application-default login 来创建 ADC，SDK 会使用这些凭据（在服务器上请使用服务账号凭据）。然后用第 7 节中的 SDK 客户端调用模型。

7. 从 SDK 调用 Claude

Anthropic 的官方 SDK 支持两个版本。只有要安装的包和客户端名称不同；messages.create 的写法与 Claude API 相同。

Google 托管（Python）

# pip install -U "anthropic[vertex]"
from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="YOUR-PROJECT-ID", region="global")  # 也可以用 "us" 或 "eu"
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

在 TypeScript 中，使用 @anthropic-ai/vertex-sdk 中的 AnthropicVertex。不用 SDK、直接通过 HTTP 调用时，URL 的形式为 https://aiplatform.googleapis.com/v1/projects/YOUR-PROJECT-ID/locations/global/publishers/anthropic/models/claude-opus-5-5:rawPredict；请求体中不写模型名，而是写入 "anthropic_version"（vertex-2023-10-16 或 2026-10-21）。流式输出使用 :streamRawPredict。新 API 版本 2026-10-21 的变化见“temperature is deprecated for this model：原因与解决方法”。

Anthropic 托管（Python）

# pip install -U "anthropic[google_cloud]"
# 环境变量：ANTHROPIC_GOOGLE_CLOUD_PROJECT 和
#           ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID（必需）
from anthropic import AnthropicGoogleCloud

client = AnthropicGoogleCloud()
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

在 TypeScript 中，使用 @anthropic-ai/google-cloud-sdk 中的 AnthropicGoogleCloud（两者都处于 beta 阶段）。通过 HTTP 调用时，请求体和响应体与 Claude API 相同，区别如下：

• 基础 URL：https://claude.googleapis.com/v1/projects/{project}/locations/global/workspaces/{workspace}/invoke，其中包含工作区 ID（不要发送 anthropic-workspace-id 请求头）。
• 身份验证：用 Authorization: Bearer 发送 Google 访问令牌（不要发送 x-api-key）。
• API 密钥：无法创建。ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 环境变量会被忽略。

来源：Anthropic“Claude Models on Google Cloud (Anthropic managed)”和“(Google managed)”。2026年10月26日确认。

8. 在 Google Cloud 上使用 Claude Code

在 Google Cloud 上，Claude Code 支持 Google 托管版。Claude Code 的功能表将 Agent Platform 定义为“run by Google, configured with CLAUDE_CODE_USE_VERTEX”。Claude Code 文档没有介绍如何在 Anthropic 托管版上使用 Claude Code（2026年10月26日确认）。

两种设置方法

1. 用向导设置启动 claude，在登录界面选择“3rd-party platform”→“Google Vertex AI”（如果已经登录，则使用 /login）。向导会询问身份验证方式、项目和区域，并可确认哪些模型可用并将其固定。结果保存在用户设置（~/.claude/settings.json）的 env 中，之后可用 /setup-vertex 重新打开。
2. 用环境变量设置适合 CI 和面向团队的部署。在 Model Garden 中启用模型后，设置以下内容。

   export CLAUDE_CODE_USE_VERTEX=1
   export CLOUD_ML_REGION=global
   export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID
   
   # 固定模型
   # 主模型：用 Sonnet 控制成本。如需 Opus，请使用 claude-opus-5-5
   export ANTHROPIC_MODEL=claude-sonnet-5-5
   export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
   export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5-5
   export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-5-5

   固定模型的理由见下方的提醒。

无论用哪种方法，设置后都运行 /status。如果“API provider”显示 Google Vertex AI，并出现 GCP 项目、区域和模型的行，就说明设置成功。

来源：Claude Code“Claude Code on Google Cloud's Agent Platform”和“Environment variables”。2026年10月26日确认。

如果某个模型在 CLOUD_ML_REGION 的 location 中不可用，可以只为该模型覆盖区域，例如 VERTEX_REGION_CLAUDE_HAIKU_4_5=us-east5（此例只让 Haiku 4.5 在 us-east5 区域调用）。CLOUD_ML_REGION 可以取 global、us 或 eu，也可以是 us-east5 这样的区域名。Claude Agent SDK 也通过相同的环境变量使用 Google 托管版（见“什么是 Claude Agent SDK？”）。

Claude Code 在 Agent Platform 上的功能支持情况

此表中的 computer use 是 Claude Code 的功能（需要订阅），不是第 3 节中的 API computer use 工具。来源：Claude Code“Feature availability”（/logout 和 MCP tool search 出自“Claude Code on Google Cloud's Agent Platform”）。2026年10月26日确认。claude.ai 连接器也不会加载（见“Claude Code 中 claude.ai 连接器被禁用”）。

9. 配额与 429 错误

Google 托管：配额按模型系列设定

2026年5月26日之后发布的模型（Opus 5.5、Sonnet 5.5、Haiku 5.5 等）使用在模型系列内共享的配额（更早的模型请查看同一 Google Cloud 页面上的按模型配额）。例如，在 global 上无论调用哪个版本的 Opus，都从同一个 anthropic-claude-opus 配额中扣减，新版本推出时也无需重新申请配额。global 和各个多区域的配额是分开的。

来源：Google Cloud“Quotas for Anthropic Claude models”中的默认配额（2026年10月26日确认）。输入为未缓存 token 与缓存写入的合计。Google 指出，上限因账号而异，且可能受到限制。

可在 Google Cloud 控制台的 Quotas & System Limits 页面查看配额并申请提高。按 base_model 筛选（例如 anthropic-claude-opus）更容易找到。由于估算和退还机制，此页面上的 token 数可能不准确；要获得准确数字，请使用 token 计数 API 或 Metrics Explorer 中的 token_count。

超出配额时，会返回带有以下消息的 429 错误：

Resource exhausted, please try again later.

这是按量付费时的消息（Google Cloud“Error code 429”）。使用 Provisioned Throughput 时，消息为“Too many requests. Exceeded the Provisioned Throughput.”

1. 对推理位置没有要求时使用 global它的配额比多区域大，并在任意有空闲容量的区域处理。在 Claude Code 中设置 CLOUD_ML_REGION=global。如果有推理须留在欧盟境内之类的要求，请跳过这一步，先申请提高配额（第 3 步）。
2. 等待并重试使用有上限的指数退避进行重试，并避免流量骤增。
3. 申请提高配额在上文提到的 Quotas & System Limits 页面申请。

来源：Google Cloud“Error code 429”，Claude Code“Claude Code on Google Cloud's Agent Platform”中的故障排除。

Anthropic 托管：上限由 Anthropic 管理

用量上限由 Anthropic 管理，官方文档中没有默认值。如需提高，请联系 Anthropic 销售代表或销售团队。Anthropic 的文档建议在迁移生产流量之前确认上限。错误形式与 Claude API 相同：超出上限返回 429 rate_limit_error，拥塞时返回 529 overloaded_error。如果缺少 IAM 权限，Google Cloud 会返回 403。

1. 等待并重试使用指数退避进行重试，并避免流量骤增（与 Google 托管版相同）。
2. 上线前确认上限迁移前把所需的用量告知 Anthropic 销售代表，并确认上限。
3. 申请提高上限联系 Anthropic 销售代表或销售团队。无法在 Google Cloud 的配额页面提高此上限。

来源：Anthropic“Claude Models on Google Cloud (Anthropic managed)”中的 Rate limits，以及“Errors”。2026年10月26日确认。

总结

常见问题

Q. Vertex AI 上的 Claude 比 Claude API 贵吗？

在 Google 托管版的 global 端点上，Opus 5.5、Sonnet 5.5 和 Haiku 5.5 的输入、输出和缓存费率相同。us 和 eu 多区域贵 10%（Anthropic 和 Google Cloud 的价格页面，2026年10月26日确认）。Anthropic 托管版的按 token 费率不在官方文档中，请查看 Google Cloud Marketplace 商品页。

Q. 可以使用 Claude 的 API 密钥吗？

两个版本都使用 Google Cloud 身份验证（ADC 或服务账号）调用，而不是在 Claude Console 中创建的 API 密钥。Anthropic 托管版无法创建 API 密钥，设置了 ANTHROPIC_API_KEY 也会被忽略。

Q. Anthropic 托管版可以使用 Claude Code 吗？

Claude Code 文档中没有介绍适用于 Anthropic 托管版的设置方法（2026年10月26日确认）。Claude Code 的 Google Cloud 设置（CLAUDE_CODE_USE_VERTEX）面向的是 Google 托管版。

Q. 能把现有的 Anthropic 组织改为通过 Google Cloud 计费吗？

不能。Anthropic 托管版会为每个项目新建一个组织，现有组织无法转换。API 密钥、工作区和 Console 设置不会继承，需要在新组织中重新创建。