Codex × 飞书 CLI:一句话处理飞书数据
Codex × 飞书 CLI:一句话处理飞书数据
2026 年 3 月底,飞书正式开源了 飞书 CLI。
如果你的团队或个人经常使用飞书,那么接入飞书 CLI 之后,你就拥有了一种全新的使用方式——在 Codex 里一句话处理飞书里的所有信息和数据。
本篇介绍如何把 Codex 和飞书 CLI 结合,直接通过自然语言操作飞书中存储的数据和内容。
在半桶水课程里,它对应的是“办公交付 / 团队协作 / 资料整理”的工作流:把飞书里的文档、表格、云盘资料变成可复核的纪要、清单、报告或素材包。
这节解决什么
很多团队资料都散在飞书里:文档、表格、云盘、会议记录、任务信息。手动整理容易漏、慢,也很难重复。
这节练的是:让 Codex 通过飞书 CLI 读取和整理团队资料,但必须把权限、凭证和输出验收说清楚。
工作流卡
| 项目 | 内容 |
|---|---|
| 输入 | 飞书 CLI、开放平台应用、授权范围、目标文档/表格/文件夹 |
| Codex 负责 | 阅读 README、安装 CLI、引导授权、整理数据、生成交付物 |
| 人类判断 | 哪些空间能授权、哪些资料不能读、输出能否给团队使用 |
| 输出 | 纪要、清单、表格、报告、信息图脚本或资料摘要 |
| 验收 | 来源可追溯、权限可解释、结果能复核、敏感信息不外泄 |
适合谁
这一节适合:
- 团队日常资料主要放在飞书的人。
- 需要定期整理会议、文档、云盘资料或多维表格的人。
- 想把“复制粘贴整理资料”变成可复用流程的人。
如果你还不清楚飞书开放平台、应用权限和 App Secret 的含义,不要直接拿真实团队空间练习。先用测试空间或示例数据跑通。
1. 安装飞书 CLI
把飞书 CLI 的 GitHub README 链接丢给 Codex,让它帮你完成所有安装:
帮我装一下所有的东西:https://github.com/larksuite/cli/blob/main/README.zh.md
2. 提供飞书应用凭证
使用飞书 CLI 需要提供飞书开放平台应用凭证(App ID 和 App Secret)。
不用担心不知道怎么获取——直接问 Codex,它会告诉你飞书开放平台的地址,并引导你在浏览器里创建应用。

打开链接,创建应用:

按照它的指引创建应用之后,让 Codex 说明需要哪些权限、这些权限会读取或操作什么数据,再决定是否继续。
App ID 可以作为配置项使用;App Secret 属于敏感凭证,不建议直接写进公开文档、截图或仓库。更稳妥的做法是使用本机环境变量、系统凭据管理,或只在一次性安全会话中输入,并在完成后检查有没有被写入可见文件。

过程中会涉及手动授权操作。Codex 会提供跳转链接,点击在浏览器里放行对应权限即可,这样它才能读取和操作你的飞书数据。

3. 开始使用
配置完成后,Codex 就具备了非常丰富的飞书操作能力。让它列举一下可以访问的内容:

Codex 还会贴心地告诉你第一次应该怎么用,连提示词都帮你准备好了。

实战演示: 我让它读取飞书云盘里一个关于"知识管理"的文件夹(共 14 篇文档),读取完成后直接调用 GPT 最新的生图模型,生成一张中文信息图。
从处理过程中可以看到,它确实能够完整读取云盘内容,访问是正常的。
执行到生图步骤时,它要求我提供 OpenAI 的 API Key:

这其实是不合理的。订阅 Codex 和 ChatGPT Plus 之后,在 Codex 里可以直接调用 GPT 生图模型,完全不需要单独提供 API Key。 这时候直接反驳它就好了。
反驳之后,它就会正确调用 GPT-Image-2 生成信息图,无需任何额外的 API Key。

你要重点检查什么
- Codex 是否说明了飞书应用需要哪些权限。
- App Secret 是否没有出现在公开仓库、截图或教程正文里。
- 读取的文档、表格、文件夹是否在你允许的范围内。
- 输出是否标明来源,方便回到飞书原文复核。
- 如果 Codex 要额外 API Key,是否真的必要,还是它误判了可用能力。
验收标准
完成这个案例后,至少确认:
- 飞书 CLI 可以正常登录或完成授权。
- Codex 能列出它可访问的范围,而不是模糊地说“都可以”。
- 产出的纪要、清单、报告或图文脚本有来源对应关系。
- 敏感凭证没有被写入仓库、聊天截图或公开文档。
- 这套流程能复用到下一次会议、表格或资料整理任务。
复用方式
可以保存成这个任务模板:
请通过飞书 CLI 整理以下资料。
目标空间或链接:
要读取的范围:
禁止读取的范围:
输出格式:
需要保留的来源:
验收标准:
执行前请先说明你需要哪些飞书权限,以及这些权限会访问什么数据。参考来源
本文操作思路参考了「数字生命卡斯克」公众号的以下两篇文章,感谢原作者的分享:
📝 飞书 CLI 开源发布介绍(本文主要参考)
来源:微信公众号「数字生命卡斯克」
链接:https://mp.weixin.qq.com/s/fvjxT_GgbEgxgsPCUlo-RQ📝 团队如何用飞书 CLI 完成协作任务(扩展阅读)
来源:微信公众号「数字生命卡斯克」
链接:https://mp.weixin.qq.com/s/6vqkEvFYNEtUu3rTQAllzw
本文截图均为作者本人实际操作所得,文字内容在参考基础上进行了重新整理与二次创作。如有侵权,请联系删除。