Claude Code в Telegram: настройка Channels за 30 минут

Дополнительные инструкции по работе с инструментами собраны в документации Ailoot.

Что такое Claude Code Channels и для чего они нужны#

20 марта 2026 года Anthropic представила Claude Code Channels — официальный плагин для связи сессии Claude с мессенджерами. Поддерживаются Telegram, Discord и iMessage. Функция доступна в режиме research preview. Инструкции опубликованы в документации Anthropic, а исходный код плагинов — в официальном репозитории Anthropic на GitHub.

Проще говоря, Channels соединяет телефонный чат с запущенной сессией Claude Code. Например, можно попросить бота продолжить работу над файлом business/products/practicum/README.md и изменить даты следующего набора. Плагин передаст запрос Claude на VPS, сессия прочитает нужный контекст, внесёт правки и ответит в Telegram. Компьютер при этом может оставаться дома, если сессия работает на сервере.

⚠️ Основное ограничение режима research preview: Channels передаёт сообщения через MCP, поэтому сессия должна быть запущена на компьютере или VPS. Если закрыть сессию, новые сообщения не будут обработаны. Для работы 24/7 потребуется отдельно настроить сервер, как описано ниже.

Чем Channels отличается от других способов удалённой работы

В официальной документации Anthropic приведено сравнение инструментов. Ниже — его пересказ:

Channels и Remote Control работают по-разному. Remote Control показывает на телефоне удалённый терминал, в котором можно наблюдать за сессией и нажимать кнопки. Channels предоставляет чат-бота, который передаёт сообщения запущенной сессии Claude.

Если важно видеть происходящее на экране и контролировать каждый шаг, выбирайте Remote Control. Если удобнее отправить запрос и заняться другими делами до ответа, подойдут Channels. Эти варианты можно сочетать: Remote Control — для подтверждения важных изменений, Channels — для задач, которые можно поручить без постоянного наблюдения.

Что подготовить перед настройкой#

Перед началом проверьте, что всё необходимое готово:

1. Аккаунт Anthropic. Требуется подписка Pro, Max, Team или Enterprise. Бесплатный тариф не поддерживается. Anthropic Console API key также поддерживается. Если организация использует managed settings, проверьте разрешение channels в них.
2. Claude Code версии 2.1.80 или новее. Узнать установленную версию можно командой claude --version. Для обновления выполните claude update либо npm install -g @anthropic-ai/claude-code@latest.
3. Bun. Плагины Channels запускаются через Bun, а не Node. Проверьте установку командой bun --version. Если Bun ещё не установлен, выполните curl -fsSL https://bun.sh/install | bash, затем source ~/.bashrc.
4. Аккаунт Telegram. Подойдёт любой аккаунт, в который вы можете войти с телефона.
5. Для организаций Team и Enterprise: попросите администратора включить channelsEnabled в managed settings или на странице admin-settings/claude-code. По умолчанию эта возможность в организациях отключена.

Bun — альтернативная среда выполнения JavaScript, похожая на Node. Anthropic использует её для плагинов Channels. Достаточно установить её один раз.

⚠️ Channels пока не поддерживаются при входе через корпоративные версии Bedrock, Google Vertex или Azure Foundry. Используйте аутентификацию claude.ai либо Anthropic Console.

Шаг 1. Создайте Telegram-бота через BotFather#

Создание бота в BotFather занимает всего несколько шагов:

1. Откройте @BotFather в Telegram. Все действия можно выполнить и с телефона.
2. Если вы ещё не начинали с ним диалог, нажмите «Start».
3. Отправьте /newbot.
4. На вопрос «Alright, a new bot. How are we going to call it?» укажите отображаемое имя. Например: My Assistant - Claude Code.
5. Затем задайте username. Он должен быть уникальным в Telegram и обязательно оканчиваться на bot. Например, my_claude_code_bot или my_dev_helper_bot.
6. BotFather пришлёт ответ примерно такого вида:

Done! Congratulations on your new bot. You will find it at
'<OFFICIAL_URL>'.

Use this token to access the HTTP API:
1234567890:AAHzlAU...

Keep your token secure and store it safely, it can be used by anyone to control your bot.

Сохраните токен: он понадобится на следующем шаге.

⚠️ Защитите токен. Он даёт полный контроль над ботом. Если токен попадёт к посторонним, они смогут писать от имени бота и, возможно, получать сообщения, предназначенные для Claude. Не добавляйте его в репозитории или исходный код и не пересылайте в чаты. На следующем шаге плагин может сохранить токен в ~/.claude/channels/telegram/.env.

Шаг 2. Установите плагин Telegram в Claude Code#

Откройте терминал в рабочей папке и запустите Claude Code:

