Control Claude Code CLI directly from Telegram. AI-powered coding assistance, anywhere, anytime.
Powerful features for developers on the go
Control Claude Code CLI from your phone or any device with Telegram. Code from anywhere.
Create, list, switch between, and close multiple Claude Code sessions with ease.
Send voice messages that get transcribed via OpenAI Whisper and sent to Claude.
Upload documents, code files, and images directly to Claude for analysis.
Add the bot to group chats for team collaboration with @mention support.
Get notified when Claude is thinking, executing tools, or waiting for input.
Make sure you have these ready
JavaScript runtime required to run the bot. Download here
Anthropic's coding assistant. Must be installed and logged in. Installation guide
You'll create a bot and need your user ID. Both are free and explained below.
Follow these steps to get your bot running
Open Telegram and search for @BotFather (the official bot for creating bots).
1. Send: /newbot
2. Enter a name for your bot (e.g., "My Claude Bot")
3. Enter a username ending in "bot" (e.g., "my_claude_code_bot")
4. Copy the token BotFather gives you
✅ Your token looks like: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
Your user ID tells the bot who's allowed to use it. Search for @userinfobot on Telegram.
1. Send any message to @userinfobot
2. It replies with your ID (a number like 123456789)
3. Save this number for the next step
💡 You can add multiple user IDs separated by commas to allow friends/teammates to use the bot.
Open your terminal (Command Prompt on Windows, Terminal on Mac/Linux) and run:
npm install -g @a5c-ai/claude-code-telegram-bot
Create a file named .env in the folder where you'll run the bot. Add your token and user ID:
# Paste your bot token from Step 1
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz
# Your user ID from Step 2 (add more IDs with commas)
ALLOWED_USER_IDS=123456789
# Folder where Claude will work (optional)
DEFAULT_WORKING_DIR=/path/to/your/projects
⚠️ Replace the example values with your actual token and user ID!
Run this command in the same folder where you created the .env file:
claude-code-telegram-bot
🎉 Open Telegram, find your bot by its username, and send /start to begin!
Important information about running the bot safely
This bot runs with --dangerously-skip-permissions enabled. Claude will automatically read, write, delete files, and run commands based on your prompts. Only run in sandboxed or disposable environments.
Only authorized Telegram user IDs can interact with the bot.
Child processes are spawned with sanitized environment variables.
Built-in rate limiting and message size limits to prevent abuse.
File operations restricted to session working directory.
Join developers who've brought Claude Code to their fingertips