MacPip你的下一款 Mac 應用程式就在這裡。macpip.com →

如何在 Claude Code 或 Codex 完成時收到通知

2026年10月22日 更新

你在 Claude Code 或 Codex 裡開始一個很長的任務,切去做別的事,十分鐘後回來才發現它兩分鐘時就停了,一直在等你按「是」。在代理完成或需要你同意時響一聲或跳出通知,就能解決這個問題。

兩個工具都能免費做到,用內建功能或加一兩行設定就行。這篇指南會一步步介紹每種方法。

重點整理

  • Claude Code 在 Ghostty、Kitty 和 iTerm2 裡本來就能通知你(iTerm2 需要改一個設定)。在其他終端機裡,加一個掛鉤(hook)。
  • Claude Code 的 Stop 掛鉤會在它完成時觸發;Notification 掛鉤會在它需要你時觸發。把任一個指向 afplay 播放聲音,或指向 osascript 顯示通知。
  • Codex:在 ~/.codex/config.toml 加一行 notify,或打開它內建的終端機通知。
  • 什麼都沒發生?重新開始工作階段:掛鉤是在工作階段開始時讀取的。

代理怎麼告訴你它做完了

Claude Code 或 Codex完成,或需要你
Hook / notify執行你的指令
你聽到了聲音 · 橫幅 · 響鈴
本頁的每種方法原理都一樣:代理在對的時機執行一個指令。

兩個工具都能在對的時機執行你指定的指令。這就是通知的本質:Claude Code 叫它 hook(掛鉤),Codex 叫它 notify。不管這個指令做什麼(播放聲音、顯示橫幅、讓螢幕閃一下),都會在代理停下來或要求輸入時發生。

代理工作時,Mac 更舒服一點

Clacky 讓代理工作時的 Mac 本身更舒服:點擊音效和鍵盤音效,想展示代理做出了什麼時還有螢幕錄影。一次付清 $4.99,用於 1 台 Mac。

Claude Code:內建通知

Claude Code 完成時,或在權限提示上等待時,可以自己送出桌面通知。Anthropic 的文件說,這在 Ghostty 和 Kitty 裡開箱即用。在 iTerm2 裡,要先打開一次:

  1. iTerm2 → Settings → Profiles → Terminal。
  2. 勾選 Notification Center Alerts。
  3. 按 Filter Alerts,然後啟用 Send escape sequence-generated alerts。

在 tmux 裡執行 Claude Code?在 ~/.tmux.conf 加上 set -g allow-passthrough on,否則通知永遠到不了你的終端機。你也可以在 Claude Code 的 /config 設定裡選擇它怎麼通知你(例如終端機鈴聲)。

來源:Claude Code 文件:終端機設定

Claude Code:會播放聲音的掛鉤

在 Apple 的「終端機」、VS Code 或任何其他終端機裡,用掛鉤就能做到。掛鉤放在 ~/.claude/settings.json(所有專案)或 .claude/settings.json(單一專案)。有兩個事件很重要:

  • Stop:Claude 回答完了。
  • Notification:Claude 需要你(權限提示,或它已經在等你輸入)。

下面這段會在兩種情況都播放 macOS 音效。把它合併到你的設定檔裡(保留檔案中原有的內容):

{
  "hooks": {
    "Stop": [{ "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }] }],
    "Notification": [{ "matcher": "", "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" }] }]
  }
}

比較喜歡橫幅通知?改用這個指令(和 Anthropic 的範例相同):

osascript -e 'display notification "Claude Code needs your attention" with title "Claude Code"'

在 Claude Code 裡輸入 /hooks 可以看到目前設定了什麼。新的掛鉤會套用到儲存後才開始的工作階段。/System/Library/Sounds/ 裡的音效都可以自由使用:Glass、Ping、Pop、Purr、Submarine 等等。

來源:hooks 參考文件 · hooks 指南

Codex:notify 設定

Codex CLI 會在每一輪結束後執行你指定的程式,用 ~/.codex/config.toml 裡的 notify 設定。Codex 會把這一輪的 JSON 描述加在最後一個參數(它的 type 是 agent-turn-complete),簡單的聲音指令可以忽略它:

notify = ["sh", "-c", "afplay /System/Library/Sounds/Glass.aiff"]

notify 是最上層的鍵:要放在檔案裡任何 [section] 的上方。Codex 的終端機介面也有內建通知([tui] 底下的 notifications),會使用終端機本身的通知或鈴聲;看不看得到橫幅取決於你的終端機。

Codex 的 notify 在一輪完成時觸發。它不像 Claude Code 的 Notification 掛鉤那樣,有獨立的「需要你核准」事件。

來源:Codex 文件:進階設定

如果什麼都沒發生

  • 重新開始工作階段。 掛鉤是在工作階段開始時讀取的,所以已經在跑的工作階段不會通知。
  • 確認檔案能正確解析。 settings.json 少一個逗號,所有掛鉤都會失效。把它貼到任何 JSON 檢查工具看看。
  • 單獨測試指令。 在「終端機」執行 afplay /System/Library/Sounds/Glass.aiff。沒聲音?檢查你的輸出裝置和音量。
  • 看不到橫幅? 到「系統設定」→通知檢查你的終端機(使用 osascript 的話是「工序指令編寫程式」),以及專注模式。
  • 同時響兩聲? 你有兩套設定(例如 ~/.claude/settings.json 裡的一個掛鉤,和專案 .claude/settings.json 裡的另一個)。留一套就好。

常見問題

Claude Code 有內建的通知聲音嗎?

它可以在 Ghostty、Kitty 和 iTerm2 裡自己送出桌面通知(iTerm2 需要打開 Send escape sequence-generated alerts)。想在任何終端機裡有聲音,加一個執行 afplay 的 Stop 或 Notification 掛鉤。

Stop 和 Notification 掛鉤有什麼不同?

Stop 在 Claude 回答完時執行。Notification 在 Claude 需要你時執行:權限提示,或它已經在等你輸入。大多數人兩個都想要,並配上不同的聲音。

Codex 可以在需要核准時告訴我嗎?

Codex 的 notify 程式在一輪完成時執行(agent-turn-complete)。目前它沒有獨立的核准事件,所以你會在這一輪結束時聽到。

第一次認識 Clacky?它是一個溫馨的 Mac 選單列 App,有點按音效和鍵盤音效、螢幕錄影、截圖,還有一座隨你工作慢慢長大的小港口小鎮。 查看所有工具 · 在瀏覽器裡聽聽聲音

2026年10月22日 確認。 有東西變了,或這裡寫錯了?請寄信到 hello@clacky.app。