一、什么是 Claude Code + 飞书协作？

【Claude Code】

Anthropic 官方 AI 编程助手

基于 Claude Sonnet 4.5 模型

支持自定义 Skills 扩展

可直接操作文件和调用 API

【飞书】

字节跳动企业协作平台

强大的文档协作能力

开放的 API 接口

移动端体验出色

【协作价值】

传统方式：代码在本地 → 手动复制 → 粘贴到飞书

智能方式：Claude 分析 → 自动创建文档 → 直接写入飞书

【核心价值】：⭐⭐⭐⭐⭐

✅ 效率提升 10-18 倍

✅ 自动化取代重复劳动

✅ 节省 80-95% 的 Claude Tokens

✅ 端到端智能工作流【效率对比】：

周报生成：从 90 分钟 → 5 分钟

代码审查报告：从 60 分钟 → 5 分钟

Tokens 消耗：节省 80-95%

二、5 步快速搭建（10分钟完成）

【步骤 1】创建飞书应用

⚡ 操作步骤：

1. 访问飞书开放平台

国内：https://open.feishu.cn

国际：https://open.larksuite.com

2. 创建企业自建应用

点击「创建企业自建应用」

应用名称：Claude Code 文档助手

点击「创建」

3. 📋 记录应用凭证（重要！）

App ID：格式如 cli_xxxxxxxxxxxx

App Secret：一长串密钥

⚠️ 安全提醒：App Secret 是敏感信息，请勿泄露

【步骤 2】配置应用权限

⚡ 必需权限（4个）：

✅ docx:document  （说明：查看、编辑和管理文档）

✅ docx:document:readonly  （说明：查看文档（只读））

✅ drive:drive   （说明：访问云空间文件）

✅ contact:user.base:readonly （说明：获取用户基本信息）

⚡ 操作步骤：

1. 进入「权限管理」

2. 搜索并开启以上 4 个权限

3. 点击「创建版本」→「提交审核」

4. 审核通过后，点击「发布版本」

【步骤 3】安装应用

⚡ 操作步骤：

1. 点击「添加应用」

2. 选择要安装的企业/团队

3. 点击「同意并添加」

4. 在飞书工作台中验证应用已启用

【步骤 4】配置 Claude Code

⚡ 创建配置文件：

macOS/Linux:vi ~/.claude/feishu-config.env

Windows:notepad %USERPROFILE%\.claude\feishu-config.env

⚡ 填写配置（复制以下内容）：

FEISHU_APP_ID="你的App_ID"FEISHU_APP_SECRET="你的App_Secret"FEISHU_API_DOMAIN="https://open.feishu.cn"FEISHU_DEFAULT_FOLDER=""

重要提示：

将"你的App_ID"替换为步骤1中记录的 App ID

将"你的App_Secret"替换为步骤1中记录的 App Secret

国内用户使用：https://open.feishu.cn

国际用户使用：https://open.larksuite.com

⚡ 保存文件：vim: 按 ESC，输入 :wq，按回车

记事本: 点击「文件」→「保存」

【步骤 5】测试配置

⚡ 运行测试命令：

python3 ~/.claude/skills/feishu_utils.py

✅ 成功输出示例：

✅ 认证成功!

❌ 如果失败，请检查：

1. 配置文件是否存在

2. App ID 和 Secret 是否正确

3. 网络是否能访问 open.feishu.cn

4. 权限是否已开启并发布

三、实际效果展示

场景 1：智能周报生成

传统方式： 1. 回忆本周工作内容（15分钟）

2. 打开飞书，新建文档（2分钟）

3. 手动编写各项工作（60分钟）

4. 格式调整（10分钟）

5. 发送给领导（2分钟）

总计：约 90 分钟

使用 Claude Code + 飞书：

1. 对 Claude 说："帮我生成本周周报"（10秒）

2. Claude 自动：   - 分析本周代码提交   - 整理完成的任务   - 生成结构化报告   - 创建飞书文档   - 填充内容

3. 你只需审核和发送（3分钟）

总计：约 5 分钟，效率提升 18 倍！

场景 2：代码审查自动化

传统方式： • 审查代码 → 记录问题 → 手动写文档 → 截图 → 整理格式 耗时：30-60分钟

智能方式： • Claude Code 审查代码 → 自动生成报告 → 直接写入飞书 耗时：5分钟（审核即可）

场景 3：知识库自动同步

传统方式： • 本地写 Markdown → 复制 → 粘贴到飞书 → 格式调整 需要重复操作，容易出错

智能方式： • 本地完成文档 → 一行命令同步到飞书知识库 保持版本一致，零错误

四、实用技巧 Tips

【Tip 1】修复 API 400 报错 ⭐⭐⭐⭐⭐

问题现象：❌API调用失败 (400): {"code":1770001,"msg":"invalid param"}

根本原因：

飞书 API 设计限制：

文档根节点只接受纯文本块

不接受标题、列表、代码块等格式化内容

这不是权限问题，而是架构限制

✅ 解决方案：（直接用方案1，完美解决）

方案1：使用优化版工具（推荐）

已内置纯文本模式

自动分批写入

100% 兼容API

【Tip 2】自动添加文档权限 ⭐⭐⭐⭐⭐

问题：应用创建的文档，文件的owner和编辑权限是skill工具，但是你没有编辑权限

✅ 解决方案1：配置自动协作者（推荐）

编辑配置文件：

vi ~/.claude/feishu-config.env

添加以下内容：

FEISHU_AUTO_COLLABORATOR_ID="你的飞书ID"FEISHU_AUTO_COLLABORATOR_TYPE="userid"FEISHU_AUTO_COLLABORATOR_PERM="full_access"

例如：飞书ID：1234abcd （请在飞书设置中查找，是在找不到的可以问飞书助手和客服）

✅ 效果：新创建的文档自动添加你为协作者，拥有完整管理权限

✅ 解决方案2：手动添加权限

添加协作者：

python3 ~/feishu-permission-manager.py add <文档ID> <你的用户ID>

转移所有者：

python3 ~/feishu-permission-manager.py transfer <文档ID> <你的用户ID>

【Tip 3】大幅节省 Claude Tokens ⭐⭐⭐⭐⭐

🎯 核心优势：节省 80-95% 的 Token 消耗！

📊 对比测试（生成3000字周报）：

传统方式：1. Claude 生成内容输出到终端：4000 tokens

2. 调整后再次输出：4000 tokens

3. 对话上下文：2000 tokens

总计：10,000 tokens

飞书 Skill 方式：1. 分析和处理：1000 tokens

2. 创建并写入飞书：250 tokens

3. API调用内容：0 tokens（不占对话）

总计：1,250 tokens

节省比例：87.5%！

💡 核心原理：

1. 内容不经过对话输出：Claude 直接调用 API 写入飞书，不消耗对话 tokens

2. 避免重复传输：修改时只传递增量，不重复输出全文

3. 减少上下文占用：对话中只传递文档 ID，不包含大段内容

📝协作的最佳实践提示词：

❌ 不推荐："帮我生成周报"（内容输出到终端，消耗大量 tokens）

✅ 推荐："帮我生成周报并创建到飞书"（内容直接写入，节省 tokens）

❌ 不推荐：粘贴3000字文档让 Claude 分析

✅ 推荐：先转成飞书文档，

/feishu-read doxcnXXXXXX > doc.txt

，"帮我分析飞书文档"

💰 经济效益：重度用户（每月20份文档）：

• 传统方式：200,000 tokens/月

• 飞书方式：30,000 tokens/月，每月节省：170,000 tokens

关键要点：长文本优先写入飞书，对话中只处理逻辑和决策，既快又省钱！

【Tip 4】安全配置检查

🔐 安全检查清单：

✅ 配置文件权限：

chmod 600 ~/.claude/feishu-config.env

✅ 不要提交到 Git：将 feishu-config.env 添加到 .gitignore

✅ 定期更换密钥：每 3-6 个月更换 App Secret

✅ 权限最小化：只开启必要的 API 权限

五、实战场景

【场景 1】智能周报生成

💬 对话示例：你："请帮我生成本周工作周报并创建到飞书"

Claude："好的！

1. 分析了你本周的 23 次代码提交

2. 创建了飞书文档：周报-2026-W02

3. 已填充本周工作内容

文档链接：https://xxx.feishu.cn/docx/...

⏱️ 时间：5 分钟（vs 传统 90 分钟）

💰 Tokens：节省 85%

【场景 2】代码审查自动化

工作流：1. Claude 审查 Pull Request

2. 发现问题并分析

3. 自动创建审查报告

4. 直接写入飞书并分享团队

⏱️ 时间：5 分钟（vs 传统 60 分钟）

【场景 3】技术文档同步

单个文件同步

/feishu-create "API 接口文档"/feishu-write <文档ID> --file ./docs/api.md

批量同步for file in docs/*.md; do

/feishu-create "$(basename $file .md)"/feishu-write <文档ID> --file "$file"done

价值：本地和云端同步、版本控制 + 团队协作、自动化发布

六、故障排查

【问题 1】认证失败

排查步骤：✅ 检查配置文件是否存在：

ls ~/.claude/feishu-config.env

✅ 检查配置内容：

cat ~/.claude/feishu-config.env

✅ 确认 App ID 和 Secret 正确

✅ 检查没有多余空格或引号

【问题 2】权限不足（403 错误）

排查步骤：✅ 检查应用权限是否已开启（4个必需权限）

✅ 检查应用版本是否已发布

✅ 检查应用是否已安装到企业

✅ 确认你有该文档的编辑权限

✅ 尝试重新安装应用

【问题 3】文档不存在（404 错误）

排查步骤：✅ 确认文档 ID 是否正确

✅ 检查文档是否被删除

✅ 确认应用有权访问该文档

✅ 尝试在浏览器直接打开

【问题 4】网络连接失败

排查步骤：✅ 测试网络：

ping open.feishu.cn

✅ 检查防火墙设置

✅ 检查代理设置

✅ 尝试切换网络

七、核心价值回顾&小结

🎯 核心价值回顾：

✅ 效率提升：10-18 倍

✅ Tokens 节省：80-95%

✅ 自动化：端到端工作流

✅ 协作：AI + 飞书深度融合

🚀 立即开始：

1. 按本文档完成 5 步配置（10分钟）

2. 创建你的第一个智能文档

3. 尝试自动化一个工作场景

💡 进阶探索：

结合 CI/CD 实现自动化报告

开发自定义工作流

集成更多企业工具

📚 更多资源：

飞书开放平台：

https://open.feishu.cn/document/

Claude Code 文档：

https://docs.claude.ai/

API 参考：

https://open.feishu.cn/document/server-docs/docs/

如果本文对你有帮助，更多AI学习知识请关注微信公众号：Rubin智造社

搭建的时候遇到任何问题都可以私聊我哦！

让我们一起拥抱 AI 时代的智能协作！

全文完 | 感谢阅读！