Содержание
Claude Code Telegram: как подключить управление
Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.
Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 16 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.
Claude Code Telegram: как подключить управление — через официальный плагин telegram@claude-plugins-official из репозитория Anthropic. Плагин ставит MCP-сервер, который логинится в Telegram как бот и пересылает ваши сообщения в текущую сессию Claude Code. Собственный прогон по запросу «Claude Code Telegram: как подключить управление» показал: текст отдали 6 из 10 страниц выдачи, медиана объёма читаемого текста — 1328 слов, метку 2026 года несут 6 из 6 прочитанных страниц. Мы скачали подборку результатов веб-поиска по запросу «Claude Code Telegram: как подключить управление»: текст отдали 6 из 10.
Документированный канал и сторонний мост
В выдаче по запросу «claude code telegram» соседствуют два разных пути. Первый — официальный плагин: в каталоге Anthropic он описан как «Telegram messaging bridge with built-in access control», то есть мост с встроенным контролем доступа, где парами, списками разрешённых и политикой управляет команда /telegram:access. Второй — сторонний проект overwirehq/claude-code-telegram: по его README это «A Telegram bot that gives you remote access to Claude Code», бот для удалённого доступа с разговорным интерфейсом к вашей кодовой базе.
Выбор зависит от задачи. Нужен минимальный документированный путь с контролем доступа от вендора — берите плагин. Нужны вебхуки, планировщик задач, режим терминала с навигацией по каталогам — смотрите на мост. Оба варианта требуют, чтобы Claude Code уже работал на вашей машине: в README плагина прямо сказано, что команды установки — это команды Claude Code, и перед ними нужно запустить сессию.
Claude Code и Telegram-бот на API Claude
Путаница между двумя сценариями — самая частая причина, по которой подключение не работает. Разведём их по существу.
Бот на API Claude — самостоятельное приложение. Вы получаете ключ API, пишете обработчик сообщений, вызываете модель, возвращаете ответ. Такой бот не знает о вашем проекте, не видит файлов и не выполняет команд. Он отвечает текстом.
Практическое следствие: бот на API живёт на сервере и доступен всегда, а канал к Claude Code живёт ровно столько, сколько идёт сессия. В README плагина это описано прямо: если бот не отвечает, проверьте, что сессия запущена с флагом —channels. Закрыли сессию — канал замолчал.
Второе следствие — доступы. У бота на API один секрет: ключ. У канала к Claude Code секретов два: токен бота и права сессии на вашей машине. Поэтому контроль доступа здесь не опция, а часть установки. В каталоге Anthropic контроль доступа заявлен как встроенная функция моста, а README описывает переход от режима pairing к списку разрешённых после первой привязки.
Подготовка бота и доступов
Дальше среда. MCP-сервер работает на Bun, и README приводит команду установки через curl. Это отдельная зависимость от самого Claude Code — проверьте её до установки плагина, иначе сервер не стартует.
Затем плагин. В сессии Claude Code выполняется установка из официального маркетплейса, после чего токен прописывается командой configure. README уточняет, куда именно ложится значение: в файл ~/.claude/channels/telegram/.env в виде переменной TELEGRAM_BOT_TOKEN. Тот же файл можно создать руками, а переменную можно задать в окружении оболочки — README отмечает, что приоритет у окружения.
Для нескольких ботов на одной машине README предлагает развести состояние: переменная TELEGRAM_STATE_DIR указывает на отдельный каталог для каждого экземпляра, со своим токеном и своим списком разрешённых.
Сторонний мост готовится иначе. Его README перечисляет два требования: Claude Code CLI и токен бота от @BotFather. Установка идёт через uv или pip из тегированного релиза, для разработки — клонированием репозитория и make dev с Poetry. Конфигурация — копия .env.example в .env, где заполняются токен, username бота, разрешённый каталог и список пользователей. Запуск — make run или make run-debug.
| Шаг | Официальный плагин | Сторонний мост |
|---|---|---|
| Бот | @BotFather, /newbot | @BotFather, /newbot |
| Среда | Bun | Claude Code CLI |
| Установка | /plugin install telegram@claude-plugins-official | uv или pip из тега |
| Токен | /telegram:configure, файл .env канала | .env в каталоге проекта |
| Запуск | сессия с —channels | make run |
Локальный проект и токены
Токен бота — это ключ к вашему каналу. В официальном плагине он ложится в файл внутри домашнего каталога Claude Code, и README допускает два способа: записать файл командой configure или создать его вручную. Переменная окружения имеет приоритет над файлом — это удобно, когда вы не хотите держать значение на диске.
Правило простое: токен остаётся на машине, где идёт сессия. Он не публикуется в репозитории, не попадает в скриншоты и не пересылается в чаты. Если токен утёк, BotFather позволяет его отозвать и выпустить новый — после этого значение в конфигурации нужно заменить.
Второй слой — доступ к проекту. У стороннего моста в .env есть параметр APPROVED_DIRECTORY: каталог, за пределы которого бот не выходит. Это ограничение на уровне приложения. У официального плагина границы задаёт сама сессия Claude Code: ассистент работает в том каталоге, откуда вы её запустили, и с теми правами, которые у вас есть.
Третий слой — пользователи. У моста список ALLOWED_USERS перечисляет Telegram user ID, которым разрешено писать. Свой ID README советует получить у @userinfobot. У плагина ту же роль играет политика доступа: по умолчанию действует pairing, а после привязки README рекомендует переключиться на allowlist, чтобы посторонние не получали ответы с кодами привязки.
Частая ошибка — оставить политику pairing на постоянной основе. Pairing нужен, чтобы захватить ID, и после первой привязки его задача выполнена. Переключение на список разрешённых закрывает канал для всех, кого вы не внесли.
Ограничение отправителя и действий
Контроль доступа в официальном плагине собран в одной команде: /telegram:access. Через неё управляют парами, списками разрешённых и политикой. README ссылается на отдельный документ ACCESS.md, где описаны политики личных сообщений, группы, определение упоминаний, настройки доставки, командные скиллы и схема access.json.
Что именно доступно ассистенту в Telegram, README перечисляет по инструментам. reply отправляет сообщение в чат: принимает chat_id и текст, опционально reply_to для ветвления и файлы по абсолютным путям; изображения уходят как фото с превью, остальные типы — как документы, с ограничением 50 МБ на файл, текст разбивается на части автоматически. react ставит реакцию из фиксированного списка эмодзи Telegram. edit_message правит сообщение, которое бот отправил ранее, — это удобно для обновлений вида «в работе» → результат.
Входящие сообщения включают индикатор набора: Telegram показывает, что бот печатает, пока ассистент готовит ответ. Входящие фото скачиваются в каталог inbox внутри канала, и локальный путь попадает в уведомление, чтобы ассистент мог прочитать файл. README предупреждает: Telegram сжимает фото, и если нужен оригинал, отправляйте файлом.
Набор действий ограничивается не только инструментами канала. Ассистент в сессии сохраняет обычные возможности Claude Code — чтение и правка файлов, запуск команд. Поэтому разумный минимум: отдельный бот под личные сообщения, список разрешённых вместо открытого pairing, каталог проекта, за который ассистент не выходит.
У стороннего моста та же логика выражена параметрами: список пользователей, разрешённый каталог, аутентификация, песочница каталога и журнал аудита — всё это перечислено в его README как встроенные средства безопасности. Дополнительно мост даёт команду /verbose с тремя уровнями: 0 — только финальный ответ, 1 — имена инструментов и короткие пояснения, 2 — имена с входными данными и более длинные рассуждения.
Проверка сообщения и результата
Запустите Claude Code командой claude --channels plugin:telegram@claude-plugins-official и напишите боту в личку. По README плагина бот возвращает код из 6 символов. В локальной сессии Claude Code выполните /telegram:access pair <code>, подставив полученный код. Затем переключите политику командой /telegram:access policy allowlist. Следующее личное сообщение боту поступит ассистенту. При отсутствии кода проверьте запуск с флагом --channels.
Дальше — короткая проверка результата. Отправьте запрос, который заведомо опирается на ваш проект: попросите перечислить файлы в каталоге или объяснить назначение одного модуля. Ответ придёт в чат, а в сессии будет видна работа с файлами. Так вы убедитесь, что канал ведёт именно в вашу сессию.
У стороннего моста проверка выглядит похоже, но с командами. README показывает диалог: вопрос о файлах проекта, ответ с описанием структуры, затем просьба добавить декоратор повторов в HTTP-клиент — бот читает файл, предлагает правку, запускает тесты и показывает результат. Команда /status показывает состояние, /new начинает сессию заново, /repo переключает каталог с автоматическим возобновлением сессии.
Границы сессии, подтверждения и диагностика
Подтверждения действий проверяйте в локальном терминале Claude Code. В инструкции Incrypted после привязки показан запрос разрешения от Claude Code, а при первом сообщении терминал спрашивает, стоит ли отвечать в Telegram. Завершите эти подтверждения в локальной сессии и проверьте доставку ответа. Входящее сообщение в Telegram само по себе подтверждением действия с файлами проекта не является.
Диагностика доставки строится на трёх проверках. Первая — сессия: запущена ли она с каналом. Вторая — конфигурация: на месте ли токен и не перекрыт ли он окружением. Третья — доступ: проходит ли ваш ID политику. У моста добавляется четвёртая — процесс: запущен ли он и что пишет в лог, который включается флагом отладки.
Уровни подробности у моста помогают и в диагностике: на уровне 1 видно, какие инструменты вызываются, на уровне 2 — с какими входными данными. Это отвечает на вопрос, дошло ли сообщение до ассистента и что он с ним делает.
Отдельная тема — несколько проектов. У плагина README предлагает разводить состояние через отдельный каталог на каждый экземпляр, со своим токеном и своим списком разрешённых. У моста переключение идёт командой /repo, а сессии возобновляются автоматически. В обоих случаях один бот обслуживает один понятный контур — так проще рассуждать о доступах.
Готовый промпт для первого запроса
Промпт, чтобы проверить канал и получить отчёт о проекте одним сообщением:
Ты работаешь в моём проекте через Telegram. Сделай три вещи и ответь одним сообщением: 1) перечисли файлы в корне проекта и назови назначение каждого в одну строку; 2) найди файл, отвечающий за [ваша тема], и объясни его роль; 3) предложи одну небольшую правку в этом файле, но не применяй её — сначала покажи diff. Пиши кратко, без вступлений.
Что менять под себя: подставьте свою тему вместо [ваша тема] и свой каталог, если проект лежит не в корне. Если ответ пришёл с описанием файлов, канал работает.
Вариации той же задачи:
Проверь канал: покажи текущий каталог, ветку git и список изменённых файлов. Ничего не меняй.
Найди в проекте все места, где обрабатываются ошибки в [ваш модуль], и перечисли их с номерами строк. Правки не вноси.
Запусти тесты проекта и пришли краткий итог: сколько прошло, сколько упало, какие имена у упавших. Полный вывод не нужен.
Предложи план из трёх шагов по [ваша задача] и жди моего подтверждения перед каждым шагом.
Сделай ревью последнего коммита: что изменилось, какие риски видишь, что стоит поправить. Изменения не применяй.
Частые вопросы
Как подключить Claude Code к Telegram?
Через официальный плагин telegram@claude-plugins-official: запустите сессию Claude Code, установите плагин, создайте бота у @BotFather, пропустите токен через команду configure и запустите сессию с флагом —channels. Альтернатива — сторонний мост overwirehq/claude-code-telegram, который ставится отдельно и настраивается файлом .env.
Claude Code в телеграм — это бот на API Claude?
Это канал к вашей работающей сессии Claude Code. Сообщение пересылается в сессию, и ассистент работает с проектом и правами этой сессии. Бот на API Claude — отдельное приложение, которое вызывает модель напрямую и о вашем проекте ничего не знает.
Почему бот не отвечает на сообщения?
Проверьте три вещи: запущена ли сессия с флагом —channels, записан ли токен туда, куда его ждёт сервер, и проходит ли ваш Telegram ID политику доступа. У стороннего моста добавьте проверку, что процесс запущен и пишет в лог.
Можно ли управлять несколькими проектами?
Да. У официального плагина README предлагает задать отдельный каталог состояния для каждого экземпляра через переменную TELEGRAM_STATE_DIR — со своим токеном и списком разрешённых. У стороннего моста переключение идёт командой /repo, а сессии возобновляются автоматически.
Видит ли бот историю переписки?
Нет. Telegram Bot API не отдаёт историю и поиск: бот видит сообщения в момент прихода, а фото скачиваются сразу, потому что позже их не забрать. Если ассистенту нужен ранний контекст, он попросит вставить текст или пересказать.
Полезное рядом: Claude Code в Visual Studio, обучение Claude AI, Cline и Claude.