手把手教你把 Claude Code 装进飞书

📅 2026/7/5 1:33:28
手把手教你把 Claude Code 装进飞书
一份完整的从零开始教程在飞书里 一下机器人就能让本地电脑上的 Claude Code 帮你写代码、跑命令、看文件。全程不用写代码。这是什么一句话说明让飞书变成 Claude Code 的遥控器。你在飞书里发消息手机或电脑都行消息通过一座桥传到你的电脑电脑上的 Claude Code 干活结果又回到飞书实时更新一张卡片出门在外用手机也能指挥家里那台电脑写代码就是这么用的。最终能实现什么在飞书 App 里跟机器人对话就像跟同事聊天机器人回一张会实时刷新的卡片能看到 Claude Code 的思考过程和结果支持切换工作目录、重置会话、控制权限等常用操作手机、电脑、Pad 全平台可用只要装了飞书需要准备什么一台电脑Windows / Mac / Linux 都行Node.js 版本 20.12.0 或更高飞书账号个人账号即可无需企业管理员权限Claude Code 本地已经装好并能正常使用一个可用的 Claude API 中转站如果你在国内通常需要整体架构一图看懂你飞书 App ↓ 发消息 飞书云 ↓ 事件推送 本地桥接程序lark-channel-bridge ↓ 调起子进程 Claude Code本地 ↓ 走中转站切换器 中转站第三方 API 代理 ↓ 转发请求 大模型 API第一步创建你的飞书机器人目标在飞书开放平台开一个属于你自己的应用拿到两串钥匙App ID 和 App Secret。浏览器打开飞书开放平台登录你的飞书账号进入开发者后台创建一个自建应用填个名字比如叫我的助手随便传个头像创建后进入应用详情页记录下App ID 和 App Secret 两串字符在应用能力里启用机器人能力在权限管理 → 可用范围里把自己加进去不然搜不到自己的机器人提示App ID 和 App Secret 相当于机器人的账号密码不要泄露也不要发到网上。第二步让 Claude Code 走中转站目标让 Claude Code 不直接连官方 API而是通过一个国内可访问的中转站。下载并安装 CC-switch一个专门管理 Claude Code 中转配置的小工具打开 CC-switch添加一个配置填入中转站的接入地址填入中转站给你的 API Key点击切换让这个配置生效打开一个新终端运行claude命令测试一下能正常对话就成功了原理CC-switch 帮你切换 Claude Code 用的 API 地址和密钥。切换后 Claude Code 的每次请求都会走中转站中转站再帮你转发给真正的大模型。第三步安装飞书桥接工具目标装一个叫 lark-channel-bridge 的小工具它负责在飞书和 Claude Code 之间传消息。打开终端敲一条命令npmi-glark-channel-bridge装完验证一下版本lark-channel-bridge-v看到版本号就说明装好了。Windows 用户额外一步解锁脚本执行Windows 默认不让运行 npm 全局脚本需要放开一下只影响当前用户不需要管理员权限打开 PowerShell执行Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned看到提示按 Y 回车即可。Mac 和 Linux 用户跳过这一步。第四步首次启动绑定应用目标让桥接工具认识你在第一步创建的飞书机器人。在终端敲lark-channel-bridge run--agentclaude --app-id 你的AppID--workspace你想让它默认工作的目录回车后会提示你输入 App Secret把第一步记下来的 Secret 粘贴进去。如果一切正常你会看到类似应用凭证校验通过你的机器人名字 配置已保存 lark-cli 配置就绪 已连接 正在监听消息按 CtrlC 退出这个窗口保持开着不要关它就是那座桥。第五步在飞书里找到你的机器人打开飞书 App手机或电脑都行顶部搜索框直接搜你给机器人起的名字结果里点机器人分类进入对话发一句你好试试如果搜不到回到开发者后台检查权限管理 → 可用范围里有没有加自己。第六步开始使用在对话里可以直接问问题也能用斜杠命令控制机器人命令作用/help看所有可用命令/status看当前工作目录和 Claude Code 状态/cd 路径切换工作目录/new开一个新会话/stop停止当前正在运行的任务/config调消息格式、思考过程显示等试试让它做点事“帮我看看当前目录下有哪些文件”“写一个 Python 脚本读取 CSV 并输出前 10 行”“帮我把这段代码改成异步的”让桥接后台常驻前面第四步启动的窗口一关桥就断了。想让它一直在后台跑先按 CtrlC 停掉前台运行然后lark-channel-bridge start这会把桥接注册成系统服务Windows 是任务计划Mac 是 launchdLinux 是 systemd。常用运维命令命令作用lark-channel-bridge status查看服务状态lark-channel-bridge stop停止后台服务lark-channel-bridge restart重启后台服务完整数据流发一条消息背后发生了什么手指在飞书里点发送消息上传到飞书云飞书云给你电脑上的桥接工具推事件桥接工具把消息喂给本地的 Claude Code 进程Claude Code 要调用大模型时请求先到 CC-switch 配置好的中转站中转站转发到真正的大模型 API大模型的回复原路返回桥接工具把结果实时写进飞书的一张卡片你在飞书里看到卡片一段段刷新出内容常见问题问飞书里搜不到机器人去开发者后台的权限管理 → 可用范围把自己加进去。问发消息了没有回复先看桥接窗口有没有新日志。没有日志说明飞书云没推事件过来检查机器人事件订阅有没有配好。问机器人回复API 调用失败之类这是 Claude Code 到中转站那一段出问题。用 CC-switch 检查配置或者直接在终端跑claude看看能不能对话。问换电脑了怎么办新电脑上重新走一遍第二到第四步就行App ID 和 App Secret 是通用的。一些安全提醒App Secret 相当于机器人的密码别贴到公开的地方中转站的 API Key 同理桥接工具默认把配置存在你的用户目录下注意别把整个用户目录截图发人机器人有你电脑的操作权限如果给别人用要谨慎可以用/invite限制访问范围写在最后整套配置花不了半小时。装好之后通勤路上、开会摸鱼、晚上躺床上都可以随手让家里的电脑帮你干活。真正做到电脑不睡程序员睡。有兴趣的可以自己搜关键词Claude Code、飞书机器人、lark-channel-bridge、CC-switch。