Claude Platform Docs
  • 消息
  • 托管智能体
  • 管理

Search...
⌘K
组织
Admin API工作区
身份验证
概览创建 Admin API 密钥工作负载身份联合通过 API 管理 WIFWIF 参考
监控
用量与成本 API速率限制 API分析 APIClaude Code 分析 API支出限额 API
数据与合规
数据驻留API 与数据保留访问透明度
合规 API
概览获取访问权限活动动态聊天、文件和项目组织、用户、角色、群组和设置设计您的集成错误常见问题

Log in
分析 API
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Claude Platform Docs

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Claude on Google Cloud

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
管理/监控

分析 API

了解您的组织需要哪种分析 API 和 API 密钥，然后配置访问权限以获取 Claude Code 生产力指标或 Claude Enterprise 的参与度和采用情况数据。

Anthropic 提供两种分析 API，您应使用哪一种取决于您的组织所管理的 Claude 产品：

  • Claude Code 分析 API 为使用 Claude Platform 的组织报告每日 Claude Code 生产力指标。它是 Admin API 的一部分，使用 Admin API 密钥。
  • Claude Enterprise 分析 API 为 Claude Enterprise 组织报告跨 Claude 产品（聊天、项目、Claude Code 等）的组织级参与度、采用情况和成本数据。它使用在 claude.ai 中创建的分析 API 密钥。

这两种 API 使用不同的密钥类型，由不同角色在不同位置创建。本页介绍哪种 API 适合您的组织，以及如何创建正确的密钥。

您需要哪种 API？

API密钥类型创建位置谁可以创建涵盖内容
Claude Code 分析 APIAdmin API 密钥（sk-ant-admin01-...）Claude Console > 设置 > Admin 密钥组织管理员每位用户的每日 Claude Code 指标：会话数、代码行数、提交数、拉取请求数、工具接受率，以及按模型划分的估算成本
Claude Enterprise 分析 API分析 API 密钥claude.ai > 组织设置 > API主要所有者组织级参与度和采用情况（用户活动、活跃用户摘要、项目、技能和连接器使用情况），以及成本和使用量报告

这两种密钥类型不可互换：Admin API 密钥无法调用 Claude Enterprise 分析 API，分析 API 密钥也无法调用 Admin API。这两种 API 都出现在 Admin API 参考下，但它们是具有不同密钥类型的独立 API。如果您的组织同时使用 Claude Platform 和 Claude Enterprise，您可以配置这两种密钥，并分别使用各自的 API 获取相应数据。



想查找 API 使用量和成本数据而非产品分析数据？请参阅使用量和成本 API，其中说明了适用于 Claude Console 组织和 Claude Enterprise 组织的正确路径。



如果您希望在产品中查看参与度和采用情况数据而非通过编程方式获取，请使用 claude.ai 中的分析仪表板。对于治理和审计用例（单个用户操作、原始活动事件、对话内容），请参阅合规 API。

获取 Claude Code 分析 API 的访问权限

Claude Code 分析 API 对所有可访问 Admin API 的组织开放，且可免费使用。

  1. 1

    创建 Admin API 密钥

    按照创建 Admin API 密钥中的步骤操作。

  2. 2

    调用 API

    在 x-api-key 标头中传递密钥：

    curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2025-09-08" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

有关可用指标、请求参数和响应架构，请参阅 Claude Code 分析 API 指南和 API 参考。

获取 Claude Enterprise 分析 API 的访问权限

Claude Enterprise 分析 API 面向 Claude Enterprise 组织提供。参与度和采用情况数据在所有 Enterprise 套餐中均可用。成本和使用量端点适用于基于用量的 Enterprise 套餐；对于基于席位的 Enterprise 套餐，这些端点仅反映使用额度。

  1. 1

    以主要所有者身份登录

    只有组织的主要所有者才能启用 API 访问并创建分析 API 密钥。

  2. 2

    启用 API 访问并创建密钥

    前往 claude.ai > 组织设置 > API 并启用公共 API 访问，然后创建一个分析 API 密钥。密钥具有 read:analytics 权限范围。复制显示的密钥并将其存储在您的密钥管理器中。

  3. 3

    调用 API

    在 x-api-key 标头中传递密钥。端点位于 https://api.anthropic.com/v1/organizations/analytics/ 下。有关请求示例、参数和响应架构，请参阅 Claude Enterprise 分析 API 参考。

