Claude Code Hooks

Claude Code Hooks，視覺化呈現。

Claude Code hooks 允許您在 Claude Code 生命週期的每個關鍵事件上執行確定性的 shell 命令：在使用工具之前、使用工具之後、提交提示時、代理停止時或傳送通知時。AgentsRoom 是視覺化指揮中心，讓您能夠跨數十個專案、在數十個 Claude Code 代理之間實時觀察每一次 hook 觸發。

Hooks 是 Anthropic 官方為 Claude Code 新增確定性自動化、護欄、審計跟蹤和自定義副作用的方式。AgentsRoom 不會替代您的 hooks。它執行真正的 Claude Code CLI，因此您在 .claude/settings.json 中配置的每一個 hook 都將按預期精確工作。AgentsRoom 所增加的是可見性：一個實時儀表板，讓您可以按代理、按專案、按執行檢視每一次 hook 觸發。

什麼是 Claude Code hooks？

Claude Code hooks 是使用者定義的 shell 命令，Claude Code 會在代理會話期間的特定節點自動執行它們。它們在 .claude/settings.json（共享，提交到 git）或 .claude/settings.local.json（個人，gitignored）中配置，為您的 Claude Code 代理行為提供確定性的控制。提示是機率性的，而 hook 是 100% 確定性的：每次匹配的事件觸發時它都會執行，沒有例外。

Hooks 是 Anthropic 針對護欄、自動化、遙測、審計日誌和自定義整合需求的答案。您可以使用 Claude Code hooks 在每次編輯後自動格式化程式碼，在執行前阻止危險命令，將每次工具呼叫記錄到檔案，在代理等待輸入時傳送桌面通知，在會話結束時觸發 CI 任務，或將每個提示流式傳輸到可觀測性後端。任何您能編寫的 shell 命令，都可以連線到 Claude Code hook。

由於 hooks 存在於專案本身（.claude/settings.json 被提交到 git），它們會隨您的程式碼庫一起傳播。團隊中的每一位開發者，以及從該專案派生出的每一個 AI 代理，都會繼承同一張安全網。AgentsRoom 端到端尊重這一模型：桌面應用不會重寫您的 hooks，它作為子程序執行真正的 Claude Code CLI，它會像您從終端執行 claude code 一樣，自動讀取您的 hook 配置。

Claude Code 的 6 個 Hook 事件

每一次 Claude Code 代理會話都會在明確定義的節點觸發 hook 事件。以下是每個事件的含義以及您可以用它們做什麼。

PreToolUse

PreToolUse hook 在 Claude Code 執行任何工具（Bash、Edit、Write、Read、Grep 等）之前觸發。這是護欄的完美落點：阻止危險命令、對破壞性操作要求確認、執行專案特定規則，或在執行前重寫工具引數。從 hook 返回非零退出碼將完全阻止該工具呼叫。對於注重安全的團隊，PreToolUse 是最重要的 Claude Code hook。

PostToolUse

PostToolUse hook 在任何 Claude Code 工具完成後立即觸發。這是您連線自動後處理的地方：在每次 Edit 後執行格式化工具（Prettier、Black、rustfmt），在每次 Write 後觸發 linter，在檔案被修改時更新變更日誌，或推送遙測事件。PostToolUse 是將 Claude Code 變成守紀律團隊成員的麵包和黃油級 hook，讓程式碼庫比它來時更乾淨。

UserPromptSubmit

UserPromptSubmit hook 在新的提示被髮送到 Claude Code 代理時觸發。用它來為審計與合規記錄每一個提示、即時重寫提示（注入上下文、抹除敏感資訊）、將請求路由到不同模型，或強制命名約定。結合 AgentsRoom 的多代理儀表板，UserPromptSubmit 為您提供一個完整的審計軌跡，記錄傳送到每一個 Claude Code 代理的每一條指令。

Stop

Stop hook 在 Claude Code 代理會話結束時觸發，無論是任務已完成還是被取消。這是執行清理任務、將最終摘要推送到跟蹤系統、提交產物，或通知人類會話已結束的正確位置。AgentsRoom 用它自己的通知系統來補充 Stop hook，因此您會同時收到來自自定義 hook 和 AgentsRoom 桌面 + 移動推送通知的提醒。

