Claude on Telegram
Chat with Local Claude Code
A personal Telegram bot that lets me drive my local Claude Code from my phone: a chat per project with memory, project switching, continuing old IDE sessions, and photos/docs Claude can read.
Problem :
I wanted to keep working with my local Claude Code when away from the desk — from my phone — without any cloud service in between.
Solution :
A personal Telegram bot that runs the Claude Agent SDK against the copy of Claude installed on my machine. It answers only me (by Telegram id), keeps one continuous session per project, switches projects, continues sessions started in the IDE, and reads photos and documents I send.
My Role :
Everything — the bot, the session and project handling, media intake and the security gate.
Process :
aiogram 3 driving the Claude Agent SDK locally; sessions live in ~/.claude/projects; commands for /projects, /cd, /sessions, /history and /stop; voice notes transcribed to text; a hard allow-list so only my id can talk to it.
Outcome :
My IDE assistant in my pocket: I can pick up a project, continue an old session and get real work done from the phone — a mobile head for Claude Code. Shown here as rendered mockups of the real flow.
Tech Stack :
Python, aiogram 3, the Claude Agent SDK (local), session storage in ~/.claude/projects, per-user id security, and voice transcription.
