Send prompts, switch sessions, share images, and dictate voice messages — all through Telegram. Your local Claude Code, now in your pocket.
npm install -g @kcisoul/remotecode
click to copy
Works directly with your local Claude Code installation. Same sessions, same project context, same history.
Send any message, get Claude Code responses with full Markdown formatting rendered as Telegram HTML.
Send photos or image documents with optional captions. Claude Code sees and analyzes them.
Speak your prompts. Transcribed locally via whisper-cli -- completely offline and free.
Multiple sessions, switch between them, browse by project. View conversation history for each session.
Watch active sessions and forward new messages in real-time. Use Claude on your host, see it on Telegram.
Restrict access by Telegram user ID or username. Unauthorized users are silently blocked.
Three steps to control Claude Code from your phone.
Install globally via npm. Requires Node.js 18+ and Claude Code CLI already set up.
Run remotecode and follow the setup wizard. Add your Telegram bot token and allowed users.
The daemon starts in the background. Open Telegram, send a message to your bot, and you're in.
Watch RemoteCode in action.
Quick actions right from the Telegram chat.
| Command | Description |
|---|---|
| /start | Welcome message with quick action buttons |
| /sessions | Browse and switch between recent sessions |
| /projects | Browse sessions grouped by project directory |
| /new | Start a new Claude Code session |
| /history | Show conversation history of current session |
| /sync | Toggle auto-sync notifications |
Install RemoteCode and start coding from anywhere.