Канал MAX для Claude Code
max-gateway
Надежный демон и плагин-мост: общайся со своей сессией Claude Code из мессенджера MAX, с фото, голосом и кнопками
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Дает прямой доступ к живой сессии Claude Code через сообщения из MAX
- Команда /restart может перезапускать сессию, а расшифровка голоса уходит на сторонний сервис Groq
Установка
Ручная установка
MAX_BOT_TOKEN="<токен>" MAX_STATE_DIR="$HOME/.claude/channels/max-claude5" bun gateway/gateway.ts pairСпаривание с ботом MAX, захватывает user_id и chat_id владельца.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект переносит на MAX Bot API идею tg-gateway того же автора: демон под systemd держит постоянное соединение с MAX через устойчивый long-poll, который не сдается при первой сетевой ошибке, в отличие от официального mcp-max-messenger. Тонкий плагин-мост вставляет входящие сообщения в открытую сессию Claude Code и отправляет ответы обратно в MAX. Входящие: текст, фото со скачиванием, голос и аудио с расшифровкой через Groq Whisper, видео, файлы и нажатия кнопок. Исходящие: текст с разбивкой на части, фото и файлы, инлайн-кнопки, ответ-тред, индикатор печати (у ботов MAX нет эмодзи-реакций). Есть командная панель /menu /ping /status /screen /restart /logs /model /mcp с allowlist администраторов для серверного развертывания в tmux, а также PID-lock, watchdog, heartbeat и плавный рестарт. Если сессия или мост на миг отвалились, демон буферизует входящие и ничего не теряет.
Для кого. Для тех, кто хочет писать своему Claude Code из MAX так же, как уже делает это из Telegram.
Подходит, если
- Нужен надежный канал MAX для Claude Code вместо официального моста с хрупким long-poll
- Нужно управлять сессией удаленно: смотреть экран, статус, перезапускать по команде из MAX
- Нужна расшифровка голосовых сообщений в MAX прямо в диалоге с агентом
Не подходит, если
- Нужен канал только для чтения без панели администрирования и tmux-деплоя
- Не хочется держать systemd-демон постоянно запущенным на сервере
Пример запроса к агенту
Из MAX боту: /status, а затем голосовым сообщением: перезапусти сессию и покажи последние логиОграничения
Расшифровка голоса идет через Groq Whisper, то есть зависит от внешнего сервиса. Демон рассчитан на систему с systemd, серверный tmux-деплой и администраторский allowlist подразумевают некоторую настройку. Лицензия в репозитории не указана.
Как отключить. Останови и отключи демон systemctl --user disable --now max-gateway и удали плагин командой claude plugin uninstall max.
Проверка безопасности
- Дает прямой доступ к живой сессии Claude Code через сообщения из MAX
- Команда /restart может перезапускать сессию, а расшифровка голоса уходит на сторонний сервис Groq
Коротко о README
README на русском описывает проект как надежный канал MAX для Claude Code, порт ранее сделанного tg-gateway. Перечислены возможности: устойчивый long-poll, входящие и исходящие типы контента, командная панель с allowlist, PID-lock и watchdog. Показан быстрый старт под bun и systemd: создание бота через @MasterBot, спаривание с получением user_id и chat_id, поднятие демона и подключение плагина-моста через маркетплейс. Таблица переменных окружения покрывает токен бота, каталог состояния, администраторов, разрешенные чаты, базовый URL API и параметры tmux-рестарта. Отдельно упомянут AGENTS.md для установки ИИ-ассистентом.
Частые вопросы
Чем это лучше официального mcp-max-messenger?
По словам автора, устойчивым long-poll: официальный вариант выходит из цикла опроса при первой сетевой ошибке, а демон max-gateway нет.
Можно ли поставить проект руками ИИ-ассистента?
Да, в комплекте есть AGENTS.md, пошаговый ранбук установки: создание бота, спаривание, деплой под нужную ОС, подключение плагина и удаление.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI