Управление Claude Code
из Telegram

Claude Code требует три компонента: Node.js, Git и Bun.

Node.js

Node.js — это среда выполнения JavaScript, без неё Claude Code не запустится.

Перейти на nodejs.org/en/download и скачать LTS-версию (кнопка с надписью LTS — она стабильная и рекомендуется для большинства пользователей). Запустить установщик и пройти по шагам — всё можно оставить по умолчанию.

nodejs.org — скачать LTS-версию

После установки открыть терминал и проверить — ввести команду:

node --version

Должна появиться строка с номером версии, например v24.14.0. Если появилась — всё в порядке.

Терминал показывает версию Node.js

Git

Git — система контроля версий, нужна Claude Code для работы с проектами.

Перейти на git-scm.com/download/win — скачивание начнётся автоматически. Запустить установщик, всё оставить по умолчанию.

git-scm.com — скачивание начнётся автоматически

Проверка в терминале:

git --version

Появится строка вида git version 2.x.x — значит установлен.

Bun

Bun — быстрая среда для запуска TypeScript, нужна для работы Telegram-плагина.

Открыть терминал и ввести команду:

npm install -g bun

Установка Bun через npm

Проверка:

bun --version

Если выводится версия — готово. Если выдаёт ошибку «bun не найден» — закрыть терминал, открыть заново и повторить проверку.

В терминале выполнить:

npm install -g @anthropic-ai/claude-code

Установка Claude Code

Проверка:

claude --version

Авторизация

Первый запуск нужен для входа в аккаунт. В терминале ввести:

claude

Claude Code автоматически откроет браузер со страницей входа Anthropic. Войти в аккаунт (или создать новый), разрешить доступ — и вернуться обратно в терминал. Там появится приглашение к вводу.

Чтобы выйти из Claude Code — нажать Ctrl+C или написать /exit.

Создание бота через BotFather

BotFather — официальный бот Telegram для управления ботами.

1. Открыть Telegram, найти @BotFather (в поиске) и открыть диалог
2. Нажать Start или написать /start
3. Отправить команду:

   /newbot

4. BotFather спросит имя бота — отображаемое имя, которое увидят пользователи. Написать любое, например: My Claude Assistant
5. Затем спросит username — уникальный адрес бота, должен заканчиваться на bot. Например: my_claude_bot
6. BotFather вернёт токен — длинную строку вида:

   1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ

   Скопировать его и сохранить — понадобится на шаге 6.

BotFather — создание бота, ввод имени и username

BotFather выдаёт токен — скопировать и сохранить

Отключение Privacy Mode

По умолчанию бот в группе видит только команды (сообщения, начинающиеся с /). Чтобы бот получал все сообщения, нужно отключить Privacy Mode:

1. В диалоге с BotFather написать:

   /setprivacy

2. Выбрать своего бота из списка
3. Выбрать Disable

Отключение Privacy Mode — выбрать Disable

После этого бот будет получать все сообщения в группе.

Создание группы

1. В Telegram создать новую группу: нажать на иконку карандаша или New Message → New Group
2. Добавить бота по его username (например, @my_claude_bot)
3. Дать группе название и создать

Включение топиков (для форум-режима)

Топики — это отдельные ветки внутри группы. Каждый топик становится независимым чатом с Claude, что удобно для разделения по темам (здоровье, задачи, ресерч и т.д.).

Чтобы включить:

1. Открыть настройки группы (название вверху → три точки → Edit)
2. Найти переключатель Topics и включить его

Настройки группы — переключатель Topics

После включения в группе появится раздел General — это первый топик по умолчанию. Новые топики создаются кнопкой со значком карандаша.

Назначение бота администратором

Чтобы бот мог ставить реакции на сообщения, ему нужны права администратора:

1. Открыть настройки группы → Administrators → Add Administrator
2. Выбрать бота из списка участников
3. Права можно оставить по умолчанию — нажать Save

ID группы — числовой идентификатор чата. Он понадобится если нужно ограничить доступ к боту только этой группой.

Способ 1: через @myidbot (рекомендуется)

