支持与配置
使用管理员 API
了解如何使用管理员 API 以编程方式管理您组织的资源,包括组织成员、工作区和 API 密钥。
The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
管理员 API 允许您以编程方式管理组织的资源,包括组织成员、工作区和 API 密钥。这提供了对管理任务的编程控制,否则这些任务需要在 Anthropic Console 中手动配置。
管理员 API 需要特殊访问权限
管理员 API 需要特殊的管理员 API 密钥(以 sk-ant-admin...
开头),这与标准 API 密钥不同。只有具有管理员角色的组织成员才能通过 Anthropic Console 配置管理员 API 密钥。
管理员 API 的工作原理
当您使用管理员 API 时:
- 您在
x-api-key
标头中使用管理员 API 密钥发出请求 - API 允许您管理:
- 组织成员及其角色
- 组织成员邀请
- 工作区及其成员
- API 密钥
这对以下用途很有用:
- 自动化用户入职/离职
- 以编程方式管理工作区访问
- 监控和管理 API 密钥使用情况
组织角色和权限
有五个组织级别的角色。查看更多详细信息这里。
角色 | 权限 |
---|---|
user | 可以使用 Workbench |
claude_code_user | 可以使用 Workbench 和 Claude Code |
developer | 可以使用 Workbench 和管理 API 密钥 |
billing | 可以使用 Workbench 和管理账单详细信息 |
admin | 可以执行上述所有操作,以及管理用户 |
关键概念
组织成员
您可以列出组织成员、更新成员角色和移除成员。
组织邀请
您可以邀请用户加入组织并管理这些邀请。
工作区
工作区成员
管理用户对特定工作区的访问:
API 密钥
监控和管理 API 密钥:
最佳实践
要有效使用管理员 API:
- 为工作区和 API 密钥使用有意义的名称和描述
- 为失败的操作实施适当的错误处理
- 定期审核成员角色和权限
- 清理未使用的工作区和过期的邀请
- 监控 API 密钥使用情况并定期轮换密钥