对于经常使用飞书且同时是 Claude Code 用户的开发者而言,一个常见的痛点在于:每次向 Claude 下达指令,都必须切换到终端窗口。在飞书内聊天或查阅文档时,突然转向命令行,这种操作割裂体验确实影响工作效率。
zarazhangrui 老师开源的 feishu-claude-code-bridge 项目恰好能解决这一难题。简单来说,它让你直接在飞书聊天窗口里给 Claude Code 发送指令,结果还能实时回传到飞书,完全无需离开聊天界面。
该工具本质上是一个运行在本地的 bridge 守护进程。其工作流程十分清晰:将你在飞书中发送的消息转化为 claude -p 形式的命令行调用,随后 Claude 的处理结果通过流式更新的方式,实时推送回飞书聊天消息中。

快速搭建最小运行流程
要上手运行此项目,需满足四个前置条件:电脑已安装 Claude Code CLI(终端输入 claude 有正常响应)、飞书本地客户端(网页版不支持)、以及 Node.js 运行环境。条件齐备后,在终端执行一行命令即可:
npx -y lark-channel-bridge@latest run
首次运行时,需要配置飞书应用凭证。前往飞书开放平台创建一个应用,获取 App ID 和 App Secret 并填入。此配置仅需一次,后续启动时会自动跳过。随后通过浏览器扫码或打开授权 URL,完成创建并与 Claude Code 建立连接。连接成功后,飞书会话列表中会出现一个新的智能助手,直接向其发送消息即可。
完成上述四步后,你在飞书中发送的任何消息都会被 bridge 转发给本地的 Claude Code 处理,结果实时同步回飞书。若 Claude 需要用户确认的操作,会以卡片形式展示在聊天中,点击即可确认。
配置 Workspace 工作目录
bridge 支持指定 Claude Code 的工作目录。配置后,所有操作均在该目录下执行,能够读取目录中的 CLAUDE.md、Skills、Hooks 等配置——与直接在终端 cd 到该目录使用 Claude Code 无异。Workspace 配置可在首次连接时的设置页面中完成,后续也可在 bridge 配置中修改。
典型应用场景
以下几个场景值得尝试:
- 向智能体发送一条推文链接,让其抓取内容、翻译为中文,并自动创建为飞书文档
- 将飞书收到的消息一键转发给智能体,由它完成后续处理
- 在手机上打开飞书,即可远程操控电脑上的 Claude Code,完全无需开启终端
由于底层即为完整的 Claude Code,其所有功能均可通过飞书界面实现,只是交互方式从终端转移到了聊天窗口。
更多扩展可能性
这种“即时通讯 ↔ 本地 Agent”的架构,不仅限于对接 Claude Code。同样的模式完全可以应用于 Codex、Cursor 或其他本地编程 Agent。
项目代码完全开源,你可以直接将仓库提供给 AI,让它帮你改编成自己的版本——更换即时通讯工具、添加自定义指令、对接其他后端服务,均无障碍。
项目开源地址:https://github.com/zarazhangrui/feishu-claude-code-bridge
飞书详细文档:https://larkcommunity.feishu.cn/docx/OaRIdFIRFoLM3xxTmKwcetHqn5e
