--- 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 金鑰可用於驗證本指南**管理**章節中的每一個 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)、[外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api)、[Claude Tag API](https://platform.claude.com/docs/zh-TW/manage-claude/claude-tag-api)、[支出限額 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-analytics-api)、[用量與成本 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api)，以及[速率限制 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 權杖。請參閱[取得 OAuth bearer 權杖](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api#oauth-bearer-token)。 您應在何處建立金鑰，取決於您的組織使用的是哪一項 Claude 產品。 ## 您需要哪一種金鑰？ | 您的組織 | 建立金鑰的位置 | 金鑰前綴 | 誰可以建立 | 適用於 | | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Claude Console**（Claude Platform，`platform.claude.com`） | Claude Console 中的[管理員金鑰](https://platform.claude.com/settings/admin-keys)頁面（`platform.claude.com/settings/admin-keys`） | `sk-ant-admin01-...` | 具有**管理員**角色的組織成員 | [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-analytics-api)、[用量與成本 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api)、[速率限制 API](https://platform.claude.com/docs/zh-TW/manage-claude/rate-limits-api)、[Claude Code 分析 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 > 組織設定 > API](https://claude.ai/admin-settings/api-access) | `sk-ant-api01-...` | 上層組織的**主要擁有者**（所有已連結的組織）。**組織擁有者（organization owner）**可以建立僅具有 Compliance API 範圍、且限定於其自身組織的金鑰 | [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)（Admin API 的成員、邀請和群組端點）、[外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api)、[Claude Tag API](https://platform.claude.com/docs/zh-TW/manage-claude/claude-tag-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)、[用量與成本分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-api)，以及[支出限額 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 API 金鑰。請參閱[組織角色與權限](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api#organization-roles-and-permissions)。 在 Claude Console 中，前往[管理員金鑰](https://platform.claude.com/settings/admin-keys)頁面（`platform.claude.com/settings/admin-keys`）。 點擊**建立管理金鑰**，為其命名，選取[金鑰到期時間](https://platform.claude.com/docs/zh-TW/manage-claude/authentication#key-expiration)，然後點擊**新增**。Claude Console 金鑰沒有可選取的範圍；每個金鑰都具有所有接受 Admin API 金鑰之端點的完整存取權限（本頁頂端提到的 service-account 和 federation 端點不接受 Admin API 金鑰）。 複製所顯示的密鑰（以 `sk-ant-admin01-` 開頭），並將其儲存於您的密鑰管理工具中。完整密鑰僅會顯示一次。 ## 為 Claude Enterprise 組織建立金鑰 Claude Enterprise 上層組織的**主要擁有者**可以建立能夠存取每個已連結組織的金鑰，或是限定於單一組織的金鑰。**組織擁有者**可以建立僅具有 Compliance API 範圍、且限定於其自身組織的金鑰。 前往 [claude.ai > 組織設定 > API](https://claude.ai/admin-settings/api-access)，並找到**金鑰**區段。 為金鑰命名，並從[範圍表](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)：變更成員角色、移除成員、[將成員從所有地方登出](https://platform.claude.com/docs/zh-TW/manage-claude/user-management#sign-a-member-out-everywhere)（beta）、建立及撤回邀請（若要在角色變更或邀請時指派 `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` | | [外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api)：讀取外掛程式、版本、安裝設定、分享和市集；下載外掛程式檔案，包括成員個人外掛程式的檔案；在連接市集之前進行驗證 | `read:plugins` | | [外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api)：上傳外掛程式和版本；選擇要提供給成員的版本；刪除外掛程式，包括成員的個人外掛程式；設定及移除安裝設定；設定市集的預設安裝設定；在連接市集之前進行驗證（若要讀取外掛程式，也請選取 `read:plugins`） | `write:plugins` | | [Claude Tag API](https://platform.claude.com/docs/zh-TW/manage-claude/claude-tag-api)：讀取 Claude Tag 在 Slack 頻道和 Slack 工作區上的設定；列出存取套組及其附加位置（沒有其他範圍可授予 Claude Tag API 的存取權限） | `read:claude_tag` | | [Claude Tag API](https://platform.claude.com/docs/zh-TW/manage-claude/claude-tag-api)：設定及移除頻道；變更設定；附加及卸離存取套組（若也要讀取，請同時選取 `read:claude_tag`） | `write:claude_tag` | | [支出限額 API](https://platform.claude.com/docs/zh-TW/manage-claude/spend-limits-api)：讀取成員的有效支出限額與提高限額請求 | `read: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)：參與度、採用率、成本與使用量報告；[用量與成本分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-api)：token 使用量與成本報告 | `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)：讀取組織中繼資料和有效設定；[外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api)：每個 `GET` 端點，包括檔案下載 | `read:compliance_org_data` | | 使用單一唯讀範圍存取 Admin API [使用者管理](https://platform.claude.com/docs/zh-TW/manage-claude/user-management)讀取端點、每個 Compliance API 讀取端點，以及每個[外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api) `GET` 端點，包括檔案下載（適用於安全稽核整合；不包括支出限額或分析 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)。 只有在您的組織可以使用外掛程式 API 時，您才能建立及使用具有 `read:plugins` 或 `write:plugins` 的金鑰。[外掛程式 API](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api) 指南說明了哪些組織可以使用它。在這些組織中，具有 `read:org_audit` 或 `read:compliance_org_data` 的金鑰也可以呼叫外掛程式 API 的讀取端點（包括檔案下載），但不包括市集驗證。`read:plugins` 和 `write:plugins` 範圍僅作用於建立該金鑰的組織。請參閱[外掛程式 API 範圍](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api#scopes)和[讀取同一上層組織下的其他組織](https://platform.claude.com/docs/zh-TW/manage-claude/plugins-api#reading-another-organization-under-the-same-parent)。 ## 使用金鑰 在每個請求的 `x-api-key` 標頭中傳遞金鑰。完整的請求範例請參閱各 API 的文件。 超出金鑰範圍的呼叫會回傳 `403 Forbidden`，並附帶一則訊息，列出該金鑰所具有的範圍以及該端點所需的範圍。 ## 後續步驟 管理組織成員、工作區與 API 金鑰。 為您的 Claude Enterprise 組織設定個別成員的支出限額，並審核提高限額請求。 產出 Claude Code 生產力或 Claude Enterprise 參與度與採用率的報告。 稽核活動，並擷取或刪除整個組織中的使用者內容。