Отправка событий в активный сеанс через каналы

Используйте каналы для отправки сообщений, оповещений и вебхуков в ваш сеанс Claude Code из MCP-сервера. Перенаправляйте результаты CI, сообщения чата и события мониторинга, чтобы Claude мог реагировать, пока вас нет.

Канал — это MCP-сервер, который отправляет события в ваш активный сеанс Claude Code, чтобы Claude мог реагировать на события, происходящие, пока вас нет у терминала. Каналы могут быть двусторонними: Claude читает событие и отвечает через тот же канал, как мост чата. События поступают только пока сеанс открыт, поэтому для постоянно работающей установки вы запускаете Claude в фоновом процессе или постоянном терминале.

В отличие от интеграций, которые создают новый облачный сеанс или ждут опроса, событие поступает в уже открытый сеанс: см. сравнение каналов.

Вы устанавливаете канал как плагин и настраиваете его со своими учетными данными. Telegram, Discord и iMessage включены в исследовательское превью.

Когда Claude отвечает через канал, вы видите входящее сообщение в терминале, но не текст ответа. Терминал показывает вызов инструмента и подтверждение (например, "отправлено"), а фактический ответ появляется на другой платформе.

На этой странице рассматривается:

• Поддерживаемые каналы: настройка Telegram, Discord и iMessage
• Установка и запуск канала с fakechat, локальной демонстрацией
• Кто может отправлять сообщения: списки разрешенных отправителей и как вы выполняете сопряжение
• Включение каналов для вашей организации если вы управляете организацией Team, Enterprise или Console
• Сравнение каналов с веб-сеансами, Slack, MCP и Remote Control

Чтобы создать свой собственный канал, см. справочник по каналам.

Поддерживаемые каналы

Каждый поддерживаемый канал — это плагин, который требует Bun. Для практической демонстрации потока плагинов перед подключением реальной платформы попробуйте быстрый старт fakechat.

/plugin install telegram@claude-plugins-official

/telegram:configure <token>

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

/telegram:access pair <code>

/telegram:access policy allowlist

/plugin install discord@claude-plugins-official

/discord:configure <token>

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

/discord:access pair <code>

/discord:access policy allowlist

/plugin install imessage@claude-plugins-official

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

/imessage:access allow +15551234567

Вы также можете создать свой собственный канал для систем, у которых еще нет плагина.

Быстрый старт

Fakechat — это официально поддерживаемый демонстрационный канал, который запускает интерфейс чата на localhost без необходимости аутентификации и без внешнего сервиса для настройки.

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

Для демонстрации fakechat вам потребуется:

• Claude Code установлен и аутентифицирован с учетной записью claude.ai или ключом API Claude Console
• Bun установлен. Встроенные плагины каналов — это скрипты Bun. Проверьте с помощью bun --version; если это не сработает, установите Bun.
• Организация Team, Enterprise или управляемая Console: ваш администратор должен включить каналы в управляемых параметрах

/plugin install fakechat@claude-plugins-official

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

hey, what's in my working directory?

Если Claude столкнется с запросом разрешения, пока вас нет у терминала, сеанс приостановится до вашего ответа. Серверы каналов, которые объявляют возможность трансляции разрешений, могут перенаправлять эти запросы вам, чтобы вы могли одобрить или отклонить их удаленно. Для автоматического использования --dangerously-skip-permissions обходит запросы полностью, но используйте это только в окружениях, которым вы доверяете.

Когда вы запускаете каналы в неинтерактивном режиме с -p, инструменты, которые требуют ввода с терминала, такие как вопросы с множественным выбором и одобрение режима плана, отключены, чтобы сеанс никогда не зависал в ожидании ввода.

Безопасность

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

Telegram и Discord инициализируют список путем сопряжения:

1. Найдите своего бота в Telegram или Discord и отправьте ему любое сообщение
2. Бот ответит кодом сопряжения
3. В вашем сеансе Claude Code одобрите код при появлении запроса
4. Ваш ID отправителя добавляется в список разрешенных

iMessage работает иначе: отправка сообщения себе автоматически обходит ворота, и вы добавляете другие контакты по дескриптору с помощью /imessage:access allow.

Кроме того, вы контролируете, какие серверы включены в каждом сеансе с помощью --channels, и ваша организация контролирует доступность с помощью channelsEnabled на планах claude.ai Team и Enterprise и на организациях Console, которые развертывают управляемые параметры.

Нахождение в .mcp.json недостаточно для отправки сообщений: сервер также должен быть указан в --channels.

Список разрешенных также контролирует трансляцию разрешений, если канал это объявляет. Любой, кто может отвечать через канал, может одобрить или отклонить использование инструмента в вашем сеансе, поэтому добавляйте в список разрешенных только отправителей, которым вы доверяете эту власть.

Элементы управления для Enterprise

Администраторы контролируют доступность через два управляемых параметра, которые пользователи не могут переопределить. Значение по умолчанию зависит от того, как вы аутентифицируетесь:

• claude.ai Team и Enterprise: каналы заблокированы до тех пор, пока администратор их не включит.
• Anthropic Console с аутентификацией ключа API: каналы разрешены по умолчанию. Этот параметр нужен только если ваша организация развертывает управляемые параметры.

Во всех случаях ни один канал не запустится до тех пор, пока пользователь не выберет его для сеанса с помощью --channels.

Пользователи Pro и Max без организации пропускают эти проверки полностью: каналы доступны и пользователи выбирают участие в каждом сеансе с помощью --channels.

Включение каналов для вашей организации

Включите каналы для вашей организации из claude.ai → Admin settings → Claude Code → Channels, что требует роли Owner, или установив channelsEnabled на true в управляемых параметрах.

После включения пользователи в вашей организации могут использовать --channels для выбора серверов каналов в отдельных сеансах. Если параметр отключен или не установлен, MCP-сервер все еще подключается и его инструменты работают, но сообщения каналов не будут поступать. Предупреждение при запуске сообщает пользователю попросить администратора включить параметр.

Ограничение того, какие плагины каналов могут работать

По умолчанию любой плагин из списка разрешенных, поддерживаемого Anthropic, может регистрироваться как канал. Администраторы на планах Team и Enterprise могут заменить этот список разрешенных своим собственным, установив allowedChannelPlugins в управляемых параметрах. Используйте это для ограничения того, какие официальные плагины разрешены, одобрения каналов из вашего собственного внутреннего маркетплейса или обоих. Каждая запись называет плагин и маркетплейс, из которого он поступает:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

Когда allowedChannelPlugins установлен, он полностью заменяет список разрешенных Anthropic: только перечисленные плагины могут регистрироваться. Оставьте его неустановленным для возврата к списку по умолчанию Anthropic. Пустой массив блокирует все плагины каналов из списка разрешенных, но --dangerously-load-development-channels все еще может его обойти для локального тестирования. Чтобы полностью заблокировать каналы, включая флаг разработки, оставьте channelsEnabled неустановленным.

Этот параметр требует channelsEnabled: true. Если пользователь передает плагин в --channels, который не находится в вашем списке, Claude Code запускается нормально, но канал не регистрируется, и уведомление при запуске объясняет, что плагин не находится в утвержденном списке организации.

Исследовательское превью

Каналы — это функция исследовательского превью. Доступность постепенно развертывается, и синтаксис флага --channels и контракт протокола могут измениться на основе обратной связи.

Во время превью --channels принимает только плагины из списка разрешенных, поддерживаемого Anthropic, или из списка разрешенных вашей организации, если администратор установил allowedChannelPlugins. Плагины каналов в claude-plugins-official — это набор по умолчанию, одобренный Anthropic. Если вы передадите что-то, что не находится в действующем списке разрешенных, Claude Code запустится нормально, но канал не зарегистрируется, и уведомление при запуске скажет вам почему.

Для тестирования создаваемого вами канала используйте --dangerously-load-development-channels. См. Тестирование во время исследовательского превью для информации о тестировании пользовательских каналов, которые вы создаете.

Сообщайте о проблемах или отзывах в репозитории Claude Code на GitHub.

Сравнение каналов

Несколько функций Claude Code подключаются к системам вне терминала, каждая подходит для разного вида работы:

Каналы заполняют пробел в этом списке, отправляя события из источников, не связанных с Claude, в ваш уже работающий локальный сеанс.

• Мост чата: спросите Claude что-то со своего телефона через Telegram, Discord или iMessage, и ответ вернется в тот же чат, пока работа выполняется на вашей машине с вашими реальными файлами.
• Получатель вебхука: вебхук из CI, вашего трекера ошибок, конвейера развертывания или другого внешнего сервиса поступает туда, где Claude уже имеет открытые ваши файлы и помнит, что вы отлаживали.

Следующие шаги

После того как у вас есть работающий канал, изучите эти связанные функции:

• Создайте свой собственный канал для систем, у которых еще нет плагинов
• Remote Control для управления локальным сеансом со своего телефона вместо отправки событий в него
• Запланированные задачи для опроса по таймеру вместо реагирования на отправленные события