MacPip你的下一款 Mac 应用就在这里。macpip.com →

如何在 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,或打开它内置的终端通知。
  • 什么都没发生?重启会话:钩子在会话启动时读取。

智能体如何告诉你它完成了

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 文档:终端设置

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 钩子那样单独的“需要你批准”事件。

来源: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。