RemoteCode

Control Claude Code remotely through Telegram. Built specifically for Claude Code.

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.

You (Anywhere)    RemoteCode (Host)    Claude Code (Host)

Features

• Text chat – Send any message, get Claude Code responses with Markdown formatting
• Image analysis – Send photos or image documents, optionally with a caption prompt
• Voice messages – Transcribed locally via whisper-cli (offline, free), then sent to Claude Code
• Session management – Multiple sessions, switch between them, browse by project
• Auto-sync – Watch active session files and forward new messages in real-time
• Background daemon – Runs as a detached process with log rotation
• User access control – Restrict access by Telegram user ID or username
• Smart permissions – Follows your host Claude Code settings.json permission rules automatically. When a tool needs approval, you get the same Allow / Deny buttons on Telegram – with per-tool “allow for session” so you don’t have to tap the same thing twice
• Session takeover – Kicked off a task in the terminal and stepped away? If Claude is stuck waiting for permission or asking a question, open Telegram and pick up right where it stopped. You’ll see exactly what it needs, tap to respond, and Claude keeps going
• Cross-session scanner – Running multiple sessions? RemoteCode watches all of them in the background. If any session is waiting for your input, you get a notification – even if it’s not the one you’re currently looking at

Demo

▶ Watch the demo on YouTube

Platform Support

Quick Start

Prerequisites

• macOS or Linux
• Node.js >= 18
• Claude Code CLI installed and authenticated (claude command available)
• Telegram Bot Token – create a bot via @BotFather on Telegram (send /newbot, follow the prompts, copy the token). See Telegram’s official guide for details

Install

npm install -g @kcisoul/remotecode

Or from source:

git clone https://github.com/kcisoul/remotecode.git
cd remotecode
npm install && npm run build
npm link

First Run

remotecode

The interactive setup wizard will prompt for:

1. TELEGRAM_BOT_TOKEN – validated against Telegram API