Claude Code Notify Hub

让 Claude Code 在需要你时第一时间通知你

English | 简体中文

这是什么？

Claude Code Notify Hub 是一个通知系统，让你在 Claude Code 需要你的时候能立即收到提醒。

适用场景：

• 🔔 Claude 遇到问题需要你的帮助
• ✅ Claude 完成了你交给它的任务
• ⚠️ 执行过程中发生错误

支持的通知方式：

• 🗣️ 语音通知 - 电脑弹窗 + 语音播报（支持 macOS/Windows/Linux）
• 📧 邮件通知 - 发送到你的邮箱（支持 Gmail、Outlook、QQ 邮箱等）

你需要做什么？

第一步：安装

npm install -g claude-notify-hub

第二步：配置

claude-notify init

跟着提示操作即可。你需要：

1. 选择通知方式（可以都选）：

   • 语音通知
   • 邮件通知

2. 如果选了语音通知：

   • 系统会自动检测你的操作系统
   • 选择是否自定义语音内容（可选，默认即可）

3. 如果选了邮件通知：

   • 选择 587 (STARTTLS - Recommended for Gmail)
   • 输入你的邮箱地址
   • 输入密码（Gmail 需要使用应用专用密码，见下方说明）

第三步：测试

# 测试所有通知
claude-notify test

# 或者单独测试
claude-notify test --voice
claude-notify test --email

# 测试所有四种通知类型（听到不同的音效）
claude-notify test --voice --all-types

--all-types 选项说明：

使用这个选项可以依次测试所有四种通知类型，每种间隔 1.5 秒，你会听到不同的音效：

1. 🔔 intervention（需要干预）→ Ping 音效（清脆的叮咚声）
2. ✅ complete（任务完成）→ Glass 音效（轻快的玻璃声）
3. ⚠️ error（发生错误）→ Basso 音效（低沉的警告声）
4. 🎉 subagent_complete（子任务完成）→ Glass 音效（轻快的玻璃声）

第四步：开始使用

配置完成后，不需要做任何事情！

当 Claude Code 运行时：

• 需要你帮助时 → 自动发通知
• 任务完成时 → 自动发通知
• 出错时 → 自动发通知

Gmail 邮件配置说明

重要：Gmail 需要应用专用密码，不能直接用登录密码！

获取 Gmail 应用专用密码：

1. 前往 Google 账户设置
2. 点击「安全性」
3. 开启「两步验证」（如果还没开启）
4. 在「两步验证」下方找到「应用专用密码」
5. 选择「邮件」和你的设备
6. 复制生成的 16 位密码

配置时选择：

? Select SMTP port and security:
❯ 587 (STARTTLS - Recommended for Gmail)  ← 选这个！
  465 (SSL/TLS)
  25 (No encryption - Not recommended)

其他邮件服务

QQ 邮箱

• 登录 QQ 邮箱 → 设置 → 账户 → 开启 SMTP 服务
• 获取授权码（不是 QQ 密码）
• 配置时选择 587 (STARTTLS)

Outlook

• 直接使用你的 Outlook 密码
• 配置时选择 587 (STARTTLS)

常用命令

# 重新配置
claude-notify config

# 临时关闭通知
claude-notify disable

# 重新开启通知
claude-notify enable

# 测试通知
claude-notify test

配置文件位置

如果需要手动修改配置：~/.config/claude-notify/config.json

常见问题

语音通知不工作？

Linux 用户需要先安装语音合成工具：

# Ubuntu/Debian
sudo apt-get install espeak

# 或者
sudo apt-get install festival

邮件发送失败？

1. 确认你使用的是应用专用密码（不是登录密码）
2. 确认选择了正确的端口（Gmail 用 587）
3. 检查网络连接

如何临时关闭通知？

claude-notify disable

需要时再开启：

claude-notify enable

问题反馈

遇到问题？提交 Issue

开源协议

MIT License

如果这个工具对你有帮助，请给它一个 ⭐️

Made with ❤️ for Claude Code users