从零到一：Claude Code 接入飞书文档的完整链路

---

第一阶段：为什么需要“创建飞书应用”？

目的：给 Claude Code 一个合法的“身份”去操作飞书。

飞书是一家公司的内部系统，不是谁都能随便改文档的。就像你要进公司大楼，需要一张工牌。

• 你：人类员工，有账号密码，通过可视化界面操作
• Claude Code：AI 程序，没有账号，不能登录飞书界面

所以你需要去飞书开放平台，帮 Claude Code 办一张“机器人工牌”——这就是创建应用。

---

第二阶段：拿到 APP_ID 和 APP_SECRET

目的：这是“工牌的编号和密码”。

创建应用后，飞书给你两个关键信息：

字段	类比	作用
APP_ID	工牌上的编号	告诉飞书“我是谁”
APP_SECRET	工牌的密码	证明“我真的是我”

这两个值要存到 .claude/.env 文件里，供 Skills 后续使用。

---

第三阶段：发布应用，激活权限

目的：让这张工牌真正能用。

刚创建的应用，默认只能在沙箱环境（测试区）活动，无法操作真实数据。就像：

• 你办了工牌，但还没激活 → 刷不开公司大门
• 你需要去行政部“激活” → 这就是发布应用

发布前，你还要在后台勾选权限：

☑️ 读取文档
☑️ 修改文档
☑️ 创建文档

告诉飞书：“这个机器人可以干这些事情。”

只有发布后，APP_ID 和 APP_SECRET 才具备真正的操作权限。

---

第四阶段：创建 Skills，固化流程

目的：教会 Claude Code 怎么用这把钥匙。

拿到钥匙（APP_ID/APP_SECRET）后，Claude Code 还不知道怎么用它。你需要写一份操作手册——这就是 Skills。

Skills 是一个文件夹，里面有一个 SKILL.md 文件，内容大致是：

# skill: feishu-write
## Description
向飞书文档写入内容

## Run
1. 用 APP_ID 和 APP_SECRET 换取临时令牌
2. 用令牌调用飞书 API，读取/修改文档
3. 返回结果给用户

这份手册告诉 Claude：

• 第一步做什么
• 第二步做什么
• 遇到错误怎么办

---

第五阶段：固化流程，变成“一键操作”

目的：把多步操作打包成一个命令。

原始操作（人类手动）：

1. 打开飞书
2. 找到周报文档
3. 复制内容
4. 用 AI 总结
5. 把总结写回飞书

固化后（Claude Code 自动）：

你：/weekly-report
↓
Claude Code 自动完成以上全部步骤

做法：在 Skills 中把多个 API 调用串联起来，形成一个完整的工作流。

---

完整链路图

你
  ↓ 想用 AI 自动操作飞书文档
  ↓
① 去飞书开放平台创建应用
  ↓ 拿到 APP_ID / APP_SECRET（钥匙）
  ↓
② 发布应用，激活权限
  ↓ 钥匙生效，可以操作真实文档
  ↓
③ 在 Claude Code 中写 Skills
  ↓ 教会 AI 怎么用钥匙调用 API
  ↓
④ 固化流程，封装成 /weekly-report 等命令
  ↓
⑤ 以后只需说一句话或敲一个命令
  ↓
⑥ Claude Code 自动完成全部操作

---

一句话总结全流程

创建应用拿钥匙 ➔ 发布激活钥匙 ➔ 写Skills教AI用法 ➔ 固化流程成一键命令 ➔ 以后一句话自动执行全部操作。