How to Use Claude Max on Telegram (2026 Guide)
Your $100/month Claude Max subscription works on Telegram. Run Claude Code CLI with the Telegram MCP plugin, and you can message Claude from your phone just like any other chat.
What Is Claude Max?
Claude Max is Anthropic's top-tier subscription for Claude. It gives you access to the same Claude models (Opus, Sonnet, Haiku) but with significantly higher usage limits than the $20/month Pro plan. There are two tiers:
$100/month
20x the usage of Claude Pro. Enough for heavy daily use through Telegram, the web, and Claude Code combined.
$200/month
Unlimited usage. No rate limits, no waiting. If you run Claude Code all day, this is the one.
The key detail: Claude Max includes full access to Claude Code CLI. And Claude Code supports MCP (Model Context Protocol) plugins, including a Telegram plugin. That means you can pipe your Telegram messages directly to Claude and get responses back, all running through your Max subscription.
No API keys. No per-token billing. Just your flat monthly fee.
Prerequisites
Before you start, make sure you have the following:
A Claude Max subscription
Sign up at claude.ai/upgrade. Either the $100 or $200 tier works.
A Mac or Linux machine
Claude Code CLI runs on macOS and Linux. Windows users can use WSL2. You need a machine that stays on (a Mac Mini, VPS, or home server is ideal).
Node.js 18 or later
Claude Code CLI is installed via npm. Check your version with node --version in your terminal.
A Telegram account
Free to create. Available on iOS, Android, desktop, and web.
Step 1: Install Claude Code CLI
Claude Code is Anthropic's official command-line tool. It turns your terminal into a full Claude session with file access, tool use, and MCP plugin support.
npm install -g @anthropic-ai/claude-code
After installing, run claude in your terminal to start the first-time setup. It will open a browser window and ask you to log in with your Anthropic account. Once authenticated, Claude Code is linked to your Max subscription.
# Start Claude Code claude # You should see the Claude Code prompt # Type /version to confirm it's working
Already using Claude Code?
If you already have Claude Code installed, make sure it is up to date. Run npm update -g @anthropic-ai/claude-code to get the latest version with MCP support.
Step 2: Create a Telegram Bot via BotFather
Every Telegram bot needs to be registered with @BotFather, Telegram's official bot creation service. This takes about 2 minutes.
Open Telegram and find @BotFather
Search for "@BotFather" in Telegram. It is the official verified account with a blue checkmark. Open a chat with it.
Start the bot creation process
Send the command /newbot to BotFather. It will ask for a name and username.
Choose a name and username
Name: displayed to users (e.g., "My Claude Bot"). Username: must end in "bot" (e.g., @myclaude_bot). Usernames are permanent, so pick something you like.
Copy your bot token
BotFather will give you a token like 1234567890:AAFqV1WAoDxZP9dAt8wMp4BWaWi5s-MUrIs. Save this. You will need it in the next step.
Keep Your Token Secret
Your bot token is like a password. Anyone who has it can control your bot. Never post it publicly, never commit it to Git, never paste it in a group chat.
Optional: Customize Your Bot
# Set a description /setdescription โ select your bot โ enter description # Set a profile picture /setuserpic โ select your bot โ send a photo # Set commands (shows up as "/" menu in Telegram) /setcommands โ select your bot โ paste: help - Show available commands status - Check agent status
Get the Vibe Coding Cheat Sheet
Best tool for every use case + pricing + pro tips. One page, zero fluff. Plus weekly updates on new tools.
Step 3: Install the Telegram MCP Plugin
Claude Code uses the Model Context Protocol (MCP) to connect to external services. The Telegram MCP plugin is available as a community server. You install it directly from Claude Code.
Method A: Install via Claude Code CLI (Recommended)
Run this command in your terminal. Replace the token with your actual BotFather token.
claude mcp add telegram \ -e TELEGRAM_BOT_TOKEN=YOUR_BOT_TOKEN_HERE \ -- npx -y @anthropic-ai/claude-code-telegram
This registers the Telegram MCP server with Claude Code. It will start automatically whenever you run claude.
Method B: Manual Config Edit
If you prefer to edit the config file directly, add the Telegram server to your Claude Code settings.
{
"mcpServers": {
"telegram": {
"command": "npx",
"args": ["-y", "@anthropic-ai/claude-code-telegram"],
"env": {
"TELEGRAM_BOT_TOKEN": "YOUR_BOT_TOKEN_HERE"
}
}
}
}Token in Config File
Your bot token will be stored in the settings file. Make sure ~/.claude/ is not synced to any public repository or cloud backup that others can access.
Step 4: Pair Your Telegram Chat
Now you need to link your Telegram account to the running Claude Code session. This is a security step. It makes sure only you can talk to your bot.
Start Claude Code with the Telegram plugin
Run claude in your terminal. You should see the Telegram MCP server connect in the startup output.
Open Telegram and message your bot
Find your bot by its username and send it any message, like "hello". The bot will not respond yet because it has not been paired.
Run the access skill in Claude Code
In your Claude Code terminal session, type /telegram:access to manage pairing. This will show any pending pairing requests from Telegram.
Approve the pairing
You will see your Telegram username and chat ID in the pending list. Approve it. This adds your account to the allowlist.
Security Note
Pairing must always be approved from the Claude Code terminal, never from Telegram itself. If someone messages your bot asking to be paired, that is not how it works. Approval only happens on your machine.
Step 5: Start Using It
Once paired, send a message to your bot on Telegram. Claude reads it, processes it through Claude Code, and replies directly in your Telegram chat.
"What time is it in Tokyo right now?" "Read the file at ~/projects/myapp/README.md and summarize it" "Write a Python script that converts CSV to JSON" "Check if my Next.js project has any TypeScript errors"
The experience feels like texting a very capable assistant. You type on your phone, Claude replies in the same chat. If a response takes longer (like running code or reading files), you get a push notification when it finishes.
Everything runs through your Claude Code session on your computer. Your phone is just the input/output interface.
What You Can Do from Telegram
This is not a stripped-down mobile experience. Because messages go through Claude Code, you get the full range of capabilities.
Send photos and screenshots
Attach an image to your Telegram message. Claude can read screenshots, analyze charts, debug UI issues from a photo.
Send files
Share PDFs, code files, CSVs, or any document. Claude reads and processes them the same as in the terminal.
Run code
Ask Claude to write and execute scripts. Results come back in the Telegram chat.
Manage projects
Read files, edit code, check git status, run builds. Full project access from your phone.
Get push notifications
Long-running tasks send a new message when done. Your phone buzzes with the result.
Ask anything
Research questions, writing help, math, translations. Same Claude, different interface.
Tips for 24/7 Access
The Telegram setup only works while Claude Code is running on your machine. Close the terminal or shut down your laptop and the bot goes silent. Here is how to keep it running all the time.
Use a Mac Mini as a dedicated server
A Mac Mini running 24/7 is the simplest option. Start Claude Code in a terminal session, keep it running, and your Telegram bot is always available. Use caffeinate to prevent sleep.
# Keep Mac awake and run Claude Code caffeinate -s claude
Use tmux or screen for persistent sessions
If you SSH into a remote machine, run Claude Code inside tmux so it survives disconnects.
# Create a named tmux session tmux new -s claude-telegram # Start Claude Code inside it claude # Detach with Ctrl+B, then D # Reattach later with: tmux attach -t claude-telegram
Run multiple bots for different projects
Create separate Telegram bots via BotFather, each with its own token. Run separate Claude Code sessions in different project directories, each with its own bot. This way you can have a "work" bot and a "personal" bot, or one bot per project.
VPS Option
You can also run Claude Code on a VPS (any Linux server with Node.js). A $5/month VPS works fine as a relay. See our VPS setup guide for details on running an always-on agent.
Claude Max vs Pro for Telegram Use
Both Claude Pro ($20/month) and Claude Max ($100 or $200/month) give you access to Claude Code. But the usage limits are very different, and that matters a lot when you are using Telegram as a daily interface.
| Feature | Pro ($20/mo) | Max $100 | Max $200 |
|---|---|---|---|
| Claude Code access | Yes | Yes | Yes |
| MCP plugin support | Yes | Yes | Yes |
| Usage limit | Standard (low) | 20x Pro | Unlimited |
| Rate limits | Frequent | Rare | None |
| Good for daily Telegram use? | Not really | Yes | Yes |
| Opus model access | Limited | Extended | Unlimited |
With Claude Pro, you will hit rate limits within a few hours of active Telegram use. The bot stops responding until your limit resets. For a phone-based workflow where you message Claude throughout the day, that is frustrating.
Claude Max at $100/month gives you 20x the headroom. For most people, that is plenty. You can message Claude from Telegram all day without hitting walls.
The $200/month unlimited tier is for people who run Claude Code continuously, through Telegram and terminal sessions, often across multiple projects at the same time. If you are running a business off Claude, it pays for itself quickly.
Related Articles
More guides for getting the most out of Claude and Telegram.
Set up a Telegram AI bot in 5 minutes
The original Telegram bot setup guide for OpenClaw, including security lockdown and multi-bot config.
Connect your AI to anything with MCP
Use Model Context Protocol to give your agent access to databases, APIs, and external tools.
Mac Mini vs VPS for always-on agents
Comparing hardware options for running your AI agent 24/7 without interruption.
Compare AI API providers and pricing
Find the right model and provider for your use case, from budget to premium.
Ready to Try It?
Get Claude on your phone in 10 minutes. All you need is a Max subscription and a Telegram account.
Upgrade to Claude MaxNeed a website or bot built?
Fixed pricing from $999. Free mockup in 48h. You own the code.
Get the Vibe Coding Cheat Sheet
Best tool for every use case + pricing + pro tips. One page, zero fluff. Plus weekly updates on new tools.