Claude Code 完成通知：提示弹窗与提示音

完成提示（Done Toast）为你提供 Claude Code 完成通知：当一轮耗时较长的对话结束时，会弹出一条写着 Done in 2m 14s 的提示，同时播放一段简短的双音提示音。如果这一轮以错误结束，则会显示 Stopped on an error after 2m 14s。较短的轮次、被中断的轮次和子代理的轮次都保持静默，所以只要听到这个声音，就意味着“回来吧，你的回答已经好了”。

如果你在长任务进行期间会切到别的窗口工作，可以开启系统通知选项，同样的消息就会出现在 macOS 通知中心，或以 Linux notify-send 弹窗的形式显示。需要 Claude Code 2.1.287 或更高版本。

录屏中，我们给 Claude 发送一个耗时超过阈值的任务。这一轮完成时，屏幕底部会出现一条显示本轮耗时的提示。

从安装区块中选择一种方式即可。在 macOS 上声音开箱即用；系统通知需要手动开启。

这个插件只有一个钩子。以下摘自 hooks/register.ts：

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (!shouldNotify(e, minSeconds)) return result

  const text = toastText(e, includeAnswerPreview)
  $.ui.toast(text)

  if (sound) {
    $.audio.play({ asset: 'sounds/done.wav' }).catch(() => undefined)
  }

  if (systemNotification) {
    platform ??= $.process
      .run(['uname', '-s'], { timeoutMs: 5000 })
      .then(ran => (ran.exitCode === 0 ? parseUname(ran.stdout) : undefined))
      .catch(() => undefined)
    platform
      .then(found =>
        found === undefined ? undefined : $.process.run(notificationArgv(found, 'Claude Code', text), { timeoutMs: 10000 }),
      )
      .catch(() => undefined)
  }

  return result
})

turn.complete 会在 Claude 完成一轮对话时触发。钩子会先等待 next(e)，因此绝不会拖慢这一轮的结果。hooks/format.ts 中的 shouldNotify 对子代理轮次（带有 agentId 的轮次）、被中止的轮次以及短于 minSeconds 的轮次返回 false。toastText 会把耗时格式化为 45s、2m 14s 或 1h 3m。

提示音是随插件一起打包的 sounds/done.wav，通过 $.audio.play 播放。插件 API 没有平台字段，也没有发送通知的调用，所以在开启系统通知时，插件会执行一次 uname -s 并缓存结果。之后它会在 macOS 上运行 osascript -e 'display notification …'，在 Linux 上运行 notify-send。参数以 argv 数组的形式传入，不经过 shell，因此 Claude 回答中的引号无法造成注入。声音和通知都是“发出即不管”的，出现的错误会被直接吞掉。

在 /config 中修改这些选项。想换成自己的声音，可以替换插件文件夹中的 sounds/done.wav，或修改钩子里的 asset 路径。提示文字来自 hooks/format.ts 中的 toastText，通知标题 'Claude Code' 则是 notificationArgv 的第二个参数。

修改界面对应提示通知，播放声音对应提示音。之所以会出现执行命令，是因为代码中用到了 $.process.run，但它只在你开启 systemNotification 后才会使用：届时它会运行一次 uname -s，然后以固定参数运行 osascript 或 notify-send。在默认设置下，不会启动任何进程。

该插件不会拦截工具调用、不读取你的提示词、不接触文件，也不使用网络。可以用 /plugin disable cm-done-toast 停用它，或者用 claude --safe-mode 启动一个关闭所有插件的会话。

已在 macOS 终端中使用 Claude Code 2.1.291 测试。如果一轮结束时什么都没有发生：

• 确认 claude --version 为 2.1.287 或更高版本，并且该插件已在 /plugin 中启用。
• 通过 shell 安装后，运行 /reload-plugins。
• 这一轮可能短于 minSeconds。
• 在 macOS 以外的系统上没有声音，这是预期行为。
• 在 macOS 上，如果系统通知始终不出现，请在“系统设置”中允许你的终端应用发送通知。
• 在 Linux 上，需要安装 libnotify（notify-send）才能使用系统通知。