用Claude Code Hook实现任务完成后发送飞书提醒（可复用到微信、钉钉、桌面提醒）

推荐语

告别频繁切换窗口的烦恼！用Claude Code Hook实现任务完成自动提醒，提升你的工作效率。

核心内容：
1. 创建飞书机器人并配置Webhook触发流程
2. 将Claude Code与飞书机器人助手连接实现自动提醒
3. 方法可复用到微信、钉钉等多种提醒场景

杨芳贤

53AI创始人/腾讯云(TVP)最具价值专家

今天是Claude Code系统的第3期，我们来聊聊怎么用 Claude Code Hook 实现在任务完成后发送飞书提醒，这里的飞书提醒，也可以是微信提醒、钉钉提醒、桌面提醒，整个逻辑和流程基本是一致的。

第一期：初学Claude Code全是卡点？试试我这份工具清单，无痛迁移和使用

第二期：MCP很难？这种方法轻松搞定，而且一劳永逸" data-itemshowtype="0" linktype="text" data-linktype="2">在Claude Code中安装MCP很难？这种方法轻松搞定，而且一劳永逸

为什么要做这个 Claude Code Hook 呢？

主要是我有个不好的习惯，在 Vibe Coding 时总想知道进度，所以时不时切换窗口查看 Claude Code 当前任务到底完成没。这其实很影响效率。

而我现在很多任务都在飞书上完成，所以我就想着是不是可以做个 Claude Code Hook，在它完成任务后给我发个飞书提醒。这样我就不用老切换窗口查看进度，也不用担心其他事情做着做着就忘了还有这个 Vibe Coding 进程。

以下是完整的分步指南，其中容易出现卡点的环节都进行了标注。

步骤一：在飞书创建一个机器人

点击飞书左侧搜索框，在出现的窗口中搜索“飞书机器人”，然后点击“飞书机器人助手”。

如果之前没有安装过“飞书机器人助手”，需要先安装并授权。

完成后就可以在飞书中打开“飞书机器人助手”，在页面中依次选择“我的应用-新建机器人应用”。

接着配置应用名称、应用描述和应用图标。

我在应用描述中填写的是“在Claude Code完成任务后给出消息提醒”，这个描述不用太讲究，主要方便自己后续查看。

完成后点击“确定”就会跳转到这个机器人应用的管理窗口（默认是“流程设计”页面）。

点击“创建流程”后跳转到流程编辑画布中，初始默认三个节点（支持添加更多）：触发器→操作→结束。

触发器：就是一个能记住状态、按信号自动切换的“记忆开关”，比如自动感应门，当你靠近自动感应门（信号），触发器让电机启动，门自动打开；你走远后，门自动关上（保持状态）。在我们这个案例中，我们需要用到 Webhook，对应飞书机器人助手中的“Wehook触发”。

这里简单介绍下 Webhook，它又叫“网络钩子”，是应用给其它应用提供实时信息的一种方式。通过 Webhook ，系统可以在收到 HTTP/HTTPS 请求时，自动触发流程运行。

飞书机器人助手提供 Webhook 触发能力，我们就可以通过 Webhook 将 Claude Code 与飞书机器人助手连接起来。进而实现从 Claude Code 自动接收数据。比如当 Claude Code 完成任务（这里的任务也可以是其它的）时，通过机器人发送飞书消息。

选择“Wehook触发”后，你就会得到一条Webhook地址。这个地址非常重要，有了它，Claude Code 才知道完成任务后给哪个飞书机器人助手发送消息。

接着填写 Webhook 推送的 JSON 数据格式或示例数据，对应的 key 值可以被后续流程节点（如操作）消费。

注：参数需要用大括号 {} 括起来，由 message_type 和键值对组成。message_type 必须为文本类型，键是字符串，值可以是字符串、数字、布尔值、数组、对象或 null。如下图所示，如果你想要获取 Claude Code 项目字段，可以在参数中填写示例数据 "project": "cc"；如果你想要获取 Claude Code 任务完成时间字段，可以在参数中填写示例数据 "time":"21:15:37"，其它更多字段依次类推。

操作：还是以自动感应门为例，当你靠近自动感应门，门自动打开就是一个操作。而在我们这个 Claude Code Hook 案例中，飞书机器人助手中的“发送飞书消息”就是一个操作。

接着需要配置飞书消息的“发送对象”、消息标题和消息内容，其中的消息内容可以从我们前面 Wehook 触发器节点配置的JSON文件的字段中获取。

完成配置后，你可以通过 curl 指令，向以上 Webhook 地址发送一个 HTTP POST 请求，进行功能测试。

• macOS 系统：在电脑上打开“终端”应用程序，并执行以下命令。

curl -X POST -H "Content-Type: application/json" \    -d '{"msg_type":"text","content":{"project":"cc","time":"21:15:37"}}' \    此处填写 Webhook 地址

• Windows 系统：在电脑上用快捷键 Win + R 打开运行对话框，输入 cmd 并按回车键。在命令窗口执行以下命令。

curl -X POST -H "Content-Type: application/json"     -d "{\"msg_type\":\"text\",\"content\":{\"text\":\"request example\"}}"     此处填写 Webhook 地址

终端返回success就代表成功。

前面所有环节完成后，记得点击“发布”，否则后续步骤在测试时会失败。

步骤二：配置 Claude Code Hook

