claude-in-telegram

Remote control Claude Code to execute programming tasks (vibe coding) via Telegram.

Prerequisites

• Claude Code CLI - Must be installed and configured first

  # Install Claude Code CLI
  npm install -g @anthropic-ai/claude-code
  
  # Configure API Key (prompted on first run)
  claude

• Rust 1.70+ (can be automatically installed via make setup)

• Linux/macOS

Quick Start

# 1. Environment setup (check Rust, auto-install if missing)
make setup

# 2. Configuration
cp config/config.toml.example config/config.toml
# Edit config/config.toml, fill in bot_token and authorized_user_id

# 3. Start
make start

Common commands:

make stop     # Stop service
make logs     # View logs
make status   # Check status
make restart  # Restart service

---

Detailed Documentation

Installation

git clone <repository-url> && cd claude-in-telegram
cargo build --release

Configuration

1. Create Bot: Message @BotFather and send /newbot
2. Get User ID: Message @userinfobot with any text
3. Create config:

   cp config/config.toml.example config/config.toml
   # Edit config file, fill in bot_token and authorized_user_id

Telegram Commands

Command	Description
/menu	Select project
/status	View task status
/stop	Terminate task
/unlock	Switch project
/history	Task history
/rollback	Git rollback

Workflow

/menu select project → send task → /status check progress → /unlock switch project

Other make commands

make setup     # Check Rust environment (auto-install if missing)
make build     # Build only
make clean     # Clean build artifacts
make help      # Show all commands

Docker Deployment

See docker/README.md

License

MIT License