如何在 Google Cloud 上管理 Claude Code 成本并证明 ROI
Manage costs and demonstrate ROI for Claude Code on Google Cloud
Anthropic 介绍了在 Google Cloud 上管理 Claude Code 成本的 control、track、prove 三层框架。
原文把 Claude Code 在 Google Cloud 上的成本治理拆成控制、追踪、证明三层,并给出可直接落地的配置项与指标。
随着组织将更多工作交给 Claude Code,支出也随之增长,平台团队需要一种既能控制成本又能了解影响的方式。受近期与 Google Cloud 联合举办的一场网络研讨会(在新标签页中打开)启发,我们分享使用 Claude Code 的组织如何在 Google Cloud 上更好地跟踪和优化这些考量,包括三个核心杠杆:控制、跟踪和证明。
管理 Claude Code 支出的控制措施
Google Cloud 上的 Claude 采用基于用量的定价,因此你的账单反映了开发者在 Google Cloud 环境中使用 Claude 的程度。采用率驱动用量;用量是你付费的依据,也是价值体现之处。
你的 Claude Code 账单由任务消耗的 token 数量和处理这些任务的模型共同决定。Token 消耗随任务复杂度和对话长度而增长。聊天是一问一答的对话。像 Claude Code 这样的智能体工具相对于聊天,每个任务消耗更多 token,因为它要完成多步骤工作:读取文件、运行工具,并在整个任务中进行推理。同时,每个模型都有各自的每 token 价格,因此将模型与任务匹配是另一项主要的成本控制手段。
每月影响组织账单的 token 和模型选择,可通过 Claude 应用网关和 Google Cloud 服务获得可见性。你可以通过三个独立的杠杆来治理支出和管理成本:
- 控制。建立护栏来引导用量,同时避免过度限制访问并意外阻止人员使用。
- 跟踪。在账单到来之前,对支出发生的位置以及将持续流向的位置进行细粒度监督。
- 证明。识别组织从这些 token 支出中获得的价值,并准确归因其来源。
以下是如何将这一控制 -> 跟踪 -> 证明框架应用于你自己的 Google Cloud 上的 Claude Code 部署。

治理工具箱
Google Cloud 上的 Claude 附带用于控制、跟踪和证明支出价值的工具与能力。

Google Cloud 已经提供了许多原生能力,可用于跟踪和控制你的 Claude 支出:
- 按项目计费。允许你为 Claude Code 托管一个专用项目,作为跟踪成本的清晰方式。
- 账单预算和提醒。允许你设置预算提醒,并在实际支出超过你定义的阈值时收到通知。
- 支出上限(预览版)。允许你强制执行服务级 Google Cloud 支出预算,并可手动解除上限。
- BigQuery 导出。让你可以将 Claude 支出与其余云成本一起分析。
- 配额。Google Cloud 上的 Claude 模型对每个模型系列和端点位置都有每分钟的请求、输入 token 和输出 token 限制。
- 预配吞吐量。为预留容量支付固定费用,而非按需付费。
Claude Code 和 Claude 应用网关会添加各自的跟踪与控制能力。该网关是一项自托管服务,随开发者已经在使用的同一个 claude 二进制文件一同发布,运行在你的 Google Cloud 项目中,位于 Claude Code 与 Google Cloud 上的 Claude 之间。开发者通过你的身份提供商(例如 Google Workspace)登录,因此每个请求都携带经过验证的身份。这样你就可以按 IdP 组设置模型允许列表,并按用户、IdP 组或组织设置支出上限,可按天、周或月。
以下是如何选择并组合各项能力,以管理衡量贵组织在 Google Cloud 上使用 Claude 的 AI 投资背后的成本与 ROI 的三个杠杆:
杠杆 1:控制
控制杠杆的核心在于提供护栏,引导开发者使用 Claude Code,而不是用任意上限去限制他们。
引导而非限制很重要,因为高成本会话未必是坏事——事实上,它们往往价值很高,在 Claude Code 中尤其如此。这些会话通常来自你的高级用户,他们处于前沿,使用新的工作流,从 Claude 获得大量价值,也完成了大量工作。
浪费往往出现在高支出者的长尾中段。例如,他们用 Fable 处理 Sonnet 就能轻松应对的日常事务。又或者他们忘了某个已不再关心的定时任务,但它仍在自动运行。
有四项功能可提供护栏来引导用户,而不是限制他们:
- 支出限额(在新标签页中打开)。Claude 应用网关允许你按用户、按 IdP 组或组织范围设置支出上限,可按天、周或月。组和组织上限是每位开发者的默认值,由每个成员继承,而不是共享池。
- 阈值提醒。与 Claude 应用网关配合使用时,Google Cloud 上的 Claude Code 会在开发者接近上限时发出警告,先在超过 75% 时提醒,再在超过 95% 时提醒。这些是面向开发者的 CLI 内警告,而 Google Cloud Billing 提醒则是面向管理员的。达到上限时,网关会返回 429,直到周期重置或管理员提高上限;你可以通过网关的管理 API 编写脚本提高上限。
- 模型默认值与允许列表。通过 Claude 应用网关按 IdP 组指定可用的模型,网关会在服务器端对每个请求强制执行允许列表。我们发现设置模型默认值效果很好,因为大多数人会沿用模型默认值;如果他们想切换模型,通常是有原因的。你可以将模型默认值与模型允许列表搭配使用,或仅使用其中之一。
- 网关管理 API。网关提供用于支出限额的管理 API(在新标签页中打开),因此你可以通过编程方式设置和更改上限,例如使用工单工作流。

