Skip to main content
The Claude Telegram Bot turns Claude Code into your personal assistant, accessible from anywhere via Telegram. Send text, voice notes, photos, documents, audio, and video; the bot downloads/transcribes/extracts as needed, then streams replies back in chat.

​
Why Use This Bot

Claude Code is described as a powerful AI coding agent, but it’s actually a very capable general-purpose agent when given the right instructions and tools. This bot lets you access that capability from your phone, so you can:
  • Ask questions and get answers instantly
  • Give instructions and see Claude work in real-time
  • Send screenshots and documents for analysis
  • Use voice for natural interaction
  • Stay productive from anywhere

​
Core Features

💬 Text

🎤 Voice

📸 Photos

📄 Documents

🎵 Audio

🎬 Video

🔄 Session Persistence

🔘 Interactive Buttons

​
Advanced Features

  • Global stop intents: Use stop, pause, abort, or ! to interrupt active work instantly
  • Message queuing: Send multiple messages while Claude works — they queue automatically. Prefix with ! to interrupt and send immediately
  • Streaming responses: See Claude’s response in real-time, updated as it generates output
  • Session management: Resume conversations from recent sessions with automatic recaps
  • Context awareness: Claude knows about your preferences, files, and workflows via CLAUDE.md

​
Getting Started

npm install -g superturtle
superturtle init
superturtle start
See the Quickstart for the full setup walkthrough.

​
How It Works

You (Telegram)
    ↓
Bot receives message (text/voice/photo/document/video)
    ↓
Claude Code processes it
    ↓
Response sent back to Telegram
When you send a message:
  1. Bot receives and validates your user ID
  2. Message is sent to Claude Code
  3. Claude can use tools, read files, execute commands (within allowed paths)
  4. Response streams back to you in real-time
  5. You see Claude’s work as it happens

​
What You Control

Claude runs with all permission prompts disabled (for seamless mobile experience), but you control what Claude can access:
  • File access: Limited to directories you specify
  • Commands: Dangerous patterns like rm -rf / are blocked
  • Rate limiting: Prevents runaway usage
  • Audit logging: All interactions are logged
See Security for the full threat model and defense layers.

​
Next Steps