我们团队的沟通基本都在飞书上,平时最常用的桌面开发环境是 Windows,主力 AI 编程工具是 Claude Code。项目越来越多之后,我发现自己有一个逃不掉的需求:人不在电脑前的时候,也想让 Claude Code 继续帮我处理代码——比如群里发来的 bug 反馈、测试报告、临时需求,总不能每次都先跑回工位,把命令粘贴到终端里跑一遍。折腾了几套方案之后,我最终用 MetaBot 在 Windows 上把飞书和 Claude Code 串了起来,实现的效果是:在飞书群里直接 @ 机器人,它就能调用我这台 Windows 机器上的 Claude Code 干活,然后把结果贴回群里。整个过程我用了大半个月,从安装、配置到踩坑基本都摸过一遍。这篇文章就是把 Windows 版的完整实战过程整理出来,包括链路原理、配置细节、真实跑通示例和排错清单,适合想在飞书里接入 Claude Code、又必须在 Windows 上运行的开发者参考。
1. 为什么我会选择在 Windows 上保留 Claude Code,还把它接进飞书
1.1 一个很具体的痛点:代码在本地,人不在电脑前
我手头的项目大部分跑在本地 Windows 开发机上,不是我不愿意用云服务器,而是很多工作依赖本地环境:项目缓存、未提交的代码分支、开发工具链、测试数据库,甚至公司内网的某些资源,都只在办公电脑上能访问。Claude Code 这类终端 Agent 被设计成“在项目目录里工作”的模式,它要读代码、跑命令、多轮修改文件,所以直接跑在本地项目目录里效率最高,而不是放在遥远的服务器上去挂载目录。
痛点发生在通勤、开会、午休这种场景。别人在飞书群里问我“这个 bug 你方便看一眼吗”,我只能说“回电脑前我看”。偶尔家里有急事远程连一次办公电脑,体验也一般:远程桌面软件要解锁屏幕、找终端、重新粘贴命令,网络波动时画面卡顿,消息来回也很慢。后来我意识到,我需要的不是“远程控制电脑”,而是“一个挂在飞书里的入口,它背后就是 Claude Code”。
1.2 为什么不是远程桌面,或者直接在飞书里调模型 API
先说远程桌面这类方案。它解决的问题是把整个桌面搬到手机或另一台电脑上,听起来很完整,实际用起来很笨重。首先要保持两台设备屏幕状态同步,其次 Windows 锁屏、休眠、网络策略都可能中断连接,更不用说从手机上的小屏幕去操作终端,体验非常痛苦。它适合“偶尔远程处理一次故障”,不适合“高频、轻量、会话式地让 AI 干活”。
再说直接调用 API 自研机器人。技术上,飞书开放平台确实支持自建应用,接上 Anthropic API 就能做一个简单的问答机器人,但离“能干活”还很远。一个真正能帮我处理代码的机器人,需要读懂项目结构、定位问题、生成代码、执行测试,还要一轮轮跟踪上下文。这些东西如果从零开发,等于把 Claude Code 重新实现一遍。我当时的判断是:要把 Claude Code 的能力暴露到飞书里,最好的方式不是绕开它,而是给它加一个“远程消息接口”。
1.3 这套链路适合谁,边界在哪里
如果你符合下面几种情况,这套方案大概率对你有用:
- 主力开发机是 Windows,电脑具备常开条件;
- 已经在用 Claude Code 写代码,希望增加手机/飞书端入口;
- 团队或客户在飞书上沟通,需要把 AI 能力接入现有协作流;
- 你更希望 Claude Code 在本地读取真实项目,而不是复制代码片段到网页。
也有不适合的场景要提前说清。飞书里跑的是“文字交互版”Claude Code,它不会把你的 IDE 界面搬进飞书,也不会自动推送整个工程给你。它更适合发指令、看结果、提交代码审查、生成文档、跑一轮测试这类任务。对“实时盯着文件变化然后改代码”这种交互,还是得老老实实坐在电脑前。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. MetaBot 在整个链路里具体管哪几件事:一次请求的四跳
2.1 MetaBot 不是大模型服务,它是“胶水层”
MetaBot 的角色就像是飞书和 Claude Code 之间的消息调度员。它不负责推理,也不生成代码,真正的执行者是 Claude Code CLI。MetaBot 做的核心事情是:接收飞书消息,解析成任务,按配置找到对应的工作目录,调用 Claude Code 执行,再把输出整理回传给飞书用户。理解这一点很重要,因为你在排查问题时,每一步失败都能快速定位是飞书的问题、MetaBot 的问题、还是 Claude Code 本身的问题。
我一开始也想自己写一个这样的小程序,但越看越发现没必要。飞书开放平台的鉴权、事件订阅、长连接重连、消息格式转换,这些代码虽然不难,但都很琐碎,自己写一遍要耗费大量时间,之后还要持续维护。MetaBot 属于把这块通用能力封装好的开源机器人网关,我只需要把“飞书应用凭证”和“要执行的命令”告诉它即可。
2.2 一条消息从飞书群到 Claude Code,再到返回结果
去掉技术细节,完整链路可以拆成四跳。
第一跳,用户在飞书群里 @ 机器人,或者在单聊里直
