claude-telegram-channel

> Control Claude Code from your phone. Get replies in Telegram. Approve tool-use permissions remotely.

A two-way Telegram messaging bridge for Claude Code, implemented as a Channels plugin. Send messages and files to Claude from Telegram; Claude responds directly in your chat.

┌─────────────┐     DM / Group     ┌─────────────┐     stdio MCP      ┌──────────────┐
│  Your Phone │ ◄─────────────────► │ Telegram Bot│ ◄─────────────────► │  Claude Code │
│  (Telegram) │                     │  server.ts  │                     │   Session    │
└─────────────┘                     └─────────────┘                     └──────────────┘
       ▲                                                                        │
       │          "yes abcde" / "no abcde"               Permission request     │
       └────────────────────────────────────────────────────────────────────────┘

Features

• 💬 Two-way text, photo, file, voice, video, and sticker support
• 🔐 Remote permission relay — approve/deny tool use from your phone
• 🛡 Access control — pairing codes, allowlists, group policies
• 📎 Automatic photo download; on-demand file fetch
• ✂️ Long-message auto-chunking (4096 char limit)
• 🔄 Graceful restart — 409 Conflict auto-retry

---

1. Prerequisites
2. Create Your Telegram Bot
3. Install the Plugin
4. Configure the Token
5. Launch with the Channel
6. Pair Your Telegram Account
7. Daily Usage
8. Permission Relay
9. Access Control
10. Tools Reference
11. Environment Variables
12. File Locations
13. Troubleshooting
14. [Limitations](#14-