Как подключить Claude к Телеграму: свой бот за 6 шагов

Пароль бота из BotFather: что именно копировать

Пароль бота BotFather называет словом token: кто его знает, тот управляет ботом. Он приходит в последнем сообщении, сразу под словами «Use this token». Копируй целиком, вместе с числом в начале и двоеточием, по виду это 123456789:AAH...

Адрес бота должен заканчиваться на bot, например moy_pomoshnik_bot, и быть свободным: занятый BotFather не примет и попросит другой. Подробнее про BotFather и настройки бота я разбирал в статье как создать телеграм-бота

Две строки ставят дополнение один раз на весь компьютер. Первая подключает официальный каталог дополнений Anthropic, вторая берёт из него дополнение для Telegram. Что такое каталог и дополнения вообще, есть в статье как установить плагин в Claude Code. Первую строку не пропускай: в чистой установке Claude Code официального каталога у меня не оказалось, и одна команда установки упала с ошибкой. Каталог подключился за 10 секунд, дополнение встало ещё за 2. Когда всё прошло, на экране две зелёные галочки:

✔ Successfully added marketplace: claude-plugins-official (declared in user settings)
✔ Successfully installed plugin: telegram@claude-plugins-official (scope: user)

После /telegram:configure пароль бота ложится в файл ~/.claude/channels/telegram/.env. Дополнение само закрывает этот файл от других пользователей компьютера при каждом запуске, руками ничего настраивать не нужно

Первое сообщение боту и код привязки

Бот отвечает, только пока на компьютере открыто окно, запущенное строкой с --channels. Обычный claude без этого флага бота не слышит. Сам флаг не ищи в claude --help: пока функция в тестовом режиме, Anthropic его там не показывает, но он работает

Напиши боту «привет». Он ответит:

Pairing required — run in Claude Code:

/telegram:access pair a4f91c

Вместо a4f91c будет твой код из 6 символов. Набери эту строку в окне Claude Code на компьютере, бот пришлёт подтверждение, и следующее твоё сообщение уже дойдёт до Claude. Код живёт час. Если не успел, напиши боту ещё раз: код он повторит только один раз, дальше замолчит, чтобы его нельзя было засыпать запросами

Теперь закрой бота от чужих командой /telegram:access policy allowlist. Пока бот в режиме привязки, любой, кто найдёт его адрес, получит код. Да, без твоего подтверждения код ничего не даёт, но бот будет отвечать незнакомым людям. После allowlist чужие сообщения пропадают молча

Проверка, ради которой всё затевалось. Напиши боту: «привет, что у меня на Рабочем столе?» В Telegram появится строка «печатает», а через несколько секунд список файлов с твоего компьютера. В окне на компьютере ты увидишь своё сообщение строкой ← telegram, но не текст ответа: ответ уходит в Telegram, в окне остаётся только отметка, что он отправлен

У меня самого в Telegram живёт такой бот-помощник: я пишу ему с телефона, а он запускает мои скиллы Claude Code на моём компьютере. Всё, что Claude умеет в окне, он делает и по сообщению из бота: читает и правит файлы, запускает скиллы, ищет в интернете

Когда Claude спрашивает разрешение, а ты не за компьютером

Здесь живёт самая частая ловушка. Ты ушёл от компьютера, Claude упёрся в вопрос «можно выполнить команду?» и стоит, пока ты не ответишь. Дополнение пересылает этот вопрос в Telegram сообщением «🔐 Permission: Bash» с тремя кнопками под ним. Bash здесь значит «выполнить команду на компьютере», вместо него бывает Write (создать файл) или Edit (изменить файл):

Вопрос висит и в окне на компьютере, и в Telegram: кто ответил первым, тот и решил. Код из 5 букв приходит вместе с запросом, в окне на компьютере его не видно

Одно окно в Telegram не приходит никогда: вопрос «доверяешь ли ты этой папке», который Claude Code задаёт при первом запуске в новой папке. Его подтверждают только на компьютере. Поэтому первый запуск с флагом делай, сидя за столом, и дальше запускай Claude из той же папки

Разрешение в Telegram может нажать любой, кто есть в твоём списке допущенных. Поэтому в список добавляй только себя. Бот для клиентов или друзей это другая задача, про неё ниже в развилках

Фото, файлы и чего бот не видит

Фото, отправленное боту, Claude видит: дополнение скачивает его в папку ~/.claude/channels/telegram/inbox/ и передаёт Claude путь к файлу. С остальными вложениями так:

Обратно Claude присылает файлы до 50 МБ, картинки приходят картинками

Чего бот не умеет: читать старые сообщения. Он видит только то, что пришло, пока окно было открыто. Если Claude нужен контекст из прошлого разговора, перешли ему кусок или перескажи

Чтобы бот отвечал, пока ты не за столом

Бот живёт, пока живёт окно. Закрыл окно, выключил компьютер или Mac ушёл в сон - бот молчит. Сообщение, отправленное в это время, лучше повторить, когда компьютер снова работает

На Mac сон от простоя отключает команда caffeinate -i: она держит компьютер бодрым, пока идёт команда, которую ей передали. Удобнее всего сделать ярлык на Рабочем столе. Создай в TextEdit простой текст с тремя строками и сохрани как Claude-v-Telegram.command:

#!/bin/zsh
cd ~
caffeinate -i claude --channels plugin:telegram@claude-plugins-official

Потом в Терминале один раз сделай файл запускаемым: chmod +x ~/Desktop/Claude-v-Telegram.command. Двойной щелчок откроет Терминал с Claude, который слушает бота. Строка cd ~ запускает Claude из домашней папки, поэтому ему видны и Рабочий стол, и Документы. Крышку ноутбука при этом не закрывай: с закрытой крышкой Mac обычно засыпает, и бот вместе с ним

