Message Bridge
Bridge Claude conversations to Telegram, Discord, Feishu / Lark, and QQ.
Message Bridge
The Message Bridge lets you chat with Claude from instant messaging apps on your phone. Start CodePilot on your desktop, configure a Bot, and you can interact with Claude anytime through Telegram, Discord, Feishu / Lark, or QQ.
Supported Platforms
| Platform | Highlights |
|---|---|
| Telegram | Long-polling mode, streaming preview, permission buttons, rich Markdown rendering |
| Discord | WebSocket mode, streaming preview, channel and DM dual-mode |
| Feishu / Lark | WebSocket mode, domestic / international edition switching, group policy control |
| REST API mode, image sending, DM bridging |
How It Works
Phone IM → Bot receives message → CodePilot forwards to Claude → Claude replies → Bot sends reply back to IM- You send a message to the Bot in your messaging platform
- CodePilot's Bridge service receives the message and forwards it to Claude
- Claude processes the request and generates a reply
- The reply is sent back to your messaging platform via the Bot
- If Claude needs permission confirmation (e.g. writing a file), it sends a confirmation button in the IM
Basic Setup
Enable the Bridge
- Click Bridge in the sidebar
- On the Bridge overview page, turn on the Bridge master switch
- Enable the channels you need (Telegram / Discord / Feishu / QQ)
- Go to each channel's page to configure Bot credentials
- Click Start
Bridge Global Settings
On the Bridge overview page you can configure:
- Default working directory — Default project path for new conversations
- Default model — Model used for bridge conversations
- Default provider — API provider used for bridge conversations
- Auto-start — Automatically start the bridge service when CodePilot launches
Bridge Status
The Bridge page shows real-time status:
- Master service status (Connected / Disconnected)
- Status of each channel adapter
- Number of active session bindings
- Time of the last message
Slash Commands
You can use slash commands in the IM to control CodePilot:
| Command | Arguments | Description |
|---|---|---|
/new | [path] | Start a new conversation, optionally specifying a working directory |
/bind | <session-id> | Bind the current IM chat to an existing CodePilot conversation |
/cwd | /path/to/dir | Switch the working directory for the current conversation |
/mode | plan|code|ask | Switch conversation mode |
/status | — | View current conversation status (ID, working directory, mode, model) |
/sessions | — | List recent conversations for the current channel (up to 10) |
/stop | — | Abort the currently running task |
/help | — | View available commands |
Usage Tips
- Keep CodePilot running — The bridge relies on the desktop app as a relay; the Bot cannot respond if CodePilot is closed
- System tray mode — Minimize to the system tray so the bridge stays active without taking up desktop space
- Prefer DMs — Using DMs is recommended; group chats may be noisy with other messages
- Permission confirmations — When Claude needs to perform a sensitive operation it sends a confirmation button in the IM; make sure to respond promptly