Перейти к основному содержанию
Каналы находятся в исследовательском превью и требуют Claude Code v2.1.80 или позже. Они требуют входа в claude.ai. Аутентификация через консоль и ключ API не поддерживается. Организации Team и Enterprise должны явно их включить.
Канал — это MCP-сервер, который отправляет события в ваш активный сеанс Claude Code, чтобы Claude мог реагировать на события, происходящие, пока вас нет у терминала. Каналы могут быть двусторонними: Claude читает событие и отвечает через тот же канал, как мост чата. События поступают только пока сеанс открыт, поэтому для постоянно работающей установки вы запускаете Claude в фоновом процессе или постоянном терминале. В отличие от интеграций, которые создают новый облачный сеанс или ждут опроса, событие поступает в уже открытый сеанс: см. сравнение каналов. Вы устанавливаете канал как плагин и настраиваете его со своими учетными данными. Telegram, Discord и iMessage включены в исследовательское превью. Когда Claude отвечает через канал, вы видите входящее сообщение в терминале, но не текст ответа. Терминал показывает вызов инструмента и подтверждение (например, “отправлено”), а фактический ответ появляется на другой платформе. На этой странице рассматривается: Чтобы создать свой собственный канал, см. справочник по каналам.

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

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

Создайте бота Telegram

Откройте BotFather в Telegram и отправьте /newbot. Дайте ему отображаемое имя и уникальное имя пользователя, заканчивающееся на bot. Скопируйте токен, который возвращает BotFather.
2

Установите плагин

В Claude Code выполните:
/plugin install telegram@claude-plugins-official
Если Claude Code сообщает, что плагин не найден ни в одном маркетплейсе, ваш маркетплейс либо отсутствует, либо устарел. Выполните /plugin marketplace update claude-plugins-official для его обновления или /plugin marketplace add anthropics/claude-plugins-official, если вы его еще не добавили. Затем повторите попытку установки.После установки выполните /reload-plugins для активации команды настройки плагина.
3

Настройте ваш токен

Выполните команду настройки с токеном от BotFather:
/telegram:configure <token>
Это сохранит его в ~/.claude/channels/telegram/.env. Вы также можете установить TELEGRAM_BOT_TOKEN в переменной окружения вашей оболочки перед запуском Claude Code.
4

Перезагрузитесь с включенными каналами

Выйдите из Claude Code и перезагрузитесь с флагом канала. Это запустит плагин Telegram, который начнет опрашивать сообщения от вашего бота:
claude --channels plugin:telegram@claude-plugins-official
5

Выполните сопряжение вашей учетной записи

Откройте Telegram и отправьте любое сообщение вашему боту. Бот ответит кодом сопряжения.
Если ваш бот не отвечает, убедитесь, что Claude Code работает с --channels из предыдущего шага. Бот может отвечать только пока канал активен.
Вернитесь в Claude Code и выполните:
/telegram:access pair <code>
Затем заблокируйте доступ, чтобы только ваша учетная запись могла отправлять сообщения:
/telegram:access policy allowlist
Вы также можете создать свой собственный канал для систем, у которых еще нет плагина.

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

Fakechat — это официально поддерживаемый демонстрационный канал, который запускает интерфейс чата на localhost без необходимости аутентификации и без внешнего сервиса для настройки. После установки и включения fakechat вы можете печатать в браузере, и сообщение поступает в ваш сеанс Claude Code. Claude отвечает, и ответ появляется обратно в браузере. После того как вы протестировали интерфейс fakechat, попробуйте Telegram, Discord или iMessage. Для демонстрации fakechat вам потребуется:
1

Установите плагин канала fakechat

Запустите сеанс Claude Code и выполните команду установки:
/plugin install fakechat@claude-plugins-official
Если Claude Code сообщает, что плагин не найден ни в одном маркетплейсе, ваш маркетплейс либо отсутствует, либо устарел. Выполните /plugin marketplace update claude-plugins-official для его обновления или /plugin marketplace add anthropics/claude-plugins-official, если вы его еще не добавили. Затем повторите попытку установки.
2

Перезагрузитесь с включенным каналом

Выйдите из Claude Code, затем перезагрузитесь с --channels и передайте установленный плагин fakechat:
claude --channels plugin:fakechat@claude-plugins-official
Сервер fakechat запустится автоматически.
Вы можете передать несколько плагинов в --channels, разделенные пробелом.
3

