Claude Code 分析 API
通过 Claude Code 分析 Admin API，以编程方式访问您组织的 Claude Code 使用分析和生产力指标。
Claude Code 分析 Admin API 提供对 Claude Code 用户每日汇总使用指标的编程访问，使组织能够分析开发者生产力并构建自定义仪表板。与 Claude Console 中基础的分析仪表板相比，此 API 提供更多详细信息，同时又没有 OpenTelemetry 集成那样复杂。
此 API 可帮助您更好地监控、分析和优化 Claude Code 的采用情况：
- 开发者生产力分析： 跟踪使用 Claude Code 的会话数、添加/删除的代码行数、提交数以及创建的拉取请求数
- 工具使用指标： 监控不同 Claude Code 工具（Edit、MultiEdit、Write、NotebookEdit）的接受率和拒绝率
- 成本分析： 查看按 Claude 模型细分的预估成本和 "token"（令牌）使用量
- 自定义报告： 导出数据，为管理团队构建高管仪表板和报告
- 使用论证： 提供指标，以便在内部论证并扩大 Claude Code 的采用
快速入门
获取您组织在特定日期的 Claude Code 分析数据：
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Claude Code 分析 API
使用 /v1/organizations/usage_report/claude_code 端点跟踪整个组织的 Claude Code 使用情况、生产力指标和开发者活动。
关键概念
- 每日汇总： 返回由
starting_at参数指定的单日指标 - 用户级数据： 每条记录代表一个用户在指定日期的活动
- 生产力指标： 跟踪会话、代码行数、提交、拉取请求和工具使用情况
- 令牌和成本数据： 监控按 Claude 模型细分的使用量和预估成本
- "Cursor-based pagination"（基于游标的分页）： 使用不透明游标进行稳定分页，以处理大型数据集
- 数据新鲜度： 为保证一致性，指标最多有 1 小时的延迟
有关完整的参数详情和响应架构，请参阅 Claude Code 分析 API 参考。
基本示例
获取特定日期的分析数据
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"使用分页获取分析数据
# 第一个请求
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# 后续请求，使用响应中返回的 cursor
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"请求参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
starting_at | string | 是 | YYYY-MM-DD 格式的 UTC 日期；仅返回该单日的指标 |
limit | integer | 否 | 每页记录数（默认：20，最大：1000） |
page | string | 否 | 来自上一个响应 next_page 字段的不透明游标令牌 |
可用指标
每条响应记录包含单个用户在单日内的以下指标：
维度
- date： RFC 3339 格式的日期（UTC 时间戳）
- actor： 执行 Claude Code 操作的用户或 API 密钥（带有
email_address的user_actor，或带有api_key_name的api_actor） - organization_id： 组织 UUID
- customer_type： 客户账户类型（
api或subscription）；记录仅涵盖针对您的 Claude Console 组织进行身份验证的使用情况 - terminal_type： 使用 Claude Code 的终端或环境类型（例如
vscode、iTerm.app、tmux）
核心指标
- num_sessions： 此 actor 发起的不同 Claude Code 会话数
- lines_of_code.added： Claude Code 在所有文件中添加的代码总行数
- lines_of_code.removed： Claude Code 在所有文件中删除的代码总行数
- commits_by_claude_code： 通过 Claude Code 的提交功能创建的 git 提交数
- pull_requests_by_claude_code： 通过 Claude Code 的 PR 功能创建的拉取请求数
工具操作指标
按工具类型细分的工具操作接受率和拒绝率：
- edit_tool.accepted/rejected： 用户接受/拒绝的 Edit 工具提议数
- multi_edit_tool.accepted/rejected： 用户接受/拒绝的 MultiEdit 工具提议数
- write_tool.accepted/rejected： 用户接受/拒绝的 Write 工具提议数
- notebook_edit_tool.accepted/rejected： 用户接受/拒绝的 NotebookEdit 工具提议数
模型细分
对于使用的每个 Claude 模型：
- model： Claude 模型标识符（例如
claude-opus-5） - tokens.input/output： 此模型的输入和输出令牌数
- tokens.cache_read/cache_creation： 此模型与缓存相关的令牌使用量
- estimated_cost.amount： 此模型的预估成本，以美分（USD）计
- estimated_cost.currency： 成本金额的货币代码（目前始终为
USD）
响应结构
API 以以下格式返回数据：
{
"data": [
{
"date": "2025-09-08T00:00:00Z",
"actor": {
"type": "user_actor",
"email_address": "developer@company.com"
},
"organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
"customer_type": "api",
"terminal_type": "vscode",
"core_metrics": {
"num_sessions": 5,
"lines_of_code": {
"added": 1543,
"removed": 892
},
"commits_by_claude_code": 12,
"pull_requests_by_claude_code": 2
},
"tool_actions": {
"edit_tool": {
"accepted": 45,
"rejected": 5
},
"multi_edit_tool": {
"accepted": 12,
"rejected": 2
},
"write_tool": {
"accepted": 8,
"rejected": 1
},
"notebook_edit_tool": {
"accepted": 3,
"rejected": 0
}
},
"model_breakdown": [
{
"model": "claude-opus-5-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 113
}
}
]
}
],
"has_more": false,
"next_page": null
}分页
对于拥有大量用户的组织，API 支持基于游标的 "pagination"（分页）：
- 发出初始请求，可选择提供
limit参数。 - 如果响应中的
has_more为true，请在下一个请求中使用next_page值。 - 持续请求，直到
has_more为false。
游标编码了最后一条记录的位置，即使有新数据到达，也能确保分页稳定。每个分页会话都保持一致的数据边界，以确保您不会遗漏或重复记录。
常见用例
- 高管仪表板： 创建高层级报告，展示 Claude Code 对开发速度的影响
- AI 工具比较： 导出指标，将 Claude Code 与 Copilot 和 Cursor 等其他 AI 编码工具进行比较
- 开发者生产力分析： 跟踪个人和团队随时间变化的生产力指标
- 成本跟踪和分配： 监控支出模式，并按团队或项目分配成本
- 采用情况监控： 识别哪些团队和用户从 Claude Code 中获得了最大价值
- ROI 论证： 提供具体指标，以便在内部论证并扩大 Claude Code 的采用
常见问题
分析数据的新鲜度如何？
Claude Code 分析数据通常在用户活动完成后 1 小时内出现。为确保分页结果一致，响应中仅包含超过 1 小时的数据。
我可以获取实时指标吗？
不可以，此 API 仅提供每日汇总指标。如需实时监控，请考虑使用 OpenTelemetry 集成。
数据中如何识别用户？
用户通过 actor 字段以两种方式识别：
user_actor： 包含通过 OAuth 进行身份验证的用户的email_address（最常见）api_actor： 包含使用 API 密钥进行身份验证的用户的api_key_name
customer_type 字段的值为 api 或 subscription。无论取哪个值，每条记录描述的都是针对您的 Claude Console 组织进行身份验证的使用情况。
此 API 是否包含来自 Claude 订阅计划的使用情况？
不包含。当有人使用 Claude 订阅计划（例如 Pro、Max、Team 或 Enterprise）登录 Claude Code 时，其使用情况会归属于其 claude.ai 组织，此 API 不会返回这些数据。
要跟踪这些使用情况，请使用以下选项之一：
- Claude Enterprise 分析 API： 报告 Claude Enterprise 组织的 Claude Code 活动，在其他计划中不可用。请参阅分析 API。
- claude.ai 中的分析仪表板： 适用于 Team 和 Enterprise 计划。请参阅使用分析跟踪团队使用情况。
- OpenTelemetry 导出： 适用于任何计划。请参阅使用 OpenTelemetry 监控使用情况。
数据保留期是多久？
历史 Claude Code 分析数据会被保留，并可通过 API 访问。此数据没有指定的删除期限。
支持哪些 Claude Code 部署？
此 API 仅跟踪 Claude API 上的 Claude Code 使用情况。通过 Amazon Bedrock 中的 Claude、Microsoft Foundry 中的 Claude、Claude Models on Google Cloud 或 Claude Platform on AWS 产生的使用量不包括在内。
使用此 API 需要多少费用？
对于所有有权访问 Admin API 的组织，Claude Code 分析 API 均可免费使用。
如何计算工具接受率？
对于每种工具类型，工具接受率 = accepted / (accepted + rejected)。例如，如果 edit 工具显示 45 次接受和 5 次拒绝，则接受率为 90%。
日期参数使用什么时区？
所有日期均为 UTC。starting_at 参数应采用 YYYY-MM-DD 格式，表示该日的 UTC 午夜。
另请参阅
Claude Code 分析 API 可帮助您了解并优化团队的开发工作流程。了解更多相关功能：
- Admin API
- Admin API 参考
- Claude Console 中的 Claude Code 分析仪表板
- 使用量和成本 API - 跟踪所有 Anthropic 服务的 API 使用情况
- 合规 API - 检索审计和活动数据
- 身份和访问管理
- 使用 OpenTelemetry 监控使用情况，用于自定义指标和告警
Was this page helpful?