在正式介绍配置流程前，先简单介绍下 Claude Code 的 Hook 功能。

它和前面介绍的 Wehook 能力上是类似的，只不过 Claude Code 的 Hook 是给AI编程加了个“自动开关”——你提前写好规则，它在代码编辑的关键节点自动触发，不用你每次提醒，该做的事一件不会落。比如你想让AI每次修改代码后自动格式化，或者在它完成任务后发送飞书提醒，Hook 就能帮你把这些“要求”变成AI必须遵守的“铁律”，彻底告别“说了八百遍还是忘”的麻烦。

它本质上是用“代码规则”替代“AI自觉”，让你的 Vibe Coding 流程更稳定、更高效。不管是代码格式化、安全检查，还是自动化测试，只要你能想到“想在某个时候做某件事”，就能借助 Hook 实现。

Claude Code 的 Hook 通过 JSON 文件配置，可以添加到以下任一位置：

• 用户设置: ~/.claude/settings.json - 适用于所有项目

• 项目设置: .claude/settings.json - 与团队共享

• 本地项目设置: .claude/settings.local.json - 个人使用，不提交到版本控制

在这个案例中，我们使用的是第三种。我们首先创建或编辑 .claude/settings.local.json 文件，添加以下配置：

{    "hooks": {      "Stop": [        {          "hooks": [            {              "type": "command",              "command": "$CLAUDE_PROJECT_DIR/.claude/scripts/feishu-notify.sh"            }          ]        }      ]    }  }

这里使用的是 Stop hook，因为它在 Claude Code 会话结束（任务完成后）触发。

整段 JSON 的整体含义是：当 Claude Code 完成当前会话的任务（如代码生成、问题解答）时，自动执行项目根目录下的feishu-notify.sh脚本。

步骤三：创建飞书通知脚本

在项目目录创建一个脚本文件（如~/.claude/scripts/feishu-notify.sh），脚本中的Wehook 链接，需要替换成我们在步骤一中得到的飞书 Wehook 链接。

#!/bin/bash
# 从stdin读取hook输入数据input=$(cat)
# 记录原始输入用于调试echo "Raw input: $input" >> /tmp/feishu-debug.log
# 提取基本信息if command -v jq >/dev/null 2>&1; then    cwd=$(echo "$input" | jq -r '.cwd // "Unknown"')    session_id=$(echo "$input" | jq -r '.session_id // "Unknown"')else
# 如果没有jq，使用简单的方法    cwd="Unknown"    session_id="Unknown"fiproject_name=$(basename "$cwd")completion_time=$(date '+%H:%M:%S')completion_date=$(date '+%Y-%m-%d')
# 记录提取的信息echo "Extracted: cwd=$cwd, project=$project_name" >> /tmp/feishu-debug.log
# 构建消息文本（避免在JSON中使用换行符）text_content="Claude Code任务完成 项目名称: $project_name 完成时间: $completion_time 完成日期: $completion_date"
# 使用简单的JSON构建（避免复杂的转义）curl -X POST '替换成你的实际 Wehook 链接' \     -H 'Content-Type: application/json' \     -d "{\"msg_type\":\"text\",\"content\":{\"project\":\"$project_name\",\"time\":\"$completion_time\",\"date\":\"$completion_date\"}}"     >> /tmp/feishu-debug.log 2>&1echo "Script completed at $(date)" >> /tmp/feishu-debug.log

这个脚本的主要作用就是，读取 Claude Code 传来的 JSON 数据（包括项目名、任务完成时间、任务完成日期）并构造一条飞书通知消息，通过 curl发送 HTTP POST 请求到飞书 Webhook。

注意：虽然脚本里已经对系统是否安装 jq 的处理，但还是建议大家提前安装 jq，方便命令行中的 JSON 处理。

这里的脚本内容大家不用自己去写，因为可以把问题抛给 AI（建议Claude Code 和 Claude Docs AI，一问一个准），比如这里你可以这么问：

我想要创建一个 Claude Code Hook，实现在 Claude Code 完成任务后发送飞书通知消息，返回的消息字段包括项目名称、任务完成时间、任务完成日期脚本创建完成后，记得在终端运行以下指令，确保脚本有执行权限（这是大家比较容易落下的点）。

chmod +x ~/.claude/scripts/feishu-notify.sh或者如果脚本在项目目录中：

chmod +x /Users/caicai/Documents/cursor开发文件-3/feishu-hook/.claude/scripts/feishu-notify.sh

步骤四：功能测试和优化

完成前面的配置后，启动 Claude Code（如果之前开着，记得退出后重新进入）中运行一个简单任务（比如“你现在使用的是哪个模型”），完成后检查前面配置的飞书账号是否收到通知。

收到通知就大功告成了！当然，大家还可以根据自己的实际情况对消息通知的内容进行调整，这些就留给大家自己去探索啦 ~

就像前面介绍的，这里的飞书提醒，也可以替换微信提醒、钉钉提醒、桌面提醒，整个核心逻辑和流程基本是一致的，比如：

• 微信提醒，可以借助企业微信机器人，或者第三方推送工具如虾推啥；

• 钉钉提醒，可以借助钉钉机器人；

• 还有桌面、Discord、Telegram、Slack等提醒，也都是类似的流程。

其中桌面、Discord、Telegram、Slack 有现成的 Hook 可以直接用，在这里就可以快速安装的指令 >>> https://www.aitmpl.com/hooks