feishu

claude-channel-feishu

基于代码生成，最后更新：2026-04-04

将飞书（Feishu/Lark）机器人消息桥接到 Claude Code 会话的 Channel 插件。

使用飞书 WebSocket 长连接模式，无需公网 IP，无需内网穿透。

---

工作原理

飞书用户发消息
      │
      ▼ WebSocket 长连接推送
本地 Channel Server（MCP subprocess）
      │ notifications/claude/channel
      ▼
Claude Code 会话
      │ reply 工具
      ▼
Channel Server → 飞书 API → 消息发回用户

服务进程实现两个职责：

1. 接收：通过飞书 WebSocket 长连接接收 im.message.receive_v1 事件，将文本消息转为 MCP channel 通知推送给 Claude Code
2. 发送：暴露 reply MCP 工具，Claude Code 调用后通过飞书 HTTP API 发送回复（超 4000 字自动分片）

目录结构

claude-channel-feishu/
├── server.ts              # 主入口，MCP Channel Server（全部逻辑在此文件）
├── package.json
├── .mcp.json              # MCP 配置，告知 Claude Code 如何启动本服务
├── .claude-plugin/
│   └── plugin.json        # 插件元数据
├── skills/
│   ├── setup/SKILL.md     # /feishu:setup — 交互式配置引导
│   └── status/SKILL.md    # /feishu:status — 检查凭据与连通性
└── docs/
    └── OPERATIONS.md      # 配置、凭据管理、飞书控制台设置

快速开始

1. 安装依赖

git clone https://github.com/ya3924143/claude-channel-feishu.git
cd claude-channel-feishu
npm install

2. 配置凭据

见 docs/OPERATIONS.md。

3. 启动

claude --dangerously-load-development-channels server:feishu

成功后 Claude Code 显示：Listening for channel messages from: server:feishu

内置 Skills

命令	说明
/feishu:setup	引导完成飞书控制台配置和凭据写入
/feishu:status	检查凭据、API 连通性、依赖状态

前置要求

要求	说明
Node.js	18+
Claude Code	v2.1.80+，需登录 claude.ai 账号（不支持纯 API Key 模式）
飞书应用	在飞书开放平台创建的企业自建应用

限制

• 仅支持文本消息（图片、文件、语音暂不支持）
• 使用 --dangerously-load-development-channels 标志（开发阶段协议）
• 无访问控制：能向机器人发消息的飞书用户均会被转发到 Claude Code

许可证

Apache 2.0