文章摘要
本Codex接入飞书教程将系统讲解通过Lark Coding Agent Bridge、cc-connect、@rottenapple/codex-im-bot等多种方案，把本地Codex CLI桥接到飞书会话中，让团队成员在群聊、文档、移动端直接调用Codex进行代码生成、调试与项目协作。

Codex接入飞书是当前软件开发团队提升协作效率的热门实践。Codex是OpenAI推出的AI编程智能体，截至2026年6月周活跃用户已突破500万。本Codex接入飞书教程将系统讲解通过Lark Coding Agent Bridge、cc-connect、@rottenapple/codex-im-bot等多种方案，把本地Codex CLI桥接到飞书会话中，让团队成员在群聊、文档、移动端直接调用Codex进行代码生成、调试与项目协作。

Codex接入飞书完整教程

一、Codex接入飞书的技术背景与核心价值

Codex是什么：从编程模型到智能编程体

Codex是OpenAI开发的AI编程智能体，能够将自然语言指令转化为高质量代码，并具备上下文理解与多轮对话能力。2026年6月，OpenAI披露Codex周活跃用户已突破500万，较年初增长超过5倍。在OpenAI内部，Codex已占据全公司每周99.8%的输出token。

Codex本身并非一个可独立下载的服务，其能力已整合进GitHub Copilot和ChatGPT的代码解释器中。当前Codex接入飞书的实践，本质上是利用开源工具链将Codex CLI（命令行界面）与飞书消息流深度整合。

为什么要把Codex接入飞书

开发团队在日常协作中面临一个普遍困境：需求讨论在飞书群里，代码反馈在文档评论中，AI编程助手的执行过程困在本地终端里，历史记录散落在不同session中。Codex接入飞书后，这些问题可以得到系统性解决：

  • 移动端对话：无需守在电脑前，在手机飞书里即可继续与Codex沟通，支持语音输入
  • 多session管理：用飞书群、话题或thread承载项目和会话，历史上下文清晰可追溯
  • 富文本回复：Codex可输出图文、表格、长图等飞书富文本形态，替代纯文字输出
  • 交互卡片：Codex发送飞书卡片，用按钮完成选择和确认操作
  • 文档协作：直接生成飞书文档，团队可划词评论、协同审阅
  • 消息转任务：将飞书消息合并转发给Codex处理

Codex接入飞书的典型工作场景

Codex接入飞书后，可在以下场景中发挥作用：

群聊协作场景：在飞书群里@机器人，Codex在指定项目目录中执行任务，结果以流式Markdown卡片实时返回。

文档评论场景：在飞书云文档（doc/docx/sheet/file，含知识库wiki）的评论里@机器人，Codex读取评论内容、执行代码任务、将答案回复到同一条评论线程中。

私聊控制台场景：私聊机器人弹出交互菜单，可进行新建项目、项目列表、设置、用量查看、诊断、重连等操作。

移动端开发场景：在手机飞书里继续与Codex对话，支持语音输入，工作不再绑定在工位。

二、Codex接入飞书的前置准备

系统环境要求

在进行Codex接入飞书之前，需要确保以下环境条件就绪：

  • Node.js运行时：版本要求18.0或以上（部分工具要求20.12.0以上）
  • Codex CLI：已安装并登录可用的Codex CLI，终端中能正常运行codex命令
  • 飞书账号：拥有飞书企业版或标准版账号
  • 操作系统：支持macOS、Windows及Linux三大主流平台

飞书自建应用配置

Codex接入飞书需要在飞书开放平台创建自建应用并获取凭证：

第一步：登录飞书开放平台，点击“创建应用”，选择“企业自建应用”，填写应用名称（如“Codex编程助手”）和描述。

第二步：在应用详情页的“凭证与基础信息”中获取App ID和App Secret，这两个凭证将在后续配置中作为必填参数。

第三步：在“事件订阅”中启用长连接机器人（persistent connection模式），订阅im.message.receive_v1消息接收事件。如果使用卡片交互按钮，还需订阅card.action.trigger事件。

