Cierras la tapa de la laptop y tu agente de programación en consola se duerme al instante junto con el sistema. La tarea en segundo plano se corta, y si de camino necesitas revisar un repositorio o correr un script, toca buscar Wi-Fi y sacar la computadora. El autor del canal Nate Herk lo resolvió de forma sencilla: subió Claude Code a un servidor en la nube y lo conectó a un bot personal de Telegram. Desde el teléfono le escribe a su bot herc2 «¿Quién soy y con qué debes ayudarme?», arriba aparece typing… y en un par de segundos el agente responde apoyándose en todos sus proyectos y habilidades.
Todo el montaje se sostiene sobre el mecanismo oficial Claude Code Channels y un par de utilidades estándar de Linux. El truco no está en la instalación, sino en tres detalles: bloquear el acceso solo a tu ID de Telegram, asegurar el autoarranque tras un reinicio del servidor y compactar a tiempo el contexto largo. Veamos la configuración paso a paso.
Por qué hace falta un VPS y qué preparar al inicio
La base del esquema es un VPS (servidor privado virtual), una máquina Linux en la nube que funciona 24/7 sin entrar en suspensión. En su video, Nate usó una plantilla de Hostinger con Claude Code preinstalado en un clic, pero sirve cualquier VPS estándar con Ubuntu o Debian y acceso por SSH.
Para el plugin de Telegram en el servidor hacen falta tres piezas: Claude Code versión v2.1.80+, tmux y bun.
tmux(multiplexor de terminal) mantiene viva la sesión en segundo plano: si cierras SSH o se cae internet, el agente sigue trabajando.bunes un runtime rápido de JavaScript/TypeScript. Sobre él, el plugin de Anthropic levanta un servidor MCP local (el puente entre Telegram Bot API y tu sesión).
Conéctate al servidor con un usuario normal (no como root) y revisa el entorno. En el caso de Nate, tmux ya venía instalado, pero faltaba bun; simplemente le pasó el error al propio Claude y obtuvo los comandos:
# Comprobamos versiones: Claude Code debe ser v2.1.80 o superior
claude --version
tmux -V
bun --version
# Instalamos bun si el sistema respondió "command not found"
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc
# Instalamos tmux si no está presente
sudo apt update && sudo apt install -y tmux
La base del servidor está lista. Ahora crea un bot en @BotFather (verifica la insignia azul): envía /newbot, elige un nombre y un username único terminado en bot (por ejemplo, herc2_bot). Incluso a Nate le costó más de un intento cumplir las reglas del nombre, así que prueba con calma hasta dar con uno libre. Copia el token HTTP API con formato 123456789:AAHfiqksKZ8.... Si algún día se filtra, en Telegram Bot API puedes revocarlo al instante con /revoke ante el mismo @BotFather.
Documentación oficial de Claude Code Channels: envío de eventos y mensajes a la sesión mediante servidor MCP (Fuente: code.claude.com)
Conectamos el plugin de Telegram y cerramos el acceso
Ejecuta claude en el servidor e inicia sesión con tu suscripción. Aquí hay dos limitaciones importantes. Primero, los canales solo funcionan con autenticación directa de Anthropic (claude.ai o clave de Console API); no se puede conectar Telegram mediante Bedrock, Vertex ni Foundry. Segundo, en los planes Team y Enterprise los canales vienen desactivados por defecto. Es un tropiezo habitual: hasta que el dueño o administrador de la organización no active channelsEnabled, el bot permanecerá mudo.
Tras iniciar sesión, instala el plugin oficial desde anthropics/claude-plugins-official y pásale el token dentro de la sesión de Claude Code:
# Instalamos el plugin oficial (elige user scope)
/plugin install telegram@claude-plugins-official
# Vinculamos el token de @BotFather
/telegram:configure 123456789:AAHfiqksKZ8...
# Salimos para reiniciar con el flag del canal
/exit
El comando /telegram:configure guarda TELEGRAM_BOT_TOKEN en ~/.claude/channels/telegram/.env. En la práctica, recargar plugins en caliente no siempre funciona, así que resulta más fiable salir con /exit y levantar enseguida la sesión dentro de tmux con el flag --channels:
# Iniciamos sesión en segundo plano con tmux y conectamos el canal Telegram
tmux new -s claude-tg
claude --channels plugin:telegram@claude-plugins-official
Ahora escríbele /start o cualquier mensaje a tu bot en Telegram. Responderá con un código de emparejamiento (pairing code) de 6 caracteres de un solo uso, que vincula tu ID numérico de Telegram sin tener que buscarlo a mano. Pero emparejar no basta: mientras la política siga abierta, cualquier desconocido podrá hablarle al bot. Justo después de vincular tu cuenta, activa una allowlist estricta:
# Confirmamos nuestra cuenta con el código de 6 dígitos del bot
/telegram:access pair A1B2C3
# Cerramos el acceso a cualquier extraño
/telegram:access policy allowlist
A partir de ese momento el bot solo te responde a ti. Manda «Hola» desde el teléfono: arriba saldrá typing… (el plugin envía el indicador de escritura, divide respuestas largas en partes y guarda fotos entrantes de hasta 50 MB en ~/.claude/channels/telegram/inbox/), y en la ventana de tmux el texto llegará directo a la consola del agente.
Supervivencia tras reinicios y traslado seguro de .env
Una sesión manual de tmux sobrevive a un corte de SSH, pero desaparece en cuanto reinicias el VPS. Para que el agente arranque solo, configúralo como servicio de systemd y define de una vez CLAUDE_CODE_AUTO_COMPACT_WINDOW=400k (abajo veremos por qué 400k). Crea /etc/systemd/system/claude-telegram.service y sustituye ubuntu por tu usuario:
# /etc/systemd/system/claude-telegram.service
[Unit]
Description=Claude Code Telegram Channel in tmux
After=network-online.target
Wants=network-online.target
[Service]
Type=forking
User=ubuntu
WorkingDirectory=/home/ubuntu/workspace
# Ruta a bun y claude (verifica con `which bun` y `which claude`)
Environment="PATH=/home/ubuntu/.bun/bin:/usr/local/bin:/usr/bin:/bin"
Environment="CLAUDE_CODE_AUTO_COMPACT_WINDOW=400k"
ExecStart=/usr/bin/tmux new-session -d -s claude-tg \
"claude --channels plugin:telegram@claude-plugins-official"
ExecStop=/usr/bin/tmux kill-session -t claude-tg
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target
Activa el autoarranque y revisa el estado (si claude está en ~/.local/bin, añade esa ruta al PATH, o el servicio no encontrará el binario):
# Aplicamos el unit-file, iniciamos y verificamos el estado
sudo systemctl daemon-reload
sudo systemctl enable --now claude-telegram.service
sudo systemctl status claude-telegram.service
La única prueba fiable del autoarranque es ejecutar sudo reboot, esperar un minuto y escribirle al bot en Telegram. Si el agente contesta, todo levantó limpio.
Después lleva al servidor tu repositorio de trabajo (en el caso de Nate es Herc2, con todas sus habilidades y proyectos) y copia por separado el .env con las claves de API:
# Clonamos el repositorio de trabajo en el servidor
git clone git@github.com:your-user/your-workspace.git ~/workspace
# Copiamos .env desde la laptop mediante scp cifrado
scp .env ubuntu@<ip-del-servidor>:~/workspace/.env
# En el servidor cerramos el archivo a lecturas ajenas
chmod 600 ~/workspace/.env
Una advertencia importante de seguridad. En su ejemplo, Nate trabaja como root, guarda la contraseña de root en .env y se la entrega a su Claude local para que arregle el servidor por SSH. Para una demo rápida es cómodo, pero en producción es peligroso: tener la contraseña de root en archivos del proyecto y en el contexto del modelo es el camino directo a perder el servidor.
Checklist de seguridad para un VPS con agente
- Crea un usuario separado sin privilegios root, entra por clave SSH y desactiva el acceso root con contraseña.
- Comprueba que
.envfigure en.gitignorey nunca suba a GitHub. - Transfiere secretos por
scpcon permisoschmod 600. - No pegues contraseñas en el chat con la IA; para depurar consulta
journalctl -u claude-telegram.service.
Frenamos el deterioro del chat a los 400k tokens
En una terminal normal sueles abrir una sesión nueva para cada tarea. En Telegram es distinto: el canal mantiene una única sesión infinita. Sin ajustes, el historial crece casi hasta el umbral estándar de unos 960k tokens y empieza el deterioro del contexto (context rot): por culpa de una cola enorme de logs antiguos, el modelo obedece peor las instrucciones recientes y gasta tokens de más.
La autocompactación (auto-compact) resume automáticamente la conversación vieja en una síntesis breve. Nate baja el umbral a 400k tokens: basta para recordar la tarea actual sin saturar la atención del modelo. En systemd ya fijamos CLAUDE_CODE_AUTO_COMPACT_WINDOW=400k, y si prefieres ajustar el límite en porcentaje de la ventana, usa la variable CLAUDE_AUTOCOMPACT_PCT_OVERRIDE (de 1 a 100, por ejemplo 40–50). Prueba el simulador de abajo para ver la cadena de paso de mensajes y el efecto del umbral de compresión.
Simulador de VPS + Telegram y umbral de autocompactación
Un último límite que conviene recordar: Telegram Bot API no entrega a los bots el historial pasado ni permite buscar mensajes antiguos. El agente solo ve lo que llega mientras está encendido, así que guarda todas tus instrucciones de trabajo, notas y guiones en archivos del repositorio Git en el servidor, no en el hilo del chat.