Notification

Notification hook 在 Claude Code 傳送系統通知時觸發：通常是代理在等待使用者輸入或完成長時間執行的任務時。用它將通知路由到 Slack、Discord、Telegram、電子郵件或您喜歡的任何 webhook。AgentsRoom 已經在其多代理儀表板中原生呈現 Claude Code 通知，並作為手機上的推送通知，因此 Notification hook 是在其上新增自定義整合的完美位置。

SubagentStop

SubagentStop hook 在 Claude Code 子代理完成其工作並將控制權返回給父代理時觸發。如果您使用在 .claude/agents/*.md 中定義的 Claude Code 子代理委派專業化任務，SubagentStop 讓您記錄每個子代理做了什麼、聚合它們的輸出，或觸發後續步驟。在 AgentsRoom 內部，SubagentStop 事件會顯示在實時代理時間線中，因此您可以準確檢視每個 Claude Code 會話中執行了哪些子代理。

為什麼 Claude Code Hooks 很重要

Hooks 將 Claude Code 從一個令人印象深刻的 AI 變成您整個團隊都能信賴的生產級編碼代理。

確定性安全護欄

提示是機率性的，可能被繞過。Claude Code hooks 是始終執行的確定性 shell 命令。PreToolUse hook 可以阻止任何 rm -rf、任何 push --force、任何破壞性遷移：無論代理如何表述其推理。這是安全關鍵型 Claude Code 部署的黃金標準。

零成本自動化

將 Claude Code hooks 連線到您的格式化工具、linter、測試執行器、型別檢查器和建置腳本。代理進行的每次編輯都會觸發與您的 CI 流水線相同的檢查：本地、即時、自動完成。您的 Claude Code 代理將變成自律的貢獻者，永遠不會忘記執行格式化工具。

完整的審計跟蹤

每一個提示、每一次工具呼叫、每一次會話的啟動和停止都可以被 Claude Code hooks 記錄。結合 AgentsRoom 的視覺化時間線，您可以獲得每一次 AI 編碼代理動作的完整審計跟蹤：這對合規要求高的團隊、注重安全的公司以及任何認真對待可觀測 AI 開發的人來說都是必不可少的。

團隊範圍的約定

由於 .claude/settings.json 被提交到 git，單一的 Claude Code hooks 配置集為團隊中的每一位開發者和從專案派生的每一個 AI 代理強制執行相同的約定。新團隊成員在克隆儲存庫的那一刻就繼承了護欄。透過一次 pull request 升級整個 AI 編碼團隊的行為。

實時 Hook 可觀測性

Claude Code hooks 產生事件。AgentsRoom 將這些事件轉化為視覺化資訊流：每一次 hook 觸發、每一次工具呼叫、每一次狀態變化，按代理和按專案實時流式傳輸。您不再需要 tail 日誌：您在實時觀察您的 Claude Code 艦隊工作。

從觀察轉向監督

沒有 hooks，執行 Claude Code 意味著觀察每一次工具呼叫。有了 hooks，您將觀察委派給確定性程式碼，並在異常級別進行監督。AgentsRoom 放大了這一點：您可以同時看到所有受 hook 保護的 Claude Code 代理，只在真正需要您注意的時候才介入。

Claude Code Hooks + AgentsRoom

AgentsRoom 是 Claude Code 和其他 AI 編碼 CLI 的視覺化指揮中心。它不會 fork Claude Code，不會重新實現 hooks，也不會攔截工具呼叫。它在完整的 xterm.js 終端內作為子程序執行真正的 Claude Code CLI，這意味著您在 .claude/settings.json 或 .claude/settings.local.json 中定義的每個 hook 都將完全按照 Anthropic 的設計執行：沒有折衷、沒有意外、沒有隱形的中介軟體。

AgentsRoom 增加的是規模和可見性。您可以並行執行數十個 Claude Code 代理，跨越數十個專案，每一個都有自己的 hook 配置，並在一個儀表板上看到每一次 hook 觸發。結合 AgentsRoom 的每代理通知、行動版伴侶應用和實時狀態跟蹤，Claude Code hooks 成為您整個 AI 編碼運營的一流可觀測性層。

執行真正的 Claude Code CLI

AgentsRoom 在完整的 xterm.js 終端內生成真正的 claude CLI 程序。在 .claude/settings.json、.claude/settings.local.json 或使用者級設定中配置的任何 hook 都會自動觸發，就像您從終端執行 Claude Code 一樣。無補丁、無重寫、無保真度損失。

跨多代理艦隊的 Hook 事件

並行執行 10、20、50 個啟用 hooks 的 Claude Code 代理。AgentsRoom 的多代理儀表板會同時呈現每一個代理的 hook 觸發通知和狀態變化。您的 PreToolUse 護欄、PostToolUse 格式化工具和 Stop 處理程式都能在艦隊規模下執行。

跨專案 Hook 可見性

AgentsRoom 中的每個專案都有自己的 .claude/settings.json，因此有自己的 Claude Code hook 配置。側邊欄跨專案聚合實時狀態，因此您可以發現哪些 hooks 正在何處觸發、哪些代理因使用者輸入被阻塞，以及哪些 Stop hooks 剛剛完成了一次執行。

桌面 + 移動通知

AgentsRoom 隨附原生 macOS 通知和端到端加密的移動推送通知。Claude Code 的 Notification hook、Stop hook 和 SubagentStop hook 都會產生訊號，AgentsRoom 會直接在您的桌面和手機上呈現。您可以離開電腦，仍然能知道什麼時候 hook 告訴您該回來了。

Claude Code Hooks 常見問題

用一句話來說，Claude Code hooks 是什麼？+

Claude Code hooks 是使用者定義的 shell 命令，Claude Code 會在特定的生命週期事件（PreToolUse、PostToolUse、UserPromptSubmit、Stop、Notification、SubagentStop）上自動執行它們，為您的 AI 編碼代理行為提供確定性的控制。

Claude Code hooks 在哪裡配置？+

Claude Code hooks 位於 .claude/settings.json（提交到 git，與團隊共享）或 .claude/settings.local.json（gitignored，個人使用）。兩個檔案都會被 Claude Code CLI 自動讀取。AgentsRoom 執行真正的 Claude Code CLI，因此它在沒有任何額外配置的情況下尊重這兩個檔案。

AgentsRoom 會替代 Claude Code hooks 嗎？+

不會。AgentsRoom 不會替代、重寫或攔截 Claude Code hooks。它作為子程序執行真正的 Claude Code CLI，這意味著您的 hooks 會完全按照 Anthropic 的設計繼續執行。AgentsRoom 的角色是在 hook 驅動的 Claude Code 會話之上為您提供一個視覺化指揮中心和多代理儀表板。

我可以在 AgentsRoom 中監控 Claude Code hook 事件嗎？+

可以。AgentsRoom 實時流式傳輸每一次 Claude Code 會話的輸出，包括 hook 觸發的事件（格式化工具輸出、護欄拒絕、通知訊息、子代理停止）。多代理儀表板跨每一個正在執行的代理聚合狀態，因此您可以一目瞭然地發現哪些 hooks 在哪裡觸發。

最值得開始使用的 Claude Code hook 是哪一個？+

對大多數團隊而言，PostToolUse 是價值最高的第一個 hook：將它連線到您的格式化工具和 linter，這樣每一次 Edit 都會立即被清理。對於安全關鍵型專案，PreToolUse 不可或缺：在代理執行之前阻止破壞性的 Bash 命令。一旦這些就位，再新增 UserPromptSubmit 用於審計日誌和 Stop 用於完成遙測。

AgentsRoom 在 Claude Code hooks 上免費使用嗎？+

是的。AgentsRoom 可免費下載並用於最多 3 個專案。使用您自己的 Anthropic 訂閱或 API 金鑰。您在 .claude/settings.json 中配置的每一個 hook、每一個 PreToolUse 護欄、每一個 PostToolUse 格式化工具都會立即工作：無額外設定、無額外費用。