如何在 Claude Code 或 Codex 完成时收到通知
你在 Claude Code 或 Codex 里开始一个很长的任务,切去做别的事,十分钟后回来,却发现它两分钟时就停下了,在等你点“是”。只要智能体在完成或需要你确认时发出声音或通知,这个问题就解决了。
两个工具都可以免费做到,用自带功能或加一两行配置就行。本指南会一步步介绍每种方法。
简要版
- Claude Code 在 Ghostty、Kitty 和 iTerm2 中本身就能通知你(iTerm2 需要改一个设置)。在其他终端中,添加一个钩子。
- 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 等等。
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、奶油音、clack 和啵啵音是什么意思,每一种听起来怎样。
- 治愈系 Mac app在你工作时运行的放置游戏、环境音、宠物和柔和点击声。
- 最佳光标高亮 app用于演示、通话和录屏的聚光灯、点按涟漪和点按声。
- 键盘声音没声音输入监控、安全输入、输出设备和安静设置。
- Mac 上的提词器在摄像头下方读稿,并让稿子不出现在录制中。
- 显示点击并录下点击声让点按波纹和点击声出现在任何 Mac 屏幕录制里。
- 带键盘声音的打字测试一个听得见的 30 秒打字测试,直接在浏览器里玩。