AcpGram позволяет управлять Claude Code, Codex и Gemini CLI прямо из Telegram
Claude Code, Codex и Gemini CLI — ИИ-помощники для программистов, которые работают только в терминале: запустил задачу и сидишь рядом. AcpGram — бесплатный Telegram-бот, который запускает их на вашем сервере и превращает работу в чат. Ход задачи виден в одном сообщении, а правку файла или запуск команды вы подтверждаете кнопкой со смартфона. Так агента можно оставить работать дома.
AI-обработка оригинала Habr AI; редакция Hamidun News
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, поэтому его можно прочитать, проверить и подстроить под свою команду.
- 21 нояб. 2026 г.Anthropic вышла на биржу и привлекла рекордные $107,3 млрд
- 21 нояб. 2026 г.Plannotator даёт комментировать планы 10 ИИ-агентов в браузере: 100 звёзд на GitHub за день
- 21 нояб. 2026 г.Grok Build оставил открытыми 35 578 приложений — 94,7% живых проектов без входа
- 21 нояб. 2026 г.Anthropic собрала на IPO рекордные $107,3 млрд при оценке компании в $1,5 трлн
Вопросы и ответы по материалу
Что известно по теме: как это устроено: один протокол вместо четырёх интерфейсов?
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-ключи.
Соберите рабочего ИИ-агента или сервис своими руками без ручного кода
В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.
Главное из мира ИИ — раз в неделю
7 ключевых событий недели, отобранных вручную. Без шума, репостов и пресс-релизов.
Готово! Проверьте почту — мы отправили подтверждение.