Настройка каналов Claude Code с Telegram

Что такое каналы

Канал это MCP-сервер. Он передаёт события в сессию Claude Code, которая уже работает. Связь может быть двусторонней. Claude читает сообщение, работает и отвечает в тот же чат. В документации Anthropic в research preview перечислены Telegram, Discord и iMessage (code.claude.com/docs/en/channels, октябрь 2026 года).

Это не то же самое, что Remote Control. Remote Control позволяет управлять сессией из приложения Claude. Каналы приносят сообщения с других платформ, а ещё webhooks, например об упавшем прогоне CI.

Требования

• Claude Code с входом через аккаунт claude.ai или API-ключ Console. Каналы не работают на Amazon Bedrock, Google Cloud и Microsoft Foundry.
• На тарифах Team и Enterprise администратор должен сначала включить каналы. Пользователи Pro и Max без организации могут пользоваться ими сразу. В документации также сказано, что доступ открывают постепенно.
• Bun. Плагины каналов это скрипты на Bun.
• Токен бота Telegram от BotFather, для канала Telegram.

Установка компонентов

Установите Claude Code и Bun их официальными скриптами.

curl -fsSL https://claude.ai/install.sh | bash
curl -fsSL https://bun.com/install | bash

В Telegram откройте BotFather и отправьте команду newbot. Выберите имя и username, который заканчивается на bot. Скопируйте токен из ответа. Затем установите плагин. Внутри Claude Code это слэш-команда.

/plugin install telegram@claude-plugins-official

Из обычной оболочки то же самое делает CLI плагинов. Если маркетплейса нет, сначала добавьте его.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install telegram@claude-plugins-official

Мы запустили эти команды на машине macOS 26 от GitHub 2 октября 2026 года, без входа в аккаунт. Установка сработала. Вот что она вывела.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Подключите бота и привяжите аккаунт

Внутри Claude Code сохраните токен. Он хранится в папке telegram в разделе channels вашей папки конфигурации Claude.

/telegram:configure <token>

Затем выйдите и снова запустите Claude Code из оболочки с флагом канала.

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

Отправьте боту любое сообщение. Он ответит кодом привязки. Одобрите код в Claude Code, а затем закройте бота для всех, кроме вашего аккаунта.

/telegram:access pair <code>
/telegram:access policy allowlist

Здесь людей путают две вещи. Во время preview флаг канала не показывается в справке, но работает. А терминал показывает входящее сообщение и пометку об отправке, но не текст ответа. Ответ появляется в Telegram.

Discord вместо Telegram

Шаги для Discord устроены так же. Создайте приложение в Discord Developer Portal и скопируйте токен бота. Включите Message Content Intent. Пригласите бота на свой сервер с правами на просмотр каналов, отправку сообщений и чтение истории. Затем установите, настройте и привяжите так же. Строка перезапуска выполняется в оболочке. Остальные строки выполняются внутри Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Флагу channels можно передать несколько плагинов через пробел. Тогда одна сессия будет слушать оба приложения.

Держите сессию открытой круглосуточно

События доходят только до открытой сессии. Закроете терминал, дадите Mac уснуть или перезагрузите его, и бот замолчит. Это решают три вещи. Отключите сон. Запускайте Claude Code внутри tmux. Запускайте эту сессию tmux при входе в систему.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Этот LaunchAgent запускает сессию tmux с именем channels, где работают Claude Code и канал Telegram. Он проверяет её каждую минуту и ничего не делает, если сессия уже есть. Сохраните его как dev.local.claude-channels.plist в папке LaunchAgents.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Если tmux ещё не установлен, сначала поставьте его. Затем загрузите агент и подключитесь, чтобы проверить Claude.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Мы проверили именно этот файл на машине macOS 26 от GitHub 2 октября 2026 года. Через двадцать секунд после загрузки launchd создал сессию в домашней папке, и внутри ждал Claude Code.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

Сессия стартует в домашней папке. Если хотите, чтобы Claude начинал в проекте, подставьте путь к нему вместо переменной домашней папки. В первый раз подключитесь, ответьте на вопросы первого запуска и войдите в аккаунт.

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

Безопасность

• У каждого канала есть allowlist отправителей. Сообщения от всех остальных молча отбрасываются.
• Любой из allowlist может управлять вашей сессией. Если плагин пересылает запросы разрешений, такие люди могут ещё и одобрять использование инструментов. Добавляйте только тех, кому доверяете свою машину.
• Токен бота это пароль. Если он утёк, отзовите его в BotFather и настройте новый.
• iMessage читает базу данных Сообщений и требует полного доступа к диску. На арендованном Mac это означает вход с вашим Apple ID в Сообщения на чужом железе. С Telegram или Discord этого нет.

Запуск на Mac от MacRun

На нашем тарифе «Агент» Claude Code уже установлен. Вы входите в него со своей подпиской Claude. Mac никогда не засыпает, а его сессия переживает перезагрузки. Вы добавляете Bun и плагин, это занимает несколько минут. После этого ноутбук можно закрыть, а бот всё равно будет отвечать.

Кому это не нужно. Если вы просто хотите управлять сессией с телефона, Remote Control в приложении Claude делает это без бота. А если администратор вашего тарифа Team не включил каналы, новый Mac этого не изменит.

Общую картину смотрите в руководстве о том, как запустить Claude Code 24/7 на Mac.