一份完整的从零开始教程：在飞书里 @ 一下机器人，就能让本地电脑上的 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 配置就绪 已连接 正在监听消息，按 Ctrl+C 退出这个窗口保持开着不要关，它就是那座"桥"。
第五步：在飞书里找到你的机器人
打开飞书 App（手机或电脑都行）：
- 顶部搜索框直接搜你给机器人起的名字
- 结果里点"机器人"分类
- 进入对话，发一句
你好试试
如果搜不到：回到开发者后台，检查"权限管理 → 可用范围"里有没有加自己。
第六步：开始使用
在对话里可以直接问问题，也能用斜杠命令控制机器人：
| 命令 | 作用 |
|---|---|
/help | 看所有可用命令 |
/status | 看当前工作目录和 Claude Code 状态 |
/cd 路径 | 切换工作目录 |
/new | 开一个新会话 |
/stop | 停止当前正在运行的任务 |
/config | 调消息格式、思考过程显示等 |
试试让它做点事：
- “帮我看看当前目录下有哪些文件”
- “写一个 Python 脚本读取 CSV 并输出前 10 行”
- “帮我把这段代码改成异步的”
让桥接后台常驻
前面第四步启动的窗口一关，桥就断了。想让它一直在后台跑：
先按 Ctrl+C 停掉前台运行，然后：
lark-channel-bridge start这会把桥接注册成系统服务（Windows 是任务计划，Mac 是 launchd，Linux 是 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。
