[Clacky](https://clacky.app/zh-hant/)/指南

# 如何在 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`，或打開它內建的終端機通知。
-   什麼都沒發生？**重新開始工作階段**：掛鉤是在工作階段開始時讀取的。

本頁內容

1.  [代理怎麼告訴你它做完了](#代理怎麼告訴你它做完了)
2.  [Claude Code：內建通知](#claude-code-內建通知)
3.  [Claude Code：會播放聲音的掛鉤](#claude-code-會播放聲音的掛鉤)
4.  [Codex：notify 設定](#codex-notify-設定)
5.  [如果什麼都沒發生](#如果什麼都沒發生)

## 代理怎麼告訴你它做完了

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 文件：終端機設定](https://code.claude.com/docs/en/terminal-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 參考文件](https://code.claude.com/docs/en/hooks) · [hooks 指南](https://code.claude.com/docs/en/hooks-guide)

## 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 文件：進階設定](https://developers.openai.com/codex/config-advanced)

## 如果什麼都沒發生

-   **重新開始工作階段。** 掛鉤是在工作階段開始時讀取的，所以已經在跑的工作階段不會通知。
-   **確認檔案能正確解析。** `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，以及每一種實際上做了什麼。](https://clacky.app/zh-hant/keep-mac-awake-lid-closed/)
-   [Mac 上的鍵盤與點擊音效它們怎麼運作、需要什麼權限、有哪些 App，以及怎麼修。](https://clacky.app/zh-hant/mac-keyboard-sounds/)
-   [在 Mac 上顯示點按內建選項、剪輯軟體，以及有聲音的即時波紋。](https://clacky.app/zh-hant/show-mouse-clicks-mac/)
-   [Mac 點按聲沒有內建設定：怎麼加上聲音，以及需要的權限。](https://clacky.app/zh-hant/mac-click-sound/)
-   [最好的鍵盤音效 App17 款免費和付費 App 並排比較，看哪個適合你。](https://clacky.app/zh-hant/best-keyboard-sound-apps-mac/)
-   [專注用的鍵盤音效讀書、寫作和寫程式用的柔和打字聲，在你的耳機裡播放。](https://clacky.app/zh-hant/keyboard-sounds-for-focus/)
-   [鍵盤音效詞彙解說thock、奶油音、clacky 和 poppy 是什麼意思，聽起來又是怎樣。](https://clacky.app/zh-hant/keyboard-sounds-explained/)
-   [療癒系 Mac App在你工作時陪著你的放置遊戲、環境音、寵物和柔和點擊聲。](https://clacky.app/zh-hant/cozy-mac-apps/)
-   [最佳游標醒目提示 App用於示範、通話和錄影的聚光燈、點按漣漪和點按聲。](https://clacky.app/zh-hant/best-cursor-highlighter-apps-mac/)
-   [鍵盤音效沒聲音輸入監控、安全輸入、輸出裝置和安靜設定。](https://clacky.app/zh-hant/keyboard-sounds-not-working-mac/)
-   [Mac 上的提詞機在鏡頭下方讀講稿，並讓它不出現在錄影裡。](https://clacky.app/zh-hant/teleprompter-mac/)
-   [顯示點擊並錄下點擊聲讓任何 Mac 螢幕錄影都帶有點擊漣漪和點擊聲。](https://clacky.app/record-click-sound/)
-   [附鍵盤音效的打字測驗一個聽得到聲音的 30 秒打字測驗，直接在瀏覽器裡玩。](https://clacky.app/zh-hant/typing-test/)

第一次認識 Clacky？它是一個溫馨的 Mac 選單列 App，有點按音效和鍵盤音效、螢幕錄影、截圖，還有一座隨你工作慢慢長大的小港口小鎮。 [查看所有工具](https://clacky.app/zh-hant/) · [在瀏覽器裡聽聽聲音](https://clacky.app/zh-hant/)

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