Tutorial

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.

claw.mobile EditorialยทMay 7, 2026ยท
12 min read

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:

1

A Claude Max subscription

Sign up at claude.ai/upgrade. Either the $100 or $200 tier works.

2

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).

3

Node.js 18 or later

Claude Code CLI is installed via npm. Check your version with node --version in your terminal.

4

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.

Terminal
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.

Verify installation
# 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.

1

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.

2

Start the bot creation process

Send the command /newbot to BotFather. It will ask for a name and username.

3

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.

4

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

BotFather commands
# 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.

Terminal
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.

~/.claude/settings.json
{
  "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.

1

Start Claude Code with the Telegram plugin

Run claude in your terminal. You should see the Telegram MCP server connect in the startup output.

2

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.

3

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.

4

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.

Example Telegram messages
"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.

FeaturePro ($20/mo)Max $100Max $200
Claude Code accessYesYesYes
MCP plugin supportYesYesYes
Usage limitStandard (low)20x ProUnlimited
Rate limitsFrequentRareNone
Good for daily Telegram use?Not reallyYesYes
Opus model accessLimitedExtendedUnlimited

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.

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 Max

Need a website or bot built?

Fixed pricing from $999. Free mockup in 48h. You own the code.

See pricing

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.