Claude Platform Docs
管理驗證

建立 Admin API 金鑰

為您的 Claude Console 或 Claude Enterprise 組織建立 Admin API 金鑰。

Admin API 金鑰可用於驗證本指南管理章節中的每一個 API：Admin API、Analytics API、Compliance API、外掛程式 API、Claude Tag API、支出限額 API、用量與成本分析 API、用量與成本 API，以及速率限制 API。您不需要為每個 API 分別建立金鑰。唯一的例外是 Admin API 的 service-account、federation-issuer 與 federation-rule 端點，這些端點僅接受具有 org:admin 範圍的 OAuth bearer 權杖。請參閱取得 OAuth bearer 權杖。

您應在何處建立金鑰，取決於您的組織使用的是哪一項 Claude 產品。

您需要哪一種金鑰？

您的組織建立金鑰的位置金鑰前綴誰可以建立適用於
Claude Console（Claude Platform，platform.claude.com）Claude Console 中的管理員金鑰頁面（platform.claude.com/settings/admin-keys）sk-ant-admin01-...具有管理員角色的組織成員Admin API、用量與成本分析 API、用量與成本 API、速率限制 API、Claude Code 分析 API，以及 Compliance API 的 Activity Feed
Claude Enterprise（claude.ai）claude.ai > 組織設定 > APIsk-ant-api01-...上層組織的主要擁有者（所有已連結的組織）。組織擁有者（organization owner）可以建立僅具有 Compliance API 範圍、且限定於其自身組織的金鑰使用者管理（Admin API 的成員、邀請和群組端點）、外掛程式 API、Claude Tag API、Compliance API、Claude Enterprise Analytics API、用量與成本分析 API，以及支出限額 API，依您所選擇的範圍而定

在某一組織中建立的金鑰無法用於管理其他組織。如果您的公司同時使用 Claude Console 與 Claude Enterprise，請在兩者中各建立一把金鑰。

為 Claude Console 組織建立金鑰

  1. 以組織管理員身分登入

    只有具有管理員角色的組織成員可以建立 Admin API 金鑰。請參閱組織角色與權限。

  2. 開啟「管理員金鑰」設定

    在 Claude Console 中，前往管理員金鑰頁面（platform.claude.com/settings/admin-keys）。

  3. 建立金鑰

    點擊建立管理金鑰，為其命名，選取金鑰到期時間，然後點擊新增。Claude Console 金鑰沒有可選取的範圍；每個金鑰都具有所有接受 Admin API 金鑰之端點的完整存取權限（本頁頂端提到的 service-account 和 federation 端點不接受 Admin API 金鑰）。

  4. 複製並儲存密鑰

    複製所顯示的密鑰（以 sk-ant-admin01- 開頭），並將其儲存於您的密鑰管理工具中。完整密鑰僅會顯示一次。

為 Claude Enterprise 組織建立金鑰

  1. 以主要擁有者或組織擁有者身分登入

    Claude Enterprise 上層組織的主要擁有者可以建立能夠存取每個已連結組織的金鑰，或是限定於單一組織的金鑰。組織擁有者可以建立僅具有 Compliance API 範圍、且限定於其自身組織的金鑰。

  2. 開啟 API 設定

    前往 claude.ai > 組織設定 > API，並找到金鑰區段。

  3. 點擊「+ 建立金鑰」

    為金鑰命名，並從範圍表中選擇您需要的範圍。主要擁有者可以在單一金鑰上組合來自不同 API 的範圍（例如 read:analytics 與 read:spend_limits）。

  4. 複製並儲存密鑰

    複製所顯示的密鑰（以 sk-ant-api01- 開頭），並將其儲存於您的密鑰管理工具中。完整密鑰僅會顯示一次。

為 Claude Enterprise 金鑰選擇範圍

當您建立 Claude Enterprise 金鑰時，請選擇您計畫呼叫的 API 所需的每一個範圍（scope）。範圍在建立時即固定；若日後要新增範圍，請建立新的金鑰。

