API快连 apikl.ai
首页 控制台

Codex 接入飞书教程（2026）：读取飞书云文档、手机飞书远程使用 Codex

更新于

想让 Codex 读飞书文档、写周报、查日程，或者出门在外用手机飞书给电脑上的 Codex 派活？这篇讲两种接法：飞书官方的「飞书 CLI」，以及把 Codex 变成飞书机器人的 lark-channel-bridge。两种都用你电脑上已经配好的 Codex，模型走 API 快连按量计费，不需要 ChatGPT 订阅。

📌
一句话答案：要让 Codex 读写飞书文档、表格、日历，装飞书 CLI：npx @larksuite/cli@latest install；要在手机飞书里给 Codex 发消息，装 lark-channel-bridge：npm i -g lark-channel-bridge，再运行 lark-channel-bridge run --agent codex 扫码绑定。
接法能做什么适合谁
方法一：飞书 CLI在 Codex 里直接说「读这篇飞书文档」「把总结写成飞书文档」「看看今天的日程」，Codex 调用飞书 CLI 去做平时在电脑上用 Codex，想让它顺手处理飞书里的文档、表格、日历、消息
方法二：飞书机器人桥接在飞书里私聊机器人，消息转给你电脑上的 Codex 执行，回复以卡片实时发回飞书人不在电脑前，想用手机飞书远程让 Codex 改代码、跑命令

两种可以一起用。注意桥接工具给每个机器人单独保存一份飞书授权，默认以机器人身份操作飞书；要让它读写你个人的文档、日历，需要在机器人那边另外授权（在飞书里发 /status 能看到当前身份）。

准备工作

  • Codex 已经能用：按 Codex 配置教程 把服务商指向 API 快连，终端里运行 codex exec "用一句话介绍你自己" 能收到回复。密钥在 控制台 创建，分组选 GPT 类分组。
  • Node.js：飞书 CLI 用 npx 安装，需要 Node.js；机器人桥接要求 Node.js 20.12 或更高。没装的看 Node.js 环境安装教程。
  • 飞书账号：安装过程会打开浏览器，让你在飞书里创建或选择一个应用并授权。
💡
国内 npm 下载慢，先切换镜像：npm config set registry https://registry.npmmirror.com。

方法一：飞书 CLI，让 Codex 读写飞书

飞书 CLI（larksuite/cli） 是飞书团队维护的开源命令行工具（MIT 协议），覆盖消息、云文档、知识库、多维表格、电子表格、日历、任务、邮件、会议等，并自带二十多个给 AI 用的 Skills。Codex 读到这些 Skills 后，就知道遇到飞书相关的任务该调用哪条命令。

第一步：一条命令安装

BASH
npx @larksuite/cli@latest install

安装向导会依次完成这几件事：

  1. 选择语言（中文 / English）。
  2. 全局安装 lark-cli 命令。
  3. 安装 AI Skills。
  4. 打开浏览器，在飞书里创建或选择一个应用。
  5. 询问「是否允许 AI 访问你个人的消息、文档、日历等飞书数据，并以你的名义执行操作」，同意后在浏览器里完成授权。

装完检查一下授权状态：

BASH
lark-cli auth status

第二步：确认 Codex 能看到飞书 Skills

Codex 读取个人 Skills 的目录是 ~/.agents/skills（Windows 是 C:\Users\你的用户名\.agents\skills），Codex 命令行、桌面版和 VS Code 插件都会读这里。新装的 Skills 一般会被自动识别；没出现的话，彻底退出 Codex 再打开。

在 Codex 命令行里输入 /skills，能看到 lark-doc、lark-calendar 这类名字就说明装好了。如果没有，手动给 Codex 装一次：

BASH
npx skills add larksuite/cli -y -g -a codex

第三步：在 Codex 里直接说

你对 Codex 说它会用到
「读一下这篇飞书文档（贴上文档链接），总结成 5 条要点」云文档（lark-doc）
「把这次改动说明写成一篇飞书文档」云文档（lark-doc）
「看看我今天和明天有哪些日程」日历（lark-calendar）
「在这个多维表格里新增一条记录：……」多维表格（lark-base）
「把这段总结发给张三」消息（lark-im）

读文档时直接把飞书文档链接贴给 Codex 就行。也可以在提示词里点名某个 Skill，例如写上 $lark-doc。Codex 只能看到你的飞书账号有权限的文档。

不用向导，手动安装

BASH
npm install -g @larksuite/clinpx skills add larksuite/cli -y -glark-cli config init --new # 在浏览器里创建或选择飞书应用lark-cli auth login --recommend # 授权常用权限lark-cli auth status

只想开放一部分权限，可以按业务分开授权，例如只开日历和任务：lark-cli auth login --domain calendar,task。

安全提醒

  • 授权后，AI 会以你本人的身份在授权范围内操作飞书。飞书官方也提醒：模型可能理解错、执行出乎意料的操作，或被文档里的恶意内容误导。
  • 只授权用得到的权限；发消息、删除、修改这类操作，让 Codex 先说明要做什么，你确认后再执行。
  • 命令行可以先加 --dry-run 预览，不会真的执行。
  • 飞书官方建议把集成的机器人当私人助手用，不要拉进群里让其他人使用。

方法二：在手机飞书里远程使用 Codex

lark-channel-bridge 是开源的桥接工具（MIT 协议，飞书官网也发布过它的介绍）。它运行在你的电脑上，把你在飞书里发给机器人的消息转给本机的 Codex，再把回复用卡片实时发回飞书。只要电脑开着、桥接程序在运行，你在手机上就能让 Codex 改代码、跑命令、查资料。

第一步：确认本机 Codex 命令行能用

桥接调用的是命令行版 codex。只装了桌面版的话，先按 Codex 配置教程 装好命令行版。在终端测试一下：

BASH
codex exec "用一句话介绍你自己"

能收到回复再往下走。桥接默认沿用你电脑上的 Codex 配置（~/.codex/config.toml），不用再单独配置模型和密钥。

第二步：安装并扫码绑定

BASH
npm i -g lark-channel-bridgelark-channel-bridge run --agent codex
  1. 终端里会显示一个二维码，用手机飞书扫码。
  2. 在飞书里选择已有应用，或新建一个机器人应用（PersonalAgent）。
  3. 配置会写入 ~/.lark-channel/config.json。
  4. 在飞书里给这个机器人私聊发一句「你好」，收到回复就接通了。

用飞书国际版（Lark）的话，在命令后面加 --tenant lark。

第三步：常用指令

在飞书里直接给机器人发这些指令：

指令作用
/cd 项目路径切换到某个项目目录（会开始新会话）
/ws save 名字把当前目录存成常用项目，以后用 /ws use 名字 一键切换
/new清空当前会话，换话题时用，也更省 token
/stop停止正在执行的任务
/status查看当前项目、会话和运行状态
/help查看全部指令

私聊不用 @；在群里要 @机器人 才会回复。默认只有创建应用的人自己能用，要让同事也能私聊它，发 /invite user @同事。

第四步：让它在后台一直运行

前台跑通后按 Ctrl+C 停掉，再交给系统的后台服务（macOS 是 launchd，Windows 是计划任务，Linux 是 systemd），关掉终端也不会断：

BASH
lark-channel-bridge startlark-channel-bridge statuslark-channel-bridge stop

后台模式要求先用 npm i -g 全局安装，用 npx 临时运行的版本不适合常驻。

⚠️
后台模式报 401，或者提示 Missing environment variable: `OPENAI_API_KEY`：我们看了桥接工具的源码，macOS 上的后台服务只传了 PATH，读不到 ~/.zshrc 里设置的 OPENAI_API_KEY。所以终端前台能用、后台却报错。解决办法：把 config.toml 里 env_key 那一行换成 experimental_bearer_token，直接写入密钥，然后运行 lark-channel-bridge restart。Windows、Linux 后台遇到同样的报错也这样处理。
~/.codex/config.toml
model = "gpt-5.6-sol"model_provider = "apikl" [model_providers.apikl]name = "API 快连"base_url = "https://apikl.ai/v1"experimental_bearer_token = "sk-你的密钥"wire_api = "responses"

这样写密钥会以明文保存在本机配置文件里，只在自己的电脑上这么做，不要把这个文件发给别人或提交到代码仓库。

安全设置（一定要看）

  • 默认权限很大：新建的配置默认是 full，对应 Codex 的 danger-full-access，可以读写电脑上任意文件、执行任意命令。只用来写代码的话，建议在 ~/.lark-channel/config.json 对应配置的 permissions 里改成 workspace（只能改工作目录）或 read-only（只读），改完重启桥接。
  • 文档评论也能触发：在支持的飞书文档评论里 @机器人，也会让它运行任务，能在这篇文档里评论的人都可能触发。不要把机器人加到多人协作的敏感文档里。
  • /cd 不是隔离：工作目录只是任务的起点，实际能访问哪些文件取决于上面的权限设置。

费用怎么算

  • 飞书 CLI 和桥接工具本身免费、开源。
  • Codex 每处理一个任务都会调用模型，按 API 快连的实际用量扣费，和在电脑上直接用 Codex 一样，每次请求都能在 控制台「使用记录」里查到。
  • 读长文档、长时间连续对话会消耗更多 token。换话题时发 /new 开新会话，更省钱。
  • 各模型价格看 模型广场。

常见问题

Codex 能连接飞书吗？

能。想让 Codex 操作飞书里的文档、表格、日历、消息，用方法一（飞书 CLI）；想在飞书里给 Codex 发消息、远程派任务，用方法二（机器人桥接）。两种可以一起用。

Codex 能读取飞书云文档吗？

能。装好飞书 CLI 并授权后，把文档链接发给 Codex，让它读取、总结或改写即可。前提是你的飞书账号对这篇文档有查看权限。

飞书机器人没反应怎么办？

先在飞书里发 /status 看状态，再发 /new 开新会话试试。还不行就在电脑终端运行 codex exec "你好"，确认 Codex 本身能用；日志在 ~/.lark-channel/profiles/配置名/logs/。终端能用、后台不行，看上面「后台模式报 401」那一段。

需要 ChatGPT Plus 订阅吗？

不需要。Codex 的服务商指向 API 快连后，按实际用量计费，不需要 ChatGPT 账号和海外信用卡。

Codex 桌面版能用飞书 CLI 吗？

能。飞书 CLI 的 Skills 对 Codex 命令行、桌面版和 VS Code 插件都有效。机器人桥接调用的是命令行版 Codex，桌面版用户需要另外装命令行版（两者共用同一份配置）。桌面版的安装与配置看 Codex 桌面版教程。

Claude Code 也能这样接飞书吗？

能。飞书 CLI 同样支持 Claude Code；桥接工具启动时把 --agent codex 换成 --agent claude 即可。Claude Code 的配置看 Claude Code 配置教程。

→