Skip to content

让飞书提醒你不要摸鱼过头(Claude code)

约 1331 字大约 4 分钟

2026-01-02

背景

众所周知,Claude code、Codex 等编程 AI 智能体的编码效率尤为高,合理利用不仅能够大大加速编码速度,还能适当进行摸鱼(不是),将精力投入在系统设计上。 作为基于 LLM 的智能体,无可避免的是需要等待来生成内容,以及一些敏感操作如代码的修改、脚本的执行以及方案的确认都需要人类的确认(你也不想回来一看项目变成空文件吧)。基于以上特点,我们既不可能一直等待它的生成,也不能完全离开导致没能及时给出确认指令使进度停滞。 为了能够在恰当的时机发出提醒,需要使用到Claude Code Hooks,具体的使用可以参阅官方文档,本文主要使用其中的 NotificationStop 这两的 Hooks,对应着需要操作执行结束两个时机。 有什么可以提醒用户的方法呢?第一个是系统通知,这个方法在 Windows 和 Mac OS 都可以实现,甚至可以实现弹窗强提醒,但如果你是远程开发则无能为力了(如果玩手机的话可能也提醒不到);第二种也是本文想要介绍的一种,通过向 webhook url 发送信息,使服务器通过其他形式提醒用户,这里选择飞书机器人进行实现。

正文

观前须知

具体的请求实现使用 curl 发送,尽管 Windows 中可以自行安装 curl 且能够手动发起有效请求,但实测因为脚本中的转义字符与 cmd 或 powershell 中的转义字符问题,笔者始终无法成功在 Windows 上通过 claude code hooks 发起正确的请求,因此以下的最终实现仅限于 Linux 与 MacOS。

创建飞书机器人

webhook 机器人需要在飞书电脑版才可以创建 飞书机器人需要在群组当中创建,我们首先创建一个群组,不需要邀请任何人。随后在群组的设置中添加一个自定义群组机器人

imageimage

头像名称描述等可以自行定义 添加机器人后,在群机器人中点击你新创建的机器人头像,此时你就能看到分配给该机器人的 webhook 地址了,我们只需要向这个地址发送一个 POST 请求就能够控制机器人的行为了

image

机器人支持的消息类型可以参阅自定义机器人使用指南,我们可以尝试发送一条简单的消息。 文本消息的请求体为:

{ "msg_type": "text", "content": { "text": "新更新提醒" } }

使用 curl 快速发送请求

curl -X POST -H 'Content-Type: application/json' -d '{"msg_type":"text","content":{"text": "你好"}}' https://open.feishu.cn/open-apis/bot/v2/hook/<你的 hook>

不出意外的话,你的机器人在群组中发出了一条消息

image

任何的修改请在命令行中进行验证以确保命令无误,更多的消息格式参考自定义机器人使用指南,这里不做过多赘述

将命令放入 hooks 中

确认了 webhook 的可行性后,就需要让 Claude Code 在恰当的时机触发我们预设好的指令了

在你的任意工作区中打开 Claude,并输入/hooks

image

作为提醒,我们只需要关注两个 Hook,一个是 Notification,一个是 Stop。以 Notification 为例,在 Hook 选择中选中 Notification 并回车进入

image

(注:第一次可能存在选中失效的情况,请确保成功进入了 Notification 的匹配器选择页面,如果不是请 esc 退出再次选择)

image

接下来需要添加匹配器,我们希望提醒指令应该被任何情况所触发,因此输入*并按下回车

image

完成了匹配器的创建或选择,接下来就需要创建钩子(hook)了,选择增加新的钩子,并在下一页的 Command 中粘贴你的命令,确保无误后回车保存

image

image

我们希望提醒应该全局生效,因此将 hook 保存于 User setting 中。如果想进一步确认可以查看~/.claude/setting.json,其中应该会出现你新创建的 hook

image

生效验证

打开一个新的终端窗口并进入 Claude Code,并在默认的手动模式下使其创建一个文件,使其要求用户确认,大约 5s 后你应该能够收到飞书机器人的提醒

image

(STOP 的操作同理)

image

结语

我也不知道为什么要写结语,大概是让文章显得更完整(吧)。总之,有了提醒功能后的 Claude Code 应该可以更高效的 摸鱼 产出。