Каналы находятся в исследовательском превью и требуют Claude Code v2.1.80 или позже. Они требуют входа в claude.ai. Аутентификация через консоль и ключ API не поддерживается. Организации Team и Enterprise должны явно их включить.
- Поддерживаемые каналы: настройка Telegram, Discord и iMessage
- Установка и запуск канала с fakechat, локальной демонстрацией
- Кто может отправлять сообщения: списки разрешенных отправителей и как вы выполняете сопряжение
- Включение каналов для вашей организации на Team и Enterprise
- Сравнение каналов с веб-сеансами, Slack, MCP и Remote Control
Поддерживаемые каналы
Каждый поддерживаемый канал — это плагин, который требует Bun. Для практической демонстрации потока плагинов перед подключением реальной платформы попробуйте быстрый старт fakechat.- Telegram
- Discord
- iMessage
Просмотрите полный исходный код плагина Telegram.
Создайте бота Telegram
Откройте BotFather в Telegram и отправьте
/newbot. Дайте ему отображаемое имя и уникальное имя пользователя, заканчивающееся на bot. Скопируйте токен, который возвращает BotFather.Установите плагин
В Claude Code выполните:Если Claude Code сообщает, что плагин не найден ни в одном маркетплейсе, ваш маркетплейс либо отсутствует, либо устарел. Выполните
/plugin marketplace update claude-plugins-official для его обновления или /plugin marketplace add anthropics/claude-plugins-official, если вы его еще не добавили. Затем повторите попытку установки.После установки выполните /reload-plugins для активации команды настройки плагина.Настройте ваш токен
Выполните команду настройки с токеном от BotFather:Это сохранит его в
~/.claude/channels/telegram/.env. Вы также можете установить TELEGRAM_BOT_TOKEN в переменной окружения вашей оболочки перед запуском Claude Code.Перезагрузитесь с включенными каналами
Выйдите из Claude Code и перезагрузитесь с флагом канала. Это запустит плагин Telegram, который начнет опрашивать сообщения от вашего бота:
Выполните сопряжение вашей учетной записи
Откройте Telegram и отправьте любое сообщение вашему боту. Бот ответит кодом сопряжения.Вернитесь в Claude Code и выполните:Затем заблокируйте доступ, чтобы только ваша учетная запись могла отправлять сообщения:
Если ваш бот не отвечает, убедитесь, что Claude Code работает с
--channels из предыдущего шага. Бот может отвечать только пока канал активен.Быстрый старт
Fakechat — это официально поддерживаемый демонстрационный канал, который запускает интерфейс чата на localhost без необходимости аутентификации и без внешнего сервиса для настройки. После установки и включения fakechat вы можете печатать в браузере, и сообщение поступает в ваш сеанс Claude Code. Claude отвечает, и ответ появляется обратно в браузере. После того как вы протестировали интерфейс fakechat, попробуйте Telegram, Discord или iMessage. Для демонстрации fakechat вам потребуется:- Claude Code установлен и аутентифицирован с учетной записью claude.ai
- Bun установлен. Встроенные плагины каналов — это скрипты Bun. Проверьте с помощью
bun --version; если это не сработает, установите Bun. - Пользователи Team/Enterprise: администратор вашей организации должен включить каналы в управляемых параметрах
Установите плагин канала fakechat
Запустите сеанс Claude Code и выполните команду установки:Если Claude Code сообщает, что плагин не найден ни в одном маркетплейсе, ваш маркетплейс либо отсутствует, либо устарел. Выполните
/plugin marketplace update claude-plugins-official для его обновления или /plugin marketplace add anthropics/claude-plugins-official, если вы его еще не добавили. Затем повторите попытку установки.Перезагрузитесь с включенным каналом
Выйдите из Claude Code, затем перезагрузитесь с Сервер fakechat запустится автоматически.
--channels и передайте установленный плагин fakechat:Отправьте сообщение
Откройте интерфейс fakechat по адресу http://localhost:8787 и введите сообщение:Сообщение поступает в ваш сеанс Claude Code как событие
<channel source="fakechat">. Claude читает его, выполняет работу и вызывает инструмент reply fakechat. Ответ появляется в интерфейсе чата.--dangerously-skip-permissions обходит запросы полностью, но используйте это только в окружениях, которым вы доверяете.
Безопасность
Каждый одобренный плагин канала поддерживает список разрешенных отправителей: только ID, которые вы добавили, могут отправлять сообщения, и все остальные молча отбрасываются. Telegram и Discord инициализируют список путем сопряжения:- Найдите своего бота в Telegram или Discord и отправьте ему любое сообщение
- Бот ответит кодом сопряжения
- В вашем сеансе Claude Code одобрите код при появлении запроса
- Ваш ID отправителя добавляется в список разрешенных
/imessage:access allow.
Кроме того, вы контролируете, какие серверы включены в каждом сеансе с помощью --channels, и на планах Team и Enterprise ваша организация контролирует доступность с помощью channelsEnabled.
Нахождение в .mcp.json недостаточно для отправки сообщений: сервер также должен быть указан в --channels.
Список разрешенных также контролирует трансляцию разрешений, если канал это объявляет. Любой, кто может отвечать через канал, может одобрить или отклонить использование инструмента в вашем сеансе, поэтому добавляйте в список разрешенных только отправителей, которым вы доверяете эту власть.
Элементы управления для Enterprise
На планах Team и Enterprise каналы отключены по умолчанию. Администраторы контролируют доступность через два управляемых параметра, которые пользователи не могут переопределить:| Параметр | Назначение | Если не настроено |
|---|---|---|
channelsEnabled | Главный переключатель. Должен быть true для доставки сообщений любым каналом. Установите через переключатель консоли администратора claude.ai или непосредственно в управляемых параметрах. Блокирует все каналы, включая флаг разработки, когда отключен. | Каналы заблокированы |
allowedChannelPlugins | Какие плагины могут регистрироваться после включения каналов. Заменяет список, поддерживаемый Anthropic, когда установлен. Применяется только когда channelsEnabled имеет значение true. | Применяется список по умолчанию Anthropic |
--channels.
Включение каналов для вашей организации
Администраторы могут включить каналы из claude.ai → Admin settings → Claude Code → Channels или установивchannelsEnabled на true в управляемых параметрах.
После включения пользователи в вашей организации могут использовать --channels для выбора серверов каналов в отдельных сеансах. Если параметр отключен или не установлен, MCP-сервер все еще подключается и его инструменты работают, но сообщения каналов не будут поступать. Предупреждение при запуске сообщает пользователю попросить администратора включить параметр.
Ограничение того, какие плагины каналов могут работать
По умолчанию любой плагин из списка разрешенных, поддерживаемого Anthropic, может регистрироваться как канал. Администраторы на планах Team и Enterprise могут заменить этот список разрешенных своим собственным, установивallowedChannelPlugins в управляемых параметрах. Используйте это для ограничения того, какие официальные плагины разрешены, одобрения каналов из вашего собственного внутреннего маркетплейса или обоих. Каждая запись называет плагин и маркетплейс, из которого он поступает:
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 что-то со своего телефона через Telegram, Discord или iMessage, и ответ вернется в тот же чат, пока работа выполняется на вашей машине с вашими реальными файлами.
- Получатель вебхука: вебхук из CI, вашего трекера ошибок, конвейера развертывания или другого внешнего сервиса поступает туда, где Claude уже имеет открытые ваши файлы и помнит, что вы отлаживали.
Следующие шаги
После того как у вас есть работающий канал, изучите эти связанные функции:- Создайте свой собственный канал для систем, у которых еще нет плагинов
- Remote Control для управления локальным сеансом со своего телефона вместо отправки событий в него
- Запланированные задачи для опроса по таймеру вместо реагирования на отправленные события