组合这些能力来控制你的总体账单,但请记住控制只是第一个杠杆。每 token 价格并不能让你看到全貌。最重要的指标是每任务成本,可以通过跟踪此用量来监控和分析。
杠杆 2:跟踪
这个杠杆的核心是看清支出流向以及使用方式。好消息是,你可以跟踪整个组织内的 Claude Code 用量、成本和工具活动。主要跟踪策略包括:
- 用量与成本可观测性。Claude Code 的 OpenTelemetry 指标与事件(在新标签页中打开)会报告用量与预估成本,并按技能、插件、代理和 MCP 服务器细分。通过 OpenTelemetry 协议(OTLP)将这些数据发送到你已在使用的工具,例如 Google Cloud Monitoring,可经由 OpenTelemetry collector 转发,或通过 Claude apps gateway 中继(用于集中式 OpenTelemetry 配置)。
- 终端用户用量视图。开发者可以在 Claude Code 中直接查看自己的支出,并在触及限额前收到用量警告。
- 将数据导出到你现有的系统。Google Cloud Billing 可导出到 BigQuery,让你按模型和 token 类型筛选 Claude SKU,从而将 Claude 支出与其余云和 AI 支出并列查看。OTel 数据流入你的 O11y 技术栈,而 gateway Admin API 可将支出限额状态直接送入你的工单系统。

Claude Code 无论运行在开发者机器上还是云工作站上,只要启用即可导出 OpenTelemetry 数据,包括会话、活跃时间、代码行数、提交、拉取请求、token 和成本,并按用户、团队和模型细分。最新版本的 Claude Code 还按技能、插件、代理和 MCP 服务器细分用量,因此你不仅能看到 Claude Code 的整体用量,还能看到组织内部哪些技能和插件被采用。借助 Claude apps gateway,你无需在每台机器上逐一配置。在网关上设置遥测目标,它就会为已登录的开发者开启遥测。它还会为每次导出打上开发者登录时验证的邮箱和 IdP 组标签,而非客户端配置的值。
要将用量归属到你自己的成本中心和部门,请设置 OTEL_RESOURCE_ATTRIBUTES 环境变量(例如 department=engineering,cost_center=eng-123)。Claude Code 会将这些标签添加到每个指标和事件中,因此你可以按这些标签进行筛选和聚合。指标会带着这些自定义属性进入 Google Cloud Monitoring(或其他监控解决方案,如 Grafana 或 Splunk)。

