Claude CodeГайд

Channels в Claude Code: Telegram, Discord и вебхуки

Пересылаем в открытую сессию Claude Code сообщения из Telegram, Discord и iMessage и вебхуки от CI. Прогон на версии 2.1.319 со скриншотами и подтверждением команд из чата.

Channels в Claude Code: Telegram, Discord и вебхуки

Channels в Claude Code это MCP-серверы, которые сами присылают события в уже открытую сессию: сообщение из Telegram, Discord или iMessage, вебхук от CI, алерт мониторинга. Claude читает событие, работает с твоими файлами и может ответить обратно в тот же чат. Включается всё флагом claude --channels и плагином из официального маркетплейса Anthropic.

Функция вышла 20 марта 2026 года в Claude Code 2.1.80 и до сих пор в research preview. За полгода в ней появились iMessage, подтверждение команд с телефона и поддержка ключей Console. Я заново прошёл весь путь на версии 2.1.319: поднял демо-чат fakechat, собрал свой webhook-канал и отправил в него сообщение «упал CI». Скриншоты ниже из этого прогона.

В статье разберём:

  • что такое Channels и чем они отличаются от Remote Control;
  • что нужно для запуска;
  • как проверить механику на fakechat;
  • как подключить Telegram, Discord и iMessage;
  • как собрать свой webhook-сервер для CI;
  • как отвечать в чат и подтверждать команды с телефона;
  • как защититься от prompt injection;
  • какие ошибки встречаются чаще всего.

Что такое Channels в Claude Code и чем они отличаются от Remote Control

Channel, или канал, это MCP-сервер, который Claude Code запускает рядом с сессией и слушает. Обычный MCP-сервер молчит, пока Claude его не спросит. Канал работает наоборот: он сам кладёт событие в контекст, и Claude реагирует, даже если ты отошёл от терминала.

У Claude Code есть ещё три способа работать с ним вне терминала, и их легко перепутать. В документации Anthropic они сведены в одну таблицу.

Таблица из документации Claude Code: Cloud sessions, Claude in Slack, стандартный MCP-сервер и Remote Control с колонками «что делает» и «для чего»
Ни один из соседних способов не пушит события в уже открытую локальную сессию: эту дыру и закрывают Channels. Скриншот: документация Claude Code

Разница в том, где работает Claude и кто начинает разговор.

Способ Где работает Claude Кто начинает Когда брать
Channels Твой компьютер, открытая сессия Внешняя система или ты из мессенджера Алерты, CI, вопросы с телефона по живому проекту
Remote Control Твой компьютер, открытая сессия Ты из приложения Claude или claude.ai Нужно рулить сессией с полным интерфейсом
Cloud sessions Облачная песочница с клоном репозитория Ты Задача, которую можно отдать и проверить позже
Claude in Slack Облачная сессия Упоминание @Claude в канале Slack Задача из командного обсуждения

Если коротко, Remote Control похож на демонстрацию экрана: ты видишь сессию целиком и печатаешь в неё. Channels работают как переписка: ты или сервис присылаете сообщение, Claude отвечает в тот же чат. Для реакции по расписанию, а не по событию, есть запланированные задачи и /loop.

Claude Code Remote Control: управляй сессией с телефона
Как продолжить локальную сессию из приложения Claude, если нужен полный интерфейс, а не переписка.

Что нужно для запуска: версия, подписка и Bun

Требования за полгода немного смягчились. Вот что нужно на 6 ноября 2026 года.

Claude Code 2.1.80 или новее. Канал появился в 2.1.80, подтверждение команд через канал в 2.1.81. Многие исправления пришли позже, поэтому обнови CLI: claude update, проверка claude --version.

Вход через claude.ai или ключ Console. В марте ключи API не поддерживались. С версии 2.1.128 каналы работают и с ключом Console. На Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry каналов нет.

Bun. Готовые плагины каналов написаны на Bun, проверка bun --version. Свой канал можно писать и на Node или Deno.

Включённые каналы в организации. Pro, Max и Ultra без организации ничего не включают. В Team и Enterprise каналы заблокированы, пока владелец не включит их в настройках организации.

Все официальные каналы живут в репозитории claude-plugins-official, в папке external_plugins. На 6 ноября там лежат telegram версии 0.0.7, discord 0.0.4, imessage 0.2.0 и демо fakechat 0.0.1.