若要呼叫……請選擇這些範圍
Admin API 使用者管理：列出並查詢成員與邀請；讀取自訂角色及其權限read:members
Admin API 使用者管理：變更成員角色、移除成員、將成員從所有地方登出（beta）、建立及撤回邀請（若要在角色變更或邀請時指派 managed 角色，也請選取 write:rbac_groups）write:members
Admin API 使用者管理：讀取群組及其成員read:rbac_groups
Admin API 使用者管理：建立、重新命名及刪除群組；新增及移除群組成員；搭配 write:members 時，可指派 managed 角色（在邀請或角色變更時）或在邀請時指派群組write:rbac_groups
外掛程式 API：讀取外掛程式、版本、安裝設定、分享和市集；下載外掛程式檔案，包括成員個人外掛程式的檔案；在連接市集之前進行驗證read:plugins
外掛程式 API：上傳外掛程式和版本；選擇要提供給成員的版本；刪除外掛程式，包括成員的個人外掛程式；設定及移除安裝設定；設定市集的預設安裝設定；在連接市集之前進行驗證（若要讀取外掛程式，也請選取 read:plugins）write:plugins
Claude Tag API：讀取 Claude Tag 在 Slack 頻道和 Slack 工作區上的設定；列出存取套組及其附加位置（沒有其他範圍可授予 Claude Tag API 的存取權限）read:claude_tag
Claude Tag API：設定及移除頻道；變更設定；附加及卸離存取套組（若也要讀取，請同時選取 read:claude_tag）write:claude_tag
支出限額 API：讀取成員的有效支出限額與提高限額請求read:spend_limits
支出限額 API：設定或清除個別使用者的支出限額；核准或拒絕提高限額請求write:spend_limits
Claude Enterprise Analytics API：參與度、採用率、成本與使用量報告；用量與成本分析 API：token 使用量與成本報告read:analytics
Compliance API Activity Feed：全組織的活動事件read:compliance_activities
Compliance API 聊天、檔案與專案端點以及 Compliance API 工作階段端點：讀取聊天、檔案、專案、工作階段逐字稿，以及組織使用者read:compliance_user_data
Compliance API 聊天、檔案與專案端點：刪除聊天、檔案與專案delete:compliance_user_data
Compliance API 組織端點：讀取組織中繼資料和有效設定；外掛程式 API：每個 GET 端點，包括檔案下載read:compliance_org_data
使用單一唯讀範圍存取 Admin API 使用者管理讀取端點、每個 Compliance API 讀取端點，以及每個外掛程式 API GET 端點，包括檔案下載（適用於安全稽核整合；不包括支出限額或分析 API）read:org_audit

在使用具有這些範圍的金鑰之前，必須先為您的組織啟用 Compliance 與 Analytics API。請參閱設定 Compliance API 以及取得 Claude Enterprise Analytics API 的存取權。

只有在您的組織可以使用外掛程式 API 時，您才能建立及使用具有 read:plugins 或 write:plugins 的金鑰。外掛程式 API 指南說明了哪些組織可以使用它。在這些組織中，具有 read:org_audit 或 read:compliance_org_data 的金鑰也可以呼叫外掛程式 API 的讀取端點（包括檔案下載），但不包括市集驗證。read:plugins 和 write:plugins 範圍僅作用於建立該金鑰的組織。請參閱外掛程式 API 範圍和讀取同一上層組織下的其他組織。

使用金鑰

在每個請求的 x-api-key 標頭中傳遞金鑰。完整的請求範例請參閱各 API 的文件。

超出金鑰範圍的呼叫會回傳 403 Forbidden，並附帶一則訊息，列出該金鑰所具有的範圍以及該端點所需的範圍。

後續步驟

Admin API

管理組織成員、工作區與 API 金鑰。

支出限額 API

為您的 Claude Enterprise 組織設定個別成員的支出限額，並審核提高限額請求。

Analytics API

產出 Claude Code 生產力或 Claude Enterprise 參與度與採用率的報告。

Compliance API

稽核活動，並擷取或刪除整個組織中的使用者內容。

這個頁面有幫助嗎？