Claude Code Telegram Bot

Claude Code Telegram Bot

A Telegram bot that gives you remote access to Claude Code. Chat naturally with Claude about your projects from anywhere -- no terminal commands needed.

What is this?

This bot connects Telegram to Claude Code, providing a conversational AI interface for your codebase:

- Chat naturally -- ask Claude to analyze, edit, or explain your code in plain language
- Maintain context across conversations with automatic session persistence per project
- Code on the go from any device with Telegram
- Receive proactive notifications from webhooks, scheduled jobs, and CI/CD events
- Stay secure with built-in authentication, directory sandboxing, and audit logging

Quick Start

Demo

1. Prerequisites

- Python 3.11+ -- Download here
- Claude Code CLI -- Install from here
- Telegram Bot Token -- Get one from @BotFather

2. Install

Choose your preferred method:

Option A: Install from a release tag (Recommended)

Option B: From source (for development)
Note: Always install from a tagged release (not main) for stability. See Releases for available versions.

3. Configure

Minimum required:

4. Run

Message your bot on Telegram to get started.
Detailed setup: See docs/setup.md for Claude authentication options and troubleshooting.

Modes

The bot supports two interaction modes:

Agentic Mode (Default)

The default conversational mode. Just talk to Claude naturally -- no special commands required.

Commands: /start, /new, /status, /verbose, /repo
If ENABLE_PROJECT_THREADS=true: /sync_threads

Use /verbose 0|1|2 to control how much background activity is shown:

GitHub Workflow

Claude Code already knows how to use gh CLI and git. Authenticate on your server with gh auth login, then work with repos conversationally:

Use /repo to list cloned repos in your…