Compliance API 常見問題
關於 Compliance API 存取、範圍、保留與整合等常見問題的解答。
存取與範圍
對於 Claude Enterprise 組織，主要擁有者可在 claude.ai > Organization settings > API 啟用 Compliance API，且啟用狀態會從父組織向下套用至每個已連結的組織。對於符合資格的獨立 Claude Console 組織（即沒有父組織的組織），組織管理員可在 Claude Console > Settings > Security 啟用。已連結至父組織的 Claude Console 組織不會自行啟用 Compliance API；而是由父組織啟用。步驟請參閱設定 Compliance API。
可以。對於獨立的 Claude Console 組織，組織管理員可以在 Claude Console > Settings > Security（也就是開啟它的同一位置）將 Compliance API 切換開關關閉。當 Compliance API 關閉時，系統不會為您的組織記錄任何活動事件，因此 Activity Feed（活動摘要）不會收到新事件。如果您的組織已加入 Access Transparency，關閉 Compliance API 也會停止 Access Transparency 事件的傳遞。在 Compliance API 關閉期間未被記錄的活動，之後無法復原。重新開啟 Compliance API 後，會從該時間點起恢復記錄；已記錄的活動不會被刪除。
不會。關閉 Compliance API 會停止記錄新的活動事件，但不會刪除在開啟期間已擷取的事件。記錄會從 Compliance API 重新開啟的時間點起恢復。
會。當 Compliance API 在 Claude Console 中被關閉（或重新開啟）時，該變更會以 org_compliance_api_settings_updated 活動的形式記錄在 Activity Feed 中，因此您的稽核軌跡會顯示是誰在何時變更了此設定。此活動是記錄停止的例外：即使在 Compliance API 關閉期間不會記錄其他任何活動，停用動作本身仍會被記錄。
這是預期行為。Claude Enterprise 父組織會集中管理所有已連結組織的身分識別；它不承載工作負載，也完全不會出現在 Claude Console 中。Claude Console 只會顯示連結在父組織之下的 Claude Console 組織。
若要呼叫 Compliance API，您需要改為建立以下兩種金鑰類型之一：
- **若需要完整的 Compliance API 存取權（Activity Feed 加上聊天、檔案、專案、工作階段、使用者、組織中繼資料與組織設定），**由父組織的主要擁有者（或組織擁有者，若金鑰僅限於其自身組織）在 claude.ai 中建立 Compliance Access Key。
- **若僅需要 Activity Feed 存取權，**由您 Claude Console 組織中的組織管理員在 Claude Console 中建立 Admin API 金鑰。該組織必須已啟用 Compliance API，且管理員必須在 Compliance API 啟用期間建立 Admin API 金鑰，該金鑰才會帶有
read:compliance_activities範圍。
不可以。Claude API 金鑰（sk-ant-api03-...）用於驗證對 Claude API 上 Claude 模型的呼叫；它無法驗證對 /v1/compliance/* 的呼叫。Compliance API 僅接受 Compliance Access Key（sk-ant-api01-...）與 Admin API 金鑰（sk-ant-admin01-...）。完整對應關係請參閱您需要哪種金鑰？。
Admin API 金鑰帶有固定的 read:compliance_activities 範圍，該範圍僅授權存取 Activity Feed。其他所有 Compliance API 端點都需要只有在 claude.ai 中建立的 Compliance Access Key 才能帶有的範圍。使用 Admin API 金鑰呼叫內容或目錄端點時，會回傳 403，並指出該端點系列所需的範圍：聊天、檔案、專案、專案附件、工作階段、使用者與群組成員需要 read:compliance_user_data；組織、角色、群組與有效組織設定需要 read:compliance_org_data。例如，列出聊天會回傳以下回應。
{
"error": {
"type": "permission_error",
"message": "Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']"
}
}若要存取內容端點，您父組織的主要擁有者（或組織擁有者，僅限其自身組織）必須建立 Compliance Access Key，並帶有 read:compliance_user_data（若需刪除則加上 delete:compliance_user_data），或針對組織、角色、群組與有效設定端點帶有 read:compliance_org_data。獨立的 Claude Console 組織（即沒有父組織的組織）無法建立 Compliance Access Key，因此無法使用內容端點；它只能查詢 Activity Feed。完整的各端點目錄請參閱處理 Compliance API 錯誤。
資料涵蓋範圍與保留
Activity Feed 會保留 6 年的組織活動，且新事件在發生後 1 分鐘內即可查詢。摘要最多只能回溯至您的組織首次啟用 Compliance API 的時間點：記錄不具追溯性，啟用前的活動不會被回填。Activity Feed 的保留期與您組織的內容保留政策無關：聊天、檔案與專案內容遵循為您組織設定的保留規則（預設為無限期），除非使用者提前將其刪除。
不包含。Activity Feed 記錄的是誰在何時做了什麼（驗證、建立聊天、上傳檔案、專案變更、管理動作及類似的資源事件），但不會擷取聊天或訊息中的提示文字或模型回應。
若要擷取訊息本文與檔案內容，請使用帶有 read:compliance_user_data 的 Compliance Access Key 呼叫聊天、訊息與檔案端點。相同的金鑰與範圍可透過本機工作階段端點擷取使用者機器上工作階段（例如 Cowork 與 Claude Code 工作階段）的逐字記錄，並透過遠端工作階段端點擷取雲端 Cowork 工作階段的逐字記錄。這些端點僅提供 Claude Enterprise 內容；Claude Console 工作負載以及使用 API 金鑰驗證的 Claude API 工作負載，會透過 Activity Feed 公開管理與資源事件，但不會透過 Compliance API 公開提示文字或模型回應。
會。在使用者機器上執行的 Claude Desktop 中的 Cowork 工作階段、Claude Code 工作階段（在終端機、Claude Desktop 或 IDE 擴充功能中）、Claude Science 桌面應用程式中的工作階段，以及 Excel、PowerPoint、Word 與 Outlook 中的 Claude for Microsoft 365 工作階段，只要使用者以其 Claude Enterprise 帳戶登入，就會被擷取，並可透過本機工作階段端點取得。在 claude.ai 網頁版或行動版上啟動、於 Anthropic 管理的環境中在雲端執行的 Cowork 工作階段，可透過遠端工作階段端點取得。每個系列都有一個回傳工作階段中繼資料的列表端點，以及一個回傳工作階段逐字記錄（使用者提示、助理回應，以及工具呼叫與結果）的訊息端點。本機系列另外新增第三個端點，用於擷取單一工作階段的中繼資料。所有這些端點都使用您現有帶有 read:compliance_user_data 的 Compliance Access Key；不需要新的金鑰或範圍。
本機工作階段是在其請求抵達 Claude API 時被擷取的，因此裝置上不會安裝任何東西，而從未抵達 API 的裝置端活動則不會被擷取。使用 Claude Console API 金鑰驗證的 Claude Code 工作階段、透過第三方雲端平台（Amazon Bedrock、Google Cloud 或 Microsoft Foundry）執行的 Claude Code 工作階段，以及網頁版 Claude Code 都不會被擷取。網頁版 Claude Code 同樣在 Anthropic 管理的環境中於雲端執行，但它不是遠端工作階段；遠端工作階段端點僅回傳 Cowork 工作階段。已啟用 HIPAA 就緒的組織不會取得任何本機工作階段資料，而適用零資料保留（ZDR）的工作階段則會被排除。
本機與遠端工作階段端點對於 Cowork 與 Claude Code 工作階段已穩定；對 Claude Science 與 Claude for Microsoft 365 工作階段的涵蓋目前為測試版。
本機與遠端工作階段逐字記錄都包含使用者提示、助理回應，以及工具呼叫與結果。對於本機工作階段（在使用者機器上），記錄的是 Claude 被要求做什麼以及它回傳了什麼，而非裝置上發生了什麼。
| 資料 | 本機工作階段（在使用者機器上） | 遠端工作階段（在雲端） |
|---|---|---|
| 使用者提示 | 是；以 text 區塊回傳。 | 是；以 text 區塊回傳。 |
| 助理回應 | 是；僅文字輸出。 | 是；僅文字輸出。 |
| 工具呼叫與結果 | 是；每個 tool_use 輸入與 tool_result 中的每個 text 項目預設截斷為 10,000 位元組（經申請可各提高至約 1 MiB）。 | 是；每個 tool_use 輸入與 tool_result 中的每個 text 項目預設截斷為 10,000 位元組（經申請可各提高至約 1 MiB）。 |
| 檔案內容與檔案名稱 | 是；Claude 透過工具讀取的文字會出現在逐字記錄中，並受相同的截斷限制。圖片、PDF 及其他二進位或結構化內容僅以預留位置 text 區塊呈現。檔案名稱會出現在工具呼叫的輸入與輸出中。 | 是；檔案內容與檔案名稱會透過工具呼叫的輸入與輸出出現在逐字記錄中（僅文字；其他內容會被省略）。 |
| Artifacts | 是；產生的內容會出現在逐字記錄中的工具呼叫輸入內。 | 是；產生的內容會出現在逐字記錄中的工具呼叫輸入內。 |
| Skills | 是；當用戶端將 skill 內容作為訊息內容傳送時會出現，且不會與其他使用者文字區分。 | 是；skill 內容會出現在逐字記錄中。 |
| 工作階段中繼資料 | 是；擁有者（user.id 與電子郵件地址）、組織、工作區、product_surface、created_at 與 updated_at，來自列表與擷取端點。本機工作階段不帶有 status。 | 是；擁有者、組織、狀態、時間戳記與 product_surface，來自列表端點。 |
| 思考區塊 | 否。 | 否。 |
| 圖片與其他非文字內容 | 否；每個圖片、PDF 或其他二進位或結構化區塊會以預留位置 text 區塊呈現（例如 [image content not shown]），且 truncated 設為 true。絕不會回傳原始檔案位元組。 | 否；非文字區塊會被省略，且絕不會回傳原始檔案位元組。 |
| Token 用量、成本與延遲 | 否；token 用量與成本可透過 Claude Enterprise Analytics API 取得。 | 否；token 用量與成本可透過 Claude Enterprise Analytics API 取得。 |
端點與參數請參閱使用者機器上的工作階段與雲端中的工作階段。
Cowork 的 OpenTelemetry 記錄與 Claude Code 監控與工作階段端點有所重疊，但滿足不同的需求：OTEL 會在活動發生時將逐事件遙測資料串流至您自行運行的基礎設施，而 Compliance API 則讓您事後從 Anthropic 擷取已保留的逐工作階段逐字記錄。OTEL 也可以擷取提示與回應，但 Anthropic 建議使用 Compliance API 來擷取 Cowork 與 Claude Code 工作階段的內容。比較本機工作階段、遠端工作階段與 OTEL 的表格，請參閱擷取工作階段逐字記錄的簡介。
OTEL 事件與 Compliance API 記錄共用組織與使用者識別碼，因此您可以將它們關聯起來。
不可以。透過 Compliance API 執行的刪除是立即、永久且無法復原的。使用者在 claude.ai 中刪除的聊天內容同樣無法復原：Compliance API 仍會回傳該聊天及其訊息，並填入 deleted_at，但不會回傳其內容。請在內容仍可取得時，擷取您需要保留的任何內容（用於法律保留或封存）。何時應將內容匯出至您自己的封存，請參閱規劃內容保留。
Compliance API 有已知的涵蓋邊界：Activity Feed 記錄資源事件，但不記錄提示或回應文字；使用 API 金鑰驗證的 Claude Console 與 Claude API 工作負載完全不公開訊息內容；而被您的保留政策移除、被使用者在 claude.ai 中刪除，或透過 Compliance API 硬刪除的內容均無法復原。完整的涵蓋邊界與傳遞契約，請參閱傳遞保證與完整性。
工作階段逐字記錄也有其自身的邊界。本機工作階段僅在其請求抵達 Claude API 時被擷取，因此從未抵達 API 的裝置端活動不會被擷取。使用 Claude Console API 金鑰驗證的 Claude Code 工作階段、透過第三方雲端平台（Amazon Bedrock、Google Cloud 或 Microsoft Foundry）執行的 Claude Code 工作階段，以及網頁版 Claude Code 同樣不會被擷取；已啟用 HIPAA 就緒的組織不會取得任何本機工作階段資料；而適用零資料保留的工作階段則會被排除。任何工作階段逐字記錄（無論本機或遠端）都不包含思考區塊或工具定義。使用客戶管理加密金鑰的組織會照常收到本機工作階段逐字記錄。當金鑰無法使用時，訊息端點會回傳 503 Service Unavailable 而非逐字記錄內容，而工作階段中繼資料仍會被列出。
整合與分頁
以 actor.user_id、actor.email_address、actor.ip_address、actor.user_agent 與 created_at 將 Activity 記錄與您的 SIEM 關聯。關聯鍵表格與取用模式請參閱設計您的合規整合。
可以。一個 Claude Enterprise 父組織可以擁有許多已連結的組織，包括 claude.ai 組織與 Claude Console 組織的混合（例如，分開的正式環境與預備環境 Claude Console 組織）。身分識別、SSO 與 SCIM 在父組織下共用；帳務、成員、專案與 API 金鑰則各組織分開。Compliance API 的啟用在父組織層級進行，並向下套用至所有已連結的組織，而涵蓋父組織且帶有 read:compliance_org_data 的 Compliance Access Key 可透過 GET /v1/compliance/organizations 列舉父組織下的每個組織。
活動以最新優先的順序回傳，created_at 相同時以活動 ID 決定先後。若要追上進度，請以 before_id 向前逐頁讀取，直到 has_more 為 false；該最終回應的 first_id 即為您的新游標，表示您已到達當前時間點。完整的迴圈（包括初始回填以及游標持久化的安全條件）請參閱游標驅動的增量讀取。
若僅測試 Activity Feed，您不需要 Claude Enterprise 組織：組織管理員可以在符合資格的獨立 Claude Console 測試組織上啟用 Compliance API，並使用新的 Admin API 金鑰查詢摘要。如果該組織的 Security 設定中看不到 Compliance API 區段，表示該組織不符合自助啟用的資格。
若要測試每個端點，請設定一個 Claude Enterprise 沙箱組織，並將其與同一父組織下的 Claude Console 組織連結。這讓沙箱可以同時測試 Activity Feed（透過 Admin API 金鑰）以及聊天、檔案、專案與工作階段端點（透過 Compliance Access Key）。
- **佈建 Claude Enterprise 組織。**請聯繫您的 Anthropic 代表以設定 Claude Enterprise 沙箱組織。在現有的 Claude Enterprise 組織上，主要擁有者可以直接在 claude.ai 中啟用 Compliance API。
- **建立 Claude Console 組織。**使用相同的電子郵件地址，自行在
platform.claude.com建立 Claude Console 組織。 - **連結兩個組織。**以 Claude Enterprise 組織的主要擁有者身分登入，前往 claude.ai > Organization settings > Identity and access，並使用 Merge Organizations 將兩者連結在共用的父組織之下。
連結完成後，請依照設定 Compliance API 建立金鑰並開始查詢。測試組織使用與正式組織相同的啟用流程。
Was this page helpful?