飞书通知 for Claude Code

为什么要接飞书

Claude Code 往往在终端里跑很久：改一堆文件、等你点权限、或者一轮对话结束你正好不在电脑前。只靠终端提示音或切回窗口，很容易漏掉「需要确认」或「已经跑完」的时机。

这个技能把 Claude Code Hooks 接到飞书：在关键节点给你发私聊卡片，必要时还能加急，把「人在不在终端」和「任务状态」拆开。

它怎么工作

安装脚本会把 Hook 写进 ~/.claude/settings.json，监听两类事件：

• Stop：每一轮 Claude Code 结束；正常结束用绿色卡片，异常结束用红色
• Notification：按 matcher 区分场景——permission_prompt（橙色，要你先确认操作）、idle_prompt（蓝色，空闲等待）、auth_success（绿色，认证成功）

消息走飞书开放平台 API，依赖你已配置好的 lark-cli 与应用权限：im:message（发私聊）、im:message.urgent:app_send（应用内加急）。收件人由环境变量 CC_FEISHU_OPEN_ID 指定；想临时关掉通知可设 CC_FEISHU_NOTIFY=0。

适用边界与注意点

• 面向长时间用 Claude Code、会离开终端的开发者；不是通用 IM 机器人框架，而是针对 CC 的 Hook 模板。
• 飞书侧要开通机器人能力并完成 lark-cli auth login；macOS/Linux 脚本会用到 jq 与 python3，Windows 用 PowerShell 处理 JSON。
• 卸载时从 settings.json 里删掉 Stop 与 Notification 的 hooks 条目即可，不会动你其它 Claude 配置。