创建 Admin API 密钥

为您的 Claude Console 或 Claude Enterprise 组织创建 Admin API 密钥。

Admin API 密钥用于对管理和报告您组织情况的 API 的调用进行身份验证,例如 Admin API 和 Compliance API。一个密钥可以用于其中多个 API。

您需要哪种密钥?

您需要哪种密钥取决于您的组织使用的是哪款 Claude 产品:Claude Console(Claude Platform)还是 Claude Enterprise。

组织Claude ConsoleClaude Enterprise
登录地址platform.claude.comclaude.ai
创建位置Claude Console 中的管理员密钥页面claude.ai > 组织设置 > API
密钥前缀sk-ant-admin01-...sk-ant-api01-...
谁可以创建具有管理员角色的组织成员主要所有者:任意作用域
组织所有者(organization owner):仅限 Compliance API 作用域,且仅限其自身组织
作用域无需选择:每个密钥都对接受它的端点拥有完全访问权限创建密钥时选择作用域。密钥仅适用于您的作用域所涵盖的 API
适用于Admin API
用量和成本分析 API
Compliance API 活动源
用量和成本 API(旧版)
速率限制 API
Claude Code 分析 API
Admin API 用户管理
用量和成本分析 API
Compliance API
Claude Enterprise Analytics API
插件 API
Claude Tag API
支出限额 API

大多数密钥只能访问您创建它们时所在的组织。某些密钥(例如具有 Compliance API、群组或审计作用域的密钥)在您的公司将其组织关联到父组织下时,可以访问更多组织。如果您的公司同时使用 Claude Console 和 Claude Enterprise,请在每个组织中各创建一个密钥。

为 Claude Console 组织创建密钥

个人 Claude Console 账户无法创建此密钥,因此请先设置组织。若要将该密钥用于活动源,请在创建密钥之前启用 Compliance API。

打开管理员密钥设置

以组织管理员身份登录 Claude Console。前往管理员密钥页面(platform.claude.com/settings/admin-keys)。

创建密钥

点击创建管理密钥,为其命名,选择密钥过期时间,然后点击添加。

复制并存储密钥

复制显示的密钥(以 sk-ant-admin01- 开头)并将其存储在您的密钥管理器中。完整密钥仅显示一次。

为 Claude Enterprise 组织创建密钥

打开 API 设置

以主要所有者或组织所有者身份登录 claude.ai。前往 claude.ai > 组织设置 > API 并找到密钥部分。

创建密钥

点击创建密钥,为密钥命名,并从作用域表中选择您需要的作用域。主要所有者可以在单个密钥上组合来自不同 API 的作用域(例如 read:analytics 和 read:spend_limits)。

如果在您选择 Compliance API 作用域时出现密钥访问选项,则默认选中仅限此组织。若要访问父组织下的每个组织,请选择所有组织。此类密钥只能包含 Compliance API、群组和审计作用域。

点击创建。如果密钥具有 delete:compliance_user_data 作用域,还需点击确认并创建密钥。

复制并存储密钥

复制显示的密钥(以 sk-ant-api01- 开头)并将其存储在您的密钥管理器中。完整密钥仅显示一次。

为 Claude Enterprise 密钥选择作用域

创建 Claude Enterprise 密钥时,请选择您计划调用的 API 所需的每个作用域(scope)。作用域在创建时即固定;若要稍后添加作用域,请创建新密钥。仅包含 Compliance API 作用域的密钥也称为 Compliance Access Key(合规访问密钥)。仅包含 read:analytics 的密钥也称为 Analytics API 密钥。

要调用……选择这些作用域
Admin API 用户管理:列出和查找成员及邀请;读取自定义角色及其权限read:members
Admin API 用户管理:更改成员角色、移除成员、将成员从所有位置登出(beta)、创建和撤回邀请(如需在角色变更或邀请中分配 managed 角色,还需选择 write:rbac_groups)write:members
Admin API 用户管理:读取群组及其成员read:rbac_groups
Admin API 用户管理:创建、重命名和删除群组;添加和移除群组成员;与 write:members 一起使用时,可分配 managed 角色(在邀请或角色变更中)或在邀请中分配群组write:rbac_groups
插件 API:读取插件、版本、安装设置、共享和市场;下载插件文件,包括成员个人插件的文件;在连接市场之前对其进行验证read:plugins
插件 API:上传插件和版本;选择向成员提供哪个版本;删除插件,包括成员的个人插件;设置和移除安装设置;设置市场的默认安装设置;在连接市场之前对其进行验证(如需读取插件,还需选择 read:plugins)write:plugins
Claude Tag API:读取 Claude Tag 在 Slack 频道和 Slack 工作区上的设置;列出访问包及其附加位置(没有其他作用域可授予对 Claude Tag API 的读取权限)read:claude_tag
Claude Tag API:设置和移除频道;更改设置;附加和分离访问包(如需同时读取,还需选择 read:claude_tag)write:claude_tag
支出限额 API:读取成员的有效支出限额和提额请求read:spend_limits
支出限额 API:设置或清除每用户支出限额;批准或拒绝提额请求write:spend_limits
Claude Enterprise Analytics API:参与度、采用率、成本和使用情况报告;用量和成本分析 API:令牌用量和成本报告read:analytics
Compliance API 活动源:组织范围的活动事件read:compliance_activities
Compliance API 聊天、文件和项目端点以及 Compliance API 会话端点:读取聊天、文件、项目、会话记录和组织用户;与 read:compliance_org_data 一起使用时,在端点返回该信息的情况下,还可读取谁作出了 Security posture 声明:用户 IDread:compliance_user_data
Compliance API 聊天、文件和项目端点:删除聊天、文件和项目delete:compliance_user_data
Compliance API 组织端点:读取组织元数据和有效设置,以及组织的 Security posture;插件 API:每个 GET 端点,包括文件下载read:compliance_org_data
使用单个只读作用域访问 Admin API 用户管理读取端点、每个 Compliance API 读取端点,以及每个插件 API GET 端点(包括文件下载)(适用于安全审计集成;不包括支出限额或分析 API)read:org_audit

必须先启用 Compliance API,才能创建具有 Compliance API 作用域的密钥。read:analytics 作用域需要获取 Claude Enterprise Analytics API 的访问权限。

read:plugins 和 write:plugins 作用域要求组织可以使用插件 API,并且仅作用于创建该密钥的组织。带有 read:org_audit 或 read:compliance_org_data 的密钥只能在可以使用插件 API 的组织中读取插件 API。请参阅插件 API 作用域。若要读取其他组织的插件,请参阅读取同一父组织下的其他组织。

使用密钥

在每个请求的 x-api-key 标头中传递密钥。有关完整的请求示例,请参阅各 API 的文档。

调用密钥作用域之外的端点会返回 403 Forbidden。错误消息会列出该端点接受的作用域。

Claude Console 密钥和 Claude Enterprise 密钥均不适用于 Admin API 的服务账户(service-account)、联合身份颁发者(federation-issuer)或联合身份规则(federation-rule)端点。这些端点仅接受具有 org:admin 作用域的 OAuth bearer 令牌。请参阅 OAuth bearer 令牌。

后续步骤

Admin API

管理组织成员、工作区和 API 密钥。

支出限额 API

为您的 Claude Enterprise 组织设置每成员支出限额并审核提额请求。

Analytics API

报告 Claude Code 生产力或 Claude Enterprise 参与度和采用率。

Compliance API

审计活动并检索或删除整个组织中的用户内容。

文档内容持续同步更新