Папка external_plugins в репозитории anthropics/claude-plugins-official на GitHub: discord, fakechat, imessage, telegram среди других плагинов
Каналы ставятся как обычные плагины: discord, fakechat, imessage и telegram лежат в одной папке с остальными. Скриншот: GitHub / matveev.tech

Как проверить механику на fakechat за пять минут

Fakechat это демо-канал от Anthropic: он поднимает простой чат на localhost:8787 без ботов и токенов. Начинать стоит с него. Если что-то не работает, ты сразу поймёшь, что дело в Claude Code, а не в Telegram.

Первый шаг: поставить плагин. Запусти claude и введи в нём команду. Когда установщик спросит про область, выбери user scope, чтобы плагин работал во всех проектах.

/plugin install fakechat@claude-plugins-official

Второй шаг: перезапустить Claude Code с каналом. Выйди из сессии и запусти её с флагом --channels. Сервер fakechat стартует сам.

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

Третий шаг: написать в чат. Открой http://localhost:8787 и отправь сообщение. Я спросил: «Что лежит в рабочей папке? Ответь коротко». Сообщение пришло в терминал строкой ← fakechat · web, Claude посмотрел файлы и ответил через инструмент reply. От отправки до ответа в браузере прошло 18 секунд.

Терминал Claude Code с каналом fakechat: входящее сообщение, команда Bash и вызов инструмента reply с ответом sent
В терминале видно входящее сообщение и вызов reply, а сам текст ответа уходит в чат. Скриншот: терминал / matveev.tech
Веб-интерфейс fakechat: вопрос «Что лежит в рабочей папке?» и ответ бота со списком файлов
Ответ пришёл в чат через 18 секунд после вопроса. Скриншот: fakechat / matveev.tech

Обрати внимание на стартовый экран: под логотипом стоит плашка «Channels (experimental) messages from plugin:fakechat… inject directly in this session». Если её нет, канал не зарегистрировался, и сообщения в сессию не попадут.

Как подключить Telegram

Telegram удобнее всего: пишешь боту с телефона, а работа идёт на твоём компьютере с настоящими файлами. Шаги в документации за полгода почти не изменились.

Раздел Supported channels в документации Claude Code: вкладки Telegram, Discord и iMessage, шаг создания бота через BotFather
С марта в списке официальных каналов появилась третья вкладка, iMessage. Скриншот: документация Claude Code

Первый шаг: создать бота. Открой @BotFather, отправь /newbot, задай имя и username с окончанием bot. Скопируй токен.

Второй шаг: поставить плагин и сохранить токен. Команда configure кладёт токен в ~/.claude/channels/telegram/.env. Вместо неё можно задать переменную TELEGRAM_BOT_TOKEN до запуска Claude Code.

/plugin install telegram@claude-plugins-official
/telegram:configure <токен>

Третий шаг: перезапустить с каналом. Плагин начнёт опрашивать Telegram, наружу ничего открывать не нужно.

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

Четвёртый шаг: привязать свой аккаунт. Напиши боту любое сообщение, он ответит кодом. Подтверди код в терминале и закрой доступ всем остальным:

/telegram:access pair <код>
/telegram:access policy allowlist

Пока ты не прошёл привязку, бот игнорирует все сообщения. Так работает список разрешённых отправителей: чужие сообщения отбрасываются молча, без ответа.

Если плагин ставился ещё весной, обнови каталог: /plugin marketplace update claude-plugins-official. У меня в одном проекте висела версия 0.0.4, а в репозитории уже 0.0.7 с исправлениями надёжности.

Discord и iMessage: чем отличается настройка

Discord. Создай приложение в Developer Portal, в разделе Bot нажми Reset Token и скопируй токен. Там же включи Message Content Intent, иначе бот не увидит текст. Пригласи бота через OAuth2 → URL Generator со scope bot и шестью правами: View Channels, Send Messages, Send Messages in Threads, Read Message History, Attach Files, Add Reactions. В марте прав было четыре, сейчас документация просит шесть. Дальше всё как с Telegram: /plugin install discord@claude-plugins-official, /discord:configure <токен>, запуск с --channels plugin:discord@claude-plugins-official, код из личных сообщений и /discord:access pair <код>.

