{/* TRANSLATED — 已翻译为中文 */}

> ## 文档索引
> 在此获取完整文档索引：https://code.claude.com/docs/llms.txt
> 使用此文件发现所有可用页面，然后再进一步探索。

# 使用分析跟踪团队使用情况

> 在分析仪表板中查看 Claude Code 使用指标、跟踪采用情况并衡量工程效率。

Claude Code 提供分析仪表板，帮助组织了解开发者使用模式、跟踪贡献指标并衡量 Claude Code 如何影响工程效率。访问您计划的仪表板：

| 计划                          | 仪表板 URL                                                              | 包含内容                                                                              | 阅读更多                                            |
| ----------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | 使用指标、带 GitHub 集成的贡献指标、排行榜、数据导出 | [详情](#access-analytics-for-team-and-enterprise) |
| API (Claude Console)          | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | 使用指标、支出跟踪、团队洞察                                          | [详情](#access-analytics-for-api-customers)       |

## 访问 Team 和 Enterprise 的分析

导航到 [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code)。管理员和所有者可以查看仪表板。

Team 和 Enterprise 仪表板包括：

* **使用指标**：接受的代码行数、建议接受率、每日活跃用户和会话
* **贡献指标**：使用 Claude Code 协助完成的 PR 和代码行数，带 [GitHub 集成](#enable-contribution-metrics)
* **排行榜**：按 Claude Code 使用量排名的顶级贡献者
* **数据导出**：下载贡献数据为 CSV 以进行自定义报告

有关每用户令牌计数和成本估算，请配置 [OpenTelemetry 导出](/en/monitoring-usage)。

### 启用贡献指标

<Note>
  贡献指标处于公开测试阶段，适用于 Claude for Teams 和 Claude for Enterprise 计划。这些指标仅涵盖您 claude.ai 组织内的用户。不包括通过 Claude Console API 或第三方集成的使用情况。
</Note>

使用和采用数据适用于所有 Claude for Teams 和 Claude for Enterprise 账户。贡献指标需要额外设置以连接您的 GitHub 组织。

您需要所有者角色来配置分析设置。GitHub 管理员必须安装 GitHub 应用。

<Warning>
  对于启用了[零数据保留](/en/zero-data-retention)的组织，贡献指标不可用。分析仪表板将仅显示使用指标。
</Warning>

<Steps>
  <Step title="安装 GitHub 应用">
    GitHub 管理员在您组织的 GitHub 账户上安装 Claude GitHub 应用，地址为 [github.com/apps/claude](https://github.com/apps/claude)。
  </Step>

  <Step title="启用 Claude Code 分析">
    Claude 所有者导航到 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) 并启用 Claude Code 分析功能。
  </Step>

  <Step title="启用 GitHub 分析">
    在同一页面上，启用"GitHub 分析"切换。
  </Step>

  <Step title="与 GitHub 认证">
    完成 GitHub 认证流程并选择要包含在分析中的 GitHub 组织。
  </Step>
</Steps>

启用后数据通常在 24 小时内出现，每日更新。如果没有出现数据，您可能会看到以下消息之一：

* **"需要 GitHub 应用"**：安装 GitHub 应用以查看贡献指标
* **"数据处理中"**：几天后检查回来，如果数据未出现请确认 GitHub 应用已安装

贡献指标支持 GitHub Cloud 和 GitHub Enterprise Server。

### 查看摘要指标

<Note>
  这些指标故意保守，代表了 Claude Code 实际影响的低估。仅计算对 Claude Code 参与度有高度信心的行和 PR。
</Note>

仪表板在顶部显示这些摘要指标：

* **使用 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 被合并时：

1. 从 PR diff 中提取添加的行
2. 识别在时间窗口内编辑了匹配文件的 Claude Code 会话
3. 使用多种策略将 PR 行与 Claude Code 输出进行匹配
4. 计算 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 指标](https://dora.dev/)、冲刺速度或其他工程 KPI 一起使用，以了解采用 Claude Code 带来的变化

#### 识别超级用户

排行榜帮助您找到具有高 Claude Code 采用率的团队成员，他们可以：

* 与团队分享提示技巧和工作流
* 提供关于哪些方面运作良好的反馈
* 帮助新用户入门

#### 以编程方式访问数据

要通过 GitHub 查询此数据，搜索标记为 `claude-code-assisted` 的 PR。

## 访问 API 客户端的分析

使用 Claude Console 的 API 客户端可以在 [platform.claude.com/claude-code](https://platform.claude.com/claude-code) 访问分析。您需要 UsageView 权限才能访问仪表板，该权限授予 Developer、Billing、Admin、Owner 和 Primary Owner 角色。

<Note>
  带 GitHub 集成的贡献指标目前不适用于 API 客户端。Console 仪表板仅显示使用和支出指标。
</Note>

Console 仪表板显示：

* **接受的代码行数**：用户在其会话中接受的 Claude Code 编写的代码总行数。这不包括被拒绝的建议，也不跟踪后续删除。
* **建议接受率**：用户接受代码编辑工具使用（包括 Edit、Write 和 NotebookEdit 工具）的百分比。
* **活动**：图表上显示的每日活跃用户和会话。
* **支出**：每日 API 成本（美元）与用户计数并列。

### 查看团队洞察

团队洞察表显示每用户指标：

* **成员**：所有已认证到 Claude Code 的用户。API 密钥用户按密钥标识符显示，OAuth 用户按电子邮件地址显示。
* **本月支出**：当前月份每用户的总 API 成本。
* **本月行数**：当前月份每用户接受的代码行总数。

<Note>
  Console 仪表板中的支出数字是用于分析目的的估算值。有关实际成本，请参阅您的计费页面。
</Note>

## 相关资源

* [使用 OpenTelemetry 监控](/en/monitoring-usage)：将实时指标和事件导出到您的可观测性堆栈
* [有效管理成本](/en/costs)：设置支出限制并优化令牌使用
* [权限](/en/permissions)：配置角色和权限