Bring the full power of Claude Code into Feishu (Lark) group chats.
A lightweight Node.js bridge that connects Feishu group chats to the local Claude Code CLI via WebSocket. No public server needed — just run it locally.
Feishu User ←→ Feishu Server ←WebSocket→ Bridge (Node.js) ←subprocess→ Claude Code CLI
Just tell your Claude Code:
Help me set up feishu-claude-bridge. Clone https://github.com/Jiahui-Gu/feishu-claude-bridge, run npm install, then guide me through creating a Feishu app and getting the App ID and App Secret.
It will walk you through everything.
Click to expand
git clone https://github.com/Jiahui-Gu/feishu-claude-bridge.git
cd feishu-claude-bridge
npm installGo to Feishu Developer Console and create an app:
- App Capabilities → Enable "Bot"
- Events & Callbacks → Subscription mode: "Long Connection" (WebSocket)
- Events & Callbacks → Add event:
im.message.receive_v1 - Permissions → Enable:
im:message,im:message.group_msg,im:message.p2p_msg:readonly - Publish the app (changes only take effect after publishing)
cp .env.example .env
# Edit .env with your FEISHU_APP_ID and FEISHU_APP_SECRETnpm startOn Windows, double-click start.bat.
Send any message in a Feishu group chat — the bot replies with Claude Code's response.
| Command | Description |
|---|---|
/reset |
Clear session, start fresh |
/status |
View current status |
/help |
Show help |
All optional. Set in .env:
| Variable | Default | Description |
|---|---|---|
CLAUDE_WORK_DIR |
Current dir | Working directory (project context) |
CLAUDE_MAX_CONCURRENT |
3 |
Max concurrent tasks |
CLAUDE_TIMEOUT |
600000 |
Timeout in ms (10 min) |
CLAUDE_MAX_TURNS |
25 |
Max turns per invocation |
ANTHROPIC_VISION_API_KEY |
unset | Optional real Anthropic API key. When set, images are pre-described via the vision API so they bypass any local proxy. Recommended with Agent Maestro or any proxy that may strip multimodal tool_result content. |
ANTHROPIC_VISION_MODEL |
claude-haiku-4-5-20251001 |
Model used for image pre-description. |
MIT