把 Claude Code 或 Codex CLI 接到飞书 / Lark 里,让你在聊天窗口里直接调用本地编程 Agent。
lark-coding-agent-bridge 更准确地说是一个飞书 / Lark 到本地 Agent 的桥。它适合想在群聊、私聊、文档评论里让 AI 帮忙看代码、改项目、跑任务的人。
一、它到底怎么用?
第一步:先准备本地环境。
你需要有 Node.js,并且本机已经装好、登录好 Claude Code 或 Codex CLI。然后全局安装:
npm i -g lark-channel-bridge也可以用:
pnpm add -g lark-channel-bridge第二步:启动并绑定飞书 / Lark。
lark-channel-bridge run第一次运行时,终端会出现二维码。用飞书 / Lark 扫码,选择或创建 PersonalAgent 应用,再按提示选择 Claude 或 Codex。
第三步:在飞书里开始用。
私聊可以直接发消息;群聊里通常需要 @bot。如果要切到某个项目目录,可以发:
/cd /你的项目路径常用命令还有 /new 重开会话、/status 看状态、/stop 停止当前任务、/ws save 保存常用工作区。
二、作为 Skill 怎么使用?
它本身不是 Claude Code 或 Codex 的 Skill,而是一个“聊天入口”。安装后,你是在飞书 / Lark 里用自然语言调用本地 Agent。
例如:
@bot 帮我看一下这个项目为什么启动失败,先读 README,再给我一个修复计划。
@bot 切到当前仓库,检查最近一次改动有没有明显 bug,并给我 review 意见。
如果你配置的是 Codex,它会把消息转给本地 Codex CLI;如果配置的是 Claude,它会转给本地 Claude Code。
三、使用注意事项
Node 和本地 Agent 要先准备好
为什么:这个工具只是桥,不自带 Claude Code 或 Codex 能力。正确做法:先确认 claude 或 codex 命令能在终端正常运行并已登录。
权限不要一开始就开太大
为什么:Agent 最终是在你的本机执行任务,能否读写文件取决于本地权限模式。正确做法:个人测试可以从默认配置开始;给团队用时,认真设置工作目录、访问名单和权限模式。
后台服务建议全局安装后再开
为什么:如果用 npx 临时运行,后台服务可能依赖临时缓存路径,后面缓存被清掉就会失效。正确做法:调试用 run,稳定使用再用 start / status / stop 管理后台服务。
群聊访问要单独管理
为什么:默认更偏私人使用,不是所有群成员都会自动获得权限。正确做法:用 /invite user @某人、/invite group、/config 管理谁能用,避免把本地 Agent 暴露给不该使用的人。
四、它适合谁?
适合:
✔ 经常在飞书 / Lark 里协作,但又想调用本地 Claude Code 或 Codex 的开发者
✔ 想让 AI 帮忙处理代码仓库、截图、文件、文档评论的人
✔ 小团队内部想把一个本地 Agent 变成聊天机器人的用户
不适合:
✘ 只想要一个网页版聊天机器人的人
✘ 不熟悉本地命令行、飞书应用配置、权限管理的人
五、最后总结
这个工具真正改变的是入口:你不必每次都切回终端,而是可以把飞书 / Lark 变成本地编程 Agent 的消息面板。
它不是替你省掉配置,而是把“本地 AI 编程助手”接进了团队日常聊天里。
夜雨聆风