Claude Code 任務完成提醒、提示音、Windows 通知怎麼設：終端響鈴、Notification hook 和 Stop hook 的區別

本文根據 Claude Code 官方文檔《Configure your terminal》《Automate actions with hooks》《Hooks reference》整理，資料核對於 2026-11-05。配圖為本站整理的示意圖，不是介面截圖。本站（bigolab.com）不是 Anthropic 官方網站。

適用於誰

• 讓 Claude Code 跑長任務，想去幹別的、做完再被叫回來的人；
• 搜「claude 任務結束時響鈴」「claude code hooks 通知 windows」的人；
• 已經配過 Hook，但提醒沒出來的人。

Hook 的基本寫法已經在 /guides/claude-code-hooks 裏整理過，這裏專門講「提醒」這一個用途，並補上 Windows 和終端響鈴。

結論先說

1. 官方有三條路：①設定項 preferredNotifChannel 設成 "terminal_bell"，讓終端響鈴；②Notification hook，在 Claude 等你輸入或批准時執行命令；③Stop hook，在 Claude 每次回覆完畢時執行命令。
2. 「做完了」和「等你」是兩個不同的事件：Notification 是 Claude 在等輸入或權限；Stop 是 Claude 完成回覆。想「任務完成就響一下」，Stop 更直接。
3. Windows 上官方的 Notification 示例是用 powershell.exe 彈一個對話框，不是螢幕角落的通知，對話框可能開在終端窗口後面。
4. 終端預設的提醒因終端而異：Ghostty、Kitty、iTerm2 預設發桌面通知（iTerm2 要先開提醒設定），Apple Terminal 預設無聲，其他終端預設什麼都沒有。
5. Hook 與內置通知並行，不是替代。

圖：本站根據 Claude Code 官方文檔：Configure your terminal 與 Automate actions with hooks 整理的示意圖

一、最簡單：讓終端響鈴

官方說，Claude 完成任務或停在權限提示上、而你似乎不在終端前時，會觸發一個通知事件。預設怎麼提醒取決於終端：

• Ghostty、Kitty、iTerm2：桌面通知，iTerm2 要先打開它的提醒設定；
• Apple Terminal：不出聲；當前窗口配置裏「Audible bell」關着時發一個靜默的響鈴字符，其他情況什麼都沒有；
• 其他終端：什麼都沒有。

要讓 Claude Code 不管終端、一律發響鈴字符，在 ~/.claude/settings.json（Windows 在用戶目錄的 .claude 文件夾裏）寫：

json
{
  "preferredNotifChannel": "terminal_bell"
}

在 Apple Terminal 裏還要在 Settings > Profiles > Advanced 打開 Audible bell 才能聽到。Windows Terminal 等終端收到響鈴字符後會不會發聲，官方沒有單獨說明，取決於終端自己的設定。

二、Notification hook：Claude 等你時彈窗

官方的 Windows 示例寫進 ~/.claude/settings.json：

json
{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

官方提醒：這條命令打開的是對話框，不是角落裏的通知，所以對話框可能開在終端窗口後面；先在 PowerShell 裏單獨測試這條命令。如果你在 WSL 裏跑 Claude Code，powershell.exe 必須能通過 Windows 互操作在 PATH 裏找到。macOS 用 osascript，Linux 用 notify-send（需要桌面通知服務，伺服器、SSH、容器裏通常沒有），完整示例見 /guides/claude-code-hooks。

空的 matcher 對所有通知類型生效。只想在特定情況下提醒，把 matcher 設為這些值之一（官方表格的一部分）：

寫完後，在 Claude Code 裏輸入 /hooks，應該能在 Notification 下看到它。要測試，按 Shift+Tab 切到 manual mode on，讓 Claude 做一件需要批准的事，然後切到別的窗口。

三、Stop hook：每次回覆完畢時執行

官方對 Stop 的描述是「Claude 回覆完畢時」觸發，不支持 matcher，每次都觸發。配置結構和 Notification 一樣，只是事件名換成 Stop，並且可以省略 matcher：

json
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[console]::beep(800,300)\""
          }
        ]
      }
    ]
  }
}

說明：這裏的 command 是本文補充的寫法，官方文檔沒有給 Stop hook 的 Windows 示例；[console]::beep 是 PowerShell 裏調用系統蜂鳴的通用方法，能不能出聲取決於你的電腦和系統設定。想彈窗而不是響鈴，可以把命令換成上面官方的 MessageBox 寫法。

注意 Stop 每個回合都會觸發，包括你隨手問一句得到的短回答，不想被頻繁打擾就用 Notification 加 idle_prompt。Hook 的更多限制，比如 Stop hook 用退出碼 2 會讓 Claude 繼續而不是停下，見官方 Hooks 參考頁，這裏不展開。

四、提醒沒出來，按這幾處查

圖：本站根據 Claude Code 官方文檔：Automate actions with hooks 與 Configure your terminal 整理的示意圖

• /hooks 裏看不到：確認 JSON 有效，尾逗號和註釋都不允許；文件在 ~/.claude/settings.json（全局）或 .claude/settings.json（項目）；改完通常自動生效，幾秒內沒出現就重啟會話；
• Hook 在列表裏但沒執行：檢查事件名和 matcher 是否一致，matcher 區分大小寫；
• 看到 blocking because Git Bash wasn't found：這是 Windows 上沒找到 Git Bash，失敗或超時的 hook 還攔住了工具調用，官方在 Hooks 參考頁有「Failed hooks on Windows without Git Bash」一節說明修法；
• 在 tmux 裏收不到桌面通知：官方說預設情況下通知和進度條到不了外層終端，要在 ~/.tmux.conf 加 set -g allow-passthrough on，再運行 tmux source-file ~/.tmux.conf；
• iTerm2 沒通知：要在 Settings → Profiles → Terminal 裏勾選 Notification Center Alerts，再點 Filter Alerts 啟用 Send escape sequence-generated alerts；
• 還是沒有，確認終端程序在系統設定裏有通知權限。

通過 SSH 登入遠程伺服器時，官方說桌面通知能到達你本機，所以遠程會話也能提醒你，詳見 /guides/claude-code-ssh-remote-server。

常見問題

Q：Hook 會消耗額度嗎？

Hook 是在本機運行的 shell 命令，官方沒有說它消耗模型額度。額度怎麼算見 /guides/claude-usage-limits。

Q：能不能用手機收提醒？

本文沒有核對官方的手機通知功能的細節，需要的話以官方文檔為準。

Q：和狀態欄有關係嗎？

沒有。狀態欄是顯示資訊的，見 /guides/claude-code-statusline-model-context-usage。

相關教學

• /guides/claude-code-hooks：Hook 的完整寫法
• /guides/claude-code-settings-json：settings.json 位置與優先級

參考資料

• Claude Code 官方文檔：Configure your terminal — https://code.claude.com/docs/en/terminal-config
• Claude Code 官方文檔：Automate actions with hooks — https://code.claude.com/docs/en/hooks-guide
• Claude Code 官方文檔：Hooks reference — https://code.claude.com/docs/en/hooks