Интенсив 21–22.11 · БесплатноБесплатный 2-дневный интенсив по вайбкодингу 21–22 ноября в 16:00 МСК (Сб–Вс) · Живой Поток 3 стартует 23.11Записаться бесплатно →Поток 3 (23.11)
РелизКод / SDK · В работуHabr AI→ оригинал

AcpGram позволяет управлять Claude Code, Codex и Gemini CLI прямо из Telegram

Claude Code, Codex и Gemini CLI — ИИ-помощники для программистов, которые работают только в терминале: запустил задачу и сидишь рядом. AcpGram — бесплатный Telegram-бот, который запускает их на вашем сервере и превращает работу в чат. Ход задачи виден в одном сообщении, а правку файла или запуск команды вы подтверждаете кнопкой со смартфона. Так агента можно оставить работать дома.

AI-обработка оригинала Habr AI; редакция Hamidun News
AcpGram позволяет управлять Claude Code, Codex и Gemini CLI прямо из Telegram
Источник: Habr AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникHabr AI ↗
Главный редактор
Ключевой факт #1Работает с Gemini CLI, Claude Code, Codex и Antigravity CLI
Четыре уровня доступаRead, Normal, Full, Admin для команды
Ключевой факт #3Node.js 24 без npm-зависимостей, сессии в SQLite, лицензия MIT

Claude Code, Codex, Gemini CLI и Antigravity CLI — это ИИ-агенты для программистов: они сами читают репозиторий, правят файлы и запускают команды. Все они работают в терминале, и это неудобно. Запустил задачу, и дальше либо сидишь у монитора, либо уходишь и не знаешь, не застрял ли агент на вопросе «можно ли мне выполнить эту команду?». Разработчик под ником selesnow выложил AcpGram — открытый шлюз, который переносит управление такими агентами в Telegram. Агент продолжает работать на вашем домашнем или рабочем сервере, а вы следите за ним и нажимаете кнопки в чате со смартфона. Название происходит от протокола ACP (Agent Client Protocol), на котором всё построено.

Как это устроено: один протокол вместо четырёх интерфейсов

ACP — это способ обмена сообщениями между программой и агентом в формате JSON-RPC через стандартные потоки ввода-вывода. AcpGram запускает консольного агента как подпроцесс на вашей машине и общается с ним по этому протоколу, а наружу показывает привычный чат.

Поддерживаются четыре движка. Gemini CLI (gemini --acp) и Antigravity CLI (agy acp) понимают ACP из коробки. Для Claude Code и OpenAI Codex автор использует отдельные лёгкие ACP-мосты — claude-agent-acp и codex-acp. Для пользователя разница скрыта: переключение проектов, сессий и выдача разрешений работают одинаково, а сменить движок можно командой /engine. Модель и уровень рассуждений выбираются через /model, и выбор запоминается отдельно для каждого пользователя и движка.

Сам проект написан на чистом Node.js 24 без единой npm-зависимости и работает на Windows, Linux и macOS. С инженерной точки зрения это плюс: меньше цепочка поставок, которую нужно проверять, и меньше шансов, что сервис с доступом к вашему коду сломается из-за чужого обновления.

Что видно в чате и как контролировать агента

Пока агент работает, его ответы, «мысли» и список шагов (чтение файлов, запуск команд, поиск, правки) обновляются в одном черновике сообщения, а не сыплются десятками отдельных реплик. Там же видно время выполнения. Если агент зациклился, его останавливает /stop.

По завершении приходит структурированный отчёт с заголовками, списками, таблицами и подсветкой кода. Под ним прячется сворачиваемый лог шагов. В футере указаны движок, модель, уровень рассуждений, токены и время, а для Claude Code ещё и реальная стоимость запроса. Для тех, кто считает расходы на токены, это полезная деталь: видно, сколько стоила конкретная задача, прямо в переписке.

Когда агент хочет изменить файл или выполнить shell-скрипт, бот присылает инлайн-кнопки: «Разрешить», «Разрешить на эту сессию» или «Отклонить». По описанию автора, система отсекает опции, которые подняли бы сессию выше прав текущего пользователя.

