文档索引
在此获取完整文档索引:https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面,然后再进一步探索。
使用分析跟踪团队使用情况
在分析仪表板中查看 Claude Code 使用指标、跟踪采用情况并衡量工程效率。
Claude Code 提供分析仪表板,帮助组织了解开发者使用模式、跟踪贡献指标并衡量 Claude Code 如何影响工程效率。访问您计划的仪表板:
| 计划 | 仪表板 URL | 包含内容 | 阅读更多 |
|---|---|---|---|
| Claude for Teams / Enterprise | claude.ai/analytics/claude-code | 使用指标、带 GitHub 集成的贡献指标、排行榜、数据导出 | 详情 |
| API (Claude Console) | platform.claude.com/claude-code | 使用指标、支出跟踪、团队洞察 | 详情 |
访问 Team 和 Enterprise 的分析
导航到 claude.ai/analytics/claude-code。管理员和所有者可以查看仪表板。
Team 和 Enterprise 仪表板包括:
- 使用指标:接受的代码行数、建议接受率、每日活跃用户和会话
- 贡献指标:使用 Claude Code 协助完成的 PR 和代码行数,带 GitHub 集成
- 排行榜:按 Claude Code 使用量排名的顶级贡献者
- 数据导出:下载贡献数据为 CSV 以进行自定义报告
有关每用户令牌计数和成本估算,请配置 OpenTelemetry 导出。
启用贡献指标
贡献指标处于公开测试阶段,适用于 Claude for Teams 和 Claude for Enterprise 计划。这些指标仅涵盖您 claude.ai 组织内的用户。不包括通过 Claude Console API 或第三方集成的使用情况。
使用和采用数据适用于所有 Claude for Teams 和 Claude for Enterprise 账户。贡献指标需要额外设置以连接您的 GitHub 组织。
您需要所有者角色来配置分析设置。GitHub 管理员必须安装 GitHub 应用。
对于启用了零数据保留的组织,贡献指标不可用。分析仪表板将仅显示使用指标。
安装 GitHub 应用
GitHub 管理员在您组织的 GitHub 账户上安装 Claude GitHub 应用,地址为 github.com/apps/claude。
启用 Claude Code 分析
Claude 所有者导航到 claude.ai/admin-settings/claude-code 并启用 Claude Code 分析功能。
启用 GitHub 分析
在同一页面上,启用"GitHub 分析"切换。
与 GitHub 认证
完成 GitHub 认证流程并选择要包含在分析中的 GitHub 组织。
启用后数据通常在 24 小时内出现,每日更新。如果没有出现数据,您可能会看到以下消息之一:
- "需要 GitHub 应用":安装 GitHub 应用以查看贡献指标
- "数据处理中":几天后检查回来,如果数据未出现请确认 GitHub 应用已安装
贡献指标支持 GitHub Cloud 和 GitHub Enterprise Server。
查看摘要指标
这些指标故意保守,代表了 Claude Code 实际影响的低估。仅计算对 Claude Code 参与度有高度信心的行和 PR。
仪表板在顶部显示这些摘要指标:
- 使用 CC 的 PR:包含至少一行使用 Claude Code 编写的代码的已合并 pull request 总数
- 使用 CC 的代码行数:所有已合并 PR 中使用 Claude Code 协助编写的代码总行数。仅计算"有效行":标准化后超过 3 个字符的行,不包括空行和仅包含括号或简单标点的行。
- 使用 Claude Code 的 PR (%):包含 Claude Code 辅助代码的所有已合并 PR 的百分比
- 建议接受率:用户接受 Claude Code 代码编辑建议的百分比,包括 Edit、Write 和 NotebookEdit 工具使用
- 接受的代码行数:用户在其会话中接受的 Claude Code 编写的代码总行数。这不包括被拒绝的建议,也不跟踪后续删除。
探索图表
仪表板包含多个图表以可视化随时间变化的趋势。
跟踪采用情况
采用图表显示每日使用趋势:
- 用户:每日活跃用户
- 会话:每天活跃的 Claude Code 会话数
衡量每用户 PR
此图表显示随时间变化的个别开发者活动:
- 每用户 PR:每天合并的 PR 总数除以每日活跃用户
- 用户:每日活跃用户
用此来了解随着 Claude Code 采用率增加,个人生产力如何变化。
查看 pull request 分解
Pull request 图表显示已合并 PR 的每日分解:
- 使用 CC 的 PR:包含 Claude Code 辅助代码的 pull request
- 未使用 CC 的 PR:不包含 Claude Code 辅助代码的 pull request
切换到代码行数视图以按代码行数而非 PR 计数查看相同的分解。
查找顶级贡献者
排行榜显示按贡献量排名的前 10 名用户。在以下之间切换:
- Pull requests:显示每位用户的使用 Claude Code 的 PR 与所有 PR
- 代码行数:显示每位用户的使用 Claude Code 的行与所有行
点击导出所有用户以下载所有用户的完整贡献数据为 CSV 文件。导出包含所有用户,而不仅仅是显示的前 10 名。
PR 归因
启用贡献指标后,Claude Code 分析已合并的 pull request 以确定哪些代码是使用 Claude Code 协助编写的。这是通过将 Claude Code 会话活动与每个 PR 中的代码进行匹配来完成的。
标记标准
如果 PR 包含至少一行在 Claude Code 会话期间编写的代码,则标记为"使用 Claude Code"。系统使用保守匹配:仅将对 Claude Code 参与度有高度信心的代码计为辅助代码。
归因过程
当 pull request 被合并时:
- 从 PR diff 中提取添加的行
- 识别在时间窗口内编辑了匹配文件的 Claude Code 会话
- 使用多种策略将 PR 行与 Claude Code 输出进行匹配
- 计算 AI 辅助行和总行的指标
在比较之前,行会被标准化:修剪空白、折叠多个空格、标准化引号并将文本转换为小写。
包含 Claude Code 辅助行的已合并 pull request 在 GitHub 中被标记为 claude-code-assisted。
时间窗口
PR 合并日期前 21 天到后 2 天的会话会被考虑用于归因匹配。
排除的文件
某些文件因为是自动生成的而被自动排除在分析之外:
- 锁文件:package-lock.json、yarn.lock、Cargo.lock 等
- 生成的代码:Protobuf 输出、构建产物、压缩文件
- 构建目录:dist/、build/、node_modules/、target/
- 测试固定数据:快照、cassettes、模拟数据
- 超过 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 角色。
带 GitHub 集成的贡献指标目前不适用于 API 客户端。Console 仪表板仅显示使用和支出指标。
Console 仪表板显示:
- 接受的代码行数:用户在其会话中接受的 Claude Code 编写的代码总行数。这不包括被拒绝的建议,也不跟踪后续删除。
- 建议接受率:用户接受代码编辑工具使用(包括 Edit、Write 和 NotebookEdit 工具)的百分比。
- 活动:图表上显示的每日活跃用户和会话。
- 支出:每日 API 成本(美元)与用户计数并列。
查看团队洞察
团队洞察表显示每用户指标:
- 成员:所有已认证到 Claude Code 的用户。API 密钥用户按密钥标识符显示,OAuth 用户按电子邮件地址显示。
- 本月支出:当前月份每用户的总 API 成本。
- 本月行数:当前月份每用户接受的代码行总数。
Console 仪表板中的支出数字是用于分析目的的估算值。有关实际成本,请参阅您的计费页面。
相关资源
- 使用 OpenTelemetry 监控:将实时指标和事件导出到您的可观测性堆栈
- 有效管理成本:设置支出限制并优化令牌使用
- 权限:配置角色和权限