claude

В открывшейся сессии установите плагин:

/plugin install telegram@claude-plugins-official

Если появится ответ «Plugin not found in any marketplace», добавьте официальный маркетплейс:

/plugin marketplace add anthropics/claude-plugins-official

Если маркетплейс уже подключали, можно обновить его:

/plugin marketplace update claude-plugins-official

После установки перезагрузите плагины, чтобы активировать новые команды:

/reload-plugins

Теперь доступны команды /telegram:configure, /telegram:access и другие. Чтобы проверить установку, выполните /help и найдите в списке раздел telegram.

Шаг 3. Передайте токен плагину#

В сессии Claude укажите токен в команде:

/telegram:configure 1234567890:AAHzlAU...

Команда запишет токен в ~/.claude/channels/telegram/.env. Файл доступен только вашему пользователю (chmod 600).

Можно также задать токен в переменной окружения. Этот способ подходит для запуска Claude через systemd или Docker, когда интерактивная команда неудобна:

export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official

При запуске на сервере переменную окружения можно указать в конфигурации systemd через Environment=TELEGRAM_BOT_TOKEN=.... Так секретом проще управлять, и меньше риск случайно включить ~/.claude/ в репозиторий.

Шаг 4. Перезапустите Claude с флагом --channels#

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

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

Если запускать без флага, Claude будет работать как обычно, а Telegram-плагин останется неактивным. С флагом Claude запустит MCP-сервер плагина, начнёт опрашивать Telegram API и обрабатывать сообщения боту.

В терминале может появиться сообщение примерно такого вида:

✻ Welcome to Claude Code 2.1.80
  Channels: telegram@claude-plugins-official (active)
  Polling for messages...

Если строки Channels нет, параметр не применился. Убедитесь, что версия Claude Code не ниже 2.1.80 и плагин установлен. Список плагинов можно посмотреть командой /plugin list внутри сессии.

⚠️ Чтобы упростить запуск, добавьте в ~/.zshrc алиас:

alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"

После этого достаточно запускать claude-tg. Через пробел можно указать несколько плагинов: --channels plugin:telegram@... plugin:discord@....

Шаг 5. Свяжите аккаунт и ограничьте доступ#

Разрешённый отправитель может просить Claude действовать над доступными файлами и инструментами. Сопрягайте только нужный аккаунт и ограничивайте отправителей до доверия боту.

Выполните следующие действия:

1. Откройте бота в Telegram. Найдите его по username @my_claude_code_bot или перейдите по ссылке, которую прислал BotFather. Нажмите «Start».
2. Отправьте любое сообщение, например hi.
3. Дождитесь кода сопряжения. Ответ будет похож на этот:

Hi! To pair this account, run in your Claude Code session:
/telegram:access pair 847291

This code is valid for 5 minutes.

4. Вернитесь в терминал. В сессии Claude выполните указанную команду:

/telegram:access pair 847291

Claude сообщит «Account paired». Теперь сообщения вашего аккаунта можно передавать в сессию.

5. Включите политику allowlist, чтобы разрешить доступ только сопряжённым аккаунтам:

/telegram:access policy allowlist

После этого сообщения от остальных аккаунтов будут игнорироваться без ответа. В терминале они тоже не появятся.

Не подтверждайте незнакомые pairing-запросы во время настройки. Успешный ответ не доказывает правильность политики отправителей.

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

/telegram:access pair <код от их аккаунта>

Пусть этот человек сначала напишет боту, получит код и передаст его вам. Затем выполните команду сопряжения.

Как выполняется для Claude Code установка на сервер и круглосуточный запуск?#

Если нужно, чтобы бот оставался доступен постоянно, сессия должна непрерывно работать. Локально можно использовать tmux, но для постоянной доступности удобнее разместить её на VPS.

В качестве одного из вариантов можно взять VPS, где уже размещён сайт, например сервер с Coolify. Claude Code запускается в его рабочем каталоге; для другого проекта используйте подходящий сервер. Если VPS ещё нет, сравните доступные тарифы и выберите подходящий для ваших задач. В числе провайдеров есть Hetzner, Yandex Cloud и Selectel.

Шаг 1: установите нужные компоненты на VPS

Сначала администратором создайте отдельную Unix-учётную запись и рабочую папку. Существующую используйте только после проверки HOME и владельца:

sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude

Продолжайте в login shell этого пользователя claude, а не в HOME root. Установите Bun официальным установщиком и Claude Code по нативной инструкции:

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

Откройте свежую login shell того же пользователя для обновлённого PATH и проверьте:

whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude

whoami должен показать claude, HOME — /home/claude. Запишите абсолютные пути command -v: настоящий путь Claude нужен ExecStart, каталог Bun — PATH службы. Если программы нет, остановитесь.

Шаг2: авторизация, установка и pairing от пользователя службы

В той же интерактивной сессии claude завершите вход и повторите шаги2–5 выше от этого Unix-пользователя: установите Telegram-плагин в пользовательской области, задайте токен, перезапустите с --channels, выполните pairing своего Telegram и policy allowlist. До службы проверьте настоящий ответ бота. Не копируйте конфигурацию и ключи root в этот HOME.

Поддерживаются вход подпиской claude.ai и Anthropic Console API key. Team/Enterprise требуют включения организацией; управляемая Console-организация также должна разрешать channels в настройках. Console оплачивается по API отдельно от подписки claude.ai. При переходе в службу сохраняйте тот же аккаунт и способ авторизации.

Шаг 3: настройте systemd для автоматического запуска

Выйдите из shell пользователя службы и создайте unit администратором. Пример предполагает найденные пути /home/claude/.local/bin/claude и /home/claude/.bun/bin/bun: замените их настоящими command -v при отличии. Передайте тот же выбранный контекст авторизации и токен, ограничьте чтение unit администратором и не коммитьте секреты.

cat > /etc/systemd/system/claude-code.service <<'EOF'
[Unit]
Description=Claude Code with Telegram channel
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=claude
WorkingDirectory=/home/claude/workspace
Environment="HOME=/home/claude"
Environment="TELEGRAM_BOT_TOKEN=1234567890:AAH..."
Environment="PATH=/home/claude/.local/bin:/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/claude/.local/bin/claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable claude-code
systemctl start claude-code

В этом примере заданы следующие параметры:

• Type=simple — systemd считает процесс запущенным сразу после старта.
• User=claude — Claude работает от отдельного пользователя, а не от root.
• WorkingDirectory=/home/claude/workspace — подготовленная папка пользователя службы. До старта поместите нужный репозиторий туда; не оставляйте владельцем root и не запускайте из HOME root.
• Environment=TELEGRAM_BOT_TOKEN=... — переменная с токеном передаётся процессу; отдельный файл .env не обязателен.
• --dangerously-skip-permissions — отключает запросы подтверждения. Без этого флага Claude будет ждать ответа в терминале на действия, требующие разрешения, и автоматическая сессия может остановиться. Allowlist определяет отправителя, но не безопасность его команд. Bypass используйте только в изолированной среде с намеренно ограниченными файлами, ключами и сетью.
• Restart=on-failure — если процесс завершится с ошибкой, systemd попробует запустить его через 10 секунд.

Просматривать журнал работы можно так:

journalctl -u claude-code -f

Если возникла проблема, последние 100 строк покажет команда journalctl -u claude-code -n 100.

Шаг 4: убедитесь, что бот отвечает

Запускайте службу после настоящего ответа интерактивной настройки. Отправьте тому же боту безвредное сообщение от сопряжённого аккаунта и проверьте ответ и журналы. При отличии systemd от ручного запуска сначала сравните Unix-пользователя, HOME, папку, путь Claude, PATH и авторизацию.

Для нового pairing остановите службу, выполните sudo -iu claude, перейдите в /home/claude/workspace и запустите тот же channel интерактивно. Выполните pairing и allowlist, выйдите и включите службу. Не запускайте два poller одного бота одновременно. journalctl только читает журналы и не является интерактивным запросом Claude.

Пять распространённых проблем на сервере и способы их решить#

1. Bun не находится в PATH у systemd

systemd не читает shell-настройки пользователя. Если Bun установлен только в HOME root, а User=claude, служба не наследует эту установку или PATH оболочки root.

Как исправить. Установите Bun в общий каталог, например /usr/local/bin/bun, либо задайте PATH в service-файле явно:

Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"

2. После длительного простоя пропадает соединение с Telegram API

Иногда после 6–12 часов работы бот перестаёт получать сообщения, хотя они отправляются в Telegram. Такое поведение может быть связано с long polling.

Как исправить. Можно настроить systemd на периодический перезапуск, например через 24 часа:

Restart=always
RuntimeMaxSec=86400

Другой вариант — задать cron-задачу 0 5 * * * systemctl restart claude-code, которая перезапускает сервис в 5 утра.

3. Лимиты Claude Max исчерпываются в течение дня

Интенсивная работа через Telegram расходует тот же бюджет, что и запросы из обычного терминала. На тарифе Max 5x (~$100/мес) лимит может закончиться за 4–6 часов, если часто отправлять запросы.

Как исправить. Если бот перестал отвечать, проверьте /stats и состояние лимита. При необходимости дождитесь его сброса или рассмотрите переход на Max 20x ($200/мес).

