Claude Code 跑完别干等,三条通知线把结果推到手机

Claude Code 跑完别干等,三条通知线把结果推到手机

让 Claude Code 跑一个 30 分钟的 SEO 死链审计,你起身去吃饭。回来一看,人家十分钟前就干完了,报告静静躺在目录里,白等二十分钟。这种事发生第三次之后,我把通知这件事当成正经工程问题解决了一遍。

可选的路有三条。Anthropic 官方的 Hooks 和 Channels,加上 Nous Research 开源 Hermes 的 MCP 反向桥接。分工一句话讲完,Hooks 是 Claude Code 干完活往外扔一条消息,Channels 是把你的消息从手机推进正在跑的会话,Hermes 反向桥接是让 Claude Code 在需要时自己去调一个 24 小时在线的消息网关。前两条是 Claude Code 专属,第三条 Codex 也能接,而且是 Codex 目前唯一的按需通知方案。三条线互不冲突,可以同时挂。

最快的五分钟,Hooks 桌面通知

Hooks 是 Claude Code 内置的生命周期钩子,跟通知相关的是四个事件。Stop 在每轮响应结束时触发,是任务完成通知的主力。Notification 在 Claude 等你输入时触发,适合做「回来看一眼」的提醒。SubagentStop 盯子 Agent 分支的完成。StopFailure 对应 API 报错中断,拿来做异常报警。

配置分两步。先在 ~/.claude/settings.json 里给 Stop 事件挂一个 command 类型的钩子,指向自己的脚本。脚本本身是个 Bash 文件,从 stdin 接 JSON,用 jq 抽出 stopreason 和 stopmessage,再用 osascript 弹 macOS 桌面通知,顺手用 afplay 放个提示音。Linux 把 osascript 换成 notify-send 就行。想要推到手机,在脚本里加一段 curl 异步调 Telegram Bot API,注意把 curl 丢后台并重定向到 /dev/null,别让通知阻塞 Hook。

有两个坑写进脚本里才安全。一是 Stop 事件的输入里有个 stophookactive 字段,为 true 时脚本必须立即 exit 0,不然 Hook 会无限循环,Claude Code 检测到连续阻塞八次没有进展会强制接管。二是触发粒度粗,每轮响应结束都会响,Claude 先提交代码再推送结论,你会连收两条,脚本里判断 stopreason 只在 endturn 时推送能滤掉大半噪音。stopreason 一共三个常见取值,endturn 是正常收尾,maxtokens 是顶到输出上限,tooluse 是还要调工具,语义分明,值得在脚本里分别处理。

Hooks 的天花板也明显,纯单向,通知发完即止,没有历史没有上下文,你没法在手机上回一个字。个人本机开发够用,想隔着手机遥控就往下看。

双向方案,Channels 把会话延伸到手机

Channels 是 Anthropic 2026 年 3 月放出的 Research Preview,思路跟 MCP 标准流向正好相反。标准 MCP 是你下指令,Claude 去调外部 Server 拿数据回来,Channels 是外部消息经由一个本地 Bun 插件推入正在运行的 Claude Code 会话,Claude 处理完再原路回复,每个 Channel 说到底是一个轮询外部平台的本地 MCP Server,靠通道事件把消息塞进会话。目前支持 Telegram 和 Discord,3 月 20 日上线,iMessage 3 月 27 日跟进,三个都在 Research Preview 阶段。

以 Telegram 为例,配置是四步。装官方插件,配 Bot Token,带 --channels 参数启动 Claude Code,然后在手机上给 Bot 发消息拿配对码回终端完成配对,最后把访问策略锁成 allowlist 只允许自己。

它的杀手锏有三个。双向对话,手机发的消息直接进会话,Claude 的回复出现在同一个聊天窗口。远程审批,权限弹窗能转发到手机上批准或拒绝,人不在工位也不卡进度。事件驱动,接收的不只是聊天,CI Webhook 和监控告警也能推进来触发 Claude 行动。会话存活期间上下文一直在,文件系统权限跟你坐在终端前完全一样。

限制同样要背下来。Research Preview 阶段语法可能变。认证绑死 claude.ai 或 Console 的 API key,走 Bedrock、Vertex 的企业部署用不了。插件依赖 Bun。事件只在会话打开期间到达,它不是常驻后台服务,一个 Channel 也只绑一个会话。企业环境注意两个开关,channelsEnabled 总开关在 Team 和 Enterprise 档默认关闭要管理员开,非白名单插件得挂 --dangerously-load-development-channels 才能加载。

赛博霓虹风插画,一部手机与一台终端之间由双向光带连接,消息气泡沿光带相向流动,中间一枚权限弹窗图标被光标引导到手机屏幕上批准,青品红双色

全能方案,Hermes MCP 反向桥接

前两条解决不了的场景,微信收通知、多品牌频道隔离、Codex 也要通知,都归 Hermes。v0.16.0 起 hermes mcp serve 能把 Hermes 自身暴露成 MCP Server,Claude Code 和 Codex 通过 SSH 连到常驻机器上的 Hermes,按需调用它向 Discord、Telegram、微信、Slack、WhatsApp、Signal、Matrix 七个平台发消息。这是个反向桥接,不是消息进来,是 Claude 主动出去。

给一套可抄的七步清单。常驻机器装 Hermes,pipx install hermes-agent[messaging],跑 hermes init 初始化,在 config.yaml 配好至少一个平台的 Bot 凭据,hermes gateway start 拉起网关。本地开发机 ssh-keygen -t ed25519 生成密钥,ssh-copy-id 推到常驻机器,验证免密能执行 hermes mcp serve --help。编辑 ~/.claude.json,mcpServers 里加 hermes 一项,type 用 stdio,command 是 ssh,args 依次放 StrictHostKeyChecking 选项、SSH 目标、远程 hermes 的绝对路径和 mcp serve 参数,同机部署就跳过 SSH 直接指向本地可执行文件。~/.claude/settings.json 的 permissions.allow 里加 mcp_hermes 前缀白名单,一步放行全部十个工具。Codex 侧在 ~/.codex/config.toml 写 [mcpservers.hermes] 段,startuptimeoutsec 给 15,tooltimeoutsec 给 60,Codex 不需要权限白名单。终端里对 Claude Code 说一句「列出 Hermes 可用的消息通道」,能返回频道列表就是通了。最后实战触发,让它跑完审计后通知你的 Discord 频道。

十个工具里通知场景最常用四个。messagessend 是核心,target 格式为 platform:identifier,比如 discord 加频道名,支持人类友好的频道名自动解析。channelslist 首次配置时确认通道。conversationslist 和 messagesread 用来精确定位目标和发前看一眼上下文。想双向也行,eventspoll 轮询回复,eventswait 最长阻塞 30 秒等一条消息,permissions_respond 甚至能远程批审批。

成本几乎可以忽略。SSH 走内网,消息走各平台免费的 Bot API,反向服务模式下 Hermes 不跑推理只做转发,唯一开销是它自己常驻的那点内存。按需调用也是零开销设计,你不主动说通知我,Claude Code 碰都不会碰它,两分钟内的短任务直接等结果,超过十分钟的活才值得配这条线。

部署拓扑上有个设计决策值得单独说,开发机和常驻机器分离。开发机负责跑 Claude Code 和 Codex,常驻机器跑 Hermes 和各家 Bot,两台之间只走 SSH。好处是开发机随便关机重启换网络,通知链路不受影响,半夜批量任务发完通知,早上一开盘都在。单机党也有省事路线,Hermes 和 Claude Code 装同一台机器,SSH 整段跳过,stdio 直连本地进程。

通知这件事还有个巧妙的放大器,Hermes 的指针架构。它的人设和记忆文件只存两类内容,外部读不到的行为约束,以及去哪找内容的路径,所有事实靠对话中现场读文件。落到通知场景,当 Claude Code 让 Hermes 往某个品牌频道发消息时,频道配置指向知识库里的品牌目录,通知自动带上该品牌的语境,不用人工标注。Claude Code 白天更新了知识库,Hermes 晚上发通知用的就是新内容,两边零同步成本。

顺带一提社区的轻量替代,如果嫌 Hermes 重,ntfy-mcp-server 主打最简部署,omni-notify-mcp 提供多通道加语音,telegram-notification-mcp 是 Telegram 专用的 Cloudflare Workers 方案,用钉钉的国内团队可以看 Claude-Code-Notifier,带 ActionCard 权限确认。只要通知,它们更轻,要 Agent 能力和多品牌路由,还是 Hermes。

赛博霓虹风插画,中央一台常驻服务器机柜向左以加密隧道连接一台开发机,向右扇出多条光线连接到一排消息平台图标,构成反向桥接枢纽,青品红霓虹

四类故障排坑清单

第一类,启动报 MCP server 连接超时。按顺序验三样,ssh 能否免密 echo ok,远程 hermes --version 是否可执行,mcp serve --help 是否有输出。八个成原因是密钥没免密在等密码输入、配置里路径跟 pipx 实际安装路径对不上、防火墙拦了 22 端口。

第二类,工具调用显示成功,手机却没收到。去常驻机器看 hermes gateway status 是否还活着,hermes status 看平台连接,tail 网关日志和错误日志。常见是网关没启动、Bot Token 过期、Chat ID 填错。

第三类,首条消息慢约 20 秒。冷启动是 SSH 建连加进程初始化加三次端点探测的叠加。解法三层,.env 里显式写死模型端点跳过探测,Codex 侧把 startuptimeoutsec 提到 15 到 20,SSH 开连接复用,ControlMaster auto 加 ControlPath 指到 sockets 目录再加 ControlPersist 600,后续连接几乎瞬通。

第四类,Hermes 工具在 Claude Code 里不可见。检查 ~/.claude.json 的 JSON 语法,重启 Claude Code,确认 permissions.allow 里有 mcp__hermes 前缀,终端里跑 /mcp 看已连接列表。

日常运维再备一组命令就够覆盖九成场景。hermes gateway status、start、stop、restart 管网关生死,hermes mcp list 和 mcp test 加名称验 MCP 连通,hermes doctor 做配置、模型、平台连接的全面自检,日志在 ~/.hermes/logs/ 下分 gateway、agent、error 三份,排障先 tail 后 cat,基本不用开调试器。

老雷提个醒,StrictHostKeyChecking=no 只建议在内网用,公网部署老老实实维护 known_hosts 做精确校验,通知链路的口子别开在安全上。

赛博霓虹风插画,四格故障排查面板呈阶梯排列,每格一个霓虹描边的故障符号,断开的插头、沉默的铃铛、沙漏、隐形眼镜形的光标,一只机械手正逐格点亮检查标记

收口,先分方向再选线

用一个场景感受三条线的差距。跑 30 分钟审计去吃饭,Hooks 给你的是回到电脑前才能看的桌面弹窗,想追问还得走回终端。Channels 和 Hermes 都是手机直接看结果,区别是前者在 Telegram 里追问,后者在 Discord 里隔着 Hermes 追问。如果这台机器上跑的是 Codex,前两条直接出局,Hermes 是唯一选项。

选型的第一步不是比功能,是分清消息方向。想从手机遥控本机 Claude Code,消息从外往里,选 Channels。想让跑完的任务主动报信,消息从里往外,Hooks 最便宜,多平台加 Codex 兼容选 Hermes。三个都想留也行,社区里常见组合是 Hooks 管本机提示音,Channels 做双向对话主通道,Hermes 当多品牌通知出口,触发机制完全不同,不会重复轰炸。两个品牌的内容分发走 Hermes 的频道隔离最舒服,不同品牌的通知物理隔离在不同频道,channel_prompts 指向各自品牌目录,通知内容自动带对品牌上下文。社区甚至出现了融合趋势,hermes-CCC 项目把 Hermes 的 46 个原生技能移植成了 Channel 插件,虽然还在早期。

通知线的价值不在推送本身,在于你敢把半小时的任务扔给 Agent 然后真的走开。

老雷的收口一句话,短任务别折腾,长任务先上 Hooks 垫底,等你发现自己开始在手机上想插嘴,再上 Channels,等你有了微信、多品牌或者 Codex 的需求,Hermes 反向桥接在那儿等着。三条线是递进关系,不是三选一。