Для команд предусмотрен многопользовательский режим. Коллег приглашают одноразовыми ссылками (/invite), а администратор задаёт уровень доступа: Read, Normal, Full или Admin. Он же назначает разрешённые движки и модели и смотрит активных пользователей (/users, /active). Уровни меняют автономность агента: от безопасного анализа кода до автоматического применения правок без подтверждений. Сессии, запросы, вызовы инструментов и токены пишутся во встроенную SQLite-базу (node:sqlite), поэтому историю можно поднять через /sessions даже после перезапуска бота. Побочный эффект — готовый журнал аудита.

Установка и ограничения

Установка делается одной командой. На Windows это PowerShell-скрипт install.ps1, на Linux и macOS — install.sh. По описанию автора, установщик проверяет контрольные суммы и при необходимости скачивает изолированный бинарник Node.js 24 без прав администратора. Затем он добавляет acpgram в PATH и запускает мастер acpgram setup: тот проверяет токен бота, подхватывает ваш Telegram ID как администратора и помогает прописать API-ключи.

Чтобы бот переживал перезагрузки, его ставят как службу через npm run service:install: на Windows используется NSSM, на Linux — systemd --user, на macOS — launchd. Есть и вариант с Docker Compose. Там агенты видят только примонтированную папку проектов (PROJECTS_DIR), а сессии и настройки лежат в постоянных томах. Если вы дадите агенту выполнять команды на сервере, контейнер ограничивает возможный ущерб.

Оговорки нужны. Это личный проект одного автора, который, по его словам, вырос в «вполне зрелый» инструмент. Независимых отзывов и аудита безопасности в материале нет. Бот получает доступ к вашему коду и командной оболочке, поэтому уровни Full и Admin стоит выдавать осторожно. Токен бота и ID администратора лучше хранить как секреты. Кроме того, каждый движок требует собственной авторизации: ключ Gemini, ключ Anthropic или подписка, вход через Google-аккаунт для Antigravity, токен для Codex. Токены и подписки остаются на вашей стороне.

Практический вывод: если вы уже гоняете агентов на выделенной машине или VPS, AcpGram позволяет не держать терминал открытым и не пропускать запросы на подтверждение. Код открыт под лицензией MIT, поэтому его можно прочитать, проверить и подстроить под свою команду.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: как это устроено: один протокол вместо четырёх интерфейсов?

ACP — это способ обмена сообщениями между программой и агентом в формате JSON-RPC через стандартные потоки ввода-вывода. AcpGram запускает консольного агента как подпроцесс на вашей машине и общается с ним по этому протоколу, а наружу показывает привычный чат. Поддерживаются четыре движка. Gemini CLI (gemini --acp) и Antigravity CLI (agy acp) понимают ACP из коробки. Для Claude Code и OpenAI Codex автор использует отдельные лёгкие ACP-мосты — claude-agent-acp и codex-acp.

Что известно по теме: что видно в чате и как контролировать агента?

Пока агент работает, его ответы, «мысли» и список шагов (чтение файлов, запуск команд, поиск, правки) обновляются в одном черновике сообщения, а не сыплются десятками отдельных реплик. Там же видно время выполнения. Если агент зациклился, его останавливает /stop. По завершении приходит структурированный отчёт с заголовками, списками, таблицами и подсветкой кода. Под ним прячется сворачиваемый лог шагов.

Что известно по теме: установка и ограничения?

Установка делается одной командой. На Windows это PowerShell-скрипт install.ps1, на Linux и macOS — install.sh. По описанию автора, установщик проверяет контрольные суммы и при необходимости скачивает изолированный бинарник Node.js 24 без прав администратора. Затем он добавляет acpgram в PATH и запускает мастер acpgram setup: тот проверяет токен бота, подхватывает ваш Telegram ID как администратора и помогает прописать API-ключи.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Практика · Hamidun Academy

Соберите рабочего ИИ-агента или сервис своими руками без ручного кода

В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.

Открыть 72ч бесплатный доступ →Интенсив по Вайб-кодингу
Что вы думаете?
Загружаем комментарии…