claude-telegram-server

Turn any computer into a 24/7 Claude Code assistant you can talk to from Telegram. Send a message from your phone — Claude reads your files, writes code, runs commands, and replies right back.

┌──────────────┐         ┌─────────────────────────┐         ┌──────────────┐
│              │         │    Your Server (any OS)  │         │              │
│   Telegram   │────────▶│  tmux / screen session   │────────▶│  Your Code   │
│   on phone   │◀────────│  Claude Code + Plugin    │◀────────│  & Terminal  │
│              │         │                          │         │              │
└──────────────┘         └─────────────────────────┘         └──────────────┘

1. You message your Telegram bot from anywhere
2. The official Telegram plugin pushes the message into Claude Code
3. Claude reads files, edits code, runs tests, makes commits — whatever you ask
4. Claude replies directly in your Telegram chat

It's like having your IDE in your pocket.

| Requirement | Details | |-------------|---------| | Claude Code | v2.1.80+ (install guide) | | Claude subscription | Pro, Max, Team, or Enterprise (OAuth login) | | Node.js | v18+ | | Bun | Required for channel plugins | | tmux or screen | To keep the session alive after disconnecting | | Telegram account | To create a bot via BotFather |

npm install -g @anthropic-ai/claude-code

Authenticate with your Claude subscription:

claude auth login --claudeai

This gives you a URL to open in your browser. Sign in and paste the code back.

Claude Code plugins run on Bun.

macOS / Linux:

curl -fsSL https://bun.sh/install | bash

Windows (PowerShell):

irm bun.sh/install.ps1 | iex

1. Open [@BotFather](https://t.me/BotFa