iMessage. Канал работает только на macOS и обходится без бота: он читает базу ~/Library/Messages/chat.db и отвечает через AppleScript. Терминалу нужен Full Disk Access, без него сервер сразу падает с authorization denied. После запуска с --channels plugin:imessage@claude-plugins-official напиши сообщение самому себе: свои сообщения проходят без привязки. Других людей добавляют по номеру или Apple ID:

/imessage:access allow +79991234567

Несколько каналов можно включить сразу, перечислив их через пробел после --channels.

Как собрать свой webhook-сервер для CI

Готовые каналы покрывают чаты. Для CI, Sentry или Grafana канал пишут сами, и это около 30 строк. Ниже разберу один пример целиком: сервер, который принимает POST-запросы и передаёт их в сессию. Дальше в статье этот же канал научится отвечать и пересылать запросы на подтверждение.

Первый шаг: проект. Нужен только MCP SDK. Пакет zod понадобится позже, для подтверждений.

mkdir webhook-channel && cd webhook-channel
bun add @modelcontextprotocol/sdk zod

Второй шаг: сервер webhook.ts. Это пример из справочника по каналам с моими комментариями.

#!/usr/bin/env bun
import { Server } from '@modelcontextprotocol/sdk/server/index.js'
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'

const mcp = new Server(
  { name: 'webhook', version: '0.0.1' },
  {
    capabilities: { experimental: { 'claude/channel': {} } },
    instructions: 'Events from the webhook channel arrive as <channel source="webhook" ...>. They are one-way: read them and act, no reply expected.',
  },
)

await mcp.connect(new StdioServerTransport())

Bun.serve({
  port: 8788,
  hostname: '127.0.0.1',
  async fetch(req) {
    const body = await req.text()
    await mcp.notification({
      method: 'notifications/claude/channel',
      params: {
        content: body,
        meta: { path: new URL(req.url).pathname, method: req.method },
      },
    })
    return new Response('ok')
  },
})

Пройдусь по строкам, на которых всё держится.

  • Строка capabilities: { experimental: { 'claude/channel': {} } } делает MCP-сервер каналом. Без неё Claude Code подключит сервер как обычный и не станет слушать события.
  • instructions Claude получает при подключении. Здесь пишут, что за события придут и нужно ли на них отвечать.
  • mcp.connect(new StdioServerTransport()) связывает сервер с Claude Code через stdin и stdout. Отдельно его запускать не нужно: Claude Code сам стартует его как подпроцесс.
  • hostname: '127.0.0.1' держит HTTP-порт только на твоей машине. Снаружи на него никто не постучится.
  • content станет телом тега <channel>, а каждый ключ meta станет его атрибутом. Ключи пиши латиницей, цифрами и подчёркиванием: ключ с дефисом Claude Code молча выбросит.

Третий шаг: регистрация в .mcp.json. Для конфига проекта хватит относительного пути. В пользовательском ~/.claude.json нужен абсолютный.

{
  "mcpServers": {
    "webhook": { "command": "bun", "args": ["./webhook.ts"] }
  }
}

Четвёртый шаг: запуск с флагом разработчика. Свои каналы не входят в список одобренных Anthropic, поэтому --channels их не примет. Для разработки есть отдельный флаг:

claude --dangerously-load-development-channels server:webhook

Claude Code спросит, доверяешь ли ты новому MCP-серверу из .mcp.json, а потом покажет полноэкранное предупреждение. Выбирай «I am using this for local development».

Предупреждение Claude Code «WARNING: Loading development channels» с вариантами I am using this for local development и Exit
Флаг разработчика пускает канал в обход списка Anthropic только после явного согласия. Скриншот: терминал / matveev.tech

Пятый шаг: отправить событие. В другом терминале имитирую упавший CI:

curl -X POST localhost:8788 -H "X-Sender: dev" \
  -d "CI: job lint failed on main. Which runtime version is installed here? Run bun --version and reply with the result."

Заголовок X-Sender нужен полной версии сервера из следующего раздела: она пропускает только известных отправителей. Без заголовка мой первый запрос получил ответ forbidden и до Claude не дошёл.

В терминале событие появилось строкой ← webhook: CI: job lint failed…, и Claude сразу взялся за bun --version. Сессия была в ручном режиме разрешений, поэтому он остановился на запросе подтверждения.

