linux.do

【造个轮子 02】Claude Code 用户必看：别让通知只响在电脑上
github.com

GitHub - zengwenliang416/claude-notifier

通过在 GitHub 上创建帐户来为 zengwenliang416/claude-notifier 开发做出贡献。

----------------------

📖 这事儿咋来的

【造个轮子 01】Claude Code 完成任务后自动通知你开发调优

【造个轮子 01】Claude Code 完成任务后自动通知你 [banner-2k] GitHub 仓库：zengwenliang416/claude-notifier前情提要用 Claude Code 的朋友应该都有这种体验：开了好几个终端窗口，让 AI 并行处理不同任务。结果呢？任务早就完成了，自己还在刷手机，等回过神来一看——白白浪费了好几分钟的 AI 使用时间。试过 o…

上回搞了个桌面通知，本以为完美收官，从此告别"Claude 干完活我还傻等着"的尴尬。结果帖子发出去没多久，评论区直接给我整不会了：

“我觉得可以考虑把 hook 的通知做到 bot 上？用飞书、QQ、tg 的 bot 发送任务提醒之类的”
【造个轮子 01】Claude Code 完成任务后自动通知你 - #15，来自 somnambulating

我：好家伙，这不是把我按在地上摩擦吗？🤯

冷静下来想想，确实，桌面通知有个致命硬伤——你得像只🐶一样守在电脑前。

这些场景你肯定熟悉：

● 🚶 去倒杯水 → 回来一看，通知早没影了
● 🚽 上个厕所 → Claude 干完了，你不知道
● 🛋️ 躺床上刷会手机 → 完了，彻底断联

搞了半天，我还是得盯着电脑？这能忍？！

不行，必须让手机也能收到。二话不说，开干！💪

----------------------

🎯 选型：要求不高，但得靠谱

调研了一圈推送方案，我的诉求就仨字：懒、快、白嫖

扒拉一圈，就这仨能打：

选哪个？ 看你手机是啥，往下翻配置教程 👇️

----------------------

🕳️ 血泪教训（帮你省半小时调试）

一开始我自信满满，心想这不就加个环境变量的事儿？直接往 ~/.zshrc 一扔：

export BARK_KEY="your-device-key"
export CLAUDE_NOTIFY_CHANNEL="bark"

测试！走你！然后… 啥也没发生 😐️

“不可能啊？” 我反复检查了 N 遍，确定没拼错… 还是不行。

折腾了半小时，终于破案了：

⚠️ Claude Code 的 Hook 压根不读你的 shell 配置！

它是直接 spawn 子进程，不走 login shell。你在 .zshrc、.bash_profile 里配的东西，对它来说跟没配一样，完全透明 👻

正解来了 —— 把环境变量写进 ~/.claude/settings.json 的 env 字段：

{
  "env": {
    "CLAUDE_NOTIFY_CHANNEL": "bark",
    "BARK_KEY": "your-device-key"
  }
}

这样 Claude Code 会在跑 Hook 之前自动注入这些变量。

记住这个坑，能帮你省掉抓耳挠腮的半小时！ 🧠

----------------------

🚀 配置教程：3 分钟，无痛上车

Step 1：选渠道、填配置

打开 ~/.claude/settings.json，根据你的情况三选一：

🍎 iPhone 用户？直接 Bark，不解释

{
  "env": {
    "CLAUDE_NOTIFY_CHANNEL": "bark",
    "BARK_KEY": "你的设备密钥"
  }
}

💡 Key 怎么拿？ App Store 搜 “Bark” → 装上 → 打开 → 首页那串就是你的 key，复制走

💬 平时用 Telegram？那就它了

{
  "env": {
    "CLAUDE_NOTIFY_CHANNEL": "telegram",
    "TELEGRAM_BOT_TOKEN": "你的Bot Token",
    "TELEGRAM_CHAT_ID": "你的Chat ID"
  }
}

💡 没 Bot？ 找 @BotFather → /newbot → 跟着走，1 分钟造一个

💡 Chat ID 咋拿？ 随便给 Bot 发句话，访问 https://api.telegram.org/bot<TOKEN>/getUpdates，里面有 chat.id

🔒️ 数据洁癖？ntfy 自己托管

{
  "env": {
    "CLAUDE_NOTIFY_CHANNEL": "ntfy",
    "NTFY_TOPIC": "你的主题名"
  }
}

💡 怎么玩？ 手机装 ntfy → 订阅你设的主题 → 齐活儿

Step 2：挂上 Hook

同样在 ~/.claude/settings.json 里，加上这段：

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "npx tsx $HOME/.claude/hooks/stop-check.ts",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

Step 3：验货时刻！

随便问 Claude 一个问题，等它答完…

手机响了吗？ 📱✨️

● ✅️ 响了！ —— 恭喜老板，从此解放双腿，想去哪去哪
● ❌️ 没响… —— 别慌，翻到下面 FAQ 对症下药

----------------------

🔧 代码思路（技术党可以瞅瞅）

核心就干俩事儿：

1. 检查 TodoList —— 还有活没干完？那先别推送，让它继续
2. 发通知 —— 桌面和手机并行发，谁也不等谁

// 俩通知一起发，互不影响
async function sendNotification(): Promise<void> {
  await Promise.all([
    sendDesktopNotification(),
    sendRemoteNotification().catch((e) => {
      logWarn(`远程推送挂了: ${e}`);
    }),
  ]);
}

💡 设计细节：远程推送挂了也不慌，吞掉错误继续走，桌面通知照发不误

渠道选择就是个朴素的 switch case：

const channel = process.env.CLAUDE_NOTIFY_CHANNEL?.toLowerCase();

switch (channel) {
  case "telegram":
    await sendTelegram(title, message);
    break;
  case "ntfy":
    await sendNtfy(title, message);
    break;
  case "bark":
    await sendBark(title, message);
    break;
}

💡 为啥用 curl？ 自动走系统代理，翻墙党福音，不用单独处理网络问题

----------------------

📊 实测几天，说说真实体验

不吹不黑，直接上数据：

选择困难症？我帮你决定：

● 🍎 果粉 → Bark，体验拉满，延迟碾压
● 🌍️ 本来就常驻 TG → Telegram，生态无缝衔接
● 🔐 数据洁癖 → ntfy，自己服务器自己做主

----------------------

📋️ 后面还想加的

目前就仨渠道，后面可能安排上：

● 📱 飞书/钉钉/企业微信 —— 上班摸鱼党的福音，老板看到的是你在认真等结果
● 🎮️ Discord —— 国外老哥用得多
● 💎 Pushover —— 付费但是真稳

有想要的渠道？ GitHub 开 issue，有求必应 ✨️

----------------------

❓️ 常见问题，自助排查
🚨 收不到推送？ (click for more details) 🔗 能同时推好几个渠道吗？ (click for more details) ⚠️ 报错 "BARK_KEY 未设置"？ (click for more details) 🪟 Windows 能用吗？ (click for more details)
----------------------

💬 最后唠两句

从桌面通知到手机推送，这玩意越来越像个正经工具了。

核心思想始终没变：Claude 干完活，第一时间告诉你——不管你是在电脑前、在厨房、还是躺床上刷手机。

代码全部开源，白嫖党请放心使用。觉得好用？顺手给个 ⭐️ star；遇到 bug 或者想加功能？直接 PR 走起，来者不拒！

下一篇预告：可能会搞个任务统计面板？敬请期待… 也可能咕咕咕 🐦️

15 views01:36