--- title: 建立 Admin API 金鑰 url: https://platform.claude.com/docs/zh-TW/manage-claude/admin-api-keys description: 為您的 Claude Console 或 Claude Enterprise 組織建立 Admin API 金鑰。 --- Admin API 金鑰可用於驗證本指南 **Admin** 章節中的每一個 API：[Admin API](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api)、[Analytics API](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api)、[Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api)、[Spend Limits API](https://platform.claude.com/docs/zh-TW/manage-claude/spend-limits-api)、[用量與成本 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api)，以及 [Rate Limits API](https://platform.claude.com/docs/zh-TW/manage-claude/rate-limits-api)。您不需要為每個 API 分別建立金鑰。唯一的例外是 Admin API 的 service-account、federation-issuer 與 federation-rule 端點，這些端點僅接受具有 `org:admin` 範圍的 OAuth bearer token。請參閱[取得 OAuth bearer token](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api#oauth-bearer-token)。 您應在何處建立金鑰，取決於您的組織使用的是哪一項 Claude 產品。 ## 您需要哪一種金鑰？ | 您的組織 | 建立金鑰的位置 | 金鑰前綴 | 誰可以建立 | 適用於 | | --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Claude Console**（Claude Platform，`platform.claude.com`） | Claude Console 中的 [Admin keys](https://platform.claude.com/settings/admin-keys) 頁面（`platform.claude.com/settings/admin-keys`） | `sk-ant-admin01-...` | 具有 **admin** 角色的組織成員 | [Admin API](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api)、[用量與成本 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api)、[Rate Limits API](https://platform.claude.com/docs/zh-TW/manage-claude/rate-limits-api)、[Claude Code Analytics API](https://platform.claude.com/docs/zh-TW/manage-claude/claude-code-analytics-api)，以及 Compliance API 的 [Activity Feed](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed) | | **Claude Enterprise**（`claude.ai`） | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | `sk-ant-api01-...` | 上層組織的**主要擁有者（primary owner）**（所有已連結的組織）。**組織擁有者（organization owner）**可以建立僅具有 Compliance API 範圍、且限定於其自身組織的金鑰 | [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)（Admin API 的成員、邀請和群組端點）、[Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api)、[Claude Enterprise Analytics API](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api)，以及 [Spend Limits API](https://platform.claude.com/docs/zh-TW/manage-claude/spend-limits-api)，依您所選擇的[範圍](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key)而定 | 在某一組織中建立的金鑰無法用於管理其他組織。如果您的公司同時使用 Claude Console 與 Claude Enterprise，請在兩者中各建立一把金鑰。 ## 為 Claude Console 組織建立金鑰 只有具有 **admin** 角色的組織成員可以建立 Admin API 金鑰。請參閱[組織角色與權限](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api#organization-roles-and-permissions)。 在 Claude Console 中，前往 [Admin keys](https://platform.claude.com/settings/admin-keys) 頁面（`platform.claude.com/settings/admin-keys`）。 點擊 **Create admin key**，為其命名，選擇[金鑰到期時間](https://platform.claude.com/docs/zh-TW/manage-claude/authentication#key-expiration)，然後點擊 **Add**。Claude Console 金鑰沒有可選取的範圍；每把金鑰都具有存取所有接受 Admin API 金鑰之端點的完整權限（本頁頂端提到的 service-account 和 federation 端點不接受 Admin API 金鑰）。 複製所顯示的密鑰（以 `sk-ant-admin01-` 開頭），並將其儲存於您的密鑰管理工具中。完整密鑰僅會顯示一次。 ## 為 Claude Enterprise 組織建立金鑰 Claude Enterprise 上層組織的**主要擁有者**可以建立能夠存取每個已連結組織的金鑰，或是限定於單一組織的金鑰。**組織擁有者**可以建立僅具有 Compliance API 範圍、且限定於其自身組織的金鑰。 前往 [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access)，並找到 **Keys** 區段。 為金鑰命名，並從[範圍表](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api-keys#choose-scopes-for-a-claude-enterprise-key)中選擇您需要的範圍。主要擁有者可以在單一金鑰上組合來自不同 API 的範圍（例如 `read:analytics` 與 `read:spend_limits`）。 複製所顯示的密鑰（以 `sk-ant-api01-` 開頭），並將其儲存於您的密鑰管理工具中。完整密鑰僅會顯示一次。 ## 為 Claude Enterprise 金鑰選擇範圍 當您建立 Claude Enterprise 金鑰時，請選擇您計畫呼叫的 API 所需的每一個範圍（scope）。範圍在建立時即固定；若日後要新增範圍，請建立新的金鑰。 | 若要呼叫…… | 請選擇這些範圍 | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | | Admin API [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)：列出並查詢成員與邀請；讀取自訂角色及其權限 | `read:members` | | Admin API [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)：變更成員角色、移除成員、建立及撤回邀請（若要在角色變更或邀請時指派 `managed` 角色，也請選取 `write:rbac_groups`） | `write:members` | | Admin API [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)：讀取群組及其成員 | `read:rbac_groups` | | Admin API [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)：建立、重新命名及刪除群組；新增及移除群組成員；搭配 `write:members` 時，可指派 `managed` 角色（在邀請或角色變更時）或在邀請時指派群組 | `write:rbac_groups` | | [Spend Limits API](https://platform.claude.com/docs/zh-TW/manage-claude/spend-limits-api)：讀取成員的有效支出限額與提高限額請求 | `read:spend_limits` | | [Spend Limits API](https://platform.claude.com/docs/zh-TW/manage-claude/spend-limits-api)：設定或清除個別使用者的支出限額；核准或拒絕提高限額請求 | `write:spend_limits` | | [Claude Enterprise Analytics API](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api)：參與度、採用率、成本與使用量報告 | `read:analytics` | | [Compliance API Activity Feed](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed)：全組織的活動事件 | `read:compliance_activities` | | [Compliance API 聊天、檔案與專案端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-content-data)以及 [Compliance API 工作階段端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions)：讀取聊天、檔案、專案、工作階段逐字稿，以及[組織使用者](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-org-data#list-organization-users) | `read:compliance_user_data` | | [Compliance API 聊天、檔案與專案端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-content-data)：刪除聊天、檔案與專案 | `delete:compliance_user_data` | | [Compliance API 組織端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-org-data)：讀取組織中繼資料與有效設定 | `read:compliance_org_data` | | Admin API [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)讀取端點以及每一個 Compliance API 讀取端點，使用單一唯讀範圍（適用於安全稽核整合；不包含 Spend Limits 或 Analytics API） | `read:org_audit` | 在使用具有這些範圍的金鑰之前，必須先為您的組織啟用 Compliance 與 Analytics API。請參閱[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#set-up-the-compliance-api) 以及[取得 Claude Enterprise Analytics API 的存取權](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api)。 ## 使用金鑰 在每個請求的 `x-api-key` 標頭中傳遞金鑰。完整的請求範例請參閱各 API 的文件。 超出金鑰範圍的呼叫會回傳 `403 Forbidden`，並附帶一則訊息，列出該金鑰所具有的範圍以及該端點所需的範圍。 ## 後續步驟 管理組織成員、工作區與 API 金鑰。 為您的 Claude Enterprise 組織設定個別成員的支出限額，並審核提高限額請求。 產出 Claude Code 生產力或 Claude Enterprise 參與度與採用率的報告。 稽核活動，並擷取或刪除整個組織中的使用者內容。