Claude Code Telegram

Overview

A Telegram bot that provides remote access to Claude Code, extended with an agentic platform layer. Users can interact with Claude’s coding capabilities from anywhere via Telegram, while the platform supports webhooks, scheduled tasks, and notification routing.

Architecture

The core is a Telegram bot that bridges messages to Claude Code’s integration API. On top of this, an event bus architecture enables:

• Webhook server: FastAPI-based endpoint accepting GitHub webhooks (HMAC-SHA256 verified) and generic Bearer-token authenticated webhooks
• Scheduler: APScheduler with SQLite persistence for recurring tasks
• Notification service: Rate-limited Telegram delivery with per-chat throttling

All features are opt-in via feature flags and disabled by default. The system maintains ordered shutdown sequences (scheduler → notifications → event bus → bot → claude → storage).

Key Design Decisions

• Event bus runs alongside the existing Telegram path rather than replacing it
• Skills and MCP configured externally — no custom plugin system needed
• WAL mode SQLite for concurrent read/write access
• Idempotent initialization for pre-init Bot access patterns