Интеграция Claude Code с Telegram и WhatsApp

Что такое Claude AI и Claude Code?

Claude AI — семейство больших языковых моделей (Haiku‚ Sonnet‚ Opus)‚ обученных по принципу Constitutional AI для безопасности‚ точности и полезности. Claude Code — это локальная среда выполнения‚ которая упаковывает модель в виде агента‚ способного:

• принимать команды через текстовый интерфейс;
• выполнять код (Python‚ Bash‚ JS и др.);
• подключать внешние инструменты (Git‚ Notion‚ Google Calendar и т.д.) через skills;
• поддерживать долгосрочную память между сессиями.

Для работы с мессенджерами Anthropic выпустила функцию Claude Code Channels (research preview‚ доступна с версии v2.1.80). Она позволяет привязать агента к Telegram‚ Discord‚ Slack‚ WhatsApp и другим платформам через специальные плагины‑мосты.

Интеграция с Telegram

Telegram считается самым простым стартовым каналом благодаря развитой Bot API‚ наличию десктоп‑‚ веб‑ и мобильных клиентов‚ а также поддержке голосовых сообщений.

Шаг‑за‑шаг: подключение через официальный плагин Claude Code Channels

1. Установить Claude Code (если ещё не установлен):

   pip install claude-code

2. Получить токен бота в BotFather (/newbot) и сохранить его в переменной окружения TELEGRAM_BOT_TOKEN.
3. Запустить Claude Code с указанием канала:

   claude-code --channels telegram --telegram-token $TELEGRAM_BOT_TOKEN

4. Отправить любое сообщение боту, Claude ответит в том же чате.

Пример взаимодействия:

Вы: /run python -c "print('Привет от Claude!')"
Claude: Привет от Claude!

Альтернативные решения

• ClaudeClaw — открытый MIT‑плагин‚ который запускает Claude как постоянный агент и пересылает сообщения между Slack‚ WhatsApp и Telegram. Установка: git clone https://github.com/yourname/claudeclaw && cd claudeclaw && pip install -r requirements.txt && python claudeclaw.py.
• linuz90/claude-telegram-bot — готовый бот с поддержкой голосового ввода (OpenAI Whisper) и подключением к MCP‑серверам (Gmail‚ Calendar‚ Notion).

Преимущества Telegram:

• Минимальная конфигурация (только токен бота).
• Поддержка медиа‚ голосовых сообщений и inline‑кнопок.
• Лёгкая отладка через веб‑хуки или long polling.

Интеграция с WhatsApp

WhatsApp не предоставляет публичный Bot API для обычных аккаунтов‚ но существует несколько обходных путей:

1. Использовать официальный WhatsApp Business API (требует одобрения и оплаты).
2. Применить community‑плагины‚ которые работают через libwhatsapp или Yowsup и эмулируют клиент.

На практике самым простым способом является плагин crisandrews/claude-whatsapp (MIT‑лицензия)‚ который подключает ваш личный WhatsApp‑аккаунт к Claude Code через QR‑сканирование‚ аналогично WhatsApp Web.

Установка и запуск claude-whatsapp

1. Клонировать репозиторий:

   git clone https://github.com/crisandrews/claude-whatsapp.git
   cd claude-whatsapp

2. Установить зависимости:

   pip install -r requirements.txt

3. Запустить скрипт:

   python whatsapp_claude.py

4. Откроется терминал с QR‑кодом. Отсканируйте его камерой телефона в WhatsApp → «Подключенные устройства» → «Подключить устройство».
5. После успешного сканирования бот будет готов принимать сообщения в любом чате (личном или групповом).

Пример использования

Вы: @claude суммируй последнее сообщение в группе
Claude: [Краткое резюме сообщения]
Вы: @claude создай задачу в Notion: подготовить отчёт по продажам за май
Claude: Задача создана в Notion (ссылка: https://www.notion.so/...)

Особенности плагина:

• Поддержка голосовых сообщений (транскрибирование через Whisper).
• Контроль доступа — можно указать список разрешенных номеров.
• Возможность прикреплять файлы‚ изображения и документы.
• Работает в фоновом режиме‚ не требует постоянного открытого веб‑клиента.

Интеграция с Slack

Slack предлагает богатую экосистему приложений и веб‑хуков‚ что делает его идеальным каналом для командной работы.

Вариант 1: Официальные Claude Code Channels

С версии v2.1.80 Anthropic добавила поддержку Slack напрямую:

1. Создать Slack App в api.slack.com и добавить_scope chat:write‚ im:read‚ im:write.
2. Установить приложение в workspace и скопировать Bot User OAuth Token (начинается с xoxb-).
3. Запустить Claude Code:

claude-code --channels slack --slack-token $SLACK_BOT_TOKEN

После этого бот появится в списке приложений и сможет получать личные сообщения или упоминаться в каналах (@claude).

Вариант 2: Плагин ClaudeClaw

ClaudeClaw также поддерживает Slack через тот же механизм‚ что и Telegram/WhatsApp. Достаточно добавить переменную окружения SLACK_BOT_TOKEN и запустить:

python claudeclaw.py

Плагин будет слушать события message.im и app_mention‚ пересылать их агенту Claude и возвращать ответ.

Практический пример: автоматизация код‑ревью

Предположим‚ команда использует Slack‑канал #code-reviews. Настроим бота так‚ чтобы при упоминании @claude review он запускал анализ пул‑реквеста:

Вы: @claude review https://github.com/org/repo/pull/42
Claude: Запускаю анализ PR #42...
Claude: Предлагаю исправить файлы: src/auth.py‚ utils/helpers.py

Для этого достаточно добавить в skills Claude Code скрипт‚ который принимает URL PR‚ вызывает gh api или GitHub API и возвращает результаты.

Преимущества Slack‑интеграции

• Лёгкая настройка прав доступа через Scopes.
• Возможность использования slash‑commands и interactive components для более сложных диалогов.
• Интеграция с существующими workflow‑инструментами (Jira‚ CI/CD‚ Notion) через уже существующие Slack‑приложения или собственные skills.

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

Для индивидуальных разработчиков и небольших команд часто выбирают Telegram из‑за простоты. WhatsApp удобен‚ когда нужно работать в привычном мессенджере клиента или коллеги‚ а Slack — лучший выбор для крупных команд‚ где требуется глубокая интеграция с корпоративными инструментами.

Лучшие практики и советы

• Безопасность: никогда не храните токены в открытом репозитории. Используйте .env файлы и добавьте их в .gitignore.
• Ограничение доступа: в Telegram и Slack можно настроить‚ чтобы бот отвечал только на сообщения от определённых пользователей или в конкретных чатах.
• Асинхронная обработка: для длительных операций (например‚ запуск тестов или сборка) используйте очереди (Redis‚ RabbitMQ) и уведомляйте пользователя по завершению.
• Логирование: ведите журнал входящих/исходящих сообщений и ошибок, это упрощает отладку и аудит.
• Обновление навыков: регулярно добавляйте новые skills (например‚ работу с Docker‚ Kubernetes‚ облачными функциями) через claude-code skill add.
• Тестирование: перед выкладкой в продакшн проверяйте работу бота в отдельном «sandbox»‑workspace или тестовой группе.