# telegram-claude

Telegram bot interface for Claude Code on a VPS. Message the bot, it spawns Claude Code in the selected project directory and streams results back — voice notes, streaming responses, session continuity, plan-mode interception.

**Type:** repo
**Added:** 2026-04-30
**Link:** https://github.com/Mark-Life/telegram-claude
**Topics:** AI Coding, Open Source
**Tags:** agents, cli

---

I built this to use Claude Code from my phone without opening an SSH client. Pick a project from an inline keyboard, type or record a voice note describing what you want, and Claude Code does the work — edits files, runs commands, opens PRs — streaming output back as Telegram messages.

See my walkthrough on setting up the underlying VPS environment (Hetzner + Tailscale + Tmux + Caddy) in [Claude Code on VPS: Full Setup to Code from Your Phone](/blog/claude-code-vps-setup) — the Telegram bot is the layer on top that makes the whole thing feel like chatting with your dev environment.

Built with TypeScript, Bun, [grammY](https://grammy.dev/), and Groq Whisper for voice transcription. Runs as a systemd user service on the same VPS that hosts your projects.

---

## Links

- Directory entry: https://andrey-markin.com/directory/telegram-claude
- All directory entries: https://andrey-markin.com/directory
- Contact: https://andrey-markin.com/#contact