第四步：在“权限管理”中添加im:message和im:message.group_at_msg等消息相关的权限。

第五步：发布应用版本并等待审核通过（自建应用通常无需审核，但需确保应用已上线）。

OpenAI API密钥配置

Codex的运行依赖于OpenAI兼容API。API Key应始终以环境变量的方式存储，不应硬编码在配置文件中。用户可以通过OpenAI平台获取API密钥，并在后续的工具配置中通过环境变量或配置文件引用。

三、主流Codex接入飞书方案详解

目前Codex接入飞书主要有四种主流方案，用户可根据自身技术栈和需求场景选择。

方案一：Lark Coding Agent Bridge（官方推荐）

Lark Coding Agent Bridge是飞书同学开发的官方桥接工具，支持将Claude Code和Codex接入飞书。这是目前Codex接入飞书最便捷的方案。

安装与启动：在终端执行一行命令即可完成安装和启动：

npx -y lark-channel-bridge@latest start

配合飞书CLI：如果尚未安装飞书CLI，可执行以下命令完成安装：

npx @larksuite/cli@latest install

多profile支持：Lark Coding Agent Bridge支持同时运行多个profile，可在一台机器上同时运行Claude Code和Codex。

Mac电脑休眠处理：如果是Mac电脑，建议搭配Amphetamine使用，在合盖情况下保持系统持续运行。配置方法为：安装Amphetamine后，在Preferences的Sessions标签页中勾选“Allow display to sleep while a session is active”，然后启动一个永久或定时session。

方案二：@rottenapple/codex-im-bot（npm包方案）

@rottenapple/codex-im-bot是基于@vdug/codex-im的定制发布版本，通过飞书长连接机器人把飞书消息转发到本机Codex。

安装：

npm install -g @rottenapple/codex-im-bot

配置文件创建：

mkdir -p ~/.codex-im
$EDITOR ~/.codex-im/.env

最小环境变量配置示例：

FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
CODEX_IM_DEFAULT_CODEX_MODEL=gpt-5.3-codex
CODEX_IM_DEFAULT_CODEX_EFFORT=medium
CODEX_IM_DEFAULT_CODEX_ACCESS_MODE=default
CODEX_IM_DEFAULT_WORKSPACE_ID=default
CODEX_IM_FEISHU_STREAMING_OUTPUT=true
CODEX_IM_FEISHU_STATUS_NOTIFICATIONS=true
CODEX_IM_FEISHU_STATUS_NOTIFICATION_STATES=approval,completed,failed,cancelled

启动机器人：

codex-im feishu-bot

飞书端使用：在飞书会话中发送/codex，然后在控制台卡片里绑定项目、选择线程、选择模型并发送消息。

后台运行：推荐使用tmux保持后台运行：

tmux new -s codex-im codex-im feishu-bot
# 按Ctrl-b d离开会话
# 恢复会话：tmux attach -t codex-im

方案三：@modelzen/feishu-codex-bridge（项目即群方案）

@modelzen/feishu-codex-bridge将飞书群与本地Codex项目目录绑定，每个群对应一个固定工作目录。

核心设计理念：

  • 群 = 项目：每个群绑定一个本地目录与默认参数
  • 话题 = 会话：群里的每个话题线程对应一条连续的Codex会话
  • 流式卡片：推理、命令、文件改动、结果实时刷新到一张可折叠卡片
  • 免@对话：项目群话题内可直接说话，不必每次@机器人

快速上手：将GitHub仓库链接交给本机在用的Codex，让它自动完成安装、后台启动和浏览器控制台配置。

核心特性：

  • 稳定隔离：每会话独立app-server进程，卡死有watchdog自动终止回收
  • 本地加密密钥库：飞书应用密钥用AES-256-GCM加密存储
  • 跨平台常驻：macOS/Windows/Linux·WSL均可注册为后台服务
  • Codex用量统计：5小时/7天限额进度、lifetime tokens、GitHub风格每日用量热力图

方案四：cc-connect（多平台通用方案）

