15 15
16Code Review 有其独立的仪表板。有关审查活动和支出,请参阅[查看使用情况](/docs/zh-CN/code-review-costs#view-usage)。16Code Review 有其独立的仪表板。有关审查活动和支出,请参阅[查看使用情况](/docs/zh-CN/code-review-costs#view-usage)。
17 17
18<h2 id="access-analytics-for-team-and-enterprise">18## 访问 Team 和 Enterprise 分析
19 访问 Team 和 Enterprise 分析
20</h2>
21 19
22导航到 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code)。管理员和所有者可以查看仪表板。20导航到 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code)。管理员和所有者可以查看仪表板。
23 21
30 28
31对于每个用户的令牌计数和成本估计,请配置 [OpenTelemetry 导出](/docs/zh-CN/monitoring-usage),或从您组织的分析设置中导出 [支出报告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans),其中列出了每个用户和每个模型的令牌使用情况和估计的使用额度支出。29对于每个用户的令牌计数和成本估计,请配置 [OpenTelemetry 导出](/docs/zh-CN/monitoring-usage),或从您组织的分析设置中导出 [支出报告](https://support.claude.com/en/articles/12883420-view-usage-analytics-for-team-and-enterprise-plans),其中列出了每个用户和每个模型的令牌使用情况和估计的使用额度支出。
32 30
33<h3 id="enable-contribution-metrics">31### 启用贡献指标
34 启用贡献指标
35</h3>
36 32
37<Note>33> [!NOTE]
38 贡献指标处于公开测试版,可用于 Claude for Teams 和 Claude for Enterprise 计划。这些指标仅涵盖您 claude.ai 组织内的用户。通过 Claude Console API 或第三方集成的使用不包括在内。34>
39</Note>35> 贡献指标处于公开测试版,可用于 Claude for Teams 和 Claude for Enterprise 计划。这些指标仅涵盖您 claude.ai 组织内的用户。通过 Claude Console API 或第三方集成的使用不包括在内。
40 36
41使用和采用数据可用于所有 Claude for Teams 和 Claude for Enterprise 账户。贡献指标需要额外设置来连接您的 GitHub 组织。37使用和采用数据可用于所有 Claude for Teams 和 Claude for Enterprise 账户。贡献指标需要额外设置来连接您的 GitHub 组织。
42 38
43您需要所有者角色来配置分析设置。GitHub 管理员必须安装 GitHub 应用。39您需要所有者角色来配置分析设置。GitHub 管理员必须安装 GitHub 应用。
44 40
45<Warning>41> [!WARNING]
46 启用了 [Zero Data Retention](/docs/zh-CN/zero-data-retention) 的组织无法使用贡献指标。分析仪表板将仅显示使用指标。42>
47</Warning>43> 启用了 [Zero Data Retention](/docs/zh-CN/zero-data-retention) 的组织无法使用贡献指标。分析仪表板将仅显示使用指标。
48 44
49<Steps>45**1. 安装 GitHub 应用**
50 <Step title="安装 GitHub 应用">
51 GitHub 管理员在您组织的 GitHub 账户上安装 Claude GitHub 应用,地址为 [github.com/apps/claude](https://github.com/apps/claude)。
52 </Step>
53 46
54 <Step title="启用 Claude Code 分析">47GitHub 管理员在您组织的 GitHub 账户上安装 Claude GitHub 应用,地址为 [github.com/apps/claude](https://github.com/apps/claude)。
55 Claude 所有者导航到 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 并启用 Claude Code 分析功能。
56 </Step>
57 48
58 <Step title="启用 GitHub 分析">49**2. 启用 Claude Code 分析**
59 在同一页面上,启用"GitHub 分析"切换。
60 </Step>
61 50
62 <Step title="使用 GitHub 进行身份验证">51Claude 所有者导航到 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 并启用 Claude Code 分析功能。
63 完成 GitHub 身份验证流程并选择要包含在分析中的 GitHub 组织。52
64 </Step>53**3. 启用 GitHub 分析**
65</Steps>54
55在同一页面上,启用"GitHub 分析"切换。
56
57**4. 使用 GitHub 进行身份验证**
58
59完成 GitHub 身份验证流程并选择要包含在分析中的 GitHub 组织。
66 60
67启用后,数据通常在 24 小时内出现,并进行每日更新。如果没有数据出现,您可能会看到以下消息之一:61启用后,数据通常在 24 小时内出现,并进行每日更新。如果没有数据出现,您可能会看到以下消息之一:
68 62
71 65
72贡献指标涵盖托管在 github.com 上的仓库。对于 [GitHub Enterprise Server](/docs/zh-CN/github-enterprise-server) 上的仓库,分析仪表板仅显示使用指标。66贡献指标涵盖托管在 github.com 上的仓库。对于 [GitHub Enterprise Server](/docs/zh-CN/github-enterprise-server) 上的仓库,分析仪表板仅显示使用指标。
73 67
74<h3 id="review-summary-metrics">68### 查看摘要指标
75 查看摘要指标
76</h3>
77 69
78<Note>70> [!NOTE]
79 这些指标故意保守,代表对 Claude Code 实际影响的低估。仅计算有高度信心涉及 Claude Code 的代码行和 PR。71>
80</Note>72> 这些指标故意保守,代表对 Claude Code 实际影响的低估。仅计算有高度信心涉及 Claude Code 的代码行和 PR。
81 73
82仪表板在顶部显示这些摘要指标:74仪表板在顶部显示这些摘要指标:
83 75
87* **建议接受率**:用户接受 Claude Code 代码编辑建议的次数百分比,包括 Edit、Write 和 NotebookEdit 工具使用79* **建议接受率**:用户接受 Claude Code 代码编辑建议的次数百分比,包括 Edit、Write 和 NotebookEdit 工具使用
88* **接受的代码行**:Claude Code 编写且用户在其会话中接受的代码行总数。这不包括被拒绝的建议,也不跟踪后续删除。80* **接受的代码行**:Claude Code 编写且用户在其会话中接受的代码行总数。这不包括被拒绝的建议,也不跟踪后续删除。
89 81
90<h3 id="explore-the-charts">82### 探索图表
91 探索图表
92</h3>
93 83
94仪表板包括多个图表来可视化一段时间内的趋势。84仪表板包括多个图表来可视化一段时间内的趋势。
95 85
96<h4 id="track-adoption">86#### 跟踪采用
97 跟踪采用
98</h4>
99 87
100采用图表显示每日使用趋势:88采用图表显示每日使用趋势:
101 89
102* **用户**:日活跃用户90* **用户**:日活跃用户
103* **会话**:每天的活跃 Claude Code 会话数91* **会话**:每天的活跃 Claude Code 会话数
104 92
105<h4 id="measure-prs-per-user">93#### 衡量每个用户的 PR
106 衡量每个用户的 PR
107</h4>
108 94
109此图表显示一段时间内的个人开发者活动:95此图表显示一段时间内的个人开发者活动:
110 96
113 99
114使用此功能了解随着 Claude Code 采用增加,个人生产力如何变化。100使用此功能了解随着 Claude Code 采用增加,个人生产力如何变化。
115 101
116<h4 id="view-pull-requests-breakdown">102#### 查看拉取请求分解
117 查看拉取请求分解
118</h4>
119 103
120拉取请求图表显示已合并 PR 的每日分解:104拉取请求图表显示已合并 PR 的每日分解:
121 105
124 108
125切换到**代码行**视图以按代码行而不是 PR 计数查看相同的分解。109切换到**代码行**视图以按代码行而不是 PR 计数查看相同的分解。
126 110
127<h4 id="find-top-contributors">111#### 查找顶级贡献者
128 查找顶级贡献者
129</h4>
130 112
131排行榜显示按贡献量排名的前 10 个用户。在以下之间切换:113排行榜显示按贡献量排名的前 10 个用户。在以下之间切换:
132 114
135 117
136单击**导出所有用户**以将所有用户的完整贡献数据下载为 CSV 文件。导出包括所有用户,而不仅仅是显示的前 10 个。118单击**导出所有用户**以将所有用户的完整贡献数据下载为 CSV 文件。导出包括所有用户,而不仅仅是显示的前 10 个。
137 119
138<h3 id="pr-attribution">120### PR 归属
139 PR 归属
140</h3>
141 121
142启用贡献指标后,Claude Code 会分析已合并的拉取请求,以确定哪些代码是使用 Claude Code 协助编写的。这是通过将 Claude Code 会话活动与每个 PR 中的代码进行匹配来完成的。122启用贡献指标后,Claude Code 会分析已合并的拉取请求,以确定哪些代码是使用 Claude Code 协助编写的。这是通过将 Claude Code 会话活动与每个 PR 中的代码进行匹配来完成的。
143 123
144<h4 id="attribution-process">124#### 归属过程
145 归属过程
146</h4>
147 125
148当拉取请求被合并时:126当拉取请求被合并时:
149 127
156 134
157包含 Claude Code 协助行的已合并拉取请求在 GitHub 中被标记为 `claude-code-assisted`。135包含 Claude Code 协助行的已合并拉取请求在 GitHub 中被标记为 `claude-code-assisted`。
158 136
159<h4 id="time-window">137#### 时间窗口
160 时间窗口
161</h4>
162 138
163PR 合并日期前 21 天到后 2 天的会话被考虑用于归属匹配。139PR 合并日期前 21 天到后 2 天的会话被考虑用于归属匹配。
164 140
165<h4 id="excluded-files">141#### 排除的文件
166 排除的文件
167</h4>
168 142
169某些文件会自动从分析中排除,因为它们是自动生成的:143某些文件会自动从分析中排除,因为它们是自动生成的:
170 144
174* 测试夹具:快照、磁带、模拟数据148* 测试夹具:快照、磁带、模拟数据
175* 超过 1,000 个字符的行,可能是缩小或生成的149* 超过 1,000 个字符的行,可能是缩小或生成的
176 150
177<h4 id="attribution-notes">151#### 归属说明
178 归属说明
179</h4>
180 152
181在解释归属数据时,请记住这些额外的细节:153在解释归属数据时,请记住这些额外的细节:
182 154
184* 不考虑 21 天窗口外的会话156* 不考虑 21 天窗口外的会话
185* 该算法在执行归属时不考虑 PR 源或目标分支157* 该算法在执行归属时不考虑 PR 源或目标分支
186 158
187<h3 id="get-the-most-from-analytics">159### 从分析中获得最大收益
188 从分析中获得最大收益
189</h3>
190 160
191使用贡献指标来展示 ROI、识别采用模式,并找到可以帮助他人入门的团队成员。161使用贡献指标来展示 ROI、识别采用模式,并找到可以帮助他人入门的团队成员。
192 162
193<h4 id="monitor-adoption">163#### 监控采用
194 监控采用
195</h4>
196 164
197跟踪采用图表和用户计数以识别:165跟踪采用图表和用户计数以识别:
198 166
200* 整个组织的整体采用趋势168* 整个组织的整体采用趋势
201* 可能表示摩擦或问题的使用下降169* 可能表示摩擦或问题的使用下降
202 170
203<h4 id="measure-roi">171#### 衡量 ROI
204 衡量 ROI
205</h4>
206 172
207贡献指标帮助回答"这个工具值得投资吗?",使用来自您自己代码库的数据:173贡献指标帮助回答"这个工具值得投资吗?",使用来自您自己代码库的数据:
208 174
210* 比较使用和不使用 Claude Code 发布的 PR 和代码行176* 比较使用和不使用 Claude Code 发布的 PR 和代码行
211* 与 [DORA 指标](https://dora.dev/)、冲刺速度或其他工程 KPI 一起使用,以了解采用 Claude Code 的变化177* 与 [DORA 指标](https://dora.dev/)、冲刺速度或其他工程 KPI 一起使用,以了解采用 Claude Code 的变化
212 178
213<h4 id="identify-power-users">179#### 识别超级用户
214 识别超级用户
215</h4>
216 180
217排行榜帮助您找到具有高 Claude Code 采用率的团队成员,他们可以:181排行榜帮助您找到具有高 Claude Code 采用率的团队成员,他们可以:
218 182
220* 提供关于什么运行良好的反馈184* 提供关于什么运行良好的反馈
221* 帮助新用户入门185* 帮助新用户入门
222 186
223<h4 id="access-data-programmatically">187#### 以编程方式访问数据
224 以编程方式访问数据
225</h4>
226 188
227在 Enterprise 计划上,[Claude Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) 为您的组织返回每个用户的参与度、使用情况和成本报告,涵盖 Claude 的所有表面,包括 Claude Code。主要所有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 处使用 `read:analytics` 范围创建密钥。该 API 在 Teams 计划上不可用。189在 Enterprise 计划上,[Claude Enterprise Analytics API](https://platform.claude.com/docs/en/api/admin/analytics) 为您的组织返回每个用户的参与度、使用情况和成本报告,涵盖 Claude 的所有表面,包括 Claude Code。主要所有者在 [claude.ai/analytics/api-keys](https://claude.ai/analytics/api-keys) 处使用 `read:analytics` 范围创建密钥。该 API 在 Teams 计划上不可用。
228 190
229要通过 GitHub 查询贡献数据,请搜索标记为 `claude-code-assisted` 的 PR。191要通过 GitHub 查询贡献数据,请搜索标记为 `claude-code-assisted` 的 PR。
230 192
231<h2 id="access-analytics-for-api-customers">193## 访问 API 客户的分析
232 访问 API 客户的分析
233</h2>
234 194
235使用 Claude Console 的 API 客户可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 访问分析。您需要 UsageView 权限来访问仪表板,该权限授予开发者、计费、管理员、所有者和主要所有者角色。要以编程方式拉取相同的每日每用户指标,请使用 [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) 和管理员 API 密钥。195使用 Claude Console 的 API 客户可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 访问分析。您需要 UsageView 权限来访问仪表板,该权限授予开发者、计费、管理员、所有者和主要所有者角色。要以编程方式拉取相同的每日每用户指标,请使用 [Claude Code Analytics API](https://platform.claude.com/docs/en/build-with-claude/claude-code-analytics-api) 和管理员 API 密钥。
236 196
237<Note>197> [!NOTE]
238 贡献指标与 GitHub 集成目前不可用于 API 客户。Console 仪表板仅显示使用和支出指标。198>
239</Note>199> 贡献指标与 GitHub 集成目前不可用于 API 客户。Console 仪表板仅显示使用和支出指标。
240 200
241Console 仪表板显示:201Console 仪表板显示:
242 202
245* **活动**:图表上显示的日活跃用户和会话。205* **活动**:图表上显示的日活跃用户和会话。
246* **支出**:每日 API 成本(美元)与用户计数一起显示。206* **支出**:每日 API 成本(美元)与用户计数一起显示。
247 207
248<h3 id="view-team-insights">208### 查看团队洞察
249 查看团队洞察
250</h3>
251 209
252团队洞察表显示每个用户的指标:210团队洞察表显示每个用户的指标:
253 211
255* **本月支出**:每个用户当前月份的 API 成本总计。213* **本月支出**:每个用户当前月份的 API 成本总计。
256* **本月代码行**:每个用户当前月份接受的代码行总数。214* **本月代码行**:每个用户当前月份接受的代码行总数。
257 215
258<Note>216> [!NOTE]
259 Console 仪表板中的支出数字是用于分析目的的估计值。有关实际成本,请参阅您的计费页面。217>
260</Note>218> Console 仪表板中的支出数字是用于分析目的的估计值。有关实际成本,请参阅您的计费页面。
261 219
262<h2 id="related-resources">220## 相关资源
263 相关资源
264</h2>
265 221
266* [使用 OpenTelemetry 进行监控](/docs/zh-CN/monitoring-usage):将实时指标和事件导出到您的可观测性堆栈222* [使用 OpenTelemetry 进行监控](/docs/zh-CN/monitoring-usage):将实时指标和事件导出到您的可观测性堆栈
267* [有效管理成本](/docs/zh-CN/costs):设置支出限制并优化令牌使用223* [有效管理成本](/docs/zh-CN/costs):设置支出限制并优化令牌使用