Сессия Claude Code с webhook-каналом: плашка Channels (experimental), входящее событие от webhook и запрос на запуск bun --version
Событие из curl пришло в открытую сессию, и Claude сам решил запустить команду. Запрос разрешения ждёт ответа. Скриншот: терминал / matveev.tech

Сам Claude видит событие как тег <channel source="webhook" chat_id="1" path="/"> с текстом внутри. В терминале его сокращают до одной строки.

Как ответить в чат и подтвердить команду с телефона

Односторонний канал годится для алертов. Чтобы Claude мог ответить, каналу нужен инструмент reply, а чтобы подтверждать команды не из терминала, нужен permission relay, то есть пересылка запросов на разрешение.

Инструмент reply. Это обычный MCP-инструмент. В capabilities добавляется tools: {}, обработчик ListToolsRequestSchema описывает reply с полями chat_id и text, а CallToolRequestSchema отправляет текст на твою платформу. В meta входящего события кладётся chat_id, чтобы Claude знал, куда отвечать. Полный код есть в справочнике.

Пересылка разрешений. Канал объявляет ещё одну возможность:

capabilities: {
  experimental: {
    'claude/channel': {},
    'claude/channel/permission': {},
  },
  tools: {},
},

Когда Claude хочет запустить Bash, Write или Edit, Claude Code шлёт каналу уведомление notifications/claude/channel/permission_request. В нём лежат имя инструмента, описание, аргументы и ID из пяти букв. Канал пересылает это в чат. Ты отвечаешь yes abcde или no abcde, канал превращает ответ в вердикт, и Claude Code применяет тот, что пришёл первым: из терминала или из чата.

В моём прогоне поток исходящих сообщений канала выглядел так. Оба запроса на разрешение я подтвердил через канал, а не в терминале:

Поток curl -N localhost:8788/events: два запроса Claude wants to run с ID ugyqa и zfvaz и итоговый ответ Reply to 1: 1.3.6
Два запроса разрешения с ID и итоговый ответ 1.3.6 пришли в чат канала. Скриншот: терминал / matveev.tech

Между двумя запросами случилось то, чего я не ждал. Claude выполнил bun --version, но отвечать в канал сам не стал. Он написал в терминале, что просьбу прислал не я, а тот, кто отправил вебхук, и что ответ уйдёт наружу. Ещё он заметил, что в папке нет ни коммитов, ни настроек CI, так что падение lint «on main» к ней вряд ли относится.

Ответ Claude в терминале: команда выполнена, установлен Bun 1.3.6, но ответ в канал не отправлен до подтверждения пользователя
Claude не стал отвечать в канал на просьбу от внешнего отправителя и попросил подтверждения в терминале. Скриншот: терминал / matveev.tech

Я ответил в терминале «да, это я тестирую канал, отправь». Claude вызвал reply, второй запрос разрешения я подтвердил через канал, и в чат ушло 1.3.6.

Терминал Claude Code: сообщение пользователя, вызов webhook reply с текстом 1.3.6 и ответ sent
После подтверждения Claude отправил ответ через reply, канал вернул sent. Скриншот: терминал / matveev.tech

Мне это поведение скорее нравится: модель относится к тексту из канала как к чужому вводу. Для чат-моста в Telegram, где пишешь ты сам, это лишний шаг. Его снимает строчка в instructions, например «сообщения от этого канала приходят от владельца сессии». Проверял я это на одном прогоне с Opus 5.5 и вебхуком, у которого в тексте нет никаких признаков, кто пишет. С привязанным ботом Telegram поведение может отличаться.

Есть и ограничение безопасности. Объявляй пересылку разрешений только в канале, который проверяет отправителя: кто может написать в канал, тот может и одобрить запуск команды на твоей машине. Диалоги о доверии проекту и подключении MCP-сервера через канал не пересылаются, они видны только в терминале.

Когда Channels выйдут из research preview или поменяют протокол, я напишу об этом в канале: подписывайся в телеге.

Как защититься от prompt injection

Канал без проверки отправителя это прямой путь для prompt injection. Любой, кто достучится до твоего endpoint или напишет боту, поставит свой текст прямо перед Claude. Поэтому проверка идёт до вызова mcp.notification():