Не запускай два окна с одним и тем же ботом. Telegram отдаёт сообщения бота только одному получателю, и второе окно начнёт спорить с первым. Нужны два разных помощника - сделай второго бота в BotFather

Готовый промпт: Claude проведёт по настройке сам

Вставь это в Claude Code целиком. Он сделает всё, что можно без тебя, а тебя позовёт только туда, где нужны твои руки: создать бота, нажать в Telegram, перезапустить окно

Подключи меня к моему Claude Code через Telegram: я пишу своему боту с телефона, а отвечаешь ты, здесь, на моём компьютере, со всеми моими файлами и скиллами. Работаем через официальный плагин Anthropic telegram@claude-plugins-official, на моей подписке Claude, API-ключ не нужен.

Правила: всё, что можешь сделать сам, делай сам. Меня зови только туда, где без меня нельзя: создать бота, нажать в Telegram, перезапустить окно. Каждое моё действие давай одной короткой инструкцией и жди, пока я сделаю.

Шаг 1. Проверь версию Claude Code (claude --version) и есть ли Bun (bun --version). Bun нет - поставь сам: на Mac и Linux curl -fsSL https://bun.sh/install | bash, на Windows powershell -c "irm bun.sh/install.ps1|iex". Проверь, что bun --version отвечает.

Шаг 2. Дай мне инструкцию создать бота: в Telegram открыть BotFather, отправить /newbot, придумать имя и адрес, который кончается на bot. Попроси прислать токен целиком, вместе с числом и двоеточием.

Шаг 3. Поставь плагин: claude plugin marketplace add anthropics/claude-plugins-official, потом claude plugin install telegram@claude-plugins-official. Запиши токен в файл ~/.claude/channels/telegram/.env одной строкой TELEGRAM_BOT_TOKEN=<токен>, закрой файл от чужих (chmod 600). Токен мне обратно не показывай.

Шаг 4. Сделай мне ярлык запуска на Рабочем столе для строки claude --channels plugin:telegram@claude-plugins-official (на Mac файл .command с cd ~ и caffeinate -i перед claude, на Windows файл .bat). ДО того как я перезапущу окно, одним сообщением напиши, что делать после: запустить ярлык, на вопрос о доверии к папке ответить да, написать боту, получить код из 6 символов, набрать /telegram:access pair <код>, потом /telegram:access policy allowlist.

Шаг 5. Коротко объясни 4 вещи: бот отвечает, пока компьютер включён и окно открыто; запросы разрешений приходят в Telegram кнопками; фото ты видишь, а оригинал без сжатия надо слать файлом; старые сообщения бот не видит.

Финальная проверка: я пишу боту «привет, что у меня на Рабочем столе?», ты отвечаешь в Telegram списком файлов.

Промпт работает в обычном окне Claude Code, ещё до перезапуска с флагом. Самое длинное место в нём твоё: создать бота и переслать токен. Остальное Claude делает за минуту-две

Если у тебя другой случай

Уже стоит приложение Claude на телефоне. Тогда Telegram не нужен: та же сессия на компьютере открывается прямо в приложении через Remote Control. Как включить, по шагам в статье Claude Code с телефона

Нужен бот для клиентов или подписчиков, а не для себя. Это дополнение сделано под одного хозяина: он запускает Claude с доступом к твоему компьютеру, давать такое чужим людям нельзя. Для бота, который отвечает другим, нужен платный ключ разработчика и своя программа, это в статье как подключить Claude API к боту

Хочешь просто поговорить с нейросетью в Telegram, без компьютера. Есть готовые боты, ставить ничего не надо. Какие живые и что в них бесплатно, сравнил в статье ИИ в Телеграме

Хочешь не одного помощника, а команду агентов с памятью и расписанием. Это другой инструмент, Hermes. Как собрать своего помощника с голосом и Telegram за девять шагов, разобрал в статье свой Джарвис на Hermes

Терминал ответил command not found: claude. Claude Code ещё не установлен. Как поставить его и оплатить подписку из России, есть в статье установка Claude Code

У тебя бесплатный план Claude или рабочий Team. На бесплатном плане Claude Code не открывается, нужен Pro или выше, тарифы сравнил в статье какой тариф Claude выбрать. На Team и Enterprise каналы выключены, пока владелец организации не включит их в настройках организации

У тебя Windows. Дополнение работает и там, Bun ставится командой из промпта выше. Вместо caffeinate в настройках питания Windows поставь, чтобы компьютер не засыпал, пока подключён к сети

Что ломается и что делать

Тексты ошибок ниже сняты с моего прогона на Mac, кроме трёх последних строк: их описывает сама Anthropic, ссылки в источниках

Источники

• Anthropic: каналы в Claude Code - шаги для Telegram, вход через claude.ai, пометка --channels вне справки, Team и Enterprise
• Anthropic: справочник каналов - пересылка запросов разрешений, код из 5 букв, доверие к папке только на компьютере
• Anthropic: дополнение telegram на GitHub - Bun, где лежит пароль бота, код привязки, фото, отсутствие истории
• Anthropic: доступ к боту, ACCESS.md - режимы pairing и allowlist, команды /telegram:access
• Anthropic: исходный код дополнения - кнопки разрешений, срок кода привязки, конфликт двух окон
• Telegram: возможности ботов - создание бота командой /newbot в BotFather и пароль бота
• Bun: установка - команды установки для Mac, Linux и Windows
• Anthropic: Remote Control - соседний способ управлять Claude Code с телефона через приложение Claude

Памятка: Claude Code в Telegram

Сохрани скриншотом, пригодится, когда через неделю захочешь что-то поменять в боте

Частые вопросы