Claude Code 网关与用量

Claude Code 网关与用量

团队用量分析

2 分钟阅读

使用分析功能跟踪团队用量

在分析仪表板中查看 Claude Code 用量指标、跟踪采用情况,并衡量工程研发速度。

Claude Code 提供分析仪表板,帮助组织了解开发者的使用模式、跟踪贡献指标,并衡量 Claude Code 对工程研发速度的影响。请根据你的方案访问相应的仪表板:

方案仪表板 URL包含内容了解详情
Claude 团队版 / 企业版claude.ai/analytics/claude-code用量指标、与 GitHub 集成的贡献指标、排行榜、数据导出详细信息
API(Claude Console)platform.claude.com/claude-code用量指标、支出跟踪、团队洞察详细信息

团队版和企业版的分析功能

前往 claude.ai/analytics/claude-code。管理员和所有者可以查看该仪表板。

团队版和企业版仪表板包括:

  • 用量指标:已接受的代码行数、建议接受率、每日活跃用户数和会话数
  • 贡献指标:借助 Claude Code 交付的 PR 数和代码行数,需启用 GitHub 集成
  • 排行榜:按 Claude Code 用量排列的贡献者排名
  • 数据导出:将贡献数据下载为 CSV,以便生成自定义报告

如需查看每位用户的 Token 数量和费用估算,请配置 OpenTelemetry 导出

启用贡献指标

贡献指标目前处于公开测试阶段,适用于 Claude 团队版和 Claude 企业版方案。这些指标仅涵盖你的 claude.ai 组织内的用户,不包括通过 Claude Console API 或第三方集成产生的用量。

所有 Claude 团队版和 Claude 企业版账户均可使用用量和采用情况数据。贡献指标需要额外配置,以连接你的 GitHub 组织。

配置分析设置需要所有者角色。GitHub 管理员必须安装 GitHub 应用。

启用了零数据保留的组织无法使用贡献指标。分析仪表板将仅显示用量指标。

1

安装 GitHub 应用

GitHub 管理员需在 github.com/apps/claude 将 Claude GitHub 应用安装到组织的 GitHub 账户中。

2

启用 Claude Code 分析功能

Claude 所有者前往 claude.ai/admin-settings/claude-code,然后启用 Claude Code 分析功能。

3

启用 GitHub 分析功能

在同一页面上,打开“GitHub analytics”开关。

4

通过 GitHub 进行身份验证

完成 GitHub 身份验证流程,并选择要纳入分析的 GitHub 组织。

启用后,数据通常会在 24 小时内出现,并每日更新。如果未出现数据,你可能会看到以下消息之一:

  • “GitHub app required”:安装 GitHub 应用后才能查看贡献指标
  • “Data processing in progress”:请过几天再查看;如果仍未出现数据,请确认已安装 GitHub 应用

贡献指标支持 GitHub Cloud 和 GitHub Enterprise Server。

查看汇总指标

这些指标刻意采用保守的计算方式,因此会低估 Claude Code 的实际影响。只有在能够高度确定 Claude Code 参与其中时,相应代码行和 PR 才会被计入。

仪表板顶部显示以下汇总指标:

  • 使用 CC 的 PR:包含至少一行由 Claude Code 编写的代码且已合并的拉取请求总数
  • 使用 CC 的代码行数:所有已合并 PR 中借助 Claude Code 编写的代码总行数。仅计算“有效行”:规范化后长度超过 3 个字符的行,不包括空行以及仅含括号或无实际意义标点的行。
  • 使用 Claude Code 的 PR(%):包含 Claude Code 辅助代码的 PR 在所有已合并 PR 中所占的百分比
  • 建议接受率:用户接受 Claude Code 代码编辑建议的次数占比,包括 Edit、Write 和 NotebookEdit 工具的使用情况
  • 已接受的代码行数:Claude Code 编写且用户在会话中接受的代码总行数。该指标不包括被拒绝的建议,也不跟踪之后被删除的代码。

浏览图表

仪表板包含多个图表,用于呈现随时间变化的趋势。

跟踪采用情况

采用情况图表展示每日用量趋势:

  • 用户:每日活跃用户数
  • 会话:每天活跃的 Claude Code 会话数

衡量人均 PR 数

此图表展示各开发者的活动如何随时间变化:

  • 人均 PR 数:每天合并的 PR 总数除以当日活跃用户数
  • 用户:每日活跃用户数

利用此图表可了解随着 Claude Code 采用率的提高,个人生产效率会如何变化。

查看拉取请求明细

拉取请求图表按天展示已合并 PR 的明细:

  • 使用 CC 的 PR:包含 Claude Code 辅助代码的拉取请求
  • 未使用 CC 的 PR:不包含 Claude Code 辅助代码的拉取请求

切换到代码行数视图,即可按代码行数而非 PR 数查看相同的分类明细。