cc-connect是一个通用的AI编程助手桥接工具，支持将Claude Code、Cursor、Gemini CLI、Codex等接入飞书、Lark、钉钉、Slack、Telegram、Discord、LINE、企业微信等多个平台。

安装：

npm install -g cc-connect

配置与启动：cc-connect的配置通过YAML文件完成，需指定飞书机器人凭证、Codex调用路径、上下文窗口大小、超时阈值等参数。

cc-connect的核心优势：

  • 无需公网IP、域名或反向代理
  • 通过WebSocket长连接在内网环境运行
  • 部署流程控制在五分钟以内
  • 支持Linux、macOS及Windows三大平台，无需Python或Node.js运行时

安全特性：

  • 消息双重加密：AES-256-CBC加密传输
  • 响应数据Base64编码嵌入飞书消息卡片
  • 敏感信息不以明文形式暴露于网络链路

进阶功能：

  • 语音转文字：基于飞书内置ASR引擎
  • 定时任务：Cron表达式声明，自动推送代码规范检查报告
  • 多机器人协作：同一服务器运行多个Agent实例，各绑定独立Token和模型参数

四、Codex接入飞书的详细操作流程

环境准备与工具选型

在开始Codex接入飞书之前，建议先根据团队情况选择合适的接入方案：

方案 适用场景 技术门槛 推荐度
Lark Coding Agent Bridge 追求最简部署 低 ★★★★★
@rottenapple/codex-im-bot 需要细粒度配置控制 中 ★★★★
@modelzen/feishu-codex-bridge 多项目/多群组管理 中 ★★★★
cc-connect 多平台统一接入 中 ★★★★

对于初次进行Codex接入飞书的用户，建议从Lark Coding Agent Bridge开始。

飞书应用创建与凭证获取

无论选择哪种方案，Codex接入飞书的第一步都是在飞书开放平台创建应用：

登录开放平台：访问飞书开放平台，使用企业账号登录。

创建自建应用：点击“创建企业自建应用”，填写应用名称（如“Codex开发助手”）和图标，完成创建。

获取App凭证：在应用详情页左侧菜单选择“凭证与基础信息”，复制App ID和App Secret并妥善保存。

配置事件订阅：选择“事件订阅”，将“事件订阅模式”设置为“持久连接”（persistent connection），订阅im.message.receive_v1事件。如需使用卡片按钮，还需订阅card.action.trigger。

配置权限：在“权限管理”中添加必要的消息权限，包括im:message、im:message.group_at_msg等。

发布应用：完成配置后发布应用版本，使配置生效。

方案一详细部署步骤（Lark Coding Agent Bridge）

安装与启动：在终端执行：

npx -y lark-channel-bridge@latest start

首次运行引导：首次运行时会提示扫码绑定飞书PersonalAgent应用。用飞书App扫描终端显示的二维码，选择或创建PersonalAgent应用即可完成绑定。

验证连接：启动成功后，在飞书中找到对应的机器人，发送一条测试消息验证连通性。

后台常驻：如需保持Codex接入飞书服务长期运行，可使用系统服务或进程管理工具（如pm2、systemd）进行守护。

飞书端使用Codex

完成Codex接入飞书后，在飞书中可通过以下方式使用：

群聊中使用：在飞书群中@机器人，发送自然语言指令（如“帮我写一个Python函数计算斐波那契数列”）。Codex会在绑定的项目目录中执行，结果以流式卡片返回。

话题线程中使用：在群聊中对某条消息开启话题（thread），话题内所有对话构成一条连续的Codex会话。

私聊中使用：私聊机器人，通过交互菜单进行项目绑定、参数设置等操作。

文档评论中使用：在飞书云文档的评论中@机器人，Codex读取评论内容并返回答案。

常见配置参数说明

在Codex接入飞书的配置过程中，以下参数较为关键：

