手把手教你搭建 Claude Code + Codex + 飞书 CLI 生态(小白友好版)

  • Claude Code 有 memory、skills、hooks。

  • Codex 有 Goals、sandbox、remote SSH。

通过飞书cli,我们可以通过手机端来串联起claude code和codex

三个东西串起来,飞书不再是聊天软件——它是两个 Agent 共用的持久数据层。

第一步:安装飞书 CLI

先安装飞书 CLI:

npm install -g

@larksuite/cli

lark-cli --version

装 AI Agent Skills,全局装完后,Claude Code 和 Codex 都能用:

npx skills add larksuite/cli -y -g

初始化并授权:

lark-cli config init lark-cli auth login --recommend lark-cli auth status

config init 会弹二维码,用飞书扫码。

企业账号建议选「测试企业」,可以避开管理员审批。 auth login --recommend 会一次打开常用权限。

看到 tokenStatus valid,就说明完成了。

第二步:建生态的「共享层」

两个 Agent 各有一套私有配置:

  • .claude/

  • .codex/

但它们需要共享一套操作飞书的规则,以及一套任务追踪机制。

先建共享目录:

mkdir -p ~/.agent-ecosystem

这个目录里放三个东西。

1. 飞书操作指令集

做一个 feishu-ops.md,两个 Agent 都读。

里面放常用飞书 CLI 命令:

飞书操作指令集

消息

  • 搜聊天记录:

  • lark-cli im +messages-search --query "关键词" --page-size 10 --format pretty

  • 发消息到指定群:

  • lark-cli im +messages-send --chat-id "群ID" --text "内容"

  • 重要操作先用 --dry-run 预览。

文档

  • 建文档:

  • lark-cli docs +create --title "标题" --markdown "内容"

  • 读文档:

  • lark-cli docs +get --doc-id "文档ID" --format markdown

多维表格

  • 查记录:

  • lark-cli base records list --table-id "表格ID" --format table

  • 新增记录:

  • lark-cli base records create --table-id "表格ID" --data '{"fields":{"字段名":"值"}}'

日程与任务

  • 查今日日程:

  • lark-cli calendar +agenda --format pretty

  • 查未完成任务:

  • lark-cli task +list --status incomplete --format pretty

  • 建任务:

  • lark-cli task +create --title "任务名" --due "日期"

邮件

  • 搜未读邮件:

  • lark-cli mail +search --unread --format pretty

  • 发邮件:

  • lark-cli mail +send --to "收件人" --subject "主题" --body "内容"

2. 建任务追踪多维表格

在飞书里手动建一个多维表格,不需要 API 创建。

打开飞书客户端,新建多维表格,字段照这个设:

建好之后,点表格右上角的「更多」→「复制表格 ID」。

把这个 ID 写进 feishu-ops.md 的工具指令里:

任务追踪

  • 查当前任务:

  • lark-cli base records list --table-id "你的表格ID" --format table

  • 新增任务:

  • lark-cli base records create --table-id "你的表格ID" --data '{"fields":{"任务名称":"xxx","Agent":"Claude","状态":"待开始"}}'

  • 更新任务状态:

先查记录拿到 record_id,再执行:

  • lark-cli base records update --table-id "你的表格ID" --record-id "xxx" --data '{"fields":{"状态":"已完成","完成时间":"日期","结果链接":"链接"}}'

3. 建交接文档模板

在飞书里建一个空白文档,标题叫:

Agent 交接记录

里面放一个最简单的结构:

Agent 交接记录

Claude → Codex

[Claude 每次 session 结束,把需要 Codex 执行的任务写在这里]

Codex → Claude

[Codex 每次 Goals 跑完,把执行结果和需要注意的事写在这里]

记下这个文档的 ID,也写进 feishu-ops.md。

第三步:把 Claude Code 接入生态

编辑 CLAUDE.md,加三部分。

Session Start

Session 开始时,让 Claude Code 读取飞书上下文:

  1. 读 ~/.agent-ecosystem/feishu-ops.md 获取飞书操作指令。

  2. 查今日日程:

lark-cli calendar +agenda --format pretty

  1. 查活跃任务:

lark-cli task +list --status incomplete --format pretty

  1. 查 Agent 任务追踪表格当前进展:

lark-cli base records list --table-id "你的表格ID" --format table

  1. 读飞书文档「Agent 交接记录」中 Codex → Claude 段,检查是否有未处理的交接。

  2. 如有需要紧急关注的事项,提醒我。

飞书操作

Session 期间,允许 Claude Code 操作飞书:

你可以通过飞书 CLI 操作飞书。 所有命令参考:

  • ~/.agent-ecosystem/feishu-ops.md

操作前先用 --dry-run 预览。

Session End

Session 结束时,写入交接和追踪:

  1. 如有需要 Codex 执行的任务,写入飞书文档「Agent 交接记录」的 Claude → Codex 段。

  2. 在 Agent 任务追踪表格中新增本次 session 产生的任务,或更新已完成任务的状态。

  3. 本次 session 的重要结论写进飞书文档一份做备份。

第四步:把 Codex 接入生态

编辑 CODEX.md,加对应的三部分。

Session Start

Session 开始时,让 Codex 读取 Claude 留下的上下文:

  1. 读 ~/.agent-ecosystem/feishu-ops.md 获取飞书操作指令。

  2. 读飞书文档「Agent 交接记录」中 Claude → Codex 段,获取待执行任务。

  3. 查 Agent 任务追踪表格,了解当前整体进度。

  4. 如有需要 Claude 确认的事项,通过飞书发消息给我,附带具体问题和当前进度。

Goals 执行期间

Codex 跑 Goals 时,按这个规则通知和记录:

  • 每个 Goals 开始:在 Agent 任务追踪表格中新增一条记录,状态为「进行中」。

  • 遇到阻塞点:通过飞书 CLI 发消息给我,说明阻塞原因和需要我决策的事。

  • 每个 Goals 完成:更新表格状态为「已完成」,写完成时间和结果链接。

Session End

Session 结束时,写回给 Claude 的交接:

  1. 将执行结果和需要注意的事项写入飞书文档「Agent 交接记录」的 Codex → Claude 段。

  2. 更新 Agent 任务追踪表格中本次处理的所有任务状态。

做完之后的三个日常场景

场景一:两个 Agent 通过飞书文档做异步交接

  1. Claude 白天跟你讨论需求、设计方案。

  2. Session 结束时,Claude 自动把「需要 Codex 做的事」写进飞书文档的 Claude → Codex 段——包含具体任务、验收标准、注意事项。

  3. 你晚上离开电脑,Codex 启动,读文档拿到任务,开 Goals 执行。

  4. 跑完之后,它把 diff 链接、测试结果、过程中遇到的问题写进 Codex → Claude 段。

  5. 第二天早上你打开 Claude Code,它自动读了 Codex 昨晚写的交接。知道什么做完了、什么还卡着、什么需要你拍板。

全过程你零手工中转。

场景二:一张多维表格管两个 Agent

  1. 你打开飞书,点进那张任务追踪表格。

  2. 每一行是一个任务,一眼看到哪些是 Claude 在做、哪些是 Codex 在做、哪些完成了、哪些卡住了。

  3. 这不是 AI 产出的黑箱,而是所有任务的一览视图。

  4. 每周回顾的时候,按完成时间筛选,看这周两个 Agent 分别做了什么。

  5. 按状态筛「阻塞」,看哪些任务反复卡在同一类问题上。

这张表格就是你管理 Agent 团队的控制面板。

场景三:每天早上 AI 替你读飞书

  1. 打开 Claude Code,说一句:

  2. 查一下今天的日程安排和未读的重要消息。

  3. 它自动跑:

  4. lark-cli calendar +agenda

  5. 列出会议;

  6. 跑:

  7. lark-cli mail +search --unread

  8. 筛高优邮件摘要;

  9. 再跑任务列表,看哪些今天到期。

三十秒后给你一个汇总。

不是飞书客户端里东点一下西点一下,而是所有关键信息一次拉齐。

最后的架构位置

三个组件各自的位置很清楚:

  • Claude Code 做判断和调度。

  • Codex 做高强度执行。

  • 飞书 CLI 让它们能进入你的真实工作数据。

不需要换工具,也不需要迁移数据。

我们就得到一个移动工作台。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