Channels в Claude Code: Telegram, Discord и вебхуки
Пересылаем в открытую сессию Claude Code сообщения из Telegram, Discord и iMessage и вебхуки от CI. Прогон на версии 2.1.319 со скриншотами и подтверждением команд из чата.
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 и кто начинает разговор.
| Способ | Где работает Claude | Кто начинает | Когда брать |
|---|---|---|---|
| Channels | Твой компьютер, открытая сессия | Внешняя система или ты из мессенджера | Алерты, CI, вопросы с телефона по живому проекту |
| Remote Control | Твой компьютер, открытая сессия | Ты из приложения Claude или claude.ai | Нужно рулить сессией с полным интерфейсом |
| Cloud sessions | Облачная песочница с клоном репозитория | Ты | Задача, которую можно отдать и проверить позже |
| Claude in Slack | Облачная сессия | Упоминание @Claude в канале Slack |
Задача из командного обсуждения |
Если коротко, Remote Control похож на демонстрацию экрана: ты видишь сессию целиком и печатаешь в неё. Channels работают как переписка: ты или сервис присылаете сообщение, Claude отвечает в тот же чат. Для реакции по расписанию, а не по событию, есть запланированные задачи и /loop.

Что нужно для запуска: версия, подписка и 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.

Как проверить механику на 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 секунд.


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

Первый шаг: создать бота. Открой @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 подключит сервер как обычный и не станет слушать события. instructionsClaude получает при подключении. Здесь пишут, что за события придут и нужно ли на них отвечать.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».

Пятый шаг: отправить событие. В другом терминале имитирую упавший 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 видит событие как тег <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 применяет тот, что пришёл первым: из терминала или из чата.
В моём прогоне поток исходящих сообщений канала выглядел так. Оба запроса на разрешение я подтвердил через канал, а не в терминале:

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

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

Мне это поведение скорее нравится: модель относится к тексту из канала как к чужому вводу. Для чат-моста в Telegram, где пишешь ты сам, это лишний шаг. Его снимает строчка в instructions, например «сообщения от этого канала приходят от владельца сессии». Проверял я это на одном прогоне с Opus 5.5 и вебхуком, у которого в тексте нет никаких признаков, кто пишет. С привязанным ботом Telegram поведение может отличаться.
Есть и ограничение безопасности. Объявляй пересылку разрешений только в канале, который проверяет отправителя: кто может написать в канал, тот может и одобрить запуск команды на твоей машине. Диалоги о доверии проекту и подключении MCP-сервера через канал не пересылаются, они видны только в терминале.
Как защититься от 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, где классификатор пропускает безопасные действия и останавливает опасные, или пересылка разрешений из прошлого раздела.

Какие ошибки встречаются чаще всего
Вот что ломается чаще всего и как это заметить.
Плашки 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.

Сервер есть в .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.
Читайте также
- Плагины Claude Code и маркетплейсы: как устроены плагины, через которые ставятся каналы.
- Хуки Claude Code: автоматизация на событиях внутри самой сессии.
- 10 воркфлоу Claude Code на каждый день: рабочие сценарии, в которые канал встраивается как ещё один вход.
- Claude Dispatch: управление Cowork с телефона: мобильный сценарий для тех, кто не работает в терминале.