Claude Code 卡住等你授权时，主动把通知推到你的手机 / Apple Watch——零配置 Claude Code 插件，走苹果官方推送。
你是不是也遇到过：给 Claude Code 派了个活儿，转头去刷手机/倒水/开会，回过神来发现它早就卡在 Do you want to proceed? 等你点「允许」，白白浪费十几分钟？
ClaudeBuzz 让它在需要你的那一刻主动震你手腕，还告诉你它卡在哪条命令上。
- 零配置安装：作为 Claude Code 插件分发，
/plugin install后 hook 自动注册，无需手动改settings.json。 - 只在该打扰时打扰：默认只在需要你授权时推送，任务进度、普通事件一律静默。
- 随时一键开关 + 勿扰时段：埋头干活/休假时
claudebuzz off全局静音；设个quiet 23:00 08:00半夜自动不吵你、到点自动恢复（支持跨夜）。 - 带真实命令详情：通知正文直接显示它要执行的命令（
Bash: git push…/rm -rf…），扫一眼就知道该不该放行。 - 危险命令升级推送：检测到
rm -rf/git push --force/drop table等高危操作，自动升级为critical（突破勿扰/静音）+ 重复响铃 + 🚨 专属图标，危险操作绝不漏。 - 分事件铃声：等授权 / 任务完成 / 危险 各用不同提示音（Bark
sound），一耳朵分清是哪类事件。 - 一键复制命令：命令类通知长按即可复制它要执行的完整命令（Bark
copy），不必回终端手敲。 - 主打 iPhone / Apple Watch：走 Bark → 苹果官方 APNs → 手腕直接震，体验最稳最顺。（安卓也能用，但不是主场景，见下文「安卓」一节。）
- 话术可换：内置 11 种语气——
coolie(牛马) /cute(可爱) /boss(总裁) /emperor(皇上) /palace(甄嬛) /gentle(温柔) /zen(佛系) /military(军令) /mom(老妈) /en(English) /off，一条命令切换。 - 图标可换：内置预设
robot-pink(默认) /robot-gray/claude/bell，也可填任意图片 URL。 - 通知类型可配：
permission(默认开) /done/attention/danger/failure，按需开关。 - 跨平台 · 零依赖：纯 Node.js 内置模块，Windows / macOS / Linux 通吃，原生 UTF-8，无 GBK 乱码坑。
/plugin marketplace add hjxccc/claudebuzz
/plugin install claudebuzz
然后在 Claude Code 里运行配置向导：
/notify-setup
它会引导你：粘贴 Bark key → 发测试推送 → 选话术。搞定后新会话即生效——Claude Code 一卡住等授权，手腕立刻震。
需要先在手机装 Bark（免费开源，iOS）并复制首页的推送地址。
不想用 /notify-setup 也可以直接用自带 CLI：
node bin/claudebuzz.js config bark "https://api.day.app/你的KEY/" # iPhone / Apple Watch（主推）
node bin/claudebuzz.js config feishu "https://open.feishu.cn/...hook/xxx" # 安卓兜底（飞书机器人）
node bin/claudebuzz.js test # 发测试推送
node bin/claudebuzz.js persona cute # 切换话术（11 种）
node bin/claudebuzz.js icon claude # 切换图标
node bin/claudebuzz.js notify done on # 开启“任务完成”通知
node bin/claudebuzz.js off # 全局静音（埋头干活/休假时一键关）
node bin/claudebuzz.js on # 恢复推送
node bin/claudebuzz.js quiet 23:00 08:00 # 勿扰时段（支持跨夜，到点自动不推/恢复）
node bin/claudebuzz.js quiet off # 关闭勿扰时段
node bin/claudebuzz.js doctor # 健康检查（含总开关/勿扰状态）~/.claude/claudebuzz/config.json：
{
"enabled": true,
"quietHours": { "enabled": false, "start": "23:00", "end": "08:00" },
"channels": [
{ "type": "bark", "key": "", "server": "https://api.day.app",
"icon": "https://cdn.jsdelivr.net/gh/hjxccc/agentwatch-assets@main/claude_robot_pink.png",
"group": "ClaudeCode", "level": "timeSensitive" }
],
"notify": { "onPermission": true, "onTaskDone": false, "onAttention": false, "onDanger": false },
"persona": "coolie",
"detailMaxLen": 45,
"dedupWindowMs": 8000
}enabled：全局总开关，false= 完全静默（等同claudebuzz off）。quietHours：勿扰时段，start > end视为跨夜（如23:00–08:00）。该时段内不推、过点自动恢复。
想顺带收「任务完成」提醒，把 notify.onTaskDone 改成 true 即可。
config.json 里两块可调：
{
"sounds": { "permission_required": "shake", "task_done": "birdsong", "danger": "alarm" },
"danger": { "level": "critical", "call": true, "icon": "danger" }
}- 危险升级：命令文本命中
rm -rf/sudo/git push/git reset --hard/chmod等高危词，自动套用danger配置——level=critical突破勿扰静音、call=true重复响铃、icon=danger换成 🚨。即使是「请求允许执行 rm -rf」这类授权事件也会被升级。 - 分事件铃声：
sounds按事件类型给不同 Bark 铃声，留空则用内置默认。铃声名见 Bark 文档。
想让
critical真正突破静音，需在 iPhone「设置 → 通知 → Bark」开启关键警报/时效性通知权限。快速体验：node bin/claudebuzz.js test danger。
ClaudeBuzz 主打 iPhone / Apple Watch——Bark 走苹果官方 APNs，到手腕又快又稳。安卓我们也认真试过独立推送 App（如 ntfy），但国产 ROM（vivo / 小米 / OPPO / 华为）会激进杀后台，经常漏收（实测消息确实推到了服务器、curl 能拿到，是手机端被系统杀进程拦下了）。所以安卓只保留一条稳的兜底路：飞书 webhook——飞书作为办公 IM 长期常驻、不被杀，消息基本必达。代价是推到的是飞书消息而非系统级通知。
# 飞书建群 → 群设置 → 群机器人 → 添加自定义机器人 → 复制 Webhook 地址
node bin/claudebuzz.js config feishu "https://open.feishu.cn/open-apis/bot/v2/hook/xxxx"
# 若机器人开了「签名校验」，再带上 secret：
node bin/claudebuzz.js config feishu "https://open.feishu.cn/.../hook/xxxx" "你的secret"
node bin/claudebuzz.js test安全设置选「自定义关键词」（如
ClaudeBuzz）最省事，不用管 secret。
一句话：iPhone 用户开箱即用、体验最佳；安卓用户用飞书 webhook 兜底，别期待 iOS 级别的丝滑。
定位：ClaudeBuzz 专注把「该打扰你的那一刻」推得及时、准确、信息够用——是通知器，不是远程遥控器。凡是「手机反过来操作电脑」的方向（一键远程批准、点击跳回终端）我们刻意不做：它们都需要双向回路，且一条通知的小窗口看不全要放行什么，盲批等于瞎签字，与单向·零配置·安全的定位相悖。我们只把出站通知本身做到极致。
- v1（当前）：Claude Code 插件，主打 Bark(iOS / Apple Watch)；安卓兜底 飞书 webhook（另含 PushDeer 可选）；按需推送 + 命令详情 + persona + 去重 + 危险命令升级 + 分事件铃声 + 一键复制命令。
- v2（纯出站，把通知做深）：任务完成摘要增强（耗时/改动文件数）、勿扰时段、角标计数、更多渠道（Telegram / 企业微信 / Server酱）。
灵感与早期实现思路来自开源项目 AgentWatch；推送链路依赖 Bark。ClaudeBuzz 在其基础上做成了零配置插件，并内置了命令详情提取、按需推送、persona、去重等改进。
MIT