参数 说明 示例值
FEISHU_APP_ID 飞书自建应用App ID cli_xxxxxxxxxx
FEISHU_APP_SECRET 飞书自建应用App Secret xxxxxxxxxxxx
CODEX_IM_DEFAULT_CODEX_MODEL 默认Codex模型 gpt-5.3-codex
CODEX_IM_DEFAULT_CODEX_EFFORT 推理强度 low/medium/high/xhigh
CODEX_IM_DEFAULT_CODEX_ACCESS_MODE 访问模式 default/full-access
CODEX_IM_FEISHU_STREAMING_OUTPUT 是否流式更新 true/false

五、Codex接入飞书方案的横向对比

对比维度 Lark Coding Agent Bridge @rottenapple/codex-im-bot @modelzen/feishu-codex-bridge cc-connect
安装方式 npx一行命令 npm全局安装 npm全局安装 npm全局安装
配置复杂度 低 中 中 中
飞书群=项目 不支持 不支持 支持 支持
话题=会话 支持 支持 支持 不支持
流式卡片 支持 支持 支持 支持
文档评论支持 支持 不支持 支持 不支持
多profile 支持 不支持 不支持 不支持
多平台支持 仅飞书/Lark 仅飞书/Lark 仅飞书/Lark 多平台
加密密钥库 不支持 不支持 AES-256-GCM AES-256-CBC
后台服务 手动 tmux/pm2 内置支持 手动

六、Codex接入飞书的常见问题

问：Codex接入飞书需要公网IP或域名吗？

不需要。当前主流的Codex接入飞书方案均通过WebSocket长连接实现通信，无需公网IP、域名或反向代理。服务完全在内网环境即可运行。

问：Codex本身已经下线了，还能接入飞书吗？

Codex作为独立服务已于2023年底下线，但其CLI工具和核心能力仍然可用。当前Codex接入飞书的实践是通过Codex CLI结合桥接工具实现的，而非调用已下线的Codex服务。用户需要在本机安装并登录Codex CLI。

问：Codex接入飞书后，代码是在本地运行还是在云端运行？

Codex在启动机器本地运行，飞书只负责消息、卡片、文件和审批交互。所有代码执行和文件操作均在本地环境完成，确保代码安全和数据隐私。

问：多个团队可以共用同一个Codex接入飞书的机器人吗？

可以。通过飞书群组权限管理和Codex接入方案中的workspace隔离机制，不同团队可以共用同一个机器人但绑定不同的项目目录。部分方案还支持多profile同时运行。

问：Codex接入飞书后支持哪些编程语言？

Codex本身支持多种主流编程语言。在Codex接入飞书的场景中，语言支持取决于Codex CLI的能力，通常包括Python、JavaScript、TypeScript、Java、Go、Rust、C++等。具体支持范围可参考Codex官方文档。

问：Mac电脑合盖后Codex接入飞书的服务会中断吗？

默认情况下Mac合盖会进入睡眠状态，导致服务中断。解决方案是安装Amphetamine应用，在Preferences中勾选“Allow display to sleep while a session is active”，然后启动一个永久session，即可在合盖情况下保持系统运行。

问：Codex接入飞书的消息交互有延迟吗？

采用WebSocket长连接方案的Codex接入飞书，延迟通常在毫秒级别。cc-connect方案实测连续运行30天无断连重连现象，心跳包间隔精确控制在45秒±200毫秒范围内。

问：如何验证Codex接入飞书是否配置成功？

在飞书机器人私聊中发送/status命令，如果收到正常响应则说明配置成功。也可以在授权的群组中发送测试消息验证消息投递。

问：Codex接入飞书后，可以处理多大的代码仓库？

Codex接入飞书的处理能力取决于本地机器的硬件配置和Codex CLI的上下文窗口限制。建议为每个项目群绑定独立的代码目录，并通过话题线程管理不同的会话上下文。

问：Codex接入飞书是否需要付费？

Codex CLI本身的使用涉及OpenAI API调用费用。桥接工具（如Lark Coding Agent Bridge、cc-connect等）均为开源免费工具。飞书应用本身不额外收费。具体费用取决于Codex的使用量和OpenAI的定价策略。

以上内容不代表本平台立场，仅供读者参考