Claude Code Channels: Controla tu terminal desde Telegram

El 20 de marzo de 2026, Anthropic lanzó Claude Code Channels, una funcionalidad que permite enviar mensajes desde Telegram (o Discord) directamente a tu sesión de Claude Code. En otras palabras: puedes pedirle cosas a Claude Code desde el móvil mientras la sesión sigue corriendo en tu ordenador.

Lo he probado de primera mano y te cuento exactamente cómo funciona, cómo configurarlo, y qué limitaciones tiene.

¿Qué es exactamente?

Channels es un plugin basado en MCP que actúa como puente entre Telegram y tu sesión de Claude Code. El flujo es simple:

1. Envías un mensaje a tu bot de Telegram desde el móvil

2. El plugin reenvía ese mensaje a tu sesión de Claude Code en la terminal

3. Claude ejecuta lo que le pidas (leer archivos, ejecutar comandos, escribir código...)

4. Te responde por Telegram

Tu código nunca sale de tu máquina. Solo los mensajes de chat viajan por el canal. Claude Code sigue ejecutándose localmente con acceso completo a tu proyecto.

Requisitos

• Claude Code v2.1.80 o superior

• Autenticación con cuenta claude.ai (no vale API key directa)

• Bun instalado (no funciona con Node.js)

• Plan Pro, Max, Team o Enterprise

• Telegram instalado en tu móvil o desktop

Setup paso a paso

1. Instalar Bun

Si no lo tienes instalado:

curl -fsSL https://bun.sh/install | bash
source ~/.zshrc  # o source ~/.bashrc si usas bash
bun --version

2. Crear un bot en Telegram

Abre Telegram y busca @BotFather. Envíale:

/newbot

Te pedirá dos cosas:

• Name: el nombre visible del bot (ej: "Mi Claude Code")

• Username: un handle único que termine en bot (ej: mi_claude_code_bot)

BotFather te devolverá un token con un formato tipo 123456789:AAHfiqksKZ8.... Cópialo entero, incluido el número y los dos puntos.

3. Instalar el plugin en Claude Code

Abre Claude Code y ejecuta:

/plugin install telegram@claude-plugins-official

Selecciona "Install for you (user scope)".

Después recarga los plugins:

/reload-plugins

4. Configurar el token

/telegram:configure <tu-token-de-botfather>

Te pedirá varios permisos para crear los archivos de configuración en ~/.claude/channels/telegram/. Acepta todos.

Si el comando /telegram:configure no es reconocido, puedes configurarlo manualmente:

mkdir -p ~/.claude/channels/telegram
echo "TELEGRAM_BOT_TOKEN=<tu-token>" > ~/.claude/channels/telegram/.env

5. Lanzar con el flag de channels

Sal de Claude Code y relanza con:

claude --channels plugin:telegram@claude-plugins-official

Verás el mensaje "Listening for channel messages from: plugin:telegram@claude-plugins-official". Eso significa que está escuchando.

6. Vincular tu cuenta de Telegram

En Telegram, busca tu bot por su username y envíale cualquier mensaje (un "Hola" vale). El bot te responderá con un código de 6 caracteres.

Vuelve a Claude Code e introduce:

/telegram:access pair <código>

Acepta los permisos que te pida.

7. Bloquear el acceso

Esto es importante. Por defecto, cualquiera que encuentre tu bot puede solicitar un código de pairing. Bloquéalo:

/telegram:access allowlist

A partir de ahora solo tú puedes interactuar con el bot.

¿Cómo se ve en la práctica?

Una vez configurado, envías un mensaje desde Telegram:

Hola, ¿qué proyecto tengo abierto?

En tu terminal ves cómo Claude recibe el mensaje, procesa la petición, y envía la respuesta de vuelta a Telegram. En mi caso, me respondió correctamente que tenía abierto el proyecto "cursosdesarrolloweb", describiendo que es una plataforma de aprendizaje construida con Laravel.

Es exactamente como si estuvieras sentado delante de la terminal, pero desde el sofá, la calle, o donde sea.

Casos de uso para desarrolladores Laravel

Supervisar un deploy mientras no estás en el ordenador

Lanzas un deploy con Forge o Envoyer, te vas a comer, y desde Telegram:

¿Está respondiendo https://miapp.com/api/health?

Revisar los logs desde el móvil

¿Hay errores nuevos en storage/logs/laravel.log de los últimos 30 minutos?

Comprobar el estado de las colas

Ejecuta php artisan queue:monitor y dime si hay jobs pendientes

Lanzar los tests de una feature

Ejecuta php artisan test --filter=PaymentTest y dime los resultados

Consultar el estado de una migración

¿Se ha completado la migración? Comprueba si el proceso sigue corriendo

Combinar con /loop

La combinación más potente: un /loop vigilando algo que te notifica por Telegram cuando detecta un problema. Configuras el loop antes de irte y recibes alertas en el móvil. Si no conoces /loop, te lo explico a fondo en este artículo.

Limitaciones que debes conocer

Después de probarlo, estas son las limitaciones reales:

Tu ordenador debe estar encendido. Claude Code se ejecuta localmente. Si cierras la terminal o apagas el ordenador, el bot deja de responder. Necesitas mantener la sesión abierta (tmux o screen ayudan aquí).

Los permisos no se pueden aprobar desde Telegram. Si Claude necesita permiso para ejecutar un comando o editar un archivo, se queda esperando hasta que lo apruebes en la terminal. Existe la opción --dangerously-skip-permissions para saltarse esto, pero como su nombre indica, es peligroso, no lo recomiendo.

No hay confirmación de entrega. Envías un mensaje y no sabes si Claude lo ha recibido, si está procesándolo, o si se ha perdido. El indicador "typing..." de Telegram aparece mientras trabaja, pero si hay un fallo silencioso, no te enteras.

Es research preview. La funcionalidad puede cambiar. No construyas workflows críticos sobre algo que aún está en beta.

El setup pide muchos permisos. Durante la configuración, Claude Code te va a pedir confirmación para prácticamente cada archivo que toca. Es tedioso pero necesario.

Un solo bot por sesión. Si abres otra sesión de Claude Code con el mismo bot, pueden competir por los mensajes y perder algunos.

Seguridad

Algunas consideraciones de seguridad:

• Sin el flag --dangerously-skip-permissions, cada acción requiere tu aprobación en la terminal. Nadie puede ejecutar nada sin que tú lo veas.

• El token del bot es lo único sensible. Si lo eliminas en @BotFather, queda invalidado inmediatamente.

• Usa /telegram:access allowlist siempre. Sin esto, cualquiera que encuentre tu bot podría intentar vincularse.

• Tus archivos y código nunca salen de tu máquina. Solo viajan los mensajes de texto por el canal de Telegram.

Limpiar todo

Si quieres desinstalar por completo:

1. En Telegram, envía /deletebot a @BotFather y selecciona tu bot

2. En Claude Code: /plugin uninstall telegram

3. Elimina los archivos de configuración:

rm -rf ~/.claude/channels/telegram

Con el bot eliminado en BotFather, el token queda invalidado. Sin bot y sin archivos, es como si nunca lo hubieras configurado.

Requisitos resumidos

• Claude Code v2.1.80+

• Bun runtime (no Node.js)

• Cuenta claude.ai (Pro/Max/Team/Enterprise)

• Telegram con un bot creado vía @BotFather

• Flag --channels obligatorio cada vez que lanzas Claude Code

Conclusión

Claude Code Channels es una de esas funcionalidades que parece ciencia ficción: enviar un mensaje desde Telegram y que tu terminal ejecute lo que le pides. La he probado y funciona, con sus limitaciones.

Para el día a día como desarrollador Laravel, el caso de uso más claro es supervisar despliegues y procesos largos sin estar atado al escritorio. Combinado con /loop, puedes tener un sistema de monitorización que te avisa por Telegram cuando algo falla.

Ahora bien, siendo honestos: es un research preview. El setup es tedioso, la gestión de permisos es incómoda, y la falta de confirmación de entrega genera incertidumbre. Para trabajo crítico, Remote Control (desde la app de Claude en el móvil) sigue siendo más fiable.

Dicho esto, la base está puesta. Cuando madure, esto va a cambiar la forma en la que interactuamos con nuestras herramientas de desarrollo.