越来越多团队开始把 Claude Code、Codex 这类 coding agent 放进日常工作流，但真正麻烦的地方往往不在“AI 会不会写代码”，而在协作入口太分散：需求在飞书群里，反馈在文档评论里，执行过程在 terminal 里，历史记录又散落在不同 session 中。
如果 AI 编程助手只能待在本地终端里，很多团队协作动作仍然要靠复制、转发、截图和口头说明完成。针对这个问题，飞书同学Zara做了个 bridge，可以把本地的 Claude Code 和 Codex 桥接到飞书/Lark 里，让 Claude Code/Codex 成为飞书里的一个 bot，把 coding agent 接回大家每天都在用的协作场景里，让对话、任务、卡片、文档和会话记录都能在同一个环境中流动。
本文来自飞书同学 Zara（小红书博主“张咋啦”）的实践分享，这篇分享的核心是：通过 Lark Coding Agent Bridge，把本地 Claude Code 和 Codex 接入飞书/Lark，让 coding agent 可以在飞书里聊天、发送交互卡片、生成文档、管理多 session，并把协作过程沉淀下来。
工具定位 | Lark Coding Agent Bridge 是一个把本地 Claude Code、Codex 接入飞书/Lark 的桥接工具。 |
核心场景 | 在手机、群聊、话题、飞书文档和飞书卡片中协作使用 coding agent。 |
解决问题 | 减少终端 tabs 混乱、纯文本交互负担、上下文复制粘贴和聊天记录丢失。 |
适合人群 | 经常使用 Claude Code/Codex 的工程师、产品经理、运营同学，以及想把 AI 编程助手接入团队协作流的人。 |
一、如何把 Claude Code/Codex 接入飞书：Lark Coding Agent Bridge 的安装与启动方式
Repo链接：https://github.com/zarazhangrui/lark-coding-agent-bridge
在Terminal输入一行命令即可：
npx -y lark-channel-bridge@latest start
配合Lark CLI使用效果更好，如果没有安装过Lark CLI，请在这里安装：https://github.com/larksuite/cli
二、Claude Code/Codex 接入飞书后能做什么：移动端对话、会话管理、卡片交互与文档协作
能力 | 原来的问题 | 接入飞书后的效果 |
移动端对话 | 只能守在电脑或终端前继续和 Claude Code/Codex 沟通。 | 可以在手机飞书里继续聊天、语音输入和跟进任务。 |
多 session 管理 | 多个项目和会话散落在 terminal tabs 里，难回找、难恢复。 | 用飞书群、话题或 thread 承载项目和 session，历史上下文更清楚。 |
富文本回复 | coding agent 只能输出大段纯文字，阅读负担重。 | 可以用图文、表格、长图等飞书富文本形态展示结果。 |
交互卡片 | 选择题、确认操作都要靠打字或键盘控制。 | Claude Code/Codex 可以发送飞书卡片，用按钮完成选择和确认。 |
文档协作 | Markdown spec 阅读和反馈成本高。 | 直接生成飞书文档，团队可以划词评论、协同审阅。 |
消息转任务 | 飞书里的需求、反馈、任务需要手动复制给 agent。 | 可以把飞书消息合并转发给 Claude Code/Codex 处理。 |
手机端使用 Claude Code/Codex：在飞书里继续对话和语音输入
工作不再绑定在工位，可以散步时跟Claude Code/Codex聊天，还可以语音输入~
250px|700px|reset
多 session 管理：用飞书群聊和话题替代 terminal tabs
Before | After |
多session管理，一堆terminal tabs，非常容易乱套、找不到之前的tab在哪里 250px|700px|reset  |
250px|700px|reset  可以给所有带Claude Code的群加上标签，更方便一键找到： 250px|700px|reset  |
富文本和多媒体回复：让 Claude Code/Codex 输出图文、表格和长图
Before | After |
Claude Code/Codex仅用文字的方式跟我沟通，经常是一大堆文字，不愿意看 250px|700px|reset  | Claude Code/Codex可以给我发送图文混排的消息 250px|700px|reset  可以给我发一个表格，并渲染出来 250px|700px|reset  可以给我发送一个长图，并且直接在飞书里查看 250px|700px|reset  |
交互式飞书卡片：用按钮完成选择、确认和运行控制
Before | After |
给我出题让我选择时，需要打字选择/键盘控制，不符合直觉，而且选择内容只能是纯文本 250px|700px|reset  250px|700px|reset  | Claude Code/Codex发送可交互的卡片，通过按钮交互，更符合直觉 250px|700px|reset  250px|700px|reset  |
飞书文档协作：用云文档承载 specs/docs 并直接评论反馈
Before | After |
给我写markdown文档，给反馈的时候还得用文字描述。 比如Claude Code/Codex最开始给我写了个spec，写的是markdown的形式，首先markdown就很不容易读，而且也不方便打开。其次如果我有具体的反馈，还得手动描述“第几段第几行，怎么改”，非常麻烦 | 给我写飞书文档，给反馈的时候直接划词评论 250px|700px|reset  250px|700px|reset  |
飞书消息转任务：把群消息一键转给 Claude Code/Codex 处理
Before | After |
飞书里的消息，需要手动复制或者截图分享给Claude Code/Codex | 直接把飞书消息合并转发给Claude Code/Codex。比如用户的反馈、leader布置的任务等等，可以一键布置给Claude Code/Codex 250px|700px|reset  |
聊天记录沉淀：在飞书里检索、回顾和分享 agent 协作过程
Before | After |
关掉terminal之后，聊天记录就没有了，因此经常不敢关。Claude并不会保留完整聊天记录，只会保留我自己的prompts。聊天记录不能很方便地回顾、检索、分享 | 所有聊天记录都留存在飞书里，方便检索、存档、回顾、分享。 比如我经常想给别人分享我跟Claude Code/Codex的brainstorm过程，或者vibe coding的过程，可以直接合并转发历史聊天记录。 |
三、如何配置 Lark Coding Agent Bridge：偏好设置、会话、工作空间和诊断命令
如果还有什么想许愿的交互体验，欢迎评论！
在飞书里直接发斜杠命令，回车即可生效。下面按用途分组，不在表里的斜杠会原样转给 Claude/Codex 处理。
偏好设置：配置回复方式、工具显示和超时策略
- /config — 表单调整：消息回复方式（卡片 / 纯文本）、工具调用是否显示、并发上限、群内是否需要at bot 才回复
250px|700px|reset
- /timeout — 当前 session 的 run 探活（优先级高于 /config 的全局值）
- /timeout 15 当前 session 设 15 分钟无响应自动 kill
- /timeout off 当前 session 关闭探活
- /timeout default 清掉 session 覆盖，跟随全局
- /account — 查看当前应用；/account change 换 appId / secret 并热重连
会话管理：新建、恢复和查看 Claude/Codex session
- /new（或 /reset） — 清空当前会话，从零开始
- /new chat [名字] — 新建一个群（自动拉你和 bot 进去），继承当前 cwd 后开新会话
- /resume [N] — 列出最近 N 个历史会话，点按钮一键恢复
- /status — 当前 cwd / session / agent 状态卡片
- /help — 命令速查卡片（更新中，下图可能不全，以实际为准）
- /account 切换绑定的bot
工作目录与工作空间：切换 cwd 并保存常用项目空间
- /cd <路径> — 切换 Claude 的工作目录（会重置 session）
- /ws list — 列出所有命名工作空间（卡片 + 按钮）
- /ws save <名字> — 把当前 cwd 存为命名工作空间
- /ws use <名字> — 切到指定命名工作空间
- /ws remove <名字> — 删除命名工作空间
运行控制：停止当前任务并重连 bridge
- /stop — 终止当前正在跑的 Claude 任务（等同卡片底部 ⏹ 终止 按钮）
- /reconnect — 强制重连 WebSocket（网络抖动后 bot 没反应时用）
进程管理：处理同 app 多开和指定进程退出
- /ps — 列出本机所有 lark-channel-bridge 进程，标识"当前回复的是哪个"
- /exit <id|#> — 终止指定 start 进程（关自己 = graceful 退出；关别人 = SIGTERM）
诊断排查：用 /doctor 分析日志和故障描述
- /doctor [描述] — 把最近日志 + 你的故障描述喂给 Claude 自助诊断，返回可能原因 / 关键日志 / 建议下一步
四、如何用多 profile 同时运行 Claude 和 Codex：账号、会话和日志隔离
默认情况下，bridge 使用当前激活的 profile；可以通过 profile use <name> 切换。每个 profile 会维护独立的应用凭据、会话、工作目录和日志。只有在需要同时连接多个 PersonalAgent 应用，或分别运行 Claude 和 Codex 时，才需要创建多个 profile：
lark-channel-bridge start --profile claude --agent claude
lark-channel-bridge start --profile codex --agent codex
例如只重启 Codex bot：
lark-channel-bridge restart --profile codex
lark-channel-bridge status --profile codex
profile 场景 | 推荐配置 | 价值 |
只使用一个 coding agent | 使用默认 profile 即可。 | 配置最简单，适合个人轻量使用。 |
Claude 和 Codex 分开运行 | 分别创建 claude 和 codex profile。 | 应用凭据、会话、工作目录和日志相互隔离，便于排查。 |
同一台机器多 app 多开 | 用 /ps 确认当前回复进程，用 /exit 关闭指定进程。 | 避免多个 bot 混用同一个会话或误回复。 |
只重启 Codex bot | lark-channel-bridge restart --profile codex | 不影响 Claude 侧正在运行的任务。 |
五、Claude Code 计费说明：claude -p 与 Agent SDK 的订阅额度变化
Bridge使用的是claude -p模式，自 2026 年 6 月 15 日起，Claude 订阅计划对 claude -p 和 Agent SDK 的使用将独立计费，不再占用原有对话额度。
各订阅档位获得独立的月度额度：Pro $20、Max 5x $100、Max 20x $200，当月未用完不滚存。
订阅价不变。轻度使用无影响；重度使用 claude -p 跑脚本的同学可能更快触顶，超额需按 API 付费或升级套餐，建议提前评估用量。
六、QA：Claude Code/Codex 接入飞书的常见问题
Q1：什么是 Lark Coding Agent Bridge？
A：它是把本地 Claude Code、Codex 连接到飞书/Lark 的 bridge，让 coding agent 能以 bot 形式在飞书里对话、发卡片、管理 session 和生成文档。
Q2：为什么要把 Claude Code/Codex 接入飞书？
A：主要是为了把 coding agent 放进真实协作流：手机可用、消息可转发、结果可沉淀、团队可评论，不再只依赖本地 terminal。
Q3：这个 bridge 适合个人还是团队使用？
A：个人可以用它管理多项目和移动端对话；团队可以用它沉淀需求、spec、讨论记录和 agent 执行过程。
Q4：Claude 和 Codex 可以同时接入吗？
A：可以。需要分别运行时，可以用不同 profile 管理 Claude 和 Codex，让应用凭据、会话、工作目录和日志保持隔离。
