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

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

更新于 2026年10月22日

你在 Claude Code 或 Codex 里开始一个很长的任务，切去做别的事，十分钟后回来，却发现它两分钟时就停下了，在等你点“是”。只要智能体在**完成**或**需要你确认**时发出声音或通知，这个问题就解决了。

两个工具都可以免费做到，用自带功能或加一两行配置就行。本指南会一步步介绍每种方法。

简要版

-   **Claude Code** 在 **Ghostty、Kitty 和 iTerm2** 中本身就能通知你（iTerm2 需要改一个设置）。在其他终端中，添加一个**钩子**。
-   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完成，或需要你

钩子 / 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 等等。

来源：[钩子参考](https://code.claude.com/docs/en/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-hans/keep-mac-awake-lid-closed/)
-   [Mac 上的键盘声和点击声它们如何工作、需要什么权限、有哪些 app，以及解决方法。](https://clacky.app/zh-hans/mac-keyboard-sounds/)
-   [在 Mac 上显示点按自带选项、剪辑软件，以及带声音的实时波纹。](https://clacky.app/zh-hans/show-mouse-clicks-mac/)
-   [Mac 点按声没有自带设置：怎么加上声音，以及需要的权限。](https://clacky.app/zh-hans/mac-click-sound/)
-   [最好的键盘声音 app17 款免费和付费 app 并排对比，看哪个适合你。](https://clacky.app/zh-hans/best-keyboard-sound-apps-mac/)
-   [专注用的键盘声音学习、写作和写代码时的柔和打字声，只在你的耳机里。](https://clacky.app/zh-hans/keyboard-sounds-for-focus/)
-   [键盘声音词汇解释thock、奶油音、clack 和啵啵音是什么意思，每一种听起来怎样。](https://clacky.app/zh-hans/keyboard-sounds-explained/)
-   [治愈系 Mac app在你工作时运行的放置游戏、环境音、宠物和柔和点击声。](https://clacky.app/zh-hans/cozy-mac-apps/)
-   [最佳光标高亮 app用于演示、通话和录屏的聚光灯、点按涟漪和点按声。](https://clacky.app/zh-hans/best-cursor-highlighter-apps-mac/)
-   [键盘声音没声音输入监控、安全输入、输出设备和安静设置。](https://clacky.app/zh-hans/keyboard-sounds-not-working-mac/)
-   [Mac 上的提词器在摄像头下方读稿，并让稿子不出现在录制中。](https://clacky.app/zh-hans/teleprompter-mac/)
-   [显示点击并录下点击声让点按波纹和点击声出现在任何 Mac 屏幕录制里。](https://clacky.app/record-click-sound/)
-   [带键盘声音的打字测试一个听得见的 30 秒打字测试，直接在浏览器里玩。](https://clacky.app/zh-hans/typing-test/)

第一次了解 Clacky？它是一个温馨的 Mac 菜单栏 app，有点按声和键盘声音、屏幕录制、截图，还有一座随你工作慢慢长大的小港口小镇。 [查看所有工具](https://clacky.app/zh-hans/) · [在浏览器里听听声音](https://clacky.app/zh-hans/)

核实于 2026年10月22日。 有内容变了，或者这里写错了？请发邮件到 hello@clacky.app。
