Как повторить
- Этот шаг только для аккаунтов Team и Enterprise: попросите администратора включить функцию через настройку
channelsEnabled. Без этого плагин установится, но сообщения доходить не будут. На личных Pro и Max функция доступна сразу, шаг пропустите. - Установите Bun:
curl -fsSL https://bun.sh/install | bash. Плагины channels собраны как Bun-скрипты. - В запущенной сессии Claude Code выполните
/plugin install telegram@claude-plugins-official. Когда спросят область установки (scope), выберите user, тогда плагин будет доступен во всех проектах. - В Telegram откройте @BotFather и отправьте
/newbot. Придумайте имя и username, который заканчивается наbot, скопируйте токен. - Сохраните токен командой
/telegram:configure <токен>. Он запишется в~/.claude/channels/telegram/.env. - После установки плагина выйдите из сессии и запустите её заново именно с этим флагом:
claude --channels plugin:telegram@claude-plugins-officialБез флага плагин не запустится, и бот не ответит совсем.
- Напишите боту любое сообщение. В ответ придёт 6-значный код.
- В сессии Claude Code выполните
/telegram:access pair <код>и сразу следом/telegram:access policy allowlist. Без второй команды код привязки сможет ввести любой, кто найдёт вашего бота. - Дальше держите сессию запущенной, а компьютер включённым.
Как проверить результат
Спросите бота что-нибудь простое, например «что в текущей рабочей директории». Если связка работает, ответ придёт в чат за пару секунд, а в терминале появится строка о входящем событии канала. Если бот молчит, причина почти всегда одна из двух: сессия запущена без --channels или компьютер ушёл в сон.
Как это устроено
Плагин запускается вместе с сессией Claude Code и передаёт в неё сообщения из Telegram. Новая сессия при этом не создаётся. Она работает на вашем компьютере, поэтому Claude видит ваши файлы и продолжает начатую задачу. Если компьютер выключен или спит, отвечать некому.
Из коробки плагин передаёт в Claude текст и файлы, фото автоматически сохраняются в папку inbox. Голосовые можно расшифровывать, например, локальной моделью Whisper Turbo (large-v3-turbo), но связывать её с плагином придётся вручную: в документации этого нет. Флаг --channels пока не показан даже в claude --help.
Ссылки
- Документация Claude Code: channels: официальное описание функции channels.
Источник: kir.sandakov, Instagram Reels.