Handy to set up, powerful to use, and secure with no open ports. Inherits your Claude Code permission policies as-is, and gives you full control over every project and session on your host — all from Telegram.
npm install -g @kcisoul/remotecode
click to copy
Works directly with your local Claude Code installation. Same sessions, same projects, same context.
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.
Follows your host Claude Code permission rules automatically. Approve tools from Telegram with per-tool session-level control.
Started a task in the terminal and stepped away? If Claude is stuck waiting, open Telegram, see what it needs, and keep it going.
Running multiple sessions? Get notified when any of them needs your input, not just the one you're looking at.
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 |
| /cancel | Cancel the current task |
| /resume | List sessions in the current project |
| /model | Switch Claude model (Sonnet / Opus / Haiku) |
| /sync | Toggle auto-sync notifications |
Install RemoteCode and start coding from anywhere.