Claude Enterprise 分析 API 提供以下内容：

  • 用户活动： 跨聊天（对话、消息、项目、文件、Artifacts）、Claude Code（会话、提交、拉取请求、代码行数、工具操作）及其他 Claude 产品的每位用户每日指标
  • 活动摘要： 组织级的每日、每周和每月活跃用户数、席位数量和待处理邀请
  • 项目、技能和连接器使用情况： 聊天项目、技能和连接器的采用情况细分
  • 成本和使用量报告： 每位用户和组织级的令牌使用量及随时间变化的成本（适用于基于用量的 Enterprise 套餐）

有关端点详情、参数和响应架构，请参阅 Claude Enterprise 分析 API 参考。以下各节介绍适用于这些端点的数据新鲜度、指标定义和操作指南。

数据可用性和新鲜度

Claude Enterprise 分析 API 数据适用于 2026 年 1 月 1 日及之后的日期。

参与度和采用情况端点（用户活动、摘要、项目、技能、连接器）返回您指定日期的每日快照。某一天的数据会在次日 10

UTC 进行聚合，并在聚合后三天可供查询。如果数据在该时间范围内不可用，通常表明 Anthropic 端的数据管道出现故障；如果数据缺口持续存在，请联系支持团队。

成本和使用量端点遵循不同的新鲜度模型。数据通常在底层使用发生后四小时内可用，但最长可能需要 24 小时。随着延迟事件的到达和对账运行，某一日期的数值可能在最多 30 天内被修订。如需获取发票级别的总计数据，请查询至少 30 天前的日期。



成本和使用量响应包含 data_refreshed_at 时间戳。当省略 ending_at 时（默认值为当前时间），响应会包含 data_refreshed_at 之后的一段不完整的尾部数据。为了在重复调用中获得稳定的结果，请将 ending_at 设置为等于或早于先前返回的 data_refreshed_at 的值。

指标定义方式

活跃用户。 如果满足以下任一条件，则用户在某一天被计为活跃：他们在 Claude 中发送了至少一条聊天消息；他们有至少一个与您的 Claude Enterprise 组织关联的 Claude Code 会话（本地或远程），且该会话包含工具使用或 git 活动；或者他们有至少一个包含工具使用或消息活动的 Cowork 会话。

按产品划分的指标块。 按产品划分的指标对象（例如用户活动记录中的 Office Agent 或 Cowork 指标）始终出现在每条记录中。未使用该产品的组织会看到全零值而非 null。

连接器名称。 连接器名称在各数据源之间已标准化。例如，Atlassian MCP server、mcp-atlassian 和 atlassian_MCP 在连接器使用情况端点中均显示为 atlassian。

使用 API

分页游标与发出它们的查询绑定。 在成本和使用量端点上，请勿在分页序列中途更改查询参数：如果您更改了 products[]、group_by[]、order_by、日期范围或任何筛选条件并传递旧游标，请求将返回 400 错误。要更改参数，请从第一页重新开始且不传递游标。

列表参数使用方括号表示法。 为每个值重复该参数，例如 products[]=chat&products[]=claude_code。

金额字段是以美分为单位的十进制字符串。 货币金额以十进制字符串形式返回，例如 "41280.000000"（表示 $412.80）。要转换为美元，请将其解析为十进制数并除以 100。对于可能超过数百万美元的值，请避免使用二进制浮点解析。

速率限制在组织级别生效，而非按密钥生效，此 API 中所有端点的默认限制为每分钟 60 个请求。如果这不足以满足您的用例，请联系您的 Anthropic 客户团队讨论调整限制。

已知限制

如果您的组织通过 Amazon Bedrock 使用 Claude Code，则 Claude Enterprise 分析 API 不会返回该使用情况对应的 Claude Code 活动。

后续步骤

Claude Code 分析 API

使用 Admin API 密钥跟踪 Claude Code 会话、代码变更和工具使用情况。

使用量和成本 API

跟踪您组织的 API 令牌使用量和成本。

Claude Enterprise 分析 API 参考

参与度、采用情况和成本数据的端点参考。

获取合规 API 的访问权限

审计和合规数据使用其专属的密钥类型。

Was this page helpful?

  • 您需要哪种 API？
  • 获取 Claude Code 分析 API 的访问权限
  • 获取 Claude Enterprise 分析 API 的访问权限
  • 数据可用性和新鲜度
  • 指标定义方式
  • 使用 API
  • 已知限制
  • 后续步骤