Claude Code 分析仪表板帮助组织追踪使用模式与ROI衡量。Teams/Enterprise用户访问 claude.ai/analytics/claude-code,API客户访问 platform.claude.com/claude-code。贡献指标需连接GitHub组织并启用,启用后24小时内可见数据,PR归因使用保守匹配算法、21天时间窗口、排除自动生成文件。
Claude Code 团队使用分析:配置贡献指标、PR归因与ROI衡量
根据你的计划访问对应仪表板:
| 计划 | 仪表板 URL | 包含内容 | 更多详情 |
|---|---|---|---|
| Claude for Teams / Enterprise | claude.ai/analytics/claude-code | 使用指标、GitHub协作指标、排行榜、数据导出 | 详情 |
| API(Claude Console) | platform.claude.com/claude-code | 使用指标、费用追踪、团队洞察 | 详情 |
Teams Enterprise分析
导航到 claude.ai/analytics/claude-code,需要Admin或Owner角色。仪表板包含:
- 使用指标:接受的代码行数、建议接受率、日活用户和会话数
- 贡献指标:通过Claude Code辅助提交的PR和代码行数(需启用GitHub集成)
- 排行榜:按Claude Code使用量排名的贡献者
- 数据导出:下载CSV格式的贡献数据
如需按用户的Token数和成本估算,配置 OpenTelemetry导出。
启用贡献指标
贡献指标目前为公开Beta,适用于Claude for Teams和Enterprise计划。这些指标仅涵盖claude.ai组织内的用户。通过Claude Console API或第三方集成的使用不会计入。
使用和采用数据对所有Claude for Teams/Enterprise账户可用。贡献指标需额外配置以连接GitHub组织。
配置分析设置需要Owner角色,GitHub管理员必须安装GitHub App。
启用了 零数据保留 的组织无法使用贡献指标。分析仪表板将仅显示使用指标。
- GitHub管理员在 github.com/apps/claude 为组织安装Claude GitHub App。
- Claude Owner在 claude.ai/admin-settings/claude-code 启用Claude Code分析功能。
- 在同一页面上,启用"GitHub分析"开关。
- 完成GitHub认证流程,选择要纳入分析的GitHub组织。
数据通常在启用后24小时内出现,每日更新。如果没有数据出现,可能看到以下提示:
- “GitHub app required”:安装GitHub App后才能查看贡献指标。
- “Data processing in progress”:几天后再检查,并确认GitHub App已安装。
贡献指标支持GitHub Cloud和GitHub Enterprise Server。
汇总指标说明
这些指标保守估计,代表了对Claude Code实际影响力的低估。只有高置信度涉及Claude Code的行和PR才会被计数。
仪表板顶部显示以下汇总指标:
- PRs with CC:包含至少一行由Claude Code编写代码的合并PR总数。
- Lines of code with CC:所有合并PR中由Claude Code辅助编写的代码行数。只计"有效行":规范化后超过3个字符的行,排除空行、仅包含括号或琐碎标点的行。
- PRs with Claude Code (%):含Claude Code辅助的PR占所有合并PR的百分比。
- 建议接受率:用户接受Claude Code代码编辑建议(包括Edit、Write、NotebookEdit工具)的百分比。
- 接受的代码行数:用户在会话中已接受的Claude Code编写代码行总数。这不包括被拒绝的建议,也不追踪后续删除的行。
图表说明
仪表板包含多个图表展示趋势。
追踪采用趋势
Adoption 图表 显示每日趋势:
- users:日活用户
- sessions:每日活跃的Claude Code会话数
衡量每用户PR数
此图表显示个人开发者随时间的变化:
- PRs per user:每日合并PR总数除以日活用户
- users:日活用户
用于了解随Claude Code采用增加,个人生产力如何变化。
查看PR分解
Pull requests 图表 每日展示合并PR的细分:
- PRs with CC:含Claude Code辅助的PR
- PRs without CC:不含Claude Code辅助的PR
切换为 Lines of code 视图可看到按代码行数而非PR数量的相同细分。
找出核心贡献者
排行榜 显示贡献量前10的用户,可在以下之间切换:
- Pull requests:每位用户包含CC的PR和全部PR
- Lines of code:每位用户包含CC的代码行和全部代码行
点击 Export all users 下载所有用户(不限于前10)的全部贡献数据CSV文件。
PR归因机制
启用贡献指标后,Claude Code会分析合并的PR,判断哪些代码是在Claude Code辅助下编写的。
归因标准
如果PR包含至少一行在Claude Code会话期间编写的代码,则该PR被标记为"使用Claude Code"。系统采用保守匹配:仅高置信度涉及Claude Code的代码才计入辅助。
归因流程
当PR合并时:
- 从PR diff中提取新增行。
- 识别在时间窗口内编辑了匹配文件的Claude Code会话。
- 使用多种策略将PR行与Claude Code输出匹配。
- 计算AI辅助行和总行数指标。
比较前,行会被规范化:去除空白、合并多个空格、统一引号格式、转换为小写。
包含Claude Code辅助行的合并PR会在GitHub中被标记为 claude-code-assisted。
时间窗口
考虑PR合并日期前 21天 到后 2天 内的会话进行归因匹配。
排除文件
以下文件自动排除,因为它们是自动生成的:
- 锁文件:package-lock.json、yarn.lock、Cargo.lock 等
- 生成代码:Protobuf 输出、构建产物、压缩文件
- 构建目录:dist/、build/、node_modules/、target/
- 测试固件:快照(snapshots)、cassette、Mock数据
- 超过1000字符的行(可能是压缩或生成内容)
归因注意事项
- 开发者大幅改写(差异超过20%)的代码不归因于Claude Code。
- 21天窗口外的会话不在考虑范围内。
- 归因时不考虑PR的来源分支或目标分支。
充分利用分析数据
监控采用情况
追踪Adoption图表和用户数,识别:
- 可分享最佳实践的活跃用户
- 整个组织的采用趋势
- 可能指示摩擦或问题的使用量下降
衡量ROI
贡献指标帮助回答"这个工具值得投资吗?"用你代码库的数据说话:
- 追踪随Claude Code采用增加,每用户PR数的变化。
- 比较含CC和不含CC的PR和代码行数。
- 与 DORA指标、冲刺速度或其他工程KPI结合分析,了解采用Claude Code带来的变化。
找出核心用户
排行榜帮助找出Claude Code采用率高的团队成员,他们可以:
- 向团队分享提示词技巧和工作流。
- 提供反馈,指出哪些功能好用。
- 协助新用户入职。
编程化访问数据
在GitHub中搜索标记了 claude-code-assisted 的PR来查询贡献数据。
API客户分析
API客户使用Claude Console,访问 platform.claude.com/claude-code。需要UsageView权限(Developer、Billing、Admin、Owner和Primary Owner角色默认拥有此权限)。
带GitHub集成的贡献指标当前不适用于API客户。Console仪表板仅显示使用和费用指标。
Console仪表板显示:
- 接受的代码行数:用户在会话中已接受的Claude Code编写代码行总数(不包括被拒绝的建议,不追踪后续删除的行)。
- 建议接受率:代码编辑工具(Edit、Write、NotebookEdit)的接受百分比。
- 活动:每日活跃用户和会话数图表。
- 费用:每日API成本(美元)与用户数对比。
查看团队洞察
团队洞察表显示每用户指标:
- Members:所有认证过Claude Code的用户。API Key用户按密钥标识显示,OAuth用户按邮箱地址显示。
- 本月花费:当月每用户API成本总计。
- 本月代码行数:当月每用户接受的代码行总计。
Console仪表板中的费用数据为分析目的估算值。实际成本请参考您的账单页面。
相关文档
- 使用OpenTelemetry监控:向可观测性系统导出实时指标和事件
- 有效管理成本:设置费用限制和优化Token使用
- 权限配置:配置角色和权限
常见问题
贡献指标和普通使用指标有什么区别?
使用指标(接受代码行数、建议接受率)不需要任何额外设置,所有Teams/Enterprise账户可用。贡献指标(PR归因、含CC的代码行数)需要连接GitHub组织并启用,分析的是实际合并到代码库的PR,且受零数据保留限制。
为什么PR归因的时间窗口是21天?
21天窗口考虑了实际开发场景:功能开发跨越多天、代码审查和修改周期等。这样能够捕捉到Claude Code真正参与的工作,同时避免过度追溯太久之前的会话。窗口为PR合并日期前21天到后2天。
如何通过GitHub查询使用了Claude Code的PR?
启用贡献指标后,涉及Claude Code的合并PR会自动带上 claude-code-assisted GitHub标签。使用 label:claude-code-assisted is:pr is:merged 进行搜索,即可筛选出所有此类PR,也可以编程化地通过GitHub API查询。