Agent Feishu Channel
Bridge Claude Code/Codex sessions to a Feishu (Lark) bot
Last verified:
What is Agent Feishu Channel?
Agent Feishu Channel is an open-source TypeScript bridge that connects Claude Code and Codex AI agents to Feishu (Lark) messaging platform. It allows users to interact with Claude Code directly from Feishu chat, turning the AI assistant into a bot within their organization's messaging workspace. The project was renamed from claude-feishu-channel to agent-feishu-channel to reflect its expanded multi-provider support for both Claude and Codex.
Key features include persistent session history that is preserved across runs, real-time streaming of tool invocations with visual status indicators, support for both direct messages and group chats, WebSocket-based communication that doesn't require a public IP, automatic state directory migration with session history preservation, OAuth 2.0 authentication with automatic token refresh, and the ability to manage multiple concurrent Claude Code sessions. The bridge operates in bypassPermissions mode, allowing it to function independently as a complete Claude Code instance with capabilities like Read, Write, Bash Glob, rep, WebSearch, and MCP.
This tool is designed for developers and teams who are heavy Feishu/Lark users and want to access Claude Code's powerful coding assistance directly from their messaging interface. It is particularly useful for users who want to receive AI coding assistance on their mobile device via Feishu, manage product requirements collaboration alongside AI programming workflows, and maintain persistent memory across agent sessions. The project is open-source under the MIT license with approximately 11,000 lines of TypeScript code and 155 test cases.
Agent Feishu Channel pricing
Pricing model: Freemium
Completely free and open-source under MIT license. No paid plans or tiers. The tool is a self-hosted bridge that you install locally using 'npx -y agent-feishu-channel@latest start' or 'npm i -g lark-channel-bridge'. All costs are limited to your own Claude Code API usage and Feishu account (which is free for most organizations). No subscription fees, no hosting costs since it runs locally, and no usage limits imposed by the tool itself.
Agent Feishu Channel pros
- Open-source with MIT license - completely free to use
- Works directly from Feishu chat without terminal access
- Mobile-friendly - use Claude Code on phone via Feishu
- WebSocket-based - no public IP required for Feishu
- Persistent session history preserved across runs
- Real-time streaming cards showing tool invocation status
- Multi-provider support for both Claude and Codex
- Supports both direct messages and group chat
- Interactive cards with button actions and emoji reactions
- Automatic token refresh for OAuth 2.0 authentication
- Message deduplication prevents replay on reconnect
- @mention parsing for group chat responses
- File/image upload and download support
- Send, edit, reply, and quote message capabilities
- Complete Claude Code instance with Read Write Bash WebSearch MCP
- One-liner installation with npx
- 155 test cases ensure reliability
Agent Feishu Channel cons
- Requires Feishu/Lark organization account
- Needs Feishu Developer Console app setup
- User authorization required for OAuth 2.0
- Only works with Feishu/Lark platform
- TypeScript knowledge needed for customization
- Requires local installation via npx or npm
- State stored locally at ~/.agent-feishu-channel/
- Group chat responds only when bot is @mentioned
Frequently asked questions about Agent Feishu Channel
What is Agent Feishu Channel?
Agent Feishu Channel is an open-source bridge that connects Claude Code/Codex AI agents to Feishu (Lark) messaging platform, allowing you to use Claude Code directly from Feishu chat like talking to a colleague. It transforms Claude Code into a Feishu bot that you can interact with on your phone or desktop.
How do I install Agent Feishu Channel?
Installation is a one-liner: run 'npx -y agent-feishu-channel@latest start' or 'npm i -g lark-channel-bridge' then 'lark-channel-bridge run'. On first run, it will prompt you to scan a QR code with Feishu for OAuth 2.0 authorization.
Does it work on mobile?
Yes, one of the main benefits is using Claude Code on your phone via Feishu chat. You can receive AI coding assistance, run code, and see streaming results directly in the Feishu mobile app.
What AI models are supported?
The tool supports both Claude Code (Anthropic's Claude) and Codex AI agents. The project was renamed from claude-feishu-channel to agent-feishu-channel specifically to reflect this multi-provider support.
Do I need a public IP to set this up?
No, the Feishu channel uses WebSocket-based communication which doesn't require a public IP. This makes it easier to set up compared to other platforms that might require port forwarding or tunneling.
How is session history handled?
Session history is automatically preserved. On first run, the old state directory at ~/.claude-feishu-channel/ is auto-renamed to ~/.agent-feishu-channel/ with all session history intact. You can manage multiple concurrent Claude Code sessions.
Can I use it in group chats?
Yes, it supports group chat but the bot only responds when it is @mentioned. This prevents the bot from responding to every message in active group conversations.
What permissions does the Feishu app need?
In the Feishu Developer Console, you need to enable: calendar:calendar (view/manage calendars), calendar:event (manage events), contact:user.base:readonly (read contact info), and bitable:app (access Bitable for todo feature). The bot also needs OAuth 2.0 user authorization.
Is there a cost to use this tool?
The tool itself is completely free and open-source under MIT license. You only pay for your own Claude Code API usage through Anthropic. There are no subscription fees, hosting costs, or usage limits from the bridge itself.
What if I get 'User authorization required' error?
Run the authorization command again: 'feishu-agent auth' or 'lark-channel-bridge start' to re-authorize with Feishu. If you get 'Token expired', run the auth command again to refresh the token. For 'Permission denied', check that all required permissions are enabled in the Feishu Developer Console.