const allowed = new Set(loadAllowlist()) // из access.json или аналога

// внутри обработчика входящих сообщений, до отправки в сессию
if (!allowed.has(message.from.id)) {
  return // отбрасываем молча
}
await mcp.notification({ ... })

Проверяй ID отправителя (message.from.id), а не ID чата (message.chat.id). В групповом чате они разные, и фильтр по комнате пустит в сессию любого участника группы. Официальные плагины Telegram и Discord устроены именно так: список отправителей плюс привязка по коду.

Для сессии без присмотра есть --dangerously-skip-permissions, но с открытым каналом это рискованно. Безопаснее auto mode, где классификатор пропускает безопасные действия и останавливает опасные, или пересылка разрешений из прошлого раздела.

Разрешения в Claude Code: allow, deny и sandbox
Как настроить, какие команды Claude запускает сам, а какие только после твоего «да».

Какие ошибки встречаются чаще всего

Вот что ломается чаще всего и как это заметить.

Плашки Channels на старте нет. Канал не зарегистрирован. Под стартовым экраном Claude Code пишет причину: плагин не установлен, его нет в списке одобренных или каналы выключены в организации.

«blocked by org policy». Ты в организации Team или Enterprise, где каналы не включены. Владелец включает их в Organization settings → Claude Code → Channels или ставит channelsEnabled: true в managed settings. Там же allowedChannelPlugins задаёт свой список разрешённых плагинов. Подробнее про managed settings в гайде по Claude Code для Team и Enterprise.

Раздел Enterprise controls в документации Claude Code: настройки channelsEnabled и allowedChannelPlugins и поведение по умолчанию для Team, Enterprise и Console
У Pro, Max и Ultra без организации этих проверок нет вовсе, а в Team и Enterprise каналы выключены по умолчанию. Скриншот: документация Claude Code

Сервер есть в .mcp.json, а события не приходят. Записи в конфиге мало. Канал надо назвать в --channels или во флаге разработчика при каждом запуске. Если curl отвечает ok, а Claude молчит, выполни /mcp: статус failed обычно значит ошибку импорта. Подробный лог даёт запуск с --debug, он пишется в ~/.claude/debug/.

curl отвечает «connection refused». Порт не поднялся или его держит старый процесс от прошлого запуска. Найди его через lsof -i :8788 и заверши.

Флаг разработчика не действует. В режиме -p и через Agent SDK Claude Code игнорирует --dangerously-load-development-channels, потому что не может показать предупреждение. Ещё флаг работает только для перечисленных в нём каналов и не распространяется на те, что указаны в --channels.

Канал на новом MCP-рантайме не регистрируется. На рантайме v2 сервер, который договорился о протоколе MCP ревизии 2026-07-28, не может доставлять события. Claude Code такой канал не регистрирует. Обходной путь: MCP_PROTOCOL_NEGOTIATION=legacy перед запуском.

Сообщения пропали, пока ноутбук спал. События приходят только в открытую сессию. Для работы без перерыва держи Claude Code в tmux или screen на машине, которая не засыпает. Если пришло несколько событий, пока Claude занят, он получит их пачкой на следующем ходу.

Сессия встала и ждёт. Claude упёрся в запрос разрешения, а пересылки у канала нет. Сессия ждёт тебя у терминала.

Кому подойдут Channels в Claude Code

Channels нужны тем, у кого события рождаются вне терминала: падает CI, Sentry шлёт ошибку, хочется спросить что-то по проекту с телефона. Telegram и iMessage подключаются четырьмя-пятью командами, свой вебхук это один файл на 30 строк и запись в .mcp.json. Если тебе нужно видеть сессию целиком и печатать в неё, бери Remote Control: там полный интерфейс, а не переписка.

Я бы пока держал Channels для личных проектов и алертов. Функция полгода в research preview, синтаксис флага и протокол могут поменяться, а сессия живёт, только пока открыт терминал. Зато свой канал умещается в один файл, а с пересылкой разрешений он становится пультом, с которого можно одобрить команду из метро.

Больше гайдов по агенту Anthropic собрано в разделе о Claude Code.

Читайте также

CTO говорит

Разбираю релизы моделей и инструментов: что вышло и стоит ли переходить.

Читать в Telegram

Ещё в разделе Claude Code

Весь раздел