Claude Code Telegram Bot
github.com/richardatct/claude-code-telegram- Category
- AI Agents
- Rank
- No. 425Tools index
Previous survey · No. 431 ·
- Pricing
- Open Source
- Type
- APP
- Use case
- Coding
- Interfaces
- CLI · API
- Builder
- @RichardAtCT
- GitHub
- 2.8k stars
- Latest release
- v1.8.0
- Date
About
A powerful Telegram bot that provides remote access to Claude Code, enabling developers to interact with their projects from anywhere with full AI assistance and session persistence. Offers both conversational and command-based modes for natural code collaboration.
What it does
The service turns Telegram updates into coding tasks against an approved project workspace. Users can chat conversationally or switch to a terminal-style command interface. It preserves project sessions, accepts external webhook and scheduled triggers, and sends results back through Telegram. Optional project topics keep separate repositories routed to distinct conversations.
Why it's ranked here
This is a credible remote operations layer, not merely a chat wrapper. It combines persistent sessions, repository switching, authenticated webhooks, scheduled jobs, notifications, uploads, cost controls, and audit events. Its security controls are unusually explicit, though two security-related stores remain memory-backed and the extension system is still planned.
What's good
Access starts from an allowlist and stays bounded to an approved directory. Path traversal checks, rate limits, configurable tool permissions, webhook signature verification, and cost ceilings add useful guardrails. SQLite stores sessions and webhook delivery records, while duplicate webhook deliveries are rejected atomically. Quiet, normal, and detailed output levels suit different Telegram workflows.
Tradeoffs
You must operate Python, Claude Code authentication, a Telegram bot token, and the host containing your repositories. Webhooks and scheduling require separate opt-in configuration. Token authentication records and audit records currently live only in memory, despite persistent session storage. Voice transcription needs optional providers or a local transcription setup. Third-party plugins remain planned rather than available.
How to use it well
Use it for trusted developers who need quick repository checks, small edits, test runs, issue work, or scheduled code health tasks away from a terminal. Keep the approved workspace narrow, allow only known Telegram users, set cost limits, and authenticate every webhook. It does not replace a hosted development environment, standalone coding model, or mature extension marketplace.
Technical notes+
pyproject.toml defines a Python 3.11+ package built with Poetry Core and exposes claude-telegram-bot = "src.main:run". src/main.py assembles Telegram handling, Claude SDK integration, SQLite session storage, authentication, validation, rate limiting, an async event bus, notifications, optional scheduling, and the optional API server. It explicitly uses InMemoryTokenStorage and InMemoryAuditStorage, each marked with a database-storage TODO. src/bot/core.py supports polling or Telegram webhook operation and orders security, authentication, and rate-limit middleware before message handlers. src/api/auth.py verifies GitHub HMAC-SHA256 signatures and generic Bearer secrets with constant-time comparison. src/api/server.py exposes health and provider webhook routes, fails closed when secrets are absent, and deduplicates deliveries through SQLite INSERT OR IGNORE. src/events/bus.py queues typed events and dispatches matching handlers concurrently with error isolation.
Observed
- License
- MIT
- Primary language
- Python 3.11 or newer
- Packaging
- Poetry Core build backend with an installable command-line entry point
- Install surface
- Installable from tagged Git releases with uv or pip, or from source with Poetry
- Interfaces
- Telegram bot, command-line launcher, and optional FastAPI webhook API
- Platform support
- Declared operating-system independent
- Persistence
- SQLite-backed sessions, migrations, scheduled jobs, and webhook delivery records
- Claude integration
- Claude Agent SDK is the primary integration, with Claude Code CLI listed as a prerequisite
Read from README.md, Makefile, setup.cfg, pyproject.toml, src/main.py, src/__init__.py, src/exceptions.py, src/api/auth.py, src/bot/core.py, src/api/server.py, src/events/bus.py, src/api/__init__.py, src/bot/__init__.py, src/events/types.py.
What it can do
Access and interact with remote codebase projects
Telegram messages and project repository → Code analysis, suggestions, and modifications
Provide AI-powered code assistance and collaboration
Natural language queries about code → Code explanations, debugging help, and development guidance
Maintain persistent development sessions
User conversations and project context → Continuous session state across interactions
Execute conversational mode interactions
Natural language messages about code → Contextual responses and code suggestions
Process command-based development requests
Structured bot commands → Specific code operations and results
Handle webhook automation triggers
External webhook events → Automated responses and code operations
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.