Claude Code 深度学习手册

主题

团队用量分析 ​

通过 analytics 仪表盘查看 Claude Code 用量、贡献度与工程效率指标。

是什么 ​

Claude Code 提供 analytics 仪表盘，帮助组织理解开发者使用模式、追踪贡献指标，并衡量 Claude Code 对工程速度的影响。不同套餐入口不同：Claude for Teams / Enterprise 在 claude.ai/analytics/claude-code，包含用量指标、含 GitHub 集成的贡献指标、leaderboard 与数据导出；API（Claude Console）客户在 platform.claude.com/claude-code，包含用量指标、spend 追踪与 team insights。

怎么工作 ​

  • Team/Enterprise 仪表盘展示顶部 summary metrics：PRs with CC、Lines of code with CC、PRs with Claude Code (%)、Suggestion accept rate、Lines of code accepted。
  • 图表区可视化趋势：Adoption（users / sessions）、PRs per user、Pull requests（PRs with CC vs PRs without CC，可切换 Lines of code 视图）、Leaderboard（前 10 名贡献者）。
  • PR attribution：PR 合并后从 diff 提取新增行，识别在时间窗内编辑过匹配文件的 Claude Code 会话，再用多种策略将 PR 行与 Claude Code 输出做匹配，最后计算 AI 辅助行与总行数。
  • 比较前会对行做归一化：去除首尾空白、合并多余空格、统一引号、转为小写。
  • 只要 PR 中包含至少一行在 Claude Code 会话中写的代码，就被标记为 with Claude Code；采用保守匹配，仅高置信度的代码才计入。
  • 含 Claude Code 辅助行的已合并 PR 会在 GitHub 上被打上 claude-code-assisted 标签，可通过该 label 搜索以编程方式查询数据。
  • 归因时间窗：考虑 PR 合并日期前 21 天到后 2 天之间的会话。
  • 可通过 Export all users 把全部用户（不止前 10 名）的贡献数据下载为 CSV。

怎么配置 / 用法 ​

Team/Enterprise 入口：claude.ai/analytics/claude-code（Admins 与 Owners 可查看）。API 客户入口：platform.claude.com/claude-code（需要 UsageView 权限，授予 Developer、Billing、Admin、Owner、Primary Owner 角色）。

启用贡献指标（需连接 GitHub 组织，配置需 Owner 角色，GitHub app 须由 GitHub admin 安装）：

1. GitHub admin 在 github.com/apps/claude 为组织安装 Claude GitHub app
2. Claude Owner 打开 claude.ai/admin-settings/claude-code 并启用 Claude Code analytics
3. 在同一页面打开 GitHub analytics 开关
4. 完成 GitHub 认证流程，选择纳入分析的 GitHub 组织

关键指标定义：

  • Lines of code with CC：仅计 effective lines，即归一化后超过 3 个字符的行，排除空行及仅含括号或琐碎标点的行。
  • Suggestion accept rate：用户接受 Claude Code 代码编辑建议的比例，含 Edit、Write、NotebookEdit 工具。
  • Lines of code accepted：用户在会话中接受的、由 Claude Code 写的代码总行数。

按用户 token 数与成本估算，请配置 OpenTelemetry export（见监控页）。

什么时候用 ​

  • 想衡量 ROI：用自有代码库数据回答这个工具值不值得投入，对比 with vs without Claude Code 的 PR 与代码行。
  • 追踪采用情况：通过 Adoption 图表和用户数发现活跃用户、整体采用趋势及可能反映摩擦的用量下滑。
  • 识别 power users：通过 Leaderboard 找到高采用度成员，让其分享技巧、反馈与帮助新人 onboarding。
  • 需要自定义报表时，导出贡献数据为 CSV，或通过 GitHub 搜索 claude-code-assisted 标签以编程方式查询。

限制 / 坑 ​

  • 贡献指标为 public beta，仅限 Claude for Teams 与 Claude for Enterprise，且只覆盖 claude.ai 组织内用户；通过 Claude Console API 或第三方集成的使用不计入。
  • 启用了 Zero Data Retention 的组织无法使用贡献指标，仪表盘只显示用量指标。
  • API 客户暂不提供含 GitHub 集成的贡献指标，Console 仪表盘只显示用量与 spend 指标；Console 的 spend 数字为分析用估算，实际成本以账单页为准。
  • 指标刻意保守，代表 Claude Code 实际影响的低估值；仅计入高置信度的行与 PR。
  • 归因局限：被开发者大幅重写（差异超过 20%）的代码不归因给 Claude Code；21 天窗口外的会话不计入；算法不考虑 PR 的源/目标分支。

硬事实速查（11 条） ​

  • Team/Enterprise 入口 claude.ai/analytics/claude-code，由 Admins 与 Owners 查看；API 入口 platform.claude.com/claude-code，需 UsageView 权限。
  • 贡献指标需 Owner 配置 analytics 设置，并由 GitHub admin 在 github.com/apps/claude 安装 Claude GitHub app。
  • 数据通常在启用后 24 小时内出现，并按天更新。
  • 贡献指标支持 GitHub Cloud 与 GitHub Enterprise Server。
  • 归因时间窗为 PR 合并日期前 21 天到后 2 天。
  • 含 Claude Code 辅助行的已合并 PR 在 GitHub 被标记为 claude-code-assisted。
  • Suggestion accept rate 统计 Edit、Write、NotebookEdit 工具的建议接受比例。
  • Lines of code with CC 仅计归一化后超过 3 字符的 effective lines，排除空行及仅含括号/琐碎标点的行。
  • 开发者大幅重写（>20% 差异）的代码不归因给 Claude Code。
  • 自动排除：lock 文件（package-lock.json、yarn.lock 等）、生成代码、构建目录（dist/、build/、node_modules/、target/）、测试 fixtures，以及超过 1000 字符的行。
  • Leaderboard 显示前 10 名，但 Export all users 导出全部用户的 CSV 数据。

官方出处：https://code.claude.com/docs/en/analytics