Mac 上 Codex 安装飞书 Cli 教程

这篇内容不是一份需要逐条复制命令的安装手册，而是我在 M1 芯片的 Mac 电脑上完成的一次真实实操记录。

我想验证的是：能不能直接把飞书官方教程交给 Codex，让它完成飞书 CLI 的安装和配置，最后真正读取我的飞书文档，并创建一篇新的飞书云文档。

飞书和 Lark 是什么关系？

飞书和 Lark 属于同一套产品体系。飞书主要面向中国市场，Lark 是面向海外市场使用的品牌。

两者的核心能力相近，但使用不同的服务环境：飞书开放平台使用 open.feishu.cn，Lark 开放平台使用 open.larksuite.com。官方命令行工具沿用了 Lark 的英文名称，所以即使连接的是飞书国内版，安装后的命令仍然叫 lark-cli。

本次实操使用的是飞书国内版账号和飞书开放平台。

一、我这次想实现什么？

这次实操的目标很明确：

1. 让 Codex 帮我安装飞书 CLI。
2. 让 Codex 获得经过我授权的飞书访问能力。
3. 实际读取我的飞书文档和文件夹。
4. 实际创建一篇新的飞书云文档。

只有“读取”和“创建”两个真实任务都能完成，才能说明安装真正跑通，而不只是终端显示安装成功。

二、我是怎么开始的？

开始前，我已经在 M1 Mac 上安装并配置好了 Codex。

我没有自己查命令，也没有手动研究飞书开放平台，而是直接把官方安装教程交给 Codex：

帮我安装飞书 CLI：https://open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide

这就是我在安装阶段输入的核心指令。

我的操作只有三类：

• 把目标和飞书官方教程交给 Codex。
• 在飞书页面中确认必要的用户授权。
• 安装后提出真实任务，检查 Codex 是否真的完成。

环境检查、CLI 安装、应用配置、官方 Skills 安装和状态验证，都由 Codex 自动处理。

三、实操过程中发生了什么？

1. Codex 自动执行安装，并让我确认授权

Codex 读取官方教程后，开始检查环境、安装飞书 CLI、配置飞书应用，并发起用户授权。

浏览器打开飞书授权页面后，我检查了应用名称和权限范围，然后点击 Add and Authorize。

这一环节是整个安装过程中最重要的人工操作。Codex 可以完成技术配置，但是否允许应用访问飞书数据，必须由用户本人确认。

2. Codex 返回安装完成结果

授权完成后，Codex 继续安装飞书官方 Skills，并验证应用身份、用户身份和 Token 状态。

最终，Codex 返回了完整的安装结果：

从结果中可以确认：

• 飞书 CLI 已经安装。
• 本次安装版本为 1.0.69。
• 飞书应用身份可用。
• 飞书用户身份可用，Token 状态正常。
• 27 个飞书官方 Skills 已安装。
• 授权状态验证通过。

到这里，安装阶段已经完成。但我还没有把“安装成功”当作最终结果，因为工具能不能真正完成任务，还需要实际测试。

3. 第一次测试：查看我的飞书文档

我直接对 Codex 说：

查看我的飞书文档

第一次查询时，Codex 发现还缺少飞书文档的只读搜索权限 search:docs:read，于是生成了新的授权链接和二维码。

我打开链接完成授权，然后回到 Codex 回复：

已授权

Codex 随即完成本地令牌交换，并重新读取我的飞书云空间。

这里出现的二维码是一次性的临时授权入口，截图只用于展示当时的实操过程。

4. 授权后，成功读取文档和文件夹

授权成功后，Codex 按最近编辑时间返回了我拥有的飞书云空间内容：

本次共读取到：

• 2 篇飞书文档。
• 7 个飞书文件夹。
• 合计 9 项内容。
• 没有下一页。

这说明文档搜索权限、用户身份、本地令牌和飞书云空间连接已经全部生效。

5. 第二次测试：创建一篇飞书云文档

能够读取内容之后，我继续提出一个写入任务：

使用 Lark Client 帮我创建一个云文档，介绍飞书 Client 的能力，以及基于你对我的了解，我可以先使用哪些功能。

Codex 成功创建了《飞书 Client 能力地图与锋哥的优先使用建议》，并返回了可以直接打开的飞书文档链接。

这一步证明 Codex 不仅能够查看飞书中的内容，也能够根据我的自然语言要求创建和写入飞书云文档。

四、最终实现了什么？

经过安装、授权和两次实际测试，我最终实现了：

• 在 M1 Mac 上安装并配置飞书 CLI。
• 让 Codex 获得飞书应用身份和用户身份。
• 安装 27 个飞书官方 Skills。
• 通过自然语言查看自己的飞书文档和文件夹。
• 通过自然语言创建一篇新的飞书云文档。
• 跑通“提出目标 → Codex 执行 → 用户授权 → 实际验证 → 交付结果”的完整闭环。

最终达到的目的，不是“电脑里多安装了一个命令行工具”，而是让 Codex 真正具备了连接和操作我个人飞书空间的能力。

五、这次实操给我的结论

这次实践中，具体安装命令并不是最重要的。真正重要的是下面这条流程：

明确自己要实现什么→ 把官方教程交给 Codex→ 让 Codex 完成中间执行→ 用户确认必要授权→ 用真实任务进行测试→ 检查是否产生了可用结果

过去学习一个新工具，往往要先研究大量文档和命令。这次我采用的是另一种方式：我负责明确目标、提供可信资料和验收结果，Codex 负责完成中间操作。

只有当它真正读取了我的文档、列出了我的文件夹，并创建了一篇新的云文档时，这次实操才算真正完成。

参考资料

• 飞书 CLI 官方安装指南
• 飞书官网：Lark 是飞书的海外市场品牌名称
• 飞书开放平台：飞书与 Lark 使用不同的开放平台域名