Отправьте сообщение

Откройте интерфейс fakechat по адресу http://localhost:8787 и введите сообщение:
hey, what's in my working directory?
Сообщение поступает в ваш сеанс Claude Code как событие <channel source="fakechat">. Claude читает его, выполняет работу и вызывает инструмент reply fakechat. Ответ появляется в интерфейсе чата.
Если Claude столкнется с запросом разрешения, пока вас нет у терминала, сеанс приостановится до вашего ответа. Серверы каналов, которые объявляют возможность трансляции разрешений, могут перенаправлять эти запросы вам, чтобы вы могли одобрить или отклонить их удаленно. Для автоматического использования --dangerously-skip-permissions обходит запросы полностью, но используйте это только в окружениях, которым вы доверяете.

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

Каждый одобренный плагин канала поддерживает список разрешенных отправителей: только ID, которые вы добавили, могут отправлять сообщения, и все остальные молча отбрасываются. Telegram и Discord инициализируют список путем сопряжения:
  1. Найдите своего бота в Telegram или Discord и отправьте ему любое сообщение
  2. Бот ответит кодом сопряжения
  3. В вашем сеансе Claude Code одобрите код при появлении запроса
  4. Ваш ID отправителя добавляется в список разрешенных
iMessage работает иначе: отправка сообщения себе автоматически обходит ворота, и вы добавляете другие контакты по дескриптору с помощью /imessage:access allow. Кроме того, вы контролируете, какие серверы включены в каждом сеансе с помощью --channels, и на планах Team и Enterprise ваша организация контролирует доступность с помощью channelsEnabled. Нахождение в .mcp.json недостаточно для отправки сообщений: сервер также должен быть указан в --channels. Список разрешенных также контролирует трансляцию разрешений, если канал это объявляет. Любой, кто может отвечать через канал, может одобрить или отклонить использование инструмента в вашем сеансе, поэтому добавляйте в список разрешенных только отправителей, которым вы доверяете эту власть.

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

На планах Team и Enterprise каналы отключены по умолчанию. Администраторы контролируют доступность через два управляемых параметра, которые пользователи не могут переопределить:
ПараметрНазначениеЕсли не настроено
channelsEnabledГлавный переключатель. Должен быть true для доставки сообщений любым каналом. Установите через переключатель консоли администратора claude.ai или непосредственно в управляемых параметрах. Блокирует все каналы, включая флаг разработки, когда отключен.Каналы заблокированы
allowedChannelPluginsКакие плагины могут регистрироваться после включения каналов. Заменяет список, поддерживаемый Anthropic, когда установлен. Применяется только когда channelsEnabled имеет значение true.Применяется список по умолчанию Anthropic
Пользователи Pro и Max без организации пропускают эти проверки полностью: каналы доступны и пользователи выбирают участие в каждом сеансе с помощью --channels.

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

Администраторы могут включить каналы из claude.ai → Admin settings → Claude Code → Channels или установив 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 Code в веб-браузереЗапускает задачи в свежей облачной песочнице, клонированной из GitHubДелегирование самостоятельной асинхронной работы, которую вы проверяете позже
Claude в SlackСоздает веб-сеанс из упоминания @Claude в канале или потокеЗапуск задач непосредственно из контекста командного разговора
Стандартный MCP-серверClaude запрашивает его во время задачи; ничего не отправляется в сеансПредоставление Claude доступа по требованию для чтения или запроса системы
Remote ControlВы управляете своим локальным сеансом из claude.ai или мобильного приложения ClaudeУправление активным сеансом, пока вас нет за столом
Каналы заполняют пробел в этом списке, отправляя события из источников, не связанных с Claude, в ваш уже работающий локальный сеанс.
  • Мост чата: спросите Claude что-то со своего телефона через Telegram, Discord или iMessage, и ответ вернется в тот же чат, пока работа выполняется на вашей машине с вашими реальными файлами.
  • Получатель вебхука: вебхук из CI, вашего трекера ошибок, конвейера развертывания или другого внешнего сервиса поступает туда, где Claude уже имеет открытые ваши файлы и помнит, что вы отлаживали.

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

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