Appearance
使用分析:追踪团队使用情况
Claude Code 提供分析仪表板帮助组织了解使用模式、追踪 PR 和代码行贡献指标、衡量 ROI。Teams/Enterprise 用户访问 claude.ai/analytics/claude-code,API 客户访问 platform.claude.com/claude-code。贡献指标需连接 GitHub 组织,PR 归因采用保守匹配算法,只有高置信度的 Claude Code 参与才会被计入。
根据你的计划访问对应仪表板:
| 计划 | 仪表板 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 格式的贡献数据
启用贡献指标
使用和采用数据对所有 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。
汇总指标说明
仪表板顶部显示以下汇总指标:
- 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 图表 显示每日活跃用户和会话数趋势。
衡量每用户 PR 数
PRs per user 图表 显示每日合并 PR 总数除以日活用户数,追踪个人生产力随 Claude Code 采用增加的变化。
查看 PR 分解
Pull requests 图表 展示每日合并 PR 细分(含 CC / 不含 CC),可切换为代码行数视图。
找出核心贡献者
排行榜 显示贡献量最高的 Top 10 用户,可在 Pull requests(含 CC vs 全部 PR)和 Lines of code(含 CC vs 全部代码行)之间切换。点击 Export all users 下载所有用户完整贡献数据(不限于 Top 10)的 CSV 文件。
PR 归因机制
启用贡献指标后,Claude Code 会分析合并的 PR 来判断哪些代码是在 Claude Code 辅助下编写的。
归因标准
PR 被标记为"使用 Claude Code"的条件:至少包含一行在 Claude Code 会话期间编写的代码。系统使用保守匹配:只有高置信度的 Claude Code 参与才计入辅助。
归因流程
PR 合并时:
- 从 PR 差异中提取新增行
- 识别在时间窗口内编辑了匹配文件的 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 采用率高的团队成员,他们可以:
- 向团队分享提示词技巧和工作流
- 提供哪些功能好用的反馈
- 协助新用户入职
编程化访问数据
在 GitHub 中搜索标记了 claude-code-assisted 的 PR 来查询贡献数据。
API 客户分析
使用 Claude Console 的 API 客户可在 platform.claude.com/claude-code 访问分析(需要 UsageView 权限,Developer、Billing、Admin、Owner 和 Primary Owner 角色均有此权限)。
Console 仪表板显示:
- 接受的代码行数:用户接受的 Claude Code 编写代码行总数(不包含拒绝的建议,不追踪后续删除)
- 建议接受率:代码编辑工具使用(Edit、Write、NotebookEdit)的接受百分比
- 活动:每日活跃用户和会话数图表
- 费用:每日 API 成本(美元)和用户数对比
查看团队洞察
团队洞察表显示每用户指标:
- Members:所有认证过 Claude Code 的用户(API Key 用户按密钥标识显示,OAuth 用户按邮箱显示)
- 本月花费:当月每用户 API 成本总计
- 本月代码行数:当月每用户接受的代码行总计
相关文档
- 使用 OpenTelemetry 监控 — 向可观测性系统导出实时指标和事件
- 管理成本 — 设置花费限制和优化 Token 使用
- 权限配置 — 配置角色和权限
常见问题
Q: Claude Code 贡献指标和普通使用指标有什么区别?
使用指标(接受代码行数、建议接受率)不需要任何额外设置,所有 Teams/Enterprise 账户可用。贡献指标(PR 归因、含 CC 的代码行数)需要连接 GitHub 组织,分析实际合并到代码库的 PR。
Q: PR 归因的时间窗口为什么是 21 天?
21 天的窗口考虑了多种实际开发场景:功能开发跨越多天、代码审查和修改周期等。这样既能捕捉到 Claude Code 真正参与的工作,又避免过度追溯太久之前的会话。
Q: 如何用 GitHub API 查询哪些 PR 使用了 Claude Code?
启用贡献指标后,包含 Claude Code 辅助代码的合并 PR 会自动打上 claude-code-assisted GitHub 标签。通过 GitHub 搜索 label:claude-code-assisted is:pr is:merged 可以筛选出所有这类 PR,也可以用 GitHub API 编程化查询。