典型的采用情况视图会显示活跃开发者数、过去 24 小时的会话数以及消耗的 token 总量。橙色框显示开发者触及网关强制支出上限时被阻止的请求。该指标可与你的现有工单系统配合,形成允许开发者申请提高限额的工作流。
如需现成的 Cloud Monitoring 仪表盘,请参阅 Claude Code Monitoring 模板(在新标签页中打开),它可将 Claude Code 的 OpenTelemetry 指标转化为采用情况、编码活动以及 token 用量和预估支出的单一视图,让你在 Google Cloud 上推广 Claude Code 时按用户和模型跟踪用量与成本。你可以直接在 Cloud Monitoring 控制台中复制此模板。
要在 Google Cloud 上设置自定义 Claude Code 遥测,请从 Claude Code OTel 快速入门(在新标签页中打开) 开始。使用它来配置 Claude Code,将 OpenTelemetry 直接导出到 Google Cloud Observability 套件,包括 Cloud Logging 和 Cloud Monitoring。该快速入门还会将日志路由到分区 BigQuery 表中,每种事件类型一张表(API 请求、工具决策、工具结果、助手响应和已完成的 hook 执行),并提供 SQL 查询,用于按开发者/模型统计支出、工具成功率和延迟、hook 等待时间、按轮次和按会话的分析。
杠杆 3:证明
控制杠杆负责管理和分配用量与成本;跟踪杠杆让你能够可视化这些支出。证明杠杆则是你将 Claude Code 在 Google Cloud 上的使用情况映射到 ROI 的方式。
平台工程师在 Claude Code 中最关心衡量的指标包含三个维度:使用情况、开发者满意度和影响。
采用与使用情况指标衡量人们如何在你的组织中使用 Claude,包括已激活用户及其每周和每日使用情况。这些指标揭示了使用深度、用户随时间推移的留存情况,以及谁是 Claude Code 的重度用户等信息。这些指标均源自 Claude Code OTel 数据。
满意度指标监控你的工程师的用户体验,包括他们对 Claude Code 的满意度、感知到的时间节省、对输出的信心,以及他们可能遇到的任何摩擦。满意度指标来自推广前后进行的简短调查,以及后续持续的用户回访。
影响指标评估 Claude 如何带来可衡量的工程成果,将吞吐量、周期时间和审查速度与基线进行比较,并对特定工作内容进行定性测量。
一组初始影响指标
以下是一组初始影响指标,分为三个领域:时间、投入和数量。
时间衡量工作交付的速度:PR 从开启到合并的周期时间,以及代码审查周转时间。
投入衡量每项变更需要多少工作:每个 PR 的审查迭代次数、每个 PR 的审查评论和返工量。
数量衡量释放出的产能带来了什么:每位工程师的 PR 数、部署频率,以及具名工作内容:你的团队利用释放出的产能交付的具体待办事项。这些在计数之外增加了定性视角。
这些是方向性参考点,而非规则,但却是衡量 Claude Code 在你的组织中影响的一个良好起点。你所需的基线已经存在:源代码控制和工单中的交付历史。
定义你的工作单元
这些指标大多以 PR 计数,但一个拼写错误修复和一个功能发布都算一个 PR。因此,应改为统计已定义类别的已合并 PR:Claude 开启 PR,由人决定是否发布。诸如 hotfix 或功能发布之类的标签、工单 ID,以及 Claude 是否参与,使得这些 PR 在你已经运行的系统里易于查找。并非每个工作单元都是 PR;服务切换或从根源上关闭的事件就是例子。同样的规则适用:统计一件完成的事情,以其落地之处为准。
Claude Code 原生遥测
在落实成本治理和使用情况跟踪之后,下一步是将这些映射到 ROI。Claude Code 的原生遥测可帮助你采集贡献度和生产力指标,用以记录你的组织所获得的价值。

Claude Code 的 OTel 指标让你可以跟踪或推导出代码建议采纳率、修改的代码行数、创建的提交数、创建的 PR 数、单位产出成本以及每用户 PR 数。
所有这些原生指标都提供了有用且可操作的信息。当这些信息与通过 Google Cloud 上的 Claude Code 遥测(在新标签页中打开)采集的已记录事件(如用户提示和工具决策)结合时,会变得更有价值。例如,记录用户提示是了解你的用户群体试图构建什么的好方法,因为并非每一项工作都必然会产生 PR。请注意,由于内容可能敏感,用户提示不会被自动记录;你必须明确选择启用。
一个例子是,如果你是 SRE,可以使用 Claude Code 排查故障;如果你是销售工程师,可以用它生成实时演示的示例数据。这些会话不会产生 PR,但它们确实加速了这些团队的工作流。请记住,Claude Code 的 PR 指标统计的是 Claude Code 创建的 PR,而不是最终合并的 PR。你的源代码管理和工单系统仍然是已交付内容的记录,因此请将 Claude Code 遥测与 GitHub 或 GitLab 以及你的工单跟踪器关联起来,以获得完整视图。
以下是部分 Google Cloud 上的 Claude 客户通过 Claude Code 取得的可衡量影响。
- Delivery Hero(在新标签页中打开) 有一个团队对 100 个 UI 组件进行了设计系统 overhaul。Claude Code 在几分钟内完成了通常需要一名工程师一周时间的工作。
- Shopify (在新标签页中打开)的工程师使用 Claude Code 构建得更快,但非工程师也能在几分钟内而非几天内构建内部工具。Claude Code 正在扩大 Shopify 中能够构建的人群,而不仅仅是加速已经在构建的人。
- Fifth Dimension(在新标签页中打开) 的工程师普遍在 Google Cloud 上使用 Claude Code。他们合计每月编写超过 300,000 行代码,采纳率达到 98%。
开始使用
本文的目标是帮助你熟悉现有的工具和能力,以便管理 Google Cloud 上的 Claude Code 成本并展示 ROI。作为平台工程师,该系统不仅用于注意和观察用户群体的行为,还为你提供动态调整治理和设置所需的知识。
这是一个持续循环:从合理的默认值开始,例如组织范围的支出上限、默认模型和模型允许列表,然后随着使用数据的到来按角色和团队进行细化。通过跟踪实际使用情况并将指标与你从 Claude Code 获得的价值相关联,你可以将这些交付给需要分析使用 Claude Code 的 ROI 和业务影响的相关方。

随着我们委托给 Claude 的工作量和工作类型不断加深和多样化,组织如何在 Google Cloud 上使用 Claude Code 以及由此获得的价值都将不断演变。此处概述的控制 → 跟踪 → 证明框架是一个稳定的起点,可用于衡量 Claude Code 部署的各个方面和成果。
以下是一些帮助你入门的资源:
来源:Claude Blog · claude.com