首页/资讯中心/详情

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

手把手教你把 Claude Code 装进飞书
📅 发布时间：2026/7/5 1:50:09

一份完整的从零开始教程：在飞书里 @ 一下机器人，就能让本地电脑上的 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）。

  1. 浏览器打开飞书开放平台，登录你的飞书账号
  2. 进入"开发者后台"，创建一个"自建应用"
  3. 填个名字（比如叫"我的助手"），随便传个头像
  4. 创建后进入应用详情页，记录下App ID 和 App Secret 两串字符
  5. 在"应用能力"里，启用"机器人"能力
  6. 在"权限管理 → 可用范围"里，把自己加进去（不然搜不到自己的机器人）

提示：App ID 和 App Secret 相当于机器人的账号密码，不要泄露，也不要发到网上。

第二步：让 Claude Code 走中转站

目标：让 Claude Code 不直接连官方 API，而是通过一个国内可访问的中转站。

  1. 下载并安装 CC-switch（一个专门管理 Claude Code 中转配置的小工具）
  2. 打开 CC-switch，添加一个"配置"：
    • 填入中转站的接入地址
    • 填入中转站给你的 API Key
  3. 点击"切换"，让这个配置生效
  4. 打开一个新终端，运行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（手机或电脑都行）：

  1. 顶部搜索框直接搜你给机器人起的名字
  2. 结果里点"机器人"分类
  3. 进入对话，发一句你好试试

如果搜不到：回到开发者后台，检查"权限管理 → 可用范围"里有没有加自己。

第六步：开始使用

在对话里可以直接问问题，也能用斜杠命令控制机器人：

命令作用
/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重启后台服务

完整数据流

发一条消息，背后发生了什么：

  1. 手指在飞书里点发送
  2. 消息上传到飞书云
  3. 飞书云给你电脑上的桥接工具推事件
  4. 桥接工具把消息喂给本地的 Claude Code 进程
  5. Claude Code 要调用大模型时，请求先到 CC-switch 配置好的中转站
  6. 中转站转发到真正的大模型 API
  7. 大模型的回复原路返回，桥接工具把结果实时写进飞书的一张卡片
  8. 你在飞书里看到卡片一段段刷新出内容

常见问题

问：飞书里搜不到机器人？
去开发者后台的"权限管理 → 可用范围"，把自己加进去。

问：发消息了没有回复？
先看桥接窗口有没有新日志。没有日志说明飞书云没推事件过来，检查机器人事件订阅有没有配好。

问：机器人回复"API 调用失败"之类？
这是 Claude Code 到中转站那一段出问题。用 CC-switch 检查配置，或者直接在终端跑claude看看能不能对话。

问：换电脑了怎么办？
新电脑上重新走一遍第二到第四步就行，App ID 和 App Secret 是通用的。

一些安全提醒

  • App Secret 相当于机器人的密码，别贴到公开的地方
  • 中转站的 API Key 同理
  • 桥接工具默认把配置存在你的用户目录下，注意别把整个用户目录截图发人
  • 机器人有你电脑的操作权限，如果给别人用要谨慎，可以用/invite限制访问范围

写在最后

整套配置花不了半小时。装好之后，通勤路上、开会摸鱼、晚上躺床上，都可以随手让家里的电脑帮你干活。真正做到"电脑不睡，程序员睡"。

有兴趣的可以自己搜关键词：Claude Code、飞书机器人、lark-channel-bridge、CC-switch。