--- title: Compliance API 常見問題 url: https://platform.claude.com/docs/zh-TW/manage-claude/compliance-faq description: 關於 Compliance API 存取、範圍、保留與整合等常見問題的解答。 --- 若要啟用 Compliance API，請參閱[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access)。 ## 存取與範圍 對於 Claude Enterprise 組織，主要擁有者會在 [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) 啟用 Compliance API，且啟用設定會從父組織向下套用至每個已連結的組織。對於符合資格的獨立 Claude Console 組織（沒有父組織的組織），組織管理員會在 Claude Console 的 [Compliance](https://platform.claude.com/settings/security) 頁面（`platform.claude.com/settings/security`）上啟用它。已連結至父組織的 Claude Console 組織不會自行啟用 Compliance API；它是從父組織啟用的。相關步驟請參閱[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#set-up-the-compliance-api)。 可以。對於獨立的 Claude Console 組織，組織管理員可以在 Claude Console 的 [Compliance](https://platform.claude.com/settings/security) 頁面（`platform.claude.com/settings/security`）上關閉 **Compliance API** 切換開關，也就是開啟它的同一個位置。當 Compliance API 關閉時，不會為您的組織記錄任何活動事件，因此 [Activity Feed](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed) 不會收到新事件。如果您的組織已加入 [Access Transparency](https://platform.claude.com/docs/zh-TW/manage-claude/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](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed) 中，因此您的稽核軌跡會顯示是誰在何時變更了此設定。此活動是記錄停止的例外：即使在 Compliance API 關閉期間不會記錄其他任何活動，停用動作本身仍會被記錄。 這是預期行為。Claude Enterprise 父組織會集中管理所有已連結組織的身分識別；它不承載工作負載，也完全不會出現在 Claude Console 中。Claude Console 只會顯示連結在父組織之下的 Claude Console 組織。 若要呼叫 Compliance API，您需要改為建立以下兩種金鑰類型之一： * **若需要完整的 Compliance API 存取權（[Activity Feed](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed) 加上聊天、檔案、專案、工作階段、使用者、組織中繼資料與組織設定），**由父組織的主要擁有者（或組織擁有者，若金鑰僅限於其自身組織）在 claude.ai 中建立 [Compliance Access Key](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#set-up-the-compliance-api)。 * **若僅需要 Activity Feed 存取權，**由您 Claude Console 組織中的組織管理員在 Claude Console 中建立 [Admin API 金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#create-an-admin-api-key)。該組織必須已啟用 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-...`）。完整對應關係請參閱[您需要哪種金鑰？](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#which-key-do-you-need)。 Admin API 金鑰唯一的 Compliance API「scope」（範圍）是 `read:compliance_activities`，它僅授權存取 Activity Feed。其他所有 Compliance API 端點都需要只有在 claude.ai 中建立的 Compliance Access Key 才能帶有的範圍。使用 Admin API 金鑰呼叫內容或目錄端點時，會傳回 403，並指出該端點系列所需的範圍：聊天、檔案、專案、專案附件、工作階段、使用者和群組成員需要 `read:compliance_user_data`，而組織、角色、群組和有效組織設定需要 `read:compliance_org_data`。例如，列出聊天會傳回以下回應。 ```json Response { "error": { "type": "permission_error", "message": "Missing required scopes. Got: ['api:admin', 'read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']" } } ``` 若要存取內容端點，您父組織的主要擁有者（或組織擁有者，僅限其自身組織）必須[建立 Compliance Access Key](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#set-up-the-compliance-api)，並帶有 `read:compliance_user_data`（若需刪除則加上 `delete:compliance_user_data`），或針對組織、角色、群組與有效設定端點帶有 `read:compliance_org_data`。獨立的 Claude Console 組織（即沒有父組織的組織）無法建立 Compliance Access Key，因此無法使用內容端點；它只能查詢 Activity Feed。完整的各端點目錄請參閱[處理 Compliance API 錯誤](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-errors#403-forbidden)。 ## 資料涵蓋範圍與保留 Activity Feed 會保留 6 年的組織活動，且新事件在發生後 1 分鐘內即可查詢。摘要最多只能回溯至您的組織首次啟用 Compliance API 的時間點：記錄不具追溯性，啟用前的活動不會被回填。Activity Feed 的保留期與您組織的內容保留政策無關：聊天、檔案與專案內容遵循為您組織設定的保留規則（預設為無限期），除非使用者提前將其刪除。 不包含。Activity Feed 記錄的是誰在何時做了什麼（驗證、建立聊天、上傳檔案、專案變更、管理動作及類似的資源事件），但不會擷取聊天或訊息中的提示文字或模型回應。 若要擷取訊息本文與檔案內容，請使用帶有 `read:compliance_user_data` 的 Compliance Access Key 呼叫聊天、訊息與檔案端點。相同的金鑰與範圍可透過[本機工作階段端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-local-sessions)擷取使用者機器上工作階段（例如 Cowork 與 Claude Code 工作階段）的逐字記錄，並透過[遠端工作階段端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-remote-sessions)擷取雲端 Cowork 工作階段的逐字記錄。這些端點僅提供 Claude Enterprise 內容；Claude Console 工作負載以及使用 API 金鑰驗證的 Claude API 工作負載，會透過 Activity Feed 公開管理與資源事件，但不會透過 Compliance API 公開提示文字或模型回應。 會。在使用者電腦上執行的 Claude Desktop 中的 Cowork 工作階段、Claude Code 工作階段（在終端機、Claude Desktop 或 IDE 擴充功能中）、Claude Science 桌面應用程式中的工作階段、Claude for Microsoft 365 工作階段（在 Excel、PowerPoint、Word 和 Outlook 中），以及 Claude in Chrome 瀏覽器擴充功能中的聊天，只要使用者以其 Claude Enterprise 帳戶登入，就會被擷取，並可透過[本機工作階段端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-local-sessions)取得。在 claude.ai 網頁版或行動版上啟動的 Cowork 工作階段會在 Anthropic 管理的環境中於雲端執行，可透過[遠端工作階段端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-remote-sessions)取得。每個系列都有一個傳回工作階段中繼資料的列表端點，以及一個傳回工作階段逐字記錄（使用者提示、助理回應，以及工具呼叫與結果）的訊息端點。本機系列另外提供第三個端點，用於擷取單一工作階段的中繼資料。所有這些端點都使用您現有的、帶有 `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 雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web)，都不會被擷取。這些雲端工作階段並非遠端工作階段，即使兩者都在雲端執行；遠端工作階段端點僅傳回 Cowork 工作階段。雲端中 Cowork 排程任務的每次執行都是一個遠端工作階段：遠端工作階段列表端點會將其作為[代理程式擁有的工作階段](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-remote-sessions)傳回（會設定 `agent_id`，且 `started_by_user` 會識別發起該次執行的人員），訊息端點則會傳回其逐字記錄，但兩者都不會傳回任務的名稱或排程。在雲端執行的 Claude Code 例行程序屬於 Claude Code 雲端工作階段，因此工作階段端點不會傳回它們。已啟用 [HIPAA 就緒](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#hipaa-readiness)的組織僅能取得 Cowork 和 Claude Code 的本機工作階段資料，且資料保存 30 天；適用「zero data retention」（零資料保留），即 [ZDR](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) 的工作階段則會被排除。 本機和遠端工作階段端點對於 Cowork、Claude Code 和 Claude for Microsoft 365 工作階段已是穩定版；對 Claude Science 和 Claude in Chrome 工作階段的涵蓋仍處於 beta 階段。 本機與遠端工作階段逐字記錄都包含使用者提示、助理回應，以及工具呼叫與結果。對於本機工作階段（在使用者機器上），記錄的是 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](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) 取得。 | 否；token 用量與成本可透過 [Claude Enterprise Analytics API](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api#get-access-to-the-claude-enterprise-analytics-api) 取得。 | 端點與參數請參閱[使用者機器上的工作階段](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-local-sessions)與[雲端中的工作階段](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-remote-sessions)。 [Cowork 的 OpenTelemetry 記錄](https://support.claude.com/en/articles/14477985-monitor-claude-cowork-activity-with-opentelemetry)與 [Claude Code 監控](https://code.claude.com/docs/zh-TW/monitoring-usage)與工作階段端點有所重疊，但滿足不同的需求：OTEL 會在活動發生時將逐事件遙測資料串流至您自行運行的基礎設施，而 Compliance API 則讓您事後從 Anthropic 擷取已保留的逐工作階段逐字記錄。OTEL 也可以擷取提示與回應，但 Anthropic 建議使用 Compliance API 來擷取 Cowork 與 Claude Code 工作階段的內容。比較本機工作階段、遠端工作階段與 OTEL 的表格，請參閱[擷取工作階段逐字記錄](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions)的簡介。 OTEL 事件與 Compliance API 記錄共用組織與使用者識別碼，因此您可以將它們關聯起來。 不可以。透過 Compliance API 執行的刪除是立即、永久且無法復原的。使用者在 claude.ai 中刪除的聊天內容同樣無法復原：Compliance API 仍會傳回該聊天及其訊息，並填入 `deleted_at`，但不會傳回其內容。使用者刪除的遠端工作階段同樣無法復原，且遠端工作階段端點將不再傳回它。請在內容仍可取得時，擷取您需要保留的任何內容（用於「legal hold」（法律保全）或封存）。關於何時將內容匯出到您自己的封存，請參閱[規劃內容保留](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-integration-patterns#plan-content-retention)。 Compliance API 有已知的涵蓋邊界：Activity Feed 記錄資源事件，但不記錄提示或回應文字；使用 API 金鑰驗證的 Claude Console 與 Claude API 工作負載完全不公開訊息內容；而被您的保留政策移除、被使用者在 claude.ai 中刪除，或透過 Compliance API 硬刪除的內容均無法復原。完整的涵蓋邊界與傳遞契約，請參閱[傳遞保證與完整性](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-integration-patterns#delivery-guarantees-and-completeness)。 工作階段逐字記錄也有其自身的邊界。本機工作階段僅在其請求抵達 Claude API 時才會被擷取，因此從未抵達 API 的裝置端活動不會被擷取。使用 Claude Console API 金鑰驗證的 Claude Code 工作階段、透過第三方雲端平台（Amazon Bedrock、Google Cloud 或 Microsoft Foundry）執行的 Claude Code 工作階段，以及在雲端基礎架構而非使用者電腦上執行的 [Claude Code 雲端工作階段](https://code.claude.com/docs/zh-TW/claude-code-on-the-web)（包括在雲端執行的 Claude Code 例行程序），也都不會被擷取；已啟用 HIPAA 就緒的組織僅能取得 Cowork 和 Claude Code 的本機工作階段資料，且資料保存 30 天；適用零資料保留的工作階段則會被排除。任何工作階段逐字記錄（無論本機或遠端）都不包含思考區塊或工具定義。使用[客戶管理的加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)的組織會照常收到本機工作階段逐字記錄。在金鑰無法使用期間，訊息端點會傳回 [503 Service Unavailable](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-errors#local-sessions-temporarily-unavailable) 而非逐字記錄內容，但工作階段中繼資料仍會被列出。 沒有任何 Compliance API 端點會列出組織的 Cowork 排程任務或 Claude Code 例行程序。 ## 整合與分頁 以 `actor.user_id`、`actor.email_address`、`actor.ip_address`、`actor.user_agent` 與 `created_at` 將 `Activity` 記錄與您的 SIEM 關聯。關聯鍵表格與取用模式請參閱[設計您的合規整合](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-integration-patterns#correlate-with-your-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` 即為您的新游標，表示您已到達當前時間點。完整的迴圈（包括初始回填以及游標持久化的安全條件）請參閱[游標驅動的增量讀取](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-integration-patterns#cursor-driven-incremental-reads)。 若只要測試 [Activity Feed](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed)，您不需要 Claude Enterprise 組織：組織管理員可以在符合資格的獨立 Claude Console 測試組織上[啟用 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#set-up-the-compliance-api)，並使用新的 Admin API 金鑰查詢 Activity Feed。如果該組織在 Claude Console 中的 [Compliance](https://platform.claude.com/settings/security) 頁面（`platform.claude.com/settings/security`）顯示找不到頁面的錯誤，或未顯示 **Compliance API** 區段，則表示該組織不符合自助啟用的資格。 若要測試每個端點，請設定一個 Claude Enterprise 沙箱組織，並將其與同一父組織下的 Claude Console 組織連結。這讓沙箱可以同時測試 Activity Feed（透過 Admin API 金鑰）以及聊天、檔案、專案與工作階段端點（透過 Compliance Access Key）。 1. **佈建 Claude Enterprise 組織。**請聯繫您的 Anthropic 代表以設定 Claude Enterprise 沙箱組織。在現有的 Claude Enterprise 組織上，主要擁有者可以[直接在 claude.ai 中啟用 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access#set-up-the-compliance-api)。 2. **建立 Claude Console 組織。**使用相同的電子郵件地址，自行在 `platform.claude.com` 建立 Claude Console 組織。 3. **連結兩個組織。**以 Claude Enterprise 組織的主要擁有者身分登入，前往 [claude.ai > Organization settings > Identity and access](https://claude.ai/admin-settings/identity)，並使用 **Merge Organizations** 將兩者連結在共用的父組織之下。 連結完成後，請依照[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access) 建立金鑰並開始查詢。測試組織使用與正式組織相同的啟用流程。