Как подключить Claude Code к Telegram
Claude Code в Telegram через официальный плагин Channels: привязка бота, удалённые запросы разрешений, ограничения сессии и более безопасная настройка.
У Claude Code есть официальная интеграция с Telegram — Channels. Она хорошо подходит, когда нужно отправить задачу в уже запущенную сессию, получить ответ в Telegram и подтверждать обычные действия инструментов, не открывая ноутбук.
Главное ограничение простое: Claude Code работает не в Telegram. Работу по-прежнему выполняет процесс Claude Code на вашем компьютере или сервере, и этот процесс должен оставаться в сети.
Короткий ответ
Создайте приватного бота через BotFather в Telegram, установите в Claude Code официальный плагин Telegram, задайте токен, запустите Claude с включённым каналом и привяжите свой аккаунт Telegram. Ограничьте бота списком разрешённых пользователей, а не делайте его публичным.
Сейчас интеграция находится в статусе research preview. Прежде чем автоматизировать её на машине с чувствительными данными, сверьтесь с документацией Channels от Anthropic: команды и возможности могут меняться.
Что понадобится
- Актуальная версия Claude Code, авторизованная через поддерживаемый аккаунт Anthropic.
- Bun на хосте: официальный плагин канала работает на Bun.
- Аккаунт Telegram и токен бота от @BotFather.
- Терминал, который может оставаться открытым, или постоянная сессия, например
tmux.
Обращайтесь с токеном бота как с паролем. Не вставляйте его в репозиторий или в историю оболочки, которую видят другие пользователи, и не показывайте на скриншотах.
1. Создайте приватного Telegram-бота
Откройте BotFather в Telegram, отправьте /newbot и следуйте подсказкам. Имя
пользователя бота должно заканчиваться на bot. Сохраните токен во временном
месте, недоступном посторонним.
Для личной работы с кодом добавлять бота в группу незачем. С личными сообщениями и списком разрешённых пользователей гораздо проще понять, у кого есть доступ.
2. Установите официальный плагин
Установите плагин Telegram прямо в Claude Code:
/plugin install telegram@claude-plugins-official
Если маркетплейс ещё не зарегистрирован, добавьте его и повторите попытку:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
Используйте официальное имя маркетплейса, а не сторонний пакет с похожим названием.
3. Задайте токен бота
Выполните команду плагина в Claude Code:
/telegram:configure <BOT_TOKEN>
Плагин сохраняет токен в локальной конфигурации канала. Если токен засветился в логах или в чате, отзовите его через BotFather и задайте новый.
4. Запустите Claude Code с включённым Telegram
Выйдите из текущей сессии и запустите её снова с каналом:
claude --channels plugin:telegram@claude-plugins-official
Запускайте команду в репозитории, с которым должен работать Claude. На постоянно
включённом хосте делайте это в именованной сессии tmux, чтобы разрыв
SSH-соединения не завершил процесс:
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
tmux сохраняет процесс, но не мешает ноутбуку уснуть и не восстанавливает
упавшее сетевое соединение.
5. Привяжите аккаунт и ограничьте доступ
Отправьте боту сообщение — в ответ он пришлёт код привязки. В терминале Claude Code подтвердите этот код и оставьте доступ ограниченным:
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
Проверьте связку запросом, который ничего не меняет, — например, попросите Claude кратко описать текущую директорию. Прежде чем давать более широкий доступ к инструментам, убедитесь, что сообщение попало в нужную сессию.
Как сейчас работают запросы разрешений
В старых описаниях Channels часто говорится, что на каждый запрос разрешения нужно возвращаться в терминал. Это уже не так. Текущий официальный плагин для Telegram объявляет поддержку ретрансляции разрешений Claude Code и может отправлять поддерживаемые запросы инструментов в Telegram с кнопками Allow и Deny.
Но подтверждения без присмотра от этого не становятся безопасными. В маленькой карточке в чате может потеряться контекст, который был бы очевиден при просмотре диффа в терминале. Читайте команду и затрагиваемый путь, избегайте широких правил «всегда разрешать» и запускайте постоянно работающую сессию под аккаунтом с минимальными правами. Первичное подтверждение доверия к проекту, согласие на MCP и настройка плагина могут по-прежнему требовать работы в локальном терминале.
Ограничения, важные на практике
- Процесс на хосте должен продолжать работать. Если закрыть Claude Code, канал остановится.
- Telegram — это поток событий, а не хранилище сессии. Bot API доставляет новые обновления, но не даёт плагину полную историю с поиском.
- Ответ остаётся в Telegram. Терминал может показывать входящее событие и статус доставки, а не транскрипт, совпадающий с чатом.
- Это решение только для Claude. Плагин не даёт доступа к Codex и другим агентам.
- Это предварительная версия. Перепроверяйте официальную документацию после обновлений и не полагайтесь на недокументированное поведение.
Channels или Remote Control
Remote Control от Anthropic — отдельный вариант. Он позволяет управлять сессией на хосте из Claude в вебе или из приложения для iOS/Android. Файлы и инструменты остаются на хосте, а телефон служит удалённым интерфейсом.
Выбирайте Channels, если вам нужен именно Telegram или внешние события должны попадать в сессию. Выбирайте Remote Control, если нужен фирменный интерфейс Claude и более полное представление об активной сессии. Оба варианта всё равно зависят от процесса на хосте.
Когда имеет смысл другой удалённый слой
Для одной сессии Claude штатный плагин обычно самое простое решение. Другая схема становится актуальной, когда меняются требования: например, нужен полноценный терминал в браузере, несколько агентов для программирования или постоянно работающий VPS, которым управляют отдельно от ноутбука.
Chatcode — один из таких вариантов: он подключает сервер к терминалу в браузере и Telegram и может запускать Claude Code вместе с Codex, Gemini и OpenCode. При этом добавляются сторонний ретранслятор и ответственность за управление сервером, так что это не автоматическое улучшение. Практическая настройка и компромиссы разобраны в руководстве Claude Code в Telegram через Chatcode.
Часто задаваемые вопросы
Есть ли у Claude Code официальная интеграция с Telegram?
Да. В Claude Code Channels есть официальный плагин для Telegram. Он подключает Telegram-бота со списком разрешённых пользователей к сессии Claude Code, которая продолжает работать на вашем компьютере или сервере.
Можно ли подтверждать запросы разрешений Claude Code из Telegram?
Да. Текущая версия официального плагина для Telegram передаёт поддерживаемые запросы разрешений для инструментов в виде кнопок Allow и Deny. Первичное подтверждение доверия к проекту, согласие на плагин и часть локальной настройки по-прежнему требуют терминала.
Чем Channels отличается от Remote Control?
Channels позволяет Telegram или другому сервису отправлять события в запущенную сессию Claude Code. Remote Control открывает сессию через Claude в вебе или на телефоне. Оба варианта используют процесс Claude на хосте, но различаются интерфейсом и тем, что запускает работу.
Работает ли Telegram-бот, когда Claude Code закрыт?
Нет. Сервер канала работает вместе с сессией Claude Code. Если бот должен оставаться доступным, держите процесс запущенным в постоянном терминале или на постоянно включённом хосте.