告别Claude Code终端限制，在飞书群里与Claude Code实时对话，让AI助手直接帮你写代码、查日志、处理文件。

最近，GitHub上的开源项目——feishu-claude-code，完美地解决了这个问题。将飞书（Lark）和Claude Code无缝连接起来，让你可以在熟悉的飞书聊天界面里，远程调用Claude Code的全部能力。

它解决了什么痛点？

想象一下这些场景：

• 你在手机上收到同事发来的紧急问题，需要快速分析一段线上日志。
• 你正在开会，想远程让AI帮你整理一下项目目录结构，或者执行一个简单的脚本。
• 你想把AI编程助手的能力开放给团队的非技术成员，让他们也能通过自然语言操作文件、查询数据。

以往，要实现这些，你可能需要折腾内网穿透、配置复杂的公网访问。而feishu-claude-code另辟蹊径，利用飞书开放平台的长连接能力，让本地服务无需公网IP或域名，就能接收消息并触发Claude Code工作。

它是如何工作的？

整个流程非常直观：

1. 你在飞书（私聊或群聊@机器人）发送一条消息，可以附带文本、图片、文件等。
2. 飞书通过WebSocket长连接，将消息推送到你本地运行的这个服务。
3. 服务解析消息，下载附件（如果有），然后启动一个独立的Claude Code子进程来处理。
4. Claude Code执行你的指令，比如分析代码、读取文件、生成报告。
5. 服务实时捕获Claude的输出，并通过飞书卡片流式地展示给你看，体验接近终端。
6. 如果Claude生成了文件，它还可以通过[[SEND_FILE:路径]]这样的标记，自动将文件上传并发送到飞书对话框里。

核心功能亮点

这个项目不仅仅是简单的消息转发，它实现了很多贴心的功能：

• 无需公网，直连飞书：利用飞书开放平台的长连接，本地服务就能接收消息，省去了配置公网IP和域名的麻烦。
• 多轮对话，会话隔离：支持与Claude Code进行多轮对话，并且可以按群聊或按用户隔离会话，互不干扰。
• 流式输出，体验流畅：通过飞书卡片实时刷新，让你能看到Claude的思考过程和输出结果，避免长时间等待。
• 权限自动批准：针对远程无终端环境，项目提供了bypassPermissions模式，可以自动批准Claude执行文件读写、命令运行等操作（使用时请注意安全限制）。
• 支持文件交互：你可以发送图片、PDF、Excel等文件给机器人，Claude能直接读取并处理。同时，它生成的文件（如报告、图表）也能通过标记语法自动发送回飞书，支持图片、普通文件甚至语音。
• 访问控制与安全：支持配置用户白名单、群聊白名单、@机器人限制等，确保只有授权的人才能使用。还可以限制Claude的工作目录，防止误操作。

快速上手体验

想要体验这个神器，并不复杂，主要分为三步：

1. 配置飞书应用

• 在飞书开放平台创建一个“企业自建应用”。
• 记录下 App ID 和 App Secret。
• 申请必要的权限，特别是 im:resource（用于收发文件），然后配置事件订阅，选择“使用长连接接收事件”，并订阅im.message.receive_v1事件。
• 最后，发布应用。

2. 本地安装与配置

• 在你的服务器或电脑上，确保已安装 Node.js (≥18) 和 Claude Code，并且Claude Code已经登录。
• 克隆项目，安装依赖。
• 复制.env.example为.env，并填入飞书应用的App ID和Secret。
• 根据需要调整工作目录、权限模式、白名单等配置。

3. 启动服务

• 运行 npm start，看到“Feishu WebSocket connected”的日志，就表示连接成功。
• 现在，你就可以在飞书上和你的Claude Code对话了！

使用示例

启动后，在飞书里和机器人聊天：

• 文本对话：私聊直接发消息，或在群里@机器人。

“帮我查看 /home/user/project 目录的结构”

• 处理文件：发送一张截图，并附上指令。

“帮我分析这张图里的代码有什么bug”

• 生成文件：要求Claude分析数据并生成报告，并加上发送文件的标记。

“帮我分析 sales.csv，生成一份 Markdown 报告，并输出”

报告就会以文件消息的形式出现在飞书里。

安全与注意事项

虽然功能强大，但使用时也需要注意安全：

• 严格限制用户白名单：在.env中配置BOT_ALLOWED_USER_IDS，只允许信任的用户操作。
• 限制工作目录：通过CLAUDE_WORKDIR将Claude的文件操作限制在特定目录。
• 谨慎使用bypassPermissions：这个模式会自动批准所有操作，建议配合白名单使用，并避免在公开群聊中开启。

总结

feishu-claude-code是一个极具巧思和实用价值的开源项目。它通过“本地服务+飞书长连接”的模式，巧妙地绕开了公网暴露的难题，将强大的Claude Code从冰冷的终端解放出来，带入到我们日常高频使用的飞书协作环境中。

无论是个人远程开发、团队共享AI能力，还是构建基于自然语言的自动化工具，它都提供了一个非常优雅的起点。如果你正在使用Claude Code，又恰好是飞书用户，强烈推荐你尝试一下这个项目，体验在聊天框里指挥AI编程助手的乐趣。

项目地址：https://github.com/Shaoruisun/feishu-claude-code