4. --dangerously-skip-permissions повышает риск ошибочных действий

Этот флаг отключает подтверждения, и команды из Telegram могут выполняться без дополнительного вопроса. В результате можно случайно удалить файлы, отправить запросы во внешние системы или внести нежелательные изменения.

Как исправить. Не включайте --dangerously-skip-permissions для критичного проекта. Используйте Remote Control, если нужно видеть предлагаемые действия и подтверждать их вручную. Режим с отключёнными подтверждениями оставляйте для задач, где допустима автономная работа, например для черновиков, тестов и части рефакторинга.

5. После переустановки перестаёт работать allowlist

Настройки allowlist находятся в ~/.claude/channels/telegram/. После перехода на новый VPS, переустановки Claude или смены пользователя прежние данные сопряжения могут не перенестись. В таком случае заново проверьте настройки доступа и сопряжение аккаунтов.

Как исправить. Перед миграцией сохраните каталог ~/.claude/channels/telegram/ в резервную копию и перенесите его на новый сервер. Либо после переустановки выполните сопряжение заново и сразу включите policy allowlist.

Channels или Remote Control: что выбрать#

Anthropic представила Remote Control 25 февраля 2026 года, а Channels — 20 марта 2026 года. Эти функции решают разные задачи.

Channels удобны для асинхронных задач, уведомлений CI и интеграций. Remote Control подходит, когда нужно наблюдать за работой Claude или подтверждать потенциально опасное действие.

Оба способа можно использовать одновременно: Telegram-бот — для быстрых запросов с телефона, Remote Control — для контроля важных шагов. Лимиты Claude при этом общие.

Часто задаваемые вопросы#

Можно ли одновременно подключить несколько ботов?

Да. После --channels можно перечислить несколько плагинов через пробел: --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Одна сессия Claude сможет отвечать в обоих чатах.

Что произойдёт, если закрыть терминал?

Сессия завершится и плагин перестанет работать. На VPS процесс может продолжить работу под управлением systemd. На локальном компьютере закрытие терминала или выключение устройства прервёт сессию; при закрытии процесса терминалом она может получить SIGHUP.

Можно ли передавать события из CI или Sentry?

Да. Channels поддерживает двустороннюю передачу сообщений. По инструкции из справочника Channels можно написать плагин, который направляет webhook в сессию. Claude сможет получать события и реагировать на них.

Есть ли у Telegram ограничения по сравнению с Discord?

Основные возможности схожи. Для Discord требуется включить Message Content Intent в настройках бота. iMessage работает только на macOS и напрямую читает базу ~/Library/Messages/chat.db. Telegram можно использовать с разных поддерживаемых систем.

Что нужно сделать для Team-плана?

Администратору организации нужно включить channelsEnabled: true в managed settings или через страницу admin-settings/claude-code. Без этого плагин может подключиться, но не будет передавать сообщения; в терминале появится предупреждение при запуске.

Получает ли Claude доступ к переписке в Telegram и данным телефона?

Нет. Claude получает только сообщения, которые вы отправляете боту. История других чатов, контакты и прочие данные телефона недоступны. MCP-плагин читает сообщения, адресованные боту, через Telegram Bot API.

Можно ли пользоваться Channels без подписки Pro или Max?

Да. Anthropic Console API key поддерживается и оплачивается этой Console-организацией. Бесплатный claude.ai не является описанным подписочным путём. Team/Enterprise и управляемые Console должны разрешать channels.

Что делать после настройки#

Когда бот стабильно отвечает, можно расширить его применение несколькими способами:

1. Добавьте webhook из CI. В GitHub Actions или GitLab CI можно настроить передачу результата сборки в сессию через Channels. Тогда Claude получит сообщение вроде «test failed» после отправки изменений и сможет предложить, что проверить. Инструкции есть в справочнике Channels.
2. Используйте Routines. На той же сессии можно настроить Routines для повторяющихся задач. Например, бот присылает утреннюю сводку по проекту, а вы просите с телефона подготовить отчёт по выручке.
3. Настройте мониторинг бота. Небольшой cron-скрипт на VPS может проверять доступность Telegram-бота раз в час и отправлять уведомление в отдельный канал, если бот не отвечает. Так можно быстрее заметить ночной сбой.
4. Рассмотрите хуки. Хуки запускаются в ответ на события Claude, например начало работы инструмента или завершение сообщения. В сочетании с Channels они могут отправлять в Telegram уведомления о завершении задачи.

Channels удобен, чтобы отправить запрос по пути и вернуться к ответу позже. Для работы, в которой нужно внимательно следить за действиями Claude, откройте ноутбук и используйте сессию напрямую.