Claude Code 和 Codex 同时在线当两个飞书 Botlark-coding-agent-bridge 多 Profile 实战教程【免费下载链接】lark-coding-agent-bridgeBot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI. Streaming cards, per-chat sessions, multiple workspaces项目地址: https://gitcode.com/gh_mirrors/fe/lark-coding-agent-bridgelark-coding-agent-bridge 是一个把飞书 / Lark 消息与本机 Claude Code、Codex CLI 打通的轻量 Bot支持流式卡片回复、每会话独立上下文和多工作空间。它的多 Profile 机制让你在同一台机器上同时运行两个独立的飞书 Bot一个对接 Claude Code一个对接 Codex各自的凭据、会话、工作目录和日志完全隔离互不干扰。本教程带你从零完成双 Bot 部署 一、为什么需要多 Profile一个 Profile 里装了什么简单说一个 Profile 一个独立的飞书 Bot 运行环境。每个 Profile 独立维护隔离维度说明应用凭据绑定各自的飞书 PersonalAgent 应用会话状态聊天 / 话题 / 文档评论会话互不串线工作目录独立的默认工作空间和命名工作空间lark-cli 授权个人授权不会共享给另一个 Profile后台服务每个 Profile 注册独立的系统服务日志结构化运行日志各自存放本地状态都放在~/.lark-channel/下按 Profile 分目录存放~/.lark-channel/ ├── config.json # 根配置所有 profiles 当前激活的 profile └── profiles/ ├── claude/ # 会话、工作空间、日志、lark-cli 目录 └── codex/当你只需要一个 Bot 时用默认 Profile 即可只有需要同时在线运行 Claude 和 Codex 两个 Bot、或连接多套飞书应用时才创建多个 Profile。设计细节可参考 src/config/profile-schema.ts 中的ProfileConfig定义。二、快速上手两条命令启动双 Bot第 1 步安装并首次启动npm i -g lark-channel-bridge lark-channel-bridge run首次运行会进入扫码向导终端渲染二维码 → 用飞书 App 扫码 → 选择或创建 PersonalAgent 应用 → 选择要初始化的 agent。配置成功后写入~/.lark-channel/config.json。第 2 步分别为 Claude 和 Codex 创建 Profile 并启动确认 Bot 能正常收发消息后用Ctrl-C停掉前台进程然后直接按 Profile 启动后台服务lark-channel-bridge start --profile claude --agent claude lark-channel-bridge start --profile codex --agent codex至此你的飞书里就有了两个 Bot一个背后是 Claude Code一个背后是 Codex CLI。两个 Bot 各自拥有独立的飞书应用身份私聊、群 、流式卡片回复全都照常工作 ✅如果某个 Profile 想指定初始项目目录创建时加--workspace path即可没指定时 bridge 会自动创建托管的默认工作目录后续在飞书里发/cd path切换。三、Profile 管理命令速查日常运维全靠这几条Profile 管理命令实现位于 src/cli/commands/profile.ts常用操作如下命令作用profile list列出所有 Profile显示激活标记、agent 类型和运行进程profile create name --agent claude创建新 Profileprofile use name切换后续默认启动使用的 Profileprofile remove name默认归档本地状态可恢复加--purge --yes才永久删除profile export name导出配置默认脱敏 App Secret加--include-secrets --yes才含敏感信息几个实用细节删错了也不怕profile remove默认是归档而不是删除状态会移到归档目录只有--purge --yes才会真正清掉。agent 类型建错了先stop或unregister --profile name清理后台服务再删除并用正确的--agent重新创建。两个 Profile 同名冲突名字只是标签Profile 名不能重复使用创建重复名会直接报错提示。四、独立后台服务只重启 Codex别打扰 Claude这是多 Profile 最有价值的地方——每个 Profile 注册独立的操作系统服务服务实现见 src/cli/commands/service.ts。平台映射如下平台服务形式macOSlaunchd 用户代理ai.lark-channel-bridge.bot.profileLinuxsystemd 用户单元lark-channel-bridge.bot.profile.serviceWindows计划任务LarkChannelBridge.Bot.profile也就是说Codex Bot 更新后只想重启它自己一条命令搞定Claude Bot 全程无感知lark-channel-bridge restart --profile codex lark-channel-bridge status --profile codex完整的生命周期命令都支持--profile参数start/stop/restart/status/unregister。各 Profile 的 daemon 日志在~/.lark-channel/profiles/profile/logs/daemon/下排查问题时按 Bot 分头看即可。 注意服务层命令必须先全局安装npm i -g不能直接用npx启动否则服务注册的路径会随 npm 缓存失效。五、进阶玩法与排障Web 控制台一把看全除了逐 Profile 启动还支持 supervisor 模式把多个 Profile 收进同一个进程配合 Web 控制台统一查看每个 Bot 的在线状态与运行时长Bot 清单逻辑见 src/ui/fleet.ts。适合 Profile 多、想集中监控的场景。飞书内命令按 Bot 独立生效/new、/cd、/ws、/status、/config等斜杠命令都作用于当前这个 Bot 所属的 Profile。比如你可以让 Claude Bot 常驻后端项目目录、Codex Bot 常驻前端项目目录用/ws save保存各自的工作空间开会话上下文自动隔离。常见排障Bot 没反应 → 多半是本机claude/codexCLI 没登录或会话指向了不存在的工作目录。发/status查看/new重开会话通常就好卡片停在最后一帧 → 可开启 idle 探活/timeout 10之类agent 假死会被自动终止想确认双 Bot 是否都活着 →lark-channel-bridge ps列出本机所有 bridge 进程或profile list看运行状态列。更多命令与配置说明完整文档在 README.zh.mdProfile 引导流程agent 检测、工作目录创建、Codex 二进制解析可看 src/cli/profile-bootstrap.ts。六、小结你的需求该怎么做只用一个 Bot默认 Profilerun走扫码向导即可Claude Codex 双 Bot 同时在线start --profile claude --agent claudestart --profile codex --agent codex只重启某一个 Botrestart --profile name另一个不受影响迁移 / 备份配置profile export namelark-coding-agent-bridge 的多 Profile 机制把一个飞书应用 一套本地状态 一个后台服务封装成最小单位双 Bot 部署也就两条命令的事。动手试试吧 ️【免费下载链接】lark-coding-agent-bridgeBot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI. Streaming cards, per-chat sessions, multiple workspaces项目地址: https://gitcode.com/gh_mirrors/fe/lark-coding-agent-bridge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考