Claude Code Notification Plugin
桌面通知插件，在以下场景自动发送通知（仅当终端在后台时触发）：
- 权限请求 - 需要用户确认权限时
- 任务完成 - Claude 完成任务时
支持多种通知方式：
- 系统通知 - Windows/macOS/Linux 原生桌面通知
- Bark 推送 - iOS 推送服务（可选）
- 微信推送 - 通过 Server酱 推送到微信（可选）
安装
# 1. 在 Claude Code 输入框中添加市场
/plugin marketplace add https://github.com/Oreo992/claude-notification
# 2. 安装插件（根据你的系统选择）
/plugin install windows@claude-notification # Windows
/plugin install unix@claude-notification # macOS/Linux
注意: 安装完成后需要重启 Claude Code 才能生效。
插件列表
| 插件 | 平台 | 说明 |
|---|
windows | Windows 10/11 | PowerShell 实现，无需额外依赖 |
unix | macOS/Linux | macOS 使用 osascript，Linux 使用 notify-send |
更新
如果您已经安装过此插件，请使用以下命令更新插件版本
/plugin marketplace update claude-notification
当提示更新完毕，重启Claude Code。
初始化/配置
此插件支持自定义配置和对应的Skills。
首次使用建议运行
/notification-config
跟随Claude，完成通知插件的配置
后续你也可以使用此Skills，对通知配置进行更改，如：
- "帮我配置 Bark 通知"
- "帮我配置 微信 通知"
- "只用 Bark 推送，不要系统通知"
- "我想终端在前台时也收到通知"
AI 会自动创建配置文件 .claude/claude-notification.local.md，并询问是否要在项目的 CLAUDE.md 中添加通知功能，让 AI 能够在完成任务后主动发送通知。
让 AI 主动发送通知
这通常会在初始化时，Claude会主动询问您是否配置，如果未询问，您也可以通过
/notification-config 给你自己加上通知的功能,到全局的CLAUDE.md中
支持的通知场景：
- 用户明确要求："完成后通知我"、"用 bark 通知我"
- 长时间任务完成：构建、测试、部署等
- 重要里程碑：PR 创建、代码审查完成
- 需要关注的错误：构建失败、测试不通过
示例：
收到的提示如下：
详细配置指南也可以查看 NOTIFICATION_SETUP.md。
微信配置
打开https://xtuis.cn/，扫码关注公众号，关注后会自动获得一个Token。
然后在Claude Code 对话框中输入 /notification-config 这个是我的微信提醒的Token，帮我配置好并测试通过
随后即可收到信息，也可以赋予CC主动提醒的能力。
如图：
手动配置
如果你想手动配置，在项目根目录创建 .claude/claude-notification.local.md：
---
bark_url: "https://api.day.app/your-key"
wechat_token: "your-wechat-token"
wechat_hook_enabled: true
bark_hook_enabled: true
system_notification_enabled: true
always_notify: false
---
配置项说明
| 配置项 | 类型 | 默认值 | 说明 |
|---|
bark_url | string | 空 | Bark 推送地址 |
wechat_token | string | 空 | 微信推送 Token |
wechat_hook_enabled | boolean | true | 是否启用微信 Hook 自动触发（需先配置 token） |
bark_hook_enabled | boolean | true | 是否启用 Bark Hook 自动触发（需先配置 url） |
system_notification_enabled | boolean | true | 是否启用系统通知 |
always_notify | boolean | false | 设为 true 则始终通知，即使终端在前台 |
微信推送
(https://xtuis.cn/) 是一个微信推送服务，可以将通知推送到微信，方便在手机上接收。
配置微信推送
- 访问 https://xtuis.cn/
- 微信扫码关注公众号
- 获取你的专属 Token
- 告诉 AI："帮我配置微信通知"，提供你的 Token
配置完成后，Token 会保存在 .claude/claude-notification.local.md 文件中：
- Hook 自动触发 - 权限请求和任务完成时自动发送微信通知
- AI 主动调用 - AI 可以在完成重要任务时主动发送通知
Hook 自动通知
配置 Token 后，插件会在以下场景自动发送微信通知：
无需额外配置，只要 Token 存在就会自动触发。
AI 主动发送通知
AI 可以在完成重要任务时主动发送微信通知。插件提供了完整的微信推送脚本，支持：
示例场景：
- 长时间构建完成
- 测试运行结束
- 代码审查完成
- 重要任务完成提醒
Bark 推送
Bark 是一个 iOS 推送服务，优势是通知会持久保留在通知中心。
安装 Bark
- 在 App Store 下载 Bark 应用
- 打开应用获取推送 URL（格式：
https://api.day.app/your-key）
- 告诉 AI："帮我配置 Bark 通知"，提供你的 URL
AI 主动发送通知
AI 可以在完成重要任务时主动发送通知。插件提供了完整的 Bark 推送脚本，支持：
- 标题和内容自定义
- 紧急通知（持续响铃30秒）
- 消息分组
- 自定义铃声
- 时效性通知
- 点击跳转 URL
- 自动复制内容
示例场景：
- 长时间构建完成
- 测试运行结束
- 代码审查完成
- 需要紧急确认
功能特点
- 智能检测 - 只在终端窗口处于后台时发送通知（可配置）
- 多终端支持 - 能正确区分不同的终端窗口实例
- 终端识别 - 通知中显示终端名称，方便多终端场景识别
- 项目路径 - 通知中显示当前项目的最后两级目录
- 持久化通知 - 通知会进入系统通知中心并保留
- Windows: 使用 Toast 通知 API，进入 Windows 通知中心
- macOS: 原生支持，进入 macOS 通知中心
- Linux: 大部分桌面环境支持（GNOME、KDE 等）
- Bark 支持 - 可选配置 iOS Bark 推送，支持持久通知
- 微信推送 - 可选配置微信推送，通知直达微信
- AI 集成 - AI 可以主动调用通知脚本发送提醒
- 丰富参数 - 支持紧急通知、消息分组、自定义铃声等
- 灵活配置 - 支持前台通知、仅 Bark 推送等多种模式
系统要求
Windows
- Windows 10/11
- PowerShell 5.1+（系统自带）
macOS
Linux
- 需要安装
libnotify
- Ubuntu/Debian:
sudo apt install libnotify-bin
插件结构