目录
1 核心目标
让 Claude Code 能够直接操控飞书,实现发消息、管理文档和多维表格等功能。根据具体的使用场景,主要有以下三种接入方案:
1.1 方案一:官方飞书 CLI(推荐)
这是飞书官方开源的命令行工具,通过简单的配置,即可让 AI 代你操作飞书,适合希望 AI 直接接管飞书账号进行自动化办公的场景。
操作步骤:
-
安装飞书 CLI:在 Claude Code 中直接发送指令,让其自动完成安装(包含本体和 19 个 AI Agent Skills):
帮我装一下lark-cli:https://github.com/larksuite/cli/blob/main/README.zh.m -
配置飞书登录:安装完成后,在 Claude Code 中输入
帮我配置飞书CLI登录。根据提示打开链接,扫码或授权创建一个飞书应用并关联账号。 -
重启并使用:配置完成后,务必完全退出并重启 Claude Code。重启后即可直接下达指令,例如:“帮我给通讯录里所有内部联系人发一条聚餐通知”或“读取我的多维表格并生成可视化报告”。
1.2 方案二:cc-connect 中转工具
如果你希望将本地运行的 Claude Code 接入飞书群聊,实现通过手机飞书远程调用终端里的 Claude 能力,可以使用开源工具 cc-connect。
操作步骤:
-
安装 cc-connect:在终端执行
npm install -g cc-connect。 -
绑定飞书应用:在飞书开放平台创建自建应用并获取凭证后,执行绑定命令
cc-connect feishu bind --app <App ID>:<App Secret>。 -
配置 API 代理:如果你的网络环境无法直接访问官方 API,需在环境变量中配置第三方代理地址和密钥(如
ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN)。 -
启动验证:执行
cc-connect start -f,随后在飞书群聊中 @机器人 发送消息即可触发 Claude Code 响应。
1.3 方案三:MCP 协议集成
基于 MCP 协议将飞书作为 Claude Code 的一个“频道”,适合开发者构建复杂的自动化工作流。
操作步骤:
-
环境准备:确保本地安装了 Python 3.10+ 以及飞书命令行工具
lark-cli。 -
飞书应用配置:在飞书开放平台创建应用,开启机器人能力,并在事件订阅中选择“使用长连接接收事件”,添加
im.message.receive_v1事件。 -
注册 MCP 服务:在 Claude Code 项目中注册飞书频道服务,指向对应的 Python 脚本,从而实现双向消息互通。
场景选择建议
-
日常自动化办公:首选方案一,官方支持稳定,能直接通过自然语言指令完成多维表格处理和消息群发。
-
远程调用与群聊互动:选择方案二,适合需要在移动端通过飞书随时唤起本地 Claude 的场景。
-
复杂工作流开发:选择方案三,适合具备开发能力、需要深度定制消息处理逻辑的团队。
2 本文使用
本文使用类似方案2的方法,使用的插件为:
官网地址:
feishu-claude-code-bridge 的核心原理是通过 WebSocket 长连接,将飞书消息实时转发到你本地的 Claude Code CLI 终端。整个过程不需要公网 IP 或服务器,直接在本地运行即可。
下面按最简实操路线讲,照着做就能把本地 Claude Code 和飞书绑定起来。
3 详细步骤
3.1 前置环境准备
在开始前,请确保你的本地电脑已满足以下条件:
-
Node.js ≥ 20:在终端执行
node -v确认版本。 -
Claude Code CLI 已安装并登录:在终端执行
claude确认能正常进入对话界面,且已完成账号登录。 -
网络环境:由于 Claude 服务的地区限制,请确保你的终端已配置好能访问 Anthropic 服务的网络代理。
3.2 安装桥接工具
打开终端,执行以下命令全局安装桥接工具(该工具在终端内显示为 lark-channel-bridge,属于正常现象):
npm i -g lark-channel-bridge
安装完成后,lark-channel-bridge命令即可全局调用。

3.3 首次启动与扫码绑定
-
在终端直接输入以下命令启动桥接服务:
lark-channel-bridge start -
自动扫码向导:首次运行时,程序检测到本地没有配置,会自动在终端渲染一个二维码,并引导你创建飞书应用。
-
飞书 App 扫码:拿出手机,使用飞书 App 扫描终端上的二维码。在手机端按提示选择“创建一个 PersonalAgent(个人智能体)应用”,给它起个名字(如“我的 Claude 助手”),并确认授权。
-

-
自动保存凭证:授权成功后,飞书的 App ID 和 App Secret 等凭据会自动保存到本地文件
~/.lark-channel/config.json中,无需你手动填写任何密钥。
4 开始使用
绑定完成后,你就可以直接在飞书里向 Claude 发号施令了!
-
私聊对话:在飞书中找到刚刚创建的那个 Bot,直接发送消息。Claude 会在你本地电脑执行,并将结果以流式卡片的形式实时回传给你。
-
群聊使用:在群聊中需要 @这个 Bot 它才会响应。
5 常用管理命令
为了方便日常使用,你可以利用以下命令管理后台进程:
-
查看状态:
lark-channel-bridge status(查看守护进程的运行状态和日志路径) -
停止服务:
lark-channel-bridge stop(停止后台守护进程并关闭开机自启) -
重启服务:
lark-channel-bridge restart(重启后台守护进程)

691

被折叠的 条评论
为什么被折叠?



