本指南 Admin 章節中的每個 API(包括 Admin API、Analytics API、Compliance API、Spend Limits API、Usage and Cost API 以及 Rate Limits API)都使用 Admin API 金鑰進行驗證。您不需要為每個 API 建立個別的金鑰。
建立金鑰的位置取決於您的組織使用的 Claude 產品。
| 您的組織 | 建立金鑰的位置 | 金鑰前綴 | 可建立者 | 適用於 |
|---|---|---|---|---|
Claude Console(Claude Platform,platform.claude.com) | Claude Console > Settings > Admin keys | sk-ant-admin01-... | 具有 admin 角色的組織成員 | Admin API、Usage and Cost API、Rate Limits API、Claude Code Analytics API,以及 Compliance API Activity Feed |
Claude Enterprise(claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | 組織的 primary owner(主要擁有者) | Compliance API、Claude Enterprise Analytics API 以及 Spend Limits API,依據您選擇的範圍而定 |
在某個組織中建立的金鑰無法用於管理其他組織。如果您的公司同時使用 Claude Console 和 Claude Enterprise,請在兩者中各建立一個金鑰。
以組織管理員身分登入
只有具有 admin 角色的組織成員才能建立 Admin API 金鑰。請參閱組織角色與權限。
開啟 Admin keys 設定
建立金鑰
點擊 Create key,為其命名,然後點擊 Create。Claude Console 金鑰沒有可選擇的範圍;每個金鑰都具有完整的 Admin API 存取權限。
複製並儲存密鑰
複製顯示的密鑰(以 sk-ant-admin01- 開頭),並將其儲存在您的密鑰管理工具中。完整的密鑰只會顯示一次。
以主要擁有者身分登入
只有 Claude Enterprise 母組織的 primary owner(主要擁有者)才能建立這些金鑰。
開啟 API 設定
前往 claude.ai > Organization settings > API,並找到 Keys 區段。
點擊 + Create key
為金鑰命名,並從範圍表格中選擇您需要的範圍。您可以在單一金鑰上組合來自不同 API 的範圍(例如 read:analytics 和 read:spend_limits)。
複製並儲存密鑰
複製顯示的密鑰(以 sk-ant-api01- 開頭),並將其儲存在您的密鑰管理工具中。完整的密鑰只會顯示一次。
建立 Claude Enterprise 金鑰時,請選擇您計劃呼叫的 API 所需的每個「scope」(範圍)。範圍在建立時即固定;若之後要新增範圍,請建立新的金鑰。
| 若要呼叫... | 請選擇這些範圍 |
|---|---|
| Spend Limits API:讀取成員的有效支出限制和增額請求 | read:spend_limits |
| Spend Limits API:設定或清除個別使用者的支出限制;核准或拒絕增額請求 | write:spend_limits |
| Claude Enterprise Analytics API:參與度、採用率、成本和使用量報告 | read:analytics |
| Compliance API Activity Feed:組織範圍的活動事件 | read:compliance_activities |
| Compliance API 內容端點:讀取對話、檔案、專案和使用者 | read:compliance_user_data |
| Compliance API 內容端點:刪除對話、檔案和專案 | delete:compliance_user_data |
| Compliance API 組織端點:讀取組織中繼資料和設定 | read:compliance_org_data、read:compliance_org_settings |
您的組織必須先啟用 Compliance API 和 Analytics API,具有這些範圍的金鑰才能使用。請參閱取得 Compliance API 存取權限和 Analytics API。
在每個請求的 x-api-key 標頭中傳遞金鑰。請參閱各 API 的文件以取得完整的請求範例。
超出金鑰範圍的呼叫會回傳 403 Forbidden,並附帶訊息列出該金鑰擁有的範圍以及端點所需的範圍。
管理組織成員、工作區和 API 金鑰。
為您的 Claude Enterprise 組織設定個別成員的支出限制並審核增額請求。
產出 Claude Code 生產力或 Claude Enterprise 參與度和採用率的報告。
稽核活動並擷取或刪除整個組織的使用者內容。
Was this page helpful?