Open Source

Claude Code
via Telegram

Control your local development environment from anywhere. Full agent capabilities — file operations, commands, code generation — all from your phone.

View on GitHub Quick Start →

Installation

Getting Started

Prerequisites

Node.js v18+ npm Telegram account Anthropic API key Claude Max subscription
Note: On macOS, Claudegram uses caffeinate to prevent sleep during long operations.

Quick Start

Terminal 
git clone https://github.com/nachoSEO/claudegram.git
cd claudegram
npm install
cp .env.example .env
# Edit .env with your credentials
npm run dev

Step-by-Step Setup

1

Clone the repository

Download the project using git clone

2

Install dependencies

Run npm install in the project directory

3

Create Telegram bot

Message @BotFather on Telegram and use /newbot to get your token

4

Get your Telegram user ID

Message @userinfobot on Telegram to get your numeric user ID

5

Configure environment

Copy .env.example to .env and fill in your credentials

6

Run the bot

Start with npm run dev for development or npm start for production

7

Verify it works

Send a message to your bot on Telegram and check for a response

Configuration

Variable Description Required
TELEGRAM_BOT_TOKEN Bot token from BotFather Yes
ALLOWED_USER_IDS Comma-separated Telegram user IDs Yes
ANTHROPIC_API_KEY Your Anthropic API key Optional*
WORKSPACE_DIR Default workspace path for projects No
STREAMING_MODE streaming or wait for responses No
*ANTHROPIC_API_KEY is optional if using a Claude Max subscription with claude CLI configured.
←
⚡
Claudegram
online
📞 ⋮
📎

Capabilities

Full Agent Power in Your Pocket

📱

Mobile-First

Send coding requests from anywhere using Telegram. Perfect for quick fixes, code reviews, or managing projects on the go.

⚡

Real-Time Streaming

Watch Claude's responses appear character by character. No waiting — see progress as it happens with debounced updates.

🔧

Full Tool Access

Read files, write code, run bash commands, search codebases. Every Claude Code capability available through chat.

🔒

Secure by Default

Runs on your local machine. Whitelist specific Telegram users. Your code never leaves your network.

Architecture

How It Works

📱 Telegram
→
🤖 Claudegram
→
🧠 Claude SDK
→
💻 Your Machine

Reference

Commands

/project <name> Open a project from your workspace directory
/newproject <name> Create and open a new project
/clear Clear the current session and start fresh
/status Show current session and project info