windows

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/) 是一个微信推送服务，可以将通知推送到微信，方便在手机上接收。

配置微信推送

1. 访问 https://xtuis.cn/
2. 微信扫码关注公众号
3. 获取你的专属 Token
4. 告诉 AI："帮我配置微信通知"，提供你的 Token

配置完成后，Token 会保存在 .claude/claude-notification.local.md 文件中：

• Hook 自动触发 - 权限请求和任务完成时自动发送微信通知
• AI 主动调用 - AI 可以在完成重要任务时主动发送通知

Hook 自动通知

配置 Token 后，插件会在以下场景自动发送微信通知：

• 权限请求时
• 任务完成时

无需额外配置，只要 Token 存在就会自动触发。

AI 主动发送通知

AI 可以在完成重要任务时主动发送微信通知。插件提供了完整的微信推送脚本，支持：

• 标题和内容自定义
• 详细描述信息
• 持久保留在微信中

示例场景：

• 长时间构建完成
• 测试运行结束
• 代码审查完成
• 重要任务完成提醒

Bark 推送

Bark 是一个 iOS 推送服务，优势是通知会持久保留在通知中心。

安装 Bark

1. 在 App Store 下载 Bark 应用
2. 打开应用获取推送 URL（格式：https://api.day.app/your-key）
3. 告诉 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

• macOS 10.14+
• 无需额外依赖

Linux

• 需要安装 libnotify
• Ubuntu/Debian: sudo apt install libnotify-bin

插件结构