Claude inference hooks：每則提示詞送出前，先過一道放行或拒絕的檢查

inference hooks 的運作方式

你的組織（或它的資安廠商）會執行一台 AI 安全伺服器，也就是一個 HTTPS 端點。有人送出提示詞時，Anthropic 會把對話紀錄 POST 到這個端點，並依 Standard Webhooks 規範簽章，然後等待判定。判定為 allow 時推論照常進行；判定為 deny 時，請求根本不會送到模型，使用者會看到你提供的原因，以及管理員預先設定的一段固定訊息。

• 兩種事件：prompt 在每次受管控的推論請求之前觸發；tool_call 在 Claude 回應中的工具呼叫執行之前觸發，需要開啟 Validate tool calls（驗證工具呼叫）。
• 整個組織只需設定一次：claude.ai、Claude Desktop 與行動版、Claude Code（包括 CLI）、Cowork、Claude for Microsoft 365、Claude Tag 以及 Claude in Chrome。
• 你的伺服器看得到的內容：對話紀錄文字、工具呼叫及其結果，以及從附件擷取出的文字。原始檔案或圖片位元組、系統提示詞和工具定義一律不會送出。
• 判定只有 allow 和 deny 兩種，不支援改寫或遮蔽提示詞。
• 每一次拒絕都會記錄在組織的 Activity Feed（活動動態）中。

inference hooks、Claude Code hooks 與 Compliance API 比較

名稱很像，但它們是三種不同的工具。Claude Code hooks 依專案或依使用者設定，在開發者自己的電腦上執行；inference hooks 由組織統一設定一次，在 Anthropic 那一端執行。

如何設定 inference hooks

你需要 Owner 或 Primary owner 角色（Admin 不夠），以及一個使用 443 連接埠的公開 HTTPS 端點。ngrok 之類的通道會被封鎖，所以測試伺服器要架在你自己掌控的網域上。

1. 允許這項功能

   在 claude.ai 開啟 Organization settings → Data and privacy（組織設定 → 資料與隱私），在 Inference hooks 底下開啟 Allow for your organization（為你的組織允許）。這一步並不會開始檢查：Enforce verdicts（執行判定）仍維持關閉。

2. 新增端點並保存簽章金鑰

   點選 Configure（設定），輸入你的 https:// URL 並儲存。第一次儲存時會顯示一次 webhook 簽章金鑰：請妥善保存，你的伺服器要用它驗證每一個請求。

3. 新增標頭並測試

   最多可新增 16 個靜態標頭，讓你的伺服器驗證請求確實來自 Anthropic，接著點選 Test connection（測試連線）。它會送出一則合成的提示詞，並回報判定結果和往返時間。

4. 以 HTTP 200 JSON 回傳判定

   每個請求都以 HTTP 200 和一個 action 回應。非 200 的狀態碼會被視為失敗，而不是拒絕。

   // 放行請求
   { "action": "allow" }
   
   // 拒絕請求：deny_reason 會顯示給使用者（最多 500 個字元），
   // reference_id 只會進入你的合規活動紀錄
   {
     "action": "deny",
     "deny_reason": "這則提示詞似乎包含客戶的信用卡資料。",
     "reference_id": "scan_01HXPT4R9V"
   }

5. 選擇失敗處理方式與逾時時間

   Block the request（攔截請求）代表失敗時關閉（fail closed），Allow the request（放行請求）代表失敗時放行（fail open）。判定逾時可設為 1 到 10,000 毫秒，預設 5,000；判定太慢會被視為無法連線。連續失敗會觸發斷路器，在伺服器恢復之前一律套用你的失敗處理設定。

6. 逐步推行，再開啟執行

   先從 Shadow mode（影子模式）開始，它會照常送出判定但不攔截任何請求；只檢查一定比例的請求，必要時排除自訂角色，然後再開啟 Enforce verdicts。變更大約一分鐘內就會同步到所有伺服器。

來源：Claude Platform 文件，Inference hooks

限制與注意事項

• 僅限 Enterprise：Team、Pro 和 Max 無法使用，Claude Platform（API）組織無法使用，Amazon Bedrock 和 Google Cloud 上也無法使用。
• 純圖片內容（例如文件的螢幕截圖）不會被檢查，因為原始位元組從不送出。
• 被拒絕的訊息仍會留在對話紀錄中，並隨之後的每則訊息再次送出。在 Claude Code 裡，可以用 /rewind 回到帶入它的那則提示詞，或用 /clear 重新開始。
• Anthropic 自己的部分背景模型呼叫不受管控，例如託管的 Claude Security 掃描、GitHub pull request 上的 Code Review，以及智慧報告。在 Claude Code 本機執行 /code-review 則受管控。
• 在語音模式下，有一小部分工具呼叫不會送出，所以別把 hooks 當成那裡唯一的管控手段。
• 同一則公告也推出了安全中心（beta），會把你的 Claude、Cowork 和 Claude Code 設定與 Anthropic 建議的設定做比較，另外還有 beta 階段的集中管理與存取控制。

為什麼這對自主執行的 agent 很重要

當 Claude Code 在無人看管的情況下工作，依排程或在背景執行時，沒有人會在每則提示詞送出前逐一查看。inference hooks 讓公司對每個請求和每次工具呼叫都有一道內嵌檢查，不論 agent 在哪裡執行；影子模式也讓資安團隊能在真正攔截之前先調整好政策。若需要單台電腦上依專案設定的防護，Claude Code 本身的 hooks 和權限規則依然適用；權限模式請見 Claude Code plan mode。

為你不在時仍在工作的 AI 員工設好護欄

Crewmark 把 Claude Code、Codex、DeepSeek Harness 或 OpenCode 工作階段變成有職位、目標和工作時間的 AI 員工，並依心跳喚醒它，從看板上接手下一個 issue。在 Claude Enterprise 方案下，inference hooks 會像檢查其他人一樣檢查它的提示詞。

1. 決定哪些事需要你同意

   每位員工在發布、合併或花錢等有風險的操作之前都會先詢問，你在同一個收件匣裡核准。

2. 把紀錄留在看板上

   每個 issue 都保留員工的留言和狀態變更，你可以把它做過的事和資安團隊的日誌對照檢視。

3. 讓心跳啟動工作

   在工作時間內，員工每 15、30 或 60 分鐘會在同一個對話中醒來一次；請參考如何讓 Claude Code 主動工作和什麼是 AI 員工。

Claude inference hooks 常見問題