Intensivo Gratis 21–22.11Intensivo gratuito de 2 días en Vibecoding (21–22 nov, 16:00 MSK) · Cohorte 3 inicia 23.11Registrarse gratis →Cohorte 3 (23.11)
IndustriaCódigo / SDK · Listo para usarHabr AI→ original

AcpGram permite controlar Claude Code, Codex y Gemini CLI directamente desde Telegram

Claude Code, Codex y Gemini CLI son asistentes de IA para programadores que funcionan solo en la terminal: lanzas una tarea y tienes que quedarte junto al equipo. AcpGram es un bot gratuito de Telegram que los ejecuta en tu servidor y convierte el trabajo en un chat. El progreso de la tarea se muestra en un solo mensaje, y la edición de un archivo o la ejecución de un comando se aprueban con un botón desde el smartphone. Así puedes dejar que el agente trabaje desde casa.

Procesado por IA desde Habr AI; editado por Hamidun News
AcpGram permite controlar Claude Code, Codex y Gemini CLI directamente desde Telegram
Fuente: Habr AI. Collage: Hamidun News.
Escuchar artículo
Ficha técnica y cifras clave
ParámetroDatos
Fuente originalHabr AI ↗
Editor jefe
Dato clave #1Compatible con Gemini CLI, Claude Code, Codex y Antigravity CLI
Cuatro niveles de acceso para el equipoRead, Normal, Full y Admin
Dato clave #3Node.js 24 sin dependencias de npm, sesiones en SQLite y licencia MIT

Claude Code, Codex, Gemini CLI y Antigravity CLI son agentes de IA para programadores: leen el repositorio por sí solos, editan archivos y ejecutan comandos. Todos funcionan en la terminal, y eso resulta incómodo. Lanzas una tarea y, a partir de ahí, o te quedas frente al monitor o te vas sin saber si el agente se ha quedado atascado en la pregunta «¿puedo ejecutar este comando?»

El desarrollador con el alias selesnow ha publicado AcpGram, una pasarela de código abierto que traslada el control de estos agentes a Telegram. El agente sigue trabajando en tu servidor doméstico o de trabajo, mientras tú lo supervisas y pulsas botones en el chat desde el smartphone. El nombre procede del protocolo ACP (Agent Client Protocol), sobre el que se construye todo.

Cómo funciona: un protocolo en lugar de cuatro interfaces

ACP es una forma de intercambiar mensajes entre un programa y un agente en formato JSON-RPC a través de los flujos estándar de entrada y salida. AcpGram lanza el agente de consola como subproceso en tu máquina y se comunica con él mediante ese protocolo, mientras que hacia fuera muestra un chat habitual.

Se admiten cuatro motores. Gemini CLI (gemini --acp) y Antigravity CLI (agy acp) entienden ACP de serie. Para Claude Code y OpenAI Codex, el autor utiliza puentes ACP ligeros independientes: claude-agent-acp y codex-acp. Para el usuario, la diferencia queda oculta: el cambio de proyectos, sesiones y permisos funciona igual en todos, y puedes cambiar de motor con el comando /engine. El modelo y el nivel de razonamiento se eligen con /model, y la elección se guarda por separado para cada usuario y motor.

El proyecto está escrito en Node.js 24 puro, sin una sola dependencia de npm, y funciona en Windows, Linux y macOS. Desde el punto de vista de la ingeniería, eso es una ventaja: la cadena de suministro es más corta y hay menos riesgo de que un servicio con acceso a tu código se rompa por una actualización ajena.

Qué se ve en el chat y cómo controlar al agente

Mientras el agente trabaja, sus respuestas, sus «pensamientos» y la lista de pasos (lectura de archivos, ejecución de comandos, búsquedas, ediciones) se actualizan en un único borrador de mensaje, en lugar de llegar en decenas de réplicas sueltas. Ahí mismo se ve el tiempo de ejecución. Si el agente entra en un bucle, se detiene con /stop.

Al terminar llega un informe estructurado con encabezados, listas, tablas y resaltado de código. Debajo se oculta un registro de pasos plegable. En el pie se indican el motor, el modelo, el nivel de razonamiento, los tokens y el tiempo, y en el caso de Claude Code también el coste real de la solicitud. Para quienes controlan el gasto en tokens, es un detalle útil: se ve cuánto costó una tarea concreta directamente en la conversación.

Cuando el agente quiere modificar un archivo o ejecutar un script de shell, el bot envía botones en línea: «Permitir», «Permitir en esta sesión» o «Rechazar». Según describe el autor, el sistema descarta las opciones que elevarían la sesión por encima de los permisos del usuario actual.

