如何在 Claude Code 或 Codex 完成時收到通知
你在 Claude Code 或 Codex 裡開始一個很長的任務,切去做別的事,十分鐘後回來才發現它兩分鐘時就停了,一直在等你按「是」。在代理完成或需要你同意時響一聲或跳出通知,就能解決這個問題。
兩個工具都能免費做到,用內建功能或加一兩行設定就行。這篇指南會一步步介紹每種方法。
重點整理
- Claude Code 在 Ghostty、Kitty 和 iTerm2 裡本來就能通知你(iTerm2 需要改一個設定)。在其他終端機裡,加一個掛鉤(hook)。
- Claude Code 的 Stop 掛鉤會在它完成時觸發;Notification 掛鉤會在它需要你時觸發。把任一個指向
afplay播放聲音,或指向osascript顯示通知。 - Codex:在
~/.codex/config.toml加一行notify,或打開它內建的終端機通知。 - 什麼都沒發生?重新開始工作階段:掛鉤是在工作階段開始時讀取的。
代理怎麼告訴你它做完了
兩個工具都能在對的時機執行你指定的指令。這就是通知的本質:Claude Code 叫它 hook(掛鉤),Codex 叫它 notify。不管這個指令做什麼(播放聲音、顯示橫幅、讓螢幕閃一下),都會在代理停下來或要求輸入時發生。
代理工作時,Mac 更舒服一點
Clacky 讓代理工作時的 Mac 本身更舒服:點擊音效和鍵盤音效,想展示代理做出了什麼時還有螢幕錄影。一次付清 $4.99,用於 1 台 Mac。
Claude Code:內建通知
Claude Code 完成時,或在權限提示上等待時,可以自己送出桌面通知。Anthropic 的文件說,這在 Ghostty 和 Kitty 裡開箱即用。在 iTerm2 裡,要先打開一次:
- iTerm2 → Settings → Profiles → Terminal。
- 勾選 Notification Center Alerts。
- 按 Filter Alerts,然後啟用 Send escape sequence-generated alerts。
在 tmux 裡執行 Claude Code?在 ~/.tmux.conf 加上 set -g allow-passthrough on,否則通知永遠到不了你的終端機。你也可以在 Claude Code 的 /config 設定裡選擇它怎麼通知你(例如終端機鈴聲)。
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 掛鉤那樣,有獨立的「需要你核准」事件。
如果什麼都沒發生
- 重新開始工作階段。 掛鉤是在工作階段開始時讀取的,所以已經在跑的工作階段不會通知。
- 確認檔案能正確解析。
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)。目前它沒有獨立的核准事件,所以你會在這一輪結束時聽到。
更多指南
- 闔上螢幕也讓 Mac 保持喚醒外接螢幕模式、caffeinate、pmset 和 App,以及每一種實際上做了什麼。
- Mac 上的鍵盤與點擊音效它們怎麼運作、需要什麼權限、有哪些 App,以及怎麼修。
- 在 Mac 上顯示點按內建選項、剪輯軟體,以及有聲音的即時波紋。
- Mac 點按聲沒有內建設定:怎麼加上聲音,以及需要的權限。
- 最好的鍵盤音效 App17 款免費和付費 App 並排比較,看哪個適合你。
- 專注用的鍵盤音效讀書、寫作和寫程式用的柔和打字聲,在你的耳機裡播放。
- 鍵盤音效詞彙解說thock、奶油音、clacky 和 poppy 是什麼意思,聽起來又是怎樣。
- 療癒系 Mac App在你工作時陪著你的放置遊戲、環境音、寵物和柔和點擊聲。
- 最佳游標醒目提示 App用於示範、通話和錄影的聚光燈、點按漣漪和點按聲。
- 鍵盤音效沒聲音輸入監控、安全輸入、輸出裝置和安靜設定。
- Mac 上的提詞機在鏡頭下方讀講稿,並讓它不出現在錄影裡。
- 顯示點擊並錄下點擊聲讓任何 Mac 螢幕錄影都帶有點擊漣漪和點擊聲。
- 附鍵盤音效的打字測驗一個聽得到聲音的 30 秒打字測驗,直接在瀏覽器裡玩。