1. Добавить в группу бота @myidbot
2. Отправить в группу команду:

   /getgroupid@myidbot

3. Бот ответит ID группы — отрицательное число, например: -1001234567890
4. Сохранить это число, затем удалить @myidbot из группы

@myidbot — ответ с ID группы

Способ 2: через Telegram API

Открыть браузер и вставить в адресную строку (предварительно отправив любое сообщение в группу):

https://api.telegram.org/bot<ВАШ_ТОКЕН>/getUpdates

Заменить <ВАШ_ТОКЕН> на токен из шага 3. В ответе найти поле "chat" → "id" — это и есть ID группы.

Запустить Claude Code — в терминале ввести:

claude

Дождаться загрузки. Внутри сессии выполнить команду установки плагина:

/plugin install telegram@claude-plugins-official

Установка Telegram-плагина внутри Claude Code

После установки перезагрузить плагины:

/reload-plugins

Теперь передать боту токен из шага 3. Вставить команду ниже, заменив <ВАШ_ТОКЕН> на свой токен:

/telegram:configure <ВАШ_ТОКЕН>

Например:

/telegram:configure 1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ

Токен принят — плагин настроен

Токен сохранится в файл ~\.claude\channels\telegram\.env — вводить его заново при каждом запуске не нужно.

После установки плагин можно расширить дополнительными возможностями: поддержкой топиков (Forum Topics), контекстом реплаев, сохранением инлайн-ссылок и другим.

Все патчи описаны в файле telegram-plugin-patches.md — он идёт вместе с этим гайдом. Применять их вручную не нужно: достаточно открыть Claude Code в любой папке и сказать:

Claude Code сам найдёт файл плагина, прочитает инструкцию и внесёт все изменения.

Первый запуск с каналом

В терминале ввести:

claude --channels plugin:telegram@claude-plugins-official

Claude Code запущен с Telegram-плагином

Привязка аккаунта

Это нужно сделать один раз — чтобы Claude Code знал, что именно ваши сообщения являются командами.

1. Открыть Telegram и написать любое сообщение своему боту — можно в личку боту или в группу
2. Бот ответит кодом привязки, например: PAIR-XXXX
3. Вернуться в терминал и ввести команду с этим кодом:

   /telegram:access pair PAIR-XXXX

   (заменить PAIR-XXXX на реальный код)
4. Ограничить доступ — чтобы бот реагировал только на ваш аккаунт:

   /telegram:access policy allowlist

После этого бот будет игнорировать сообщения от других пользователей.

Базовый запуск

Каждый раз для работы с ботом открывать терминал и вводить:

claude --channels plugin:telegram@claude-plugins-official

Запуск через bat-файл (для удобства)

Чтобы не вводить длинную команду каждый раз, можно создать файл start.bat — двойной клик на него будет запускать Claude Code автоматически.

Создать в любой удобной папке файл start.bat и вставить в него:

@echo off
claude --channels plugin:telegram@claude-plugins-official

Если используется Патч 3 (сохранение вложений в папку проекта), добавить путь к папке. Вместо C:\Мой\Проект\inbox подставить свой путь:

@echo off
set TELEGRAM_INBOX_DIR=C:\Мой\Проект\inbox
claude --channels plugin:telegram@claude-plugins-official

Флаг --dangerously-skip-permissions

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

Флаг --dangerously-skip-permissions отключает все эти запросы — Claude выполняет действия автоматически, без остановок. Именно для этого сценария (фоновая работа через мессенджер) он и предназначен.

Полный вариант bat-файла с этим флагом:

@echo off
set TELEGRAM_INBOX_DIR=C:\Мой\Проект\inbox
claude --dangerously-skip-permissions --channels plugin:telegram@claude-plugins-official

Теперь достаточно дважды кликнуть на этот файл — терминал откроется и Claude Code запустится с нужными настройками.

bat-файл в папке проекта — двойной клик для запуска

Проверка работы

1. Отправить сообщение в группу (или в топик, если Topics включены)
2. Claude Code должен его получить и ответить
3. При правильно применённых патчах Claude будет видеть из какого топика пришло сообщение и отвечать туда же