Para los comandos existe un modo multiusuario. A los compañeros se les invita mediante enlaces de un solo uso (/invite), y el administrador fija el nivel de acceso: Read, Normal, Full o Admin. También asigna los motores y modelos permitidos y consulta los usuarios activos (/users, /active). Los niveles cambian la autonomía del agente: desde el análisis seguro del código hasta la aplicación automática de cambios sin confirmaciones. Las sesiones, las solicitudes, las llamadas a herramientas y los tokens se escriben en una base SQLite integrada (node:sqlite), por lo que el historial puede recuperarse con /sessions incluso después de reiniciar el bot. Como efecto colateral, se obtiene un registro de auditoría listo para usar.

Instalación y limitaciones

La instalación se hace con un solo comando. En Windows es el script de PowerShell install.ps1, y en Linux y macOS, install.sh. Según el autor, el instalador verifica las sumas de control y, si es necesario, descarga un binario aislado de Node.js 24 sin privilegios de administrador. Después añade acpgram al PATH y lanza el asistente acpgram setup, que comprueba el token del bot, toma tu ID de Telegram como administrador y ayuda a configurar las claves de API.

Para que el bot sobreviva a los reinicios se instala como servicio con npm run service:install: en Windows se usa NSSM, en Linux, systemd --user, y en macOS, launchd. También existe una variante con Docker Compose. En ese caso, los agentes solo ven la carpeta de proyectos montada (PROJECTS_DIR), y las sesiones y la configuración se guardan en volúmenes persistentes. Si permites que el agente ejecute comandos en el servidor, el contenedor limita el posible daño.

Hacen falta algunas advertencias. Es un proyecto personal de un único autor que, según sus palabras, se ha convertido en una herramienta «bastante madura». En el material no hay reseñas independientes ni auditoría de seguridad. El bot tiene acceso a tu código y a la shell de comandos, así que los niveles Full y Admin conviene concederlos con cautela. El token del bot y el ID del administrador es mejor guardarlos como secretos. Además, cada motor requiere su propia autorización: la clave de Gemini, la clave de Anthropic o una suscripción, el inicio de sesión con una cuenta de Google para Antigravity, y un token para Codex. Los tokens y las suscripciones siguen bajo tu control.

La conclusión práctica: si ya ejecutas agentes en una máquina dedicada o en un VPS, AcpGram te permite no mantener la terminal abierta ni perder las solicitudes de confirmación. El código se publica bajo la licencia MIT, así que puede leerse, auditarse y adaptarse a tu equipo.

Historia

Preguntas frecuentes sobre la noticia

Cómo funciona: un protocolo en lugar de cuatro interfaces?

ACP es una forma de intercambiar mensajes entre un programa y un agente en formato JSON-RPC a través de los flujos estándar de entrada y salida. AcpGram lanza el agente de consola como subproceso en tu máquina y se comunica con él mediante ese protocolo, mientras que hacia fuera muestra un chat habitual. Se admiten cuatro motores. Gemini CLI (gemini --acp) y Antigravity CLI (agy acp) entienden ACP de serie.

¿Qué se sabe sobre Qué se ve en el chat y cómo controlar al agente?

Mientras el agente trabaja, sus respuestas, sus «pensamientos» y la lista de pasos (lectura de archivos, ejecución de comandos, búsquedas, ediciones) se actualizan en un único borrador de mensaje, en lugar de llegar en decenas de réplicas sueltas. Ahí mismo se ve el tiempo de ejecución. Si el agente entra en un bucle, se detiene con /stop. Al terminar llega un informe estructurado con encabezados, listas, tablas y resaltado de código. Debajo se oculta un registro de pasos plegable.

¿Qué se sabe sobre Instalación y limitaciones?

La instalación se hace con un solo comando. En Windows es el script de PowerShell install.ps1, y en Linux y macOS, install.sh. Según el autor, el instalador verifica las sumas de control y, si es necesario, descarga un binario aislado de Node.js 24 sin privilegios de administrador. Después añade acpgram al PATH y lanza el asistente acpgram setup, que comprueba el token del bot, toma tu ID de Telegram como administrador y ayuda a configurar las claves de API.

ZK
Zhemal Khamidun — CPO de Alpina Digital, product manager de AlpinaGPT. Crea productos de IA desde 2019. Hamidun News es un proyecto personal que creció hasta ser un agregador en producción con más de 6.000 lectores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
¿Qué te parece?
Cargando comentarios…