Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

claude-cli-telegram

Convierte terminales Mac/Linux en interfaces remotas controladas vía Telegram usando Claude Code CLI real con acceso completo a herramientas Bash, Read, Write, Edit, Grep, Glob y 30+ comandos nativos.

Ficha actualizada 25 sept 2026, 12:56 · upstream 25 sept 2026, 12:48 · release v1.0.0

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es claude-cli-telegram

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este proyecto transforma tu máquina Mac o Linux en un terminal remoto Claude Code gestionado completamente desde Telegram. A diferencia de los bridges MCP limitados, implementa una arquitectura completa que ejecuta el CLI real con acceso total a herramientas del sistema, gestión avanzada de sesiones y sistema de aprobaciones para operaciones peligrosas.

La solución soporta múltiples modos de salida (terminal, híbrido o Telegram puro), reconocimiento de voz mediante Groq Whisper STT, integración nativa con Git completo (status, diff, log, push/pull) y control remoto de Mac incluyendo gestión de energía. Incluye sistema de aprobaciones duales que funciona con tmux para inyectar respuestas directamente en prompts del terminal sin perder contexto.

El proyecto ofrece gestión completa de sesiones con auto-resumen, rotación de tokens, seguimiento de uso por sesión y comandos rápidos instantáneos como /sh, /sys, /clip. Soporta chats de grupo con listas de usuarios permitidos y denegación automática de operaciones peligrosas para no dueños.

CASOS DE USO
  • Desarrollo remoto desde móvil ejecutando Claude Code CLI real en servidor Linux/Mac
  • Auditoría de seguridad mediante sistema de aprobaciones duales para operaciones críticas como git push, rm -rf o despliegues
  • Automatización de despliegues con confirmación en Telegram antes de ejecutar comandos peligrosos
  • Monitoreo y control remoto de sistemas Linux/Mac incluyendo gestión de energía y reinicios
PUNTOS DESTACADOS
  • Sistema de aprobaciones duales con tmux que inyecta respuestas directamente en prompts nativos del terminal sin perder contexto
  • Gestión completa de sesiones con auto-resumen, rotación de tokens y seguimiento de uso por sesión
  • Integración nativa con Claude Code CLI manteniendo acceso completo a herramientas Bash, Read, Write, Edit, Grep, Glob y 30+ comandos
  • Soporte multilenguaje EN/RU con detección automática y reconocimiento de voz mediante Groq Whisper STT
PRECAUCIONES
  • Dependencia obligatoria de tmux para aprobaciones en terminal sin pérdida de contexto (sin tmux solo funciona fallback takeover)
  • Requerimiento de Groq API key para reconocimiento de voz (no es opcional)
  • Restricción a un solo chat por token del bot
  • Ejecución obligatoria como usuario regular (no root) debido a restricciones de seguridad de Claude Code
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Voice and toolsApprovalApprovedStatusSessions
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Usar role: "primary" en servidor Linux con Mac como standby para evitar silencios cuando el equipo se duerme. Configurar hooks en ~/.claude/settings.json para forwarding de aprobaciones. Ejecutar siempre como usuario regular (no root) debido a restricciones de seguridad de Claude Code que rechaza --dangerously-skip-permissions bajo root.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.