---
title: "Claude Code Telegram Bot vs Push Questions"
description: "Claude Code and Telegram: the official channel plugin, a DIY hook bot, or push questions over MCP. Setup, limits and where each fits, checked 2026-11-19."
url: "https://notifexapp.com/blog/claude-code-telegram-vs-push-questions"
published: "2026-11-19"
updated: "2026-11-19"
author: "Alaa Jawhar"
---

# Claude Code Telegram Bot vs Push Questions to Your Phone

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](https://code.claude.com/docs/en/channels) 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](https://bun.sh). 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](https://code.claude.com/docs/en/channels-reference) can forward permission prompts, so you approve or deny from the chat. The official [Telegram plugin source](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) 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](https://core.telegram.org/bots/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](https://code.claude.com/docs/en/hooks) 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.](https://d29bihfk9mha1v.cloudfront.net/notifex/blog-claude-code-telegram-vs-push-questions-tg-1-v1.webp)

_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](https://notifexapp.com/claude-code). Other clients are on [the setup page for other clients](https://notifexapp.com/connect-your-agent).

![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.](https://d29bihfk9mha1v.cloudfront.net/notifex/blog-claude-code-telegram-vs-push-questions-tg-2-v1.webp)

_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 channel | DIY bot from a hook | Push questions (Notifex) |
| --- | --- | --- | --- |
| What you get | A two-way chat with the running session | One-way alerts | The agent's question, answered on your phone |
| Approve permission prompts | Yes, through permission relay | No | No; the agent asks at the points you name |
| Answer format | Free chat, plus approve or deny | None | Single choice, multiple choice or free text |
| Agents | Claude Code | Any agent with hooks | Any MCP client |
| Needs | Bun, a bot, --channels, claude.ai or Console sign-in | A bot and a script | The Notifex app and one MCP entry |
| Team | Allowlisted senders | Whoever is in the chat | Team projects, first answer wins |
| Cost | Included in Claude Code | Free | Free |

## 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](https://notifexapp.com/blog/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](https://notifexapp.com/blog/ntfy-vs-pushover-for-ai-agents).

Notifex is free on the App Store and Google Play: [Notifex for iPhone](https://notifexapp.com/iphone-app) and [Notifex for Android](https://notifexapp.com/android-app).

## Quick answers

### Can I control Claude Code from Telegram?

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.

### Does the Claude Code Telegram plugin work with an API key?

Channels need claude.ai sign-in or a Console API key. They do not run on Amazon Bedrock, Google Cloud or Microsoft Foundry, according to the Claude Code docs.

### How do I get a Telegram message when Claude Code needs input?

Add a Notification hook that calls the Telegram Bot API sendMessage method with your bot token and chat id. It is a one-way alert.

### What is the difference between a Telegram bot and Notifex?

A Telegram bot carries chat messages. Notifex carries the agent's question with answer options, and returns your tapped answer to the agent as the tool result.
