支援與設定
使用 Admin API
了解如何使用 Admin 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.
Admin API 允許您以程式化方式管理組織的資源,包括組織成員、工作區和 API 金鑰。這提供了對管理任務的程式化控制,否則這些任務需要在 Anthropic Console 中手動配置。
Admin API 需要特殊存取權限
Admin API 需要特殊的 Admin API 金鑰(以 sk-ant-admin...
開頭),這與標準 API 金鑰不同。只有具有管理員角色的組織成員才能透過 Anthropic Console 提供 Admin API 金鑰。
Admin API 的運作方式
當您使用 Admin API 時:
- 您在
x-api-key
標頭中使用您的 Admin API 金鑰發出請求 - API 允許您管理:
- 組織成員及其角色
- 組織成員邀請
- 工作區及其成員
- API 金鑰
這對以下用途很有用:
- 自動化使用者入職/離職
- 以程式化方式管理工作區存取
- 監控和管理 API 金鑰使用情況
組織角色和權限
有五個組織層級的角色。請在此處查看更多詳細資訊。
角色 | 權限 |
---|---|
user | 可以使用 Workbench |
claude_code_user | 可以使用 Workbench 和 Claude Code |
developer | 可以使用 Workbench 並管理 API 金鑰 |
billing | 可以使用 Workbench 並管理帳單詳細資訊 |
admin | 可以執行上述所有操作,以及管理使用者 |
關鍵概念
組織成員
您可以列出組織成員、更新成員角色和移除成員。
組織邀請
您可以邀請使用者加入組織並管理這些邀請。
工作區
工作區成員
管理使用者對特定工作區的存取:
API 金鑰
監控和管理 API 金鑰:
最佳實務
要有效使用 Admin API:
- 為工作區和 API 金鑰使用有意義的名稱和描述
- 為失敗的操作實作適當的錯誤處理
- 定期審核成員角色和權限
- 清理未使用的工作區和過期的邀請
- 監控 API 金鑰使用情況並定期輪換金鑰