claude-code-notifier-hook

Claude Code Notifier Hook

当 Claude Code 完成任务时，自动发送 macOS 系统通知（可附带提示音），让你不用盯着屏幕等待。

效果

• Claude 完成任务后弹出系统通知："Claude Code 任务完成，请继续..."
• 可选播放提示音（系统音效或内置趣味音效）

安装

npm install -g claude-code-notifier-hook

使用

初始化（只需运行一次）

claude-code-notifier-hook init

向导会引导你：

• 选择安装级别

  • 用户级别 ~/.claude/settings.json — 对所有项目生效
  • 项目级别 .claude/settings.json — 仅对当前项目生效

• 选择提示音（macOS）

  • 系统音效：Frog、Purr、Sosumi、Submarine
  • 内置趣味音效：来啦老弟 / 你干嘛 / 开始工作
  • 自定义音效（~/Library/Sounds 中的 .aiff 文件）
  • 或不使用提示音

配置完成后，Claude Code 每次完成任务都会自动触发通知。

手动测试

echo '{"stop_hook_active": false}' | claude-code-notifier-hook notify --sound Frog

工作原理

本工具作为 Claude Code 的 Stop hook 运行。每当 Claude 完成一轮任务，Claude Code 会自动调用 notify 子命令并通过 stdin 传入 JSON 数据。

防止无限循环： 若 JSON 中 stop_hook_active === true（表示 hook 本身触发了新会话），通知器会立即退出，避免循环触发。

用户级去重： 安装到用户级别时，hook 命令会先检查当前项目是否已有自定义 notifier hook，有则跳过，避免重复通知。

内置音效说明

音效名	文件
来啦老弟	lailalaodi.aiff
你干嘛	niganma.aiff
开始工作	letsgetwork.aiff

init 时会将所选文件复制到 ~/Library/Sounds/，之后通过 afplay 播放。

系统要求

• macOS（通知与音效功能依赖 macOS API）
• Node.js >= 14

License

MIT