WhatsApp Channel for Claude Code — плагин
Плагин Claude Code с каналом WhatsApp: сессия отвечает на сообщения и пишет с вашего номера или через официальный Cloud API
- 119 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Плагин принимает сообщения от других людей прямо в сессию агента, а подключение через связанное устройство нарушает правила WhatsApp и грозит блокировкой номера
- Агент отправляет сообщения от вашего номера и может запрашивать выполнение инструментов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/whatsapp-channel-for-claude-codeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Плагин принимает сообщения от других людей прямо в сессию агента, а подключение через связанное устройство нарушает правила WhatsApp и грозит блокировкой номера
- Агент отправляет сообщения от вашего номера и может запрашивать выполнение инструментов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
WhatsApp Channel for Claude Code подключает сессию Claude Code к WhatsApp. Входящее сообщение будит сессию сразу, Claude отвечает с вашего номера или с номера бизнеса. Выбрать можно один из двух вариантов. Связанное устройство `baileys` работает по умолчанию: вы связываете телефон, как с WhatsApp Web, и ключей Meta не нужно. Официальный `cloud-api` использует бизнес-API Meta и общедоступный адрес HTTPS для вебхука с отдельными учетными данными. В реализации он работает только с личными сообщениями, платит по тарифам и правилам Meta. Сервер на Bun дает инструменты `reply`, `react`, `download_attachment`, `status`, `unreplied` и `catch_up`. Есть чанкование длинных ответов, индикатор набора текста, упоминания, фото, голосовые, видео, документы и стикеры, опросы до 12 вариантов, локальная расшифровка голосовых через `mlx-whisper`, у каждой группы свой `config.md` с характером и памятью, задачи по расписанию и подтверждение запросов инструментов реакцией. Доступ закрывает шлюз: коды сопряжения, списки разрешенных и политики по группам, посторонние до сессии не доходят. Сообщения других людей попадают в вашу сессию, поэтому ограничьте круг доверенных.
Для кого. Разработчикам, которые хотят вести сессию Claude Code из WhatsApp и готовы к сопутствующим ограничениям неофициального протокола.
Подходит, если
- Claude Code отвечает на сообщения с телефона по пути, и итог приходит в WhatsApp
- Командная группа получает ответы агента, у каждой группы своя настройка характера и памяти
- Запрос Claude на выполнение инструмента утверждают или отклоняют реакцией на сообщение
- После перезапуска сессия показывает, сколько сообщений ждет по каждому чату, и продолжает с места остановки
Не подходит, если
- Нужен официальный и безопасный канал без угрозы блокировки номера: протокол связанного устройства неофициальный и может противоречить правилам WhatsApp
- Нужны группы через Cloud API: в этой реализации поддерживаются только личные сообщения
- Агент должен работать без Bun или в клиенте, который не доставляет входящие: вне Claude Code приходится опрашивать вызовом `wait_for_messages`
Пример запроса к агенту
Запусти /whatsapp-channel:`setup` и подключи связанное устройство, потом покажи политику доступа командой /whatsapp-channel:`access`.Ограничения
Плагин не создан Anthropic или Meta. Вариант `baileys` использует неофициальный протокол связанного устройства, это может нарушать правила WhatsApp и поставить номер под угрозу блокировки. Cloud API требует бизнес-номер Meta, токен, секрет приложения и общедоступный адрес вебхука, плюс тарифы и правила Meta. Загрузка идет с флагом `--dangerously-load-development-channels`, а Claude Code предупреждает, что такой канал вводит текст других людей прямо в сессию. Читайте код плагина, держите запросы разрешений включенными и сужайте доверенных. Одновременно один клиент держит каталог состояния.
Как отключить. Удалите плагин whatsapp-channel через /plugin и остановите сессию. В WhatsApp снимите связанное устройство в разделе «Связанные устройства». Каталог ~/.whatsapp-channel с состоянием и ключами удалите вручную.
Частые вопросы
Как поставить плагин?
Выполните `claude plugin marketplace add Rich627/whatsapp-claude-plugin` и `claude plugin install whatsapp-channel@whatsapp-claude-plugin`, затем запустите Claude Code с флагом `--dangerously-load-development-channels plugin:whatsapp-channel@whatsapp-claude-plugin`.
Зачем нужен опасный флаг?
Он регистрирует плагин как канал, поэтому входящее сообщение будит сессию сразу. Без него инструменты загрузятся, но сообщения будут ждать, пока вы сами не попросите Claude проверить почту. Флаг `--channels` этот плагин пока не принимает.
Как привязать номер?
Выполните `/whatsapp-channel:configure <номер>` с кодом страны, без плюса. Введите показанный код в WhatsApp, Связанные устройства, Привязать по номеру телефона, либо отсканируйте QR. Для Cloud API мастер запускается в вашем терминале, ключи в чат не попадают.
Как закрыть доступ посторонним?
Шлюз пропускает только тех, кто в списке: используйте `/whatsapp-channel:access` или `bun scripts/access.ts policy pairing`. Одобрение каждого сопряжения требует конкретного кода, потому что запрос «одобри ожидающего» похож на внедрение инструкции.
Работает ли он в Codex, Gemini CLI и Cursor?
Да как обычный stdio-сервер MCP через Bun, но входящие не пушатся: это расширение Claude Code. Остальные клиенты опрашивают `wait_for_messages`, а настройки доступа делаются командой `bun scripts/access.ts`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныClaude Code берет интервью о вашем бизнесе и сам пишет, тестирует и выкладывает бота для WhatsApp с памятью клиентов
Плагин дает Claude Code доступ к API OpenBSP и позволяет отвечать в WhatsApp, пропуская в канал только выбранные контакты.
MCP-канал, который передает сообщения из WeChat в сессию Claude Code и возвращает ответы агента в тот же чат
Расширение официального плагина Telegram для Claude Code: голосовые сообщения, живой прогресс, кнопки, память и доска агентов
Плагин превращает Claude Code в фонового ассистента: расписание задач, ответы в Telegram, Discord и Slack, веб-панель.
Telegram-бот управляет Claude Code на вашем компьютере: пишете в чат, а агент правит проект и стримит ответ.
Коротко о README
README объясняет, как подключить сессию Claude Code к WhatsApp двумя способами: связанным устройством или официальным Cloud API. Описаны предупреждения о неофициальном протоколе и опасном флаге, установка, выбор подключения, использование в других клиентах MCP, управление доступом из терминала, возможности, расшифровка голоса, диагностика и лицензия Apache-2.0.