Claude Code Hooks：把 AI Agent 的行為約束寫成程式

Hooks 解決的不是「提醒」，而是「執行前控制」

一般專案會把行為規則寫在 CLAUDE.md 或團隊文件中，例如不要碰 production env、修改後要跑測試、提交前要檢查 lint。問題是這些規則仍然要靠模型在每一輪都理解、記得、並主動遵守。上下文變長、任務變複雜、工具變多時，提醒就會變成脆弱的安全機制。

Hooks 的差別在於它們跑的是預先寫好的程式。當 Claude Code 即將呼叫工具、寫檔、執行命令或結束任務時，Hook 可以先檢查輸入、決定是否放行，或把結果同步到外部系統。這讓「不要做某件事」從提示詞變成可測、可審查、可重複執行的控制層。

設定檔其實有三層：事件、匹配規則、實際動作

文章最實用的部分，是把 Hooks 的設定拆成三層來看。第一層是事件 registry，決定要在哪個時間點介入；第二層是 matcher，決定哪些工具或情境會被這組 Hook 處理；第三層才是實際 Hook，也就是要執行的 command、HTTP call 或 MCP tool。

主流程事件能擋下操作，旁路事件適合觀測與通知

Rahul 特別提醒一個容易混淆的點：事件不是父子關係。PreToolUse 和 PermissionRequest 可能接連發生，但它們是不同的介入點。設計 Hooks 時要先分清楚，這個事件是要影響 Claude 下一步，還是只是旁路同步資料。

要阻擋 Claude，不要只回傳一般失敗

文章指出一個實務陷阱：傳統 shell 腳本裡 exit 1 常代表失敗，但在 Hook 流程中，這不等於明確阻擋。真正需要的是系統錯誤訊號，或用結構化 JSON 回傳政策決策。後者通常更適合團隊規則，因為它能說清楚拒絕原因，也能引導模型改用安全替代方案。

{
  "decision": "deny",
  "reason": "production config must be edited manually"
}

{
  "decision": "ask",
  "reason": "this command modifies deployment state"
}

最值得先做的 Hook：保護不可自動修改的檔案

如果只挑一個起點，文章建議從保護 production 環境檔開始。這不是最華麗的用法，但最能展現 Hooks 的價值：規則不是寫在文件裡等待模型記得，而是在每次 Write 或 Edit 前由腳本讀取 tool input，檢查目標路徑，符合保護規則就拒絕。