feishu

claude-code-feishu

Feishu/Lark channel for Claude Code — chat with your AI coding assistant directly from Feishu.

将飞书/Lark 接入 Claude Code，让飞书成为 Claude Code 会话的第二终端。

---

Overview / 概述

This plugin bridges Feishu (and Lark international) with Claude Code sessions using the official Channels protocol. Messages sent to the Bot in Feishu are forwarded to your active Claude Code session, and Claude's replies are sent back to the Feishu conversation.

• Bidirectional: CLI and Feishu can be used simultaneously without blocking each other
• Real-time: Uses WebSocket long connection — no public IP or reverse proxy required
• Secure: Built-in pairing and allowlist access control

---

Architecture / 架构

┌─────────────┐   WebSocket (long connection)   ┌──────────────────┐
│   Feishu /  │◄───────────────────────────────►│                  │
│   Lark      │   REST API (reply/reaction)      │   server.ts      │
│   Open      │◄────────────────────────────────│   (MCP Server)   │
│   Platform  │                                  │                  │
└─────────────┘                                  │  ┌────────────┐  │
                                                 │  │  Feishu    │  │
       ┌──────────────┐      stdio / MCP         │  │  WSClient  │  │
       │ Claude Code  │◄───────────────────────►│  └────────────┘  │
       │   Session    │                           │  ┌────────────┐  │
       └──────────────┘                           │  │ MCP Channel│  │
              ▲                                   │  │  Server    │  │
              │ CLI input                         │  └────────────┘  │
         ┌────┴────┐                              └──────────────────┘
         │Terminal │
         └─────────┘

Inbound (Feishu → Claude Code): Feishu message → WebSocket push → access check → notifications/claude/channel → Claude processes

Outbound (Claude Code → Feishu): Claude calls reply tool → MCP handler → Feishu REST API → message appears in chat

---

Features / 功能

• Send text, images, and files to Claude Code from Feishu
• Receive Claude's replies (with code block formatting) back in Feishu
• Emoji reaction acknowledgement when a message is received
• Pairing-based access control with allowlist management
• Supports both Feishu (China) and Lark (international)
• Automatic message chunking for long responses
• Code blocks rendered as Feishu rich-text (post) with syntax highlighting

---

Quick Start / 快速开始

See GUIDE.md for the complete setup guide (Chinese).

1. Create a Feishu self-built app

Go to open.feishu.cn/app, create a self-built app, and configure:

• Enable Bot capability
• Permissions: im:message, im:message:send_as_bot, im:message.p2p_msg:readonly, im:resource, im:message.reactions:write
• Event subscription: Long connection mode, event im.message.receive_v1
• Publish the app version

2. Install the plugin

/plugin marketplace add TeacherZeng/claude_code_feishu
/plugin install feishu@TeacherZeng/claude_code_feishu

3. Configure credentials

/feishu:configure <app_id> <app_secret>

4. Start the channel

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

5. Pair your Feishu account

Send any message to your Bot in Feishu. The Bot replies with a pairing code. In the CLI:

/feishu:access pair <code>

---

Requirements / 环境要求

Node.js	>= 18
Claude Code	Channels support (research preview)
Feishu account	Enterprise admin or app-creation permission

---

Skills / 内置命令

Command	Description
/feishu:configure <app_id> <app_secret>	Save Feishu credentials
/feishu:access pair <code>	Confirm a pairing code
/feishu:access policy <pairing|allowlist>	Switch access policy
/feishu:access add <open_id>	Manually add a user
/feishu:access remove <open_id>	Remove a user
/feishu:access list	Show current policy and allowlist

---

Environment Variables / 环境变量

Variable	Default	Description
FEISHU_APP_ID	(required)	Feishu App ID (cli_xxx)
FEISHU_APP_SECRET	(required)	Feishu App Secret
FEISHU_DOMAIN	feishu	Set to lark for international
FEISHU_STATE_DIR	~/.claude/channels/feishu	State directory

---

License

MIT — see LICENSE