Lark Channel Bridge 安装指南：让 Claude Code 接入飞书

7天前作者：Covsun & Bob 浏览量：25

Claude Code 很强，但它没有飞书接入能力。lark-channel-bridge 解决的就是这个问题——一个 npm 包，让你在飞书里直接跟 Claude Code 对话。

背景

Claude Code 是 Anthropic 推出的终端版 AI 编程助手，直接在命令行里干活，能力很强。但它有一个短板：没有飞书/即时通讯集成。

你想在手机上给服务器上的 Claude Code 发个指令？不行。它只能老老实实蹲在终端里等你开 SSH。

lark-channel-bridge 就是补这块短板的——一个 Node.js 工具，把飞书消息桥接到本地 Claude Code 进程，让你在飞书上跟 Claude Code 对话，就像跟 Hermes 聊天一样。

整体架构

组件	角色
飞书自建应用	接收/发送消息的入口
lark-channel-bridge	消息中转服务
Claude Code CLI	实际执行指令的 AI 引擎

消息流：飞书 → lark-channel-bridge → claude CLI → 回复 → 飞书

安装步骤（4 步搞定）

① 安装 npm 包

npm install -g lark-channel-bridge@latest

② 存入飞书 App Secret

printf '你的AppSecret' | lark-channel-bridge secrets set --app-id cli_xxxxxxxxxxxxxxxx

③ 配置 config.json

编辑 ~/.lark-channel/config.json，填入你的 App ID 和密钥获取方式：

{
  "accounts": {
    "app": {
      "id": "cli_你的AppID",
      "secret": { "source": "exec", "provider": "bridge", "id": "app-cli_你的AppID" }
    }
  },
  "secrets": {
    "providers": {
      "bridge": {
        "source": "exec",
        "command": "/root/.lark-channel/secrets-getter"
      }
    }
  },
  "preferences": {
    "access": { "admins": ["ou_你的飞书用户ID"] }
  }
}

④ 注册为 systemd 服务（服务器部署）

服务器上没有 DBUS 桌面会话，start 命令会报错。需要手动创建 systemd 服务：

[Unit]
Description=Lark Channel Bridge
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/lark-channel-bridge run
Environment=PATH=/usr/local/bin:/usr/bin:/bin
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

启用并启动：

systemctl daemon-reload
systemctl enable lark-channel-bridge
systemctl start lark-channel-bridge

5 个踩坑记录

#	问题	原因	解决
1	脚本中 secrets set 无法交互	命令默认交互输入	printf 管道传参
2	首次 run 自动创建了新应用	无配置时走创建流程	先手动配好 config.json 再 run
3	start 报 DBUS 错误	服务器无 user session bus	手动创建 systemd service
4	找不到 claude 命令	PATH 不完整	service 中显式设 PATH
5	已有应用被覆盖	新应用 ID 写入了 config	手动改回正确 ID 并删错误 secret

与 Hermes 的对比

如果你已经在用 Hermes Agent，你可能想问：Hermes 不是已经有飞书通道了吗？

是的，但两者定位不同：

维度	Hermes	lark-channel-bridge
飞书应用	Hermes 自己的 App ID	你的独立 App ID
对话方	Hermes Agent 本身	Claude Code CLI
消息处理	Hermes 内置 agent loop	转发给本地 claude 进程
运行方式	hermes-gateway 服务	lark-channel-bridge 服务

两者完全独立，可以在同一台服务器上并行跑。Hermes 负责日常调度，Claude Code 聚焦代码任务，互不干扰。

总结

lark-channel-bridge 是一个小而美的工具，安装简单（4 步），踩坑有解（5 个坑都已摸清），跟 Hermes 能和平共处。如果你需要随时随地从手机给 Claude Code 派活，值得一试。

文章资讯