查找主要贡献者

排行榜按贡献量列出排名前 10 的用户。你可以在以下视图之间切换:

  • 拉取请求:显示每位用户使用 Claude Code 的 PR 数与全部 PR 数
  • 代码行数:显示每位用户使用 Claude Code 的代码行数与全部代码行数

点击导出所有用户,即可将所有用户的完整贡献数据下载为 CSV 文件。导出内容包括所有用户,而不仅是页面中显示的前 10 名。

PR 归因

启用贡献指标后,Claude Code 会分析已合并的拉取请求,以判断其中哪些代码是借助 Claude Code 编写的。系统会将 Claude Code 会话活动与每个 PR 中的代码进行匹配,以完成此分析。

标记标准

如果 PR 中包含至少一行在 Claude Code 会话期间编写的代码,就会被标记为“使用 Claude Code”。系统采用保守的匹配方式:只有高度确定 Claude Code 参与编写的代码,才会计为辅助生成的代码。

归因流程

拉取请求合并后,系统会执行以下步骤:

  1. 从 PR 差异中提取新增代码行
  2. 找出在指定时间窗口内编辑过匹配文件的 Claude Code 会话
  3. 使用多种策略,将 PR 中的代码行与 Claude Code 的输出进行匹配
  4. 计算 AI 辅助代码行数和代码总行数指标

比较前,系统会对代码行进行规范化:移除首尾空白、将连续多个空格合并、统一引号,并将文本转换为小写。

包含 Claude Code 辅助代码行的已合并拉取请求会在 GitHub 中标记为 claude-code-assisted

时间窗口

归因匹配会考虑从 PR 合并日期前 21 天到合并日期后 2 天内的会话。

排除的文件

以下文件因属于自动生成内容,会被自动排除在分析范围之外:

  • 锁文件:package-lock.json、yarn.lock、Cargo.lock 及类似文件
  • 生成的代码:Protobuf 输出、构建产物、压缩文件
  • 构建目录:dist/、build/、node_modules/、target/
  • 测试固件:快照、录制数据、模拟数据
  • 超过 1,000 个字符的行,这些内容很可能经过压缩或由工具生成

归因注意事项

解读归因数据时,还应注意以下细节:

  • 如果开发者对代码进行了大幅重写,差异超过 20%,则不会将该代码归因于 Claude Code
  • 不考虑 21 天时间窗口之外的会话
  • 执行归因时,算法不考虑 PR 的源分支或目标分支

充分利用分析功能

利用贡献指标展示投资回报率、识别采用模式,并找出能够帮助其他人上手的团队成员。

监控采用情况

跟踪采用情况图表和用户数量,以便发现:

  • 能够分享最佳实践的活跃用户
  • 整个组织的总体采用趋势
  • 可能表明存在阻碍或问题的用量下降

衡量投资回报率

贡献指标利用你自己的代码库数据,帮助回答“这款工具是否值得投入?”:

  • 随着采用率提高,跟踪人均 PR 数随时间的变化
  • 比较使用和未使用 Claude Code 时交付的 PR 数与代码行数
  • 将其与 DORA 指标、迭代速度或其他工程 KPI 结合使用,了解采用 Claude Code 后发生的变化

识别深度用户

排行榜可帮助你找出 Claude Code 采用程度较高的团队成员。这些成员可以:

  • 与团队分享提示技巧和工作流程
  • 反馈哪些做法效果良好
  • 帮助新用户上手

以编程方式访问数据

如需通过 GitHub 查询这些数据,请搜索带有 claude-code-assisted 标签的 PR。

API 客户的分析功能

使用 Claude Console 的 API 客户可以在 platform.claude.com/claude-code 访问分析功能。你需要拥有 UsageView 权限才能访问该仪表板;Developer、Billing、Admin、Owner 和 Primary Owner 角色均会获得此权限。

API 客户目前无法使用与 GitHub 集成的贡献指标。Console 仪表板仅显示用量和支出指标。

Console 仪表板显示:

  • 已接受的代码行数:Claude Code 编写且用户在会话中接受的代码总行数。该指标不包括被拒绝的建议,也不跟踪之后被删除的代码。
  • 建议接受率:用户接受代码编辑工具操作的次数占比,包括 Edit、Write 和 NotebookEdit 工具。
  • 活动:以图表形式显示每日活跃用户数和会话数。
  • 支出:每日 API 费用(美元)以及对应的用户数。

查看团队洞察

团队洞察表格显示每位用户的指标:

  • 成员:所有通过 Claude Code 完成身份验证的用户。API 密钥用户按密钥标识符显示,OAuth 用户按电子邮件地址显示。
  • 本月支出:每位用户当月的 API 费用总额。
  • 本月代码行数:每位用户当月接受的代码总行数。

Console 仪表板中的支出数字是用于分析的估算值。实际费用请参阅你的账单页面。

相关资源