鉤子
鉤子(Hooks)讓您可以在 Claude Code 生命週期的特定時間點執行指令。鉤子與本課程涵蓋的其他內容之間的主要差異在於,鉤子是確定性的——它們永遠都會執行。
為什麼要使用鉤子
您可以在 CLAUDE.md 中告訴 Claude 在每次編輯檔案後執行 Prettier。大多數時候它會照做,但有時候不會。鉤子則能確保每次都會執行,沒有例外。
常見的使用情境包括:
- 編輯檔案後自動格式化
- 記錄所有已執行的指令以符合合規要求
- 封鎖危險操作,例如修改正式環境檔案
- 在 Claude 完成任務時傳送通知給自己
運作方式
鉤子是在您的 settings.json 中設定的。您可以選擇一個事件,選擇性地設定一個比對條件(matcher)來指定它適用於哪些工具,並提供要執行的指令。以下是一些最常見的事件:
- PreToolUse — 在工具呼叫之前執行
- PostToolUse — 在工具呼叫完成後執行
- UserPromptSubmit — 在您提交提示、Claude 處理之前執行
- Stop — 在 Claude 完成回應時執行
- Notification — 在 Claude 傳送通知時執行
這些只是您可以掛接的一小部分事件——Claude Code 還支援更多事件。完整清單請參閱鉤子參考文件(在新分頁中開啟)。
您可以直接編輯 settings.json 來設定它們。Claude Code 中的 /hooks 指令會開啟一個唯讀清單,顯示您已設定的鉤子,方便您確認新設定的鉤子是否出現。

實際範例
最常見的鉤子:編輯後自動格式化。設定一個比對條件為 "Edit|Write" 的 PostToolUse 鉤子,讓它在 Claude 使用 Edit 或 Write 工具後觸發。該指令會執行您專案所使用的任何格式化工具。若使用 Prettier,請將以下內容加入 .claude/settings.json(需要 jq):
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "file=$(jq -r '.tool_input.file_path') && npx prettier --write -- \"$file\""
}
]
}
]
}
}若要測試,請讓 Claude 編輯一個檔案,然後確認該檔案已被重新格式化。
使用 PreToolUse 封鎖操作
PreToolUse 鉤子可以在工具呼叫執行前封鎖它們。您的鉤子會透過 stdin 以 JSON 格式接收工具名稱與輸入內容。結束代碼(exit code)決定了行為:
- 結束代碼 0 — 正常繼續執行。
- 結束代碼 2 — 封鎖該操作。stderr 訊息會回饋給 Claude,讓它知道為什麼被封鎖,以便調整。
- 其他任何結束代碼 — 屬於非封鎖性的錯誤,會顯示給您看,但不會阻止任何事情。
這就是您強制執行硬性規則的方式。封鎖對正式環境設定目錄的寫入。封鎖包含 rm -rf 的 bash 指令。封鎖對 main 分支的提交。只要是您團隊需要保證發生(而非只是建議)的事情,都可以這樣做。

與團隊共用鉤子
在 .claude/settings.json 中設定的鉤子屬於專案層級,可以一併加入版本控制並提交到您的儲存庫中。這表示您的整個團隊都會自動獲得相同的鉤子。請在您的指令中使用 CLAUDE_PROJECT_DIR 環境變數來參照儲存在專案中的腳本,這樣無論 Claude 目前的工作目錄為何,這些腳本都能正常運作。
重點回顧
鉤子讓您能夠對 Claude Code 的行為進行確定性的控制。使用 PostToolUse 來進行自動格式化與記錄。使用 PreToolUse 來封鎖危險操作。在 settings.json 中設定它們,並使用 /hooks 檢視它們。再將它們提交到您的儲存庫中,讓您的團隊也能一起使用。
如果某件事必須每次都確實發生,不要把它寫進提示裡,而是把它放進鉤子裡。