The Claude Code channels docs on the Telegram setup steps, next to a Notifex question on an iPhone asking which build to prepare.

There are two ways to reach Claude Code through Telegram, and a third option built for questions. Anthropic's Telegram channel turns a Telegram bot into a chat with your running session, and it can relay permission prompts. A DIY bot called from a hook sends you one-way alerts. Push questions over MCP send the agent's question to a phone app and return your tapped answer as the tool result.

Pick the Telegram channel if you want to chat with Claude Code from Telegram. Pick push questions if you want structured answers, a team that can answer, or the same setup in other agents. We make Notifex, the push question app in this post. All Claude Code and Telegram facts were checked in their docs on 2026-11-19.

What is the Claude Code Telegram channel?

A channel is an MCP server that pushes events into a Claude Code session that is already running. The Claude Code channels docs list Telegram, Discord and iMessage in a research preview. You message your bot, the message lands in the session, and Claude replies in the same Telegram chat while it works on your files.

The setup, as the docs give it:

  1. Install Bun. The channel plugins are Bun scripts.
  2. In Telegram, open BotFather, send /newbot, and copy the token.
  3. In Claude Code, run /plugin install telegram@claude-plugins-official.
  4. Save the token with /telegram:configure <token>.
  5. Restart with claude --channels plugin:telegram@claude-plugins-official.
  6. Message your bot, then pair with /telegram:access pair <code> and lock it down with /telegram:access policy allowlist.

A few limits come with the preview. Channels need claude.ai or Console API key sign-in, and they do not run on Amazon Bedrock, Google Cloud or Microsoft Foundry. Team and Enterprise admins must turn them on. Events only arrive while the session is open, so the terminal has to keep running.

Can the Telegram channel approve Claude Code permission prompts?

Yes, when the channel supports it. The docs say a channel that declares the permission relay capability can forward permission prompts, so you approve or deny from the chat. The official Telegram plugin source declares that capability, and it sends each request with inline buttons.

The docs add a warning worth repeating. Anyone on the channel's allowlist can approve tool use in your session. Keep the allowlist to people you trust with that.

How do you send Claude Code alerts to Telegram with a hook?

Without the channel, you can post to Telegram from a hook. The Telegram Bot API takes requests at https://api.telegram.org/bot<token>/METHOD_NAME, and sendMessage posts text to a chat. In Claude Code, a Notification hook runs when Claude needs your attention. Its input carries the notification text in message.

  1. Create a bot with BotFather and keep the token in TELEGRAM_BOT_TOKEN.
  2. Send your bot a message, then read your chat id from getUpdates and keep it in TELEGRAM_CHAT_ID.
  3. Write a script that reads .message and calls sendMessage.
  4. Register it as a Notification hook in .claude/settings.json.
A terminal shows .claude/settings.json with a Notification hook, and a telegram-notify.sh script that posts the message to the Telegram Bot API sendMessage method.
A Notification hook and its script in a demo project, shown in a terminal on a Mac, 2026-11-19. Token and chat id come from environment variables.

This is a one-way alert. Telegram tells you Claude is waiting, and you walk back to the terminal. To answer from Telegram instead, your script has to read replies with getUpdates or a webhook. It then has to match each reply to the right prompt and feed it to the session. The Bot API docs also note that updates wait on Telegram's servers for at most 24 hours. At that point you are building your own channel, and the official plugin already does that job.

How do push questions to your phone work?

Push questions start from the agent instead of from you. Notifex is a remote MCP server with a phone app. When Claude Code reaches a decision, it calls ask_question and blocks. Your phone gets a push. You tap an option or type a reply, and the answer returns to Claude as the tool result.

  • Structured answers. Single choice, multiple choice or free text. ask_questions sends up to 10 questions in one push.
  • Context on the phone. The agent can attach screenshots, video or PDFs with create_upload, up to 10 files of 10 MB each.
  • A team can answer. In a team project every member gets the push, and the first answer wins.
  • Answers survive a dropped connection. The question stays open on the server. wait_for_answer picks it up again with the question id.
  • Any MCP client. The same entry works in Claude Code, Cursor, Codex, the Claude.ai connector and ChatGPT.

Setup is one claude mcp add line with your project key, shown on the Notifex page for Claude Code. Other clients are on the setup page for other clients.

Two iPhone screens: the first of three questions in one Notifex push, with two options, and a dark-mode question with a field to type a reply.
Notifex on an iPhone 17 Pro simulator with demo fixture data, captured October 2026.

Telegram bot vs push questions: how do they compare?

The table sums up the three routes. The channel is a research preview, so check the docs before you rely on a detail.

Claude Code and Telegram vs push questions (Claude Code docs, plugin source and Telegram Bot API, checked 2026-11-19)
Telegram channelDIY bot from a hookPush questions (Notifex)
What you getA two-way chat with the running sessionOne-way alertsThe agent's question, answered on your phone
Approve permission promptsYes, through permission relayNoNo; the agent asks at the points you name
Answer formatFree chat, plus approve or denyNoneSingle choice, multiple choice or free text
AgentsClaude CodeAny agent with hooksAny MCP client
NeedsBun, a bot, --channels, claude.ai or Console sign-inA bot and a scriptThe Notifex app and one MCP entry
TeamAllowlisted sendersWhoever is in the chatTeam projects, first answer wins
CostIncluded in Claude CodeFreeFree

Where is Telegram the better choice?

  • You want to talk to the session. Ask what it is doing, give new instructions, send a photo. A chat does that and a question does not.
  • You want every permission prompt on your phone. Permission relay forwards them without changing your instructions.
  • You live in Telegram already. No new app, and Anthropic maintains the plugin.
  • You only need a ping. A ten-line hook script sends it, for free.

Where are push questions the better choice?

  • The agent should decide when to ask. You name the checkpoints, such as deploys and deletes, and nothing else interrupts you.
  • You want a clean answer. A tapped option comes back as text the agent can act on, with no parsing of chat replies.
  • You run more than Claude Code. Cursor, Codex and browser chats can use the same project.
  • Someone else may answer. Teammates get the same push, and the first answer wins.

Can you use both?

Yes. They do different jobs. Run the Telegram channel when you want to steer the session from a chat. Add Notifex for the decisions you want as a clear choice, with a note like this in CLAUDE.md:

Before a deploy, a database migration or deleting files, ask me with Notifex ask_question and wait.

If a Telegram chat with the whole session is more than you need, read Claude Code Remote Control vs MCP questions for the same trade-off with Anthropic's Remote Control. For one-way alert services, see ntfy vs Pushover for AI coding agents.

Notifex is free on the App Store and Google Play: Notifex for iPhone and Notifex for Android.

Quick answers

  • Yes, with Anthropic's Telegram channel plugin, in research preview as of 2026-11-19. You message a bot, and the message reaches your running Claude Code session started with --channels.

Give your agent someone to ask

Free on the App Store and Google Play. Then add one MCP entry and let your agent ask.

Download on the App StoreGet it on Google Play