Oh My Feishu

oh-my-feishu

The best way to use Claude Code on Feishu.

在飞书里使用 Claude Code 的最佳方式

开始使用 · 你可以做什么 · 声明 · 感谢

开始使用

开始之前，请先安装并配置好：

• Claude Code：确保终端里可以运行 claude --version

Claude Code 负责对话和执行任务。oh-my-feishu 会随包提供 lark-cli 和 PM2，并在 CLI 中引导你完成飞书绑定和授权。

Showcase 部署

Showcase 站点托管在 Vercel，源码位于 showcase/。Vercel 项目应使用仓库根目录，并由根目录的 vercel.json 指定构建：

• Framework Preset: Astro
• Install Command: npm ci --prefix showcase
• Build Command: npm run build --prefix showcase && rm -rf .vercel/output && mkdir -p .vercel && cp -R showcase/.vercel/output .vercel/output
• Output Directory: 留空，使用 Astro Vercel adapter 生成的 .vercel/output

不要选择 Vite，也不要把 Root Directory 改成 showcase。GitHub Pages workflow 已移除，旧 Pages 地址不会继续更新。

文档管理

公开文档只放在 showcase/src/content/docs/，这些 Markdown 会自动进入网站 /docs/ 和文档搜索接口。

根目录 docs/ 是本地私有草稿区，用于周报、临时方案和内部记录，不会被 GitHub 或网站公开。提交前可以运行：

npm run check:private-docs

全局安装（推荐）

npm install -g oh-my-feishu

然后启动交互式配置：

oh-my-feishu

从源码安装

如果你想参与开发或使用最新功能：

git clone https://github.com/yjzhang2003/oh-my-feishu.git
cd oh-my-feishu

npm install
npm run build
npm link

你可以做什么

开始使用

在终端输入

oh-my-feishu

CLI 会带你完成检查、扫码和服务启动。你不需要记住复杂步骤，只需要跟随界面操作。

推荐顺序：

1. 在 Feishu 配置页选择 Bind App with QR Code，扫码绑定应用凭证。
2. 选择 Login lark-cli Auth，按提示完成 lark-cli auth login --recommend。
3. 回到 Service 配置页启动后台服务。

用菜单管理工作上下文

输入 /menu 开启你的 oh-my-feishu 之旅。

通过 /menu 切换直接对话、目录会话和历史会话。普通问答可以直接聊；需要处理某个项目时，绑定到对应本地目录。

在飞书里和 Claude Code 对话

不用切回终端，直接在飞书里问问题、讨论代码、查看 Claude Code 的完整回复。

继续一段 Claude code 会话

如果你走在路上突然有些灵感，想接着你在电脑上的工作继续对话，我们支持在你电脑的任意目录新建会话，或者是继续你之前在电脑上的任意Claude code会话。

使用自动化服务

自动化服务会在后台监听事件，只在处理完成后把最终结果发回飞书。当前已经支持 Web 服务监控：注册服务的 traceback 地址后，日志变化会触发 Claude Code 在对应仓库目录里静默分析和修复。

你可以通过三种方式管理 Web 服务监控：

• 在飞书 /menu 中打开“自动化技能”，使用卡片创建、查看和删除监控服务。

• 在 workspace Claude Code 中用自然语言让它调用 Web Monitor 服务管理能力。

• 在终端中使用 oh-my-feishu web-monitor 管理服务配置。

让 Claude Code 帮你使用飞书

oh-my-feishu集成了完整的 lark-cli 技能， Claude Code 知道自己正在通过飞书与用户对话。普通问答直接回答；如果用户请求飞书操作，它会按需读取飞书技能。

只给 Claude Code 加上飞书能力

如果你只是想让你的 Claude Code 项目获得飞书操作能力，可以直接安装我们的 oh-my-feishu plugin：

claude plugin marketplace add https://github.com/yjzhang2003/oh-my-feishu
claude plugin install oh-my-feishu@oh-my-feishu-marketplace --scope project

声明

本项目仍处于开发阶段，已经可以使用，但功能和体验还没有完全完善。如果你有想法、问题或建议，欢迎提 issue，或者直接联系我：zhangyj2003@foxmail.com。

另外请注意：本项目中 Claude Code 默认运行在 skip permission 的使用方式下。请确认你理解相关风险，并只在可信环境中使用。

感谢

感谢飞书官方的 larksuite/cli，oh-my-feishu 的飞书能力建立在 lark-cli 生态之上。

感谢 Ink，我们使用 Ink 构建了交互式 CLI。

License

MIT