Claude Code Hook 食譜：Stop 事件桌面通知＋音效（跨 macOS／Linux／Windows）

AI 在跑長任務，你卻得一直盯著終端機看它好了沒？
掛一個 Stop hook，完工自動「叮」一聲＋跳桌面通知——去喝杯咖啡，它會叫你回來。

[ Log in to see the full prompt ]

## 這是什麼／解決什麼痛點 長任務最浪費的不是 AI 的時間、是你的注意力：你叫 Claude Code 去跑一個要好幾分鐘的重構或測試，然後就得一直瞄終端機，怕它早就跑完在等你、或卡在某個提問。這個 Stop hook 把這件事自動化——只要 Claude 結束一輪回應，就跳一則桌面通知＋播一聲提示音。你可以安心切去看文件、回訊息、泡咖啡，完工它會主動「叫」你回來。這是少數「一次設定、天天回本」的生產力小設定。 ## 為什麼這來源值得用 「跑完播聲音／通知」是 hooks 的經典用法，而且有兩個開放授權的實作背書本食譜：rohitg00/awesome-claude-code-toolkit（Apache-2.0）內含 `claude-sounds`，用 macOS 的 `afplay` 對約 10 個生命週期事件（含任務完成）播音；decider/claude-hooks（MIT）則提供一個專門的 Stop 事件「Task Completion Notifier」，在 Claude 結束時送通知。我把這兩者的概念合成一個「跨平台」腳本：自動判斷 macOS / 原生 Linux / WSL，分別用 afplay+osascript、paplay/aplay+notify-send、或 PowerShell，讓你不論在哪種環境都能用同一份設定。 ## 怎麼用（步驟） 1. 把 JSON 併進 `~/.claude/settings.json`（放全域，所有專案都通知）。注意 Stop hook 通常不需要 `matcher`。 2. 建立 `notify-on-stop.sh`，貼上腳本並 `chmod +x`。 3. 設定 `{{NOTIFY_TITLE}}` 與 `{{NOTIFY_MESSAGE}}`（例如「Claude Code」「任務完成 ✅」）。 4. 依平台填音效路徑：macOS 用 `{{MAC_SOUND_PATH}}`（例 `/System/Library/Sounds/Glass.aiff`）；Linux 用 `{{LINUX_SOUND_PATH}}`（指向任一 .wav）。 5. Linux 桌面記得有 `notify-send`（多半在 `libnotify-bin` 套件）；WSL 想要桌面 toast 可裝 BurntToast PowerShell 模組，沒裝也至少會 beep。 6. 測試：隨便叫 AI 做件小事，等它停下來，應該會「叮」一聲＋跳通知。 ## 要點與何時用 - **Stop vs Notification 是兩個事件**：Stop 是「這輪結束」，Notification 是「需要你輸入／核准」。想用聽覺分辨「真的做完了」與「在等我按確認」，可以對兩個事件掛不同聲音。 - **全部用 `|| true` 包起來**：某台機器沒裝播音工具時，hook 不該因此報錯中斷——通知失敗頂多沒聲音，不要拖累主流程。 - **何時用**：跑長測試、大重構、批次資料處理、或你習慣同時開很多視窗多工時最有感。短互動其實也行，但你可能會嫌太吵——那就只在特定專案（專案層 settings.json）開。 📎 來源：rohitg00/awesome-claude-code-toolkit（作者 Rohit Ghumare，Apache-2.0 授權）的 claude-sounds，與 decider/claude-hooks（作者 decider，MIT 授權）的 Stop 事件 Task Completion Notifier — 本篇繁中改寫並整合為跨平台 Stop 通知＋音效設定，原始內容見上方連結。