Cómo controlar Claude Code desde el teléfono por Telegram en 2026

Encontrarás más materiales sobre la configuración de herramientas en la documentación de Ailoot.

¿Qué es Claude Code Channels y por qué lo necesitas?#

El 20 de marzo de 2026, Anthropic lanzó Claude Code Channels, un plugin oficial para conectar una sesión de Claude con aplicaciones de mensajería. Admite Telegram, Discord e iMessage. La función está en fase de vista previa de investigación: la documentación está en code.claude.com/docs/en/channels, y el código fuente del plugin se encuentra en el repositorio abierto anthropics/claude-plugins-official.

En pocas palabras, es un «puente de chat» entre tu teléfono y tu sesión de Claude Code. Le escribo al bot: «Sigue reescribiendo la tabla de precios; actualiza las fechas de la próxima promoción en business/products/practicum/README.md», y el bot reenvía el mensaje a la sesión de mi VPS. Claude recupera el contexto, edita el archivo, confirma los cambios y responde en Telegram: «Listo, revisa el commit». El portátil se queda cerrado en casa.

⚠️ La principal limitación de la vista previa de investigación: Channels es un puente MCP. La sesión debe estar en ejecución en tu equipo o VPS. Cuando se cierra la sesión, nadie recibe los mensajes. Por eso hay que configurar el funcionamiento 24/7 por separado (consulta la sección sobre VPS más abajo).

En qué se diferencia Channels de otras formas de trabajar a distancia

En su documentación oficial, Anthropic incluye una tabla comparativa directa. Aquí tienes una adaptación:

La principal diferencia entre Channels y Remote Control: Remote Control es «tu teléfono como ventana al terminal»: literalmente ves el cursor y pulsas botones. Channels es un chatbot cuyo cerebro es tu sesión local de Claude. Con Remote Control, miro el terminal. Con Channels, le escribo a alguien que lee mis archivos.

Si necesitas tener el control total desde la pantalla, usa Remote Control. Si quieres «enviar una pregunta, seguir con tu día y recibir una respuesta», usa Channels. Yo uso ambos: Remote Control cuando necesito aprobar cambios importantes y Channels cuando confío en la tarea y quiero disponer de mi tarde.

Qué necesitas antes de empezar#

Antes de pasar a los comandos, revisa esta lista:

1. Cuenta de Anthropic. Necesitas Pro, Max, Team o Enterprise. Channels no está disponible en el plan gratuito. También funciona una clave API Anthropic Console; si su organización usa ajustes gestionados, comprueba allí la habilitación de canales.
2. Claude Code v2.1.80 o posterior. Comprueba la versión con claude --version. Si es anterior, actualiza con claude update o npm install -g @anthropic-ai/claude-code@latest.
3. Bun. Los plugins de Channels son scripts de Bun, no de Node. Comprueba la versión con bun --version. Si no está instalado, ejecuta curl -fsSL https://bun.sh/install | bash y luego source ~/.bashrc.
4. Cuenta de Telegram. Puede ser cualquier cuenta; lo importante es que hayas iniciado sesión en el teléfono.
5. Si tienes un plan Team/Enterprise, pídele al administrador que active channelsEnabled en los ajustes gestionados o a través de admin-settings/claude-code. En las organizaciones, está desactivado de forma predeterminada.

No te preocupes por Bun si es la primera vez que oyes hablar de él. Bun es un entorno de ejecución alternativo de JavaScript, como Node. Anthropic lo eligió para los plugins de Channels porque se inicia más rápido y es más fácil empaquetarlo en un solo binario. Instálalo una vez y olvídate.

⚠️ Channels todavía no funciona con Bedrock / Google Vertex / Azure Foundry corporativos. Solo funciona con la autenticación de claude.ai o Anthropic Console.

Paso 1. Crea un bot de Telegram con BotFather#

BotFather hace todo el trabajo por ti: solo tienes que pulsar cinco veces. Estos son los pasos:

1. Abre @BotFather en Telegram (puedes usar el teléfono; también puedes hacer el resto de la configuración desde allí).
2. Pulsa «Start» si es la primera vez que lo usas.
3. Envía el comando /newbot.
4. BotFather te preguntará: «Alright, a new bot. How are we going to call it?» Escribe el nombre visible, por ejemplo, Mi asistente - Claude Code.
5. Después te pedirá un nombre de usuario. Debe ser único en Telegram y terminar en bot. Por ejemplo, my_claude_bot o my_dev_bot.
6. BotFather responderá con un mensaje parecido a este:

Done! Congratulations on your new bot. You will find it at
'<OFFICIAL_URL>'.

Use this token to access the HTTP API:
1234567890:AAHzlAU...

Keep your token secure and store it safely, it can be used by anyone to control your bot.

Copia el token. Lo necesitarás dentro de dos minutos.

⚠️ Seguridad del token. El token da control total sobre el bot. Si se filtra, cualquiera podrá escribir como el bot y (potencialmente) interceptar los mensajes que envías a Claude. No lo publiques en repositorios, no lo pegues en el código ni lo envíes en chats. Yo guardo los tokens en ~/.claude/channels/telegram/.env; el plugin los colocará allí en el siguiente paso.

Paso 2. Instala el plugin de Telegram en Claude Code#

Abre un terminal en cualquier carpeta donde suelas trabajar con Claude y ejecuta:

claude

Escribe el comando slash en la sesión:

/plugin install telegram@claude-plugins-official

Si Claude responde «Plugin not found in any marketplace», significa que tu cliente no conoce el marketplace oficial. Añádelo:

/plugin marketplace add anthropics/claude-plugins-official

O actualízalo si ya lo habías añadido:

/plugin marketplace update claude-plugins-official

Cuando la instalación termine correctamente, vuelve a cargar los plugins para activar sus comandos:

/reload-plugins

Ahora deberías tener comandos slash como /telegram:configure y /telegram:access. Para comprobarlo, escribe /help; la lista debe incluir una sección de Telegram.

Paso 3. Vincula el token al plugin#

En la sesión de Claude:

/telegram:configure 1234567890:AAHzlAU...

El comando guardará el token en ~/.claude/channels/telegram/.env. El archivo solo es accesible para tu usuario (chmod 600), así que no tienes que preocuparte.

También puedes definir el token mediante una variable de entorno. Esto resulta útil si despliegas Claude con systemd o Docker y no quieres usar comandos interactivos:

export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official

⚠️ En producción, siempre uso variables de entorno en lugar de un archivo .env en mi directorio personal, ~/. Así es más fácil gestionar los secretos con systemd (Environment=TELEGRAM_BOT_TOKEN=...) y se evita añadir ~/.claude/ al repositorio por accidente.

Paso 4. Reinicia Claude con la opción --channels#

Este es el punto más importante y el que confunde a todo el mundo la primera vez. No basta con instalar el plugin. Para que el bot empiece a recibir mensajes, tienes que iniciar Claude con una opción explícita:

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

Sin esta opción, la sesión funciona como siempre, pero el plugin de Telegram permanece inactivo. Con ella, Claude inicia el servidor MCP del plugin, empieza a consultar la API de Telegram y responde a los mensajes que se envían al bot.

Después de iniciarlo, deberías ver algo parecido a esto en el terminal:

✻ Welcome to Claude Code 2.1.80
  Channels: telegram@claude-plugins-official (active)
  Polling for messages...

Si no aparece ninguna línea sobre channels, no se ha reconocido la opción. Comprueba que Claude Code sea la versión 2.1.80+ y que el plugin esté instalado (/plugin list dentro de la sesión).

⚠️ Consejo práctico. He añadido un alias a ~/.zshrc:

alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"

Así solo tengo que ejecutar claude-tg. Puedes pasar varios plugins separados por espacios: --channels plugin:telegram@... plugin:discord@....

Paso 5. Vincula la cuenta y bloquea a todos los demás#

Este paso es importante para la seguridad. Un remitente aprobado puede pedir a Claude actuar sobre archivos y herramientas disponibles. Vincula solo la cuenta prevista y fija la política de remitentes antes de depender del bot.

Pasos:

1. Abre el bot en Telegram. Encuéntralo con el nombre de usuario @my_claude_bot o mediante el enlace de la respuesta de BotFather. Pulsa «Start».
2. Envía cualquier mensaje al bot. Por ejemplo, hi.
3. El bot responderá con un código de vinculación. Será parecido a este:

Hi! To pair this account, run in your Claude Code session:
/telegram:access pair 847291

This code is valid for 5 minutes.

4. Vuelve al terminal. En tu sesión de Claude, escribe el comando de la respuesta:

/telegram:access pair 847291

Claude responderá: «Account paired.» Ahora tu cuenta de Telegram puede enviar comandos.

5. Activa la política de lista de permitidos. Esto bloquea a todas las cuentas que aún no estén vinculadas:

/telegram:access policy allowlist

A partir de entonces, los mensajes de otras cuentas se ignorarán en silencio. No aparecerán en el terminal y el bot no responderá, como si nunca hubieran existido.

⚠️ Es muy importante activar la lista de permitidos justo después de vincular la cuenta. No lo dejes para más tarde. No apruebes peticiones desconocidas durante la configuración ni supongas que responder correctamente demuestra que la política de remitentes sea correcta. La primera vez, mi bot estuvo funcionando diez minutos sin una lista de permitidos, y dos usuarios aleatorios de Telegram lograron enviar «hi» durante ese tiempo. Por suerte, entonces no permitía que los comandos escribieran en archivos.

Si necesitas añadir a otra persona (por ejemplo, un colaborador del proyecto):

/telegram:access pair <código de su cuenta>

Esa persona debe escribir primero al bot, obtener un código y pasártelo. Solo así puedes añadirla.

Encontrarás más guías en la documentación de Ailoot.

Cómo ejecutar Claude 24/7 en tu propio VPS#

Si quieres que el bot esté «activo las 24 horas» y no tener que «abrir el portátil una hora y trastear», la sesión debe permanecer en ejecución. En local puedes hacerlo con tmux, pero un VPS es más sencillo y fiable.

Una configuración de ejemplo usa un VPS con Coolify que también aloja un sitio web (detalles en la guía para publicar mediante Coolify). Puedes usar el mismo servidor: Claude consume poca memoria. Si no tienes un VPS, contrata el más barato, por 4–5 euros al mes, por ejemplo Hetzner CX11 / Yandex Cloud / Selectel.

Paso 1: Instala el sistema en el VPS

Primero crea como administrador la cuenta Unix dedicada y su espacio de trabajo. Reutiliza una cuenta existente solo tras comprobar directorio personal y propietario:

sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude

Continúa en esa sesión de claude, no en el directorio de root. Instala Bun con su instalador oficial y Claude Code con la instalación nativa:

curl -fsSL https://bun.sh/install | bash
curl -fsSL https://claude.ai/install.sh | bash

Abre una sesión de inicio nueva del mismo usuario para aplicar PATH. Comprueba cuenta y ejecutables:

whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude

whoami debe mostrar claude y HOME, /home/claude. Registra las rutas absolutas de command -v; utiliza la real de Claude en ExecStart y añade el directorio Bun al PATH del servicio. Detente si falta un ejecutable.

Paso 2: autentica, instala y vincula como usuario del servicio

En esa misma sesión interactiva, completa el acceso y repite los pasos 2–5 anteriores bajo ese usuario Unix: instala el plugin Telegram en ámbito de usuario, configura token, reinicia con --channels, vincula tu cuenta Telegram y establece policy allowlist. Prueba mensaje y respuesta antes de configurar el servicio. No copies configuración ni credenciales de root.

Se admiten tanto suscripción claude.ai como clave API de Anthropic Console. Team/Enterprise requieren habilitación de organización; Console con gestión también debe cumplir sus ajustes de canales. Console factura API, no lo cubre la suscripción claude.ai. Conserva cuenta y autenticación elegidas al pasar de sesión interactiva a servicio.

Paso 3: Configura la sesión en systemd

Sal de la sesión del usuario de servicio y crea la unidad como administrador. El ejemplo presupone rutas comprobadas /home/claude/.local/bin/claude y /home/claude/.bun/bin/bun; sustitúyelas por las salidas reales si difieren. Aporta la misma autenticación y token elegidos, restringe la lectura de la unidad a su administrador y nunca publiques secretos en Git. Crea el archivo para inicio automático y reinicio tras fallos:

cat > /etc/systemd/system/claude-code.service <<'EOF'
[Unit]
Description=Claude Code with Telegram channel
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=claude
WorkingDirectory=/home/claude/workspace
Environment="HOME=/home/claude"
Environment="TELEGRAM_BOT_TOKEN=1234567890:AAH..."
Environment="PATH=/home/claude/.local/bin:/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/claude/.local/bin/claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable claude-code
systemctl start claude-code

Estos son los ajustes que he activado:

• Type=simple: modo sencillo; systemd considera que el proceso se ha iniciado en cuanto arranca.
• User=claude: se ejecuta con un usuario independiente, no como root. Es más seguro.
• WorkingDirectory=/home/claude/workspace: espacio preparado, propiedad del usuario del servicio. Coloca el repositorio previsto antes de arrancar; no dejes una copia propiedad de root ni ejecutes desde su directorio personal.
• Environment=TELEGRAM_BOT_TOKEN=...: el token se pasa directamente al proceso. No hace falta un archivo .env.
• --dangerously-skip-permissions: esencial para el funcionamiento sin supervisión. Sin esta opción, Claude espera a que respondas «sí/no» en el terminal antes de cada acción y la sesión se queda bloqueada. La lista identifica remitentes; no vuelve seguros sus comandos. Usa esa omisión de permisos solo en un entorno aislado con archivos, credenciales y red limitados deliberadamente.
• Restart=on-failure: si el proceso falla (Claude se bloquea o se cae la red), systemd lo vuelve a iniciar en 10 segundos.

Consulta los registros con:

journalctl -u claude-code -f

Si algo sale mal, journalctl -u claude-code -n 100 muestra las últimas 100 líneas.

Paso 4: Comprueba que el bot esté activo

Inicia el servicio solo después de obtener una respuesta Telegram real con la configuración interactiva. Envía al mismo bot un mensaje inocuo desde la cuenta vinculada y confirma respuesta y registros. Si funciona interactivamente pero no en systemd, compara primero usuario Unix, HOME, espacio, ejecutable, PATH y autenticación.

Para cambiar vinculaciones después, detén el servicio, ejecuta sudo -iu claude, entra en /home/claude/workspace e inicia el mismo canal interactivamente. Vincula, activa la lista, sal y vuelve a iniciar el servicio. No ejecutes dos procesos de consulta del mismo bot simultáneamente. journalctl lee registros; no proporciona un prompt interactivo Claude.

5 trampas en un servidor de producción y cómo evitarlas#

1. Bun no está en el PATH de systemd

systemd inicia los procesos con un entorno mínimo: no ve las variables de ~/.bashrc. Si instalaste Bun solo en el directorio de root y el servicio usa User=claude, no heredará esa instalación ni el PATH de su shell.

Solución. Instala Bun para todo el sistema (/usr/local/bin/bun) o indica PATH explícitamente:

Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"

2. La sesión pierde la conexión TCP con la API de Telegram después de un largo periodo de inactividad

Después de 6–12 horas inactiva, el bot puede «quedarse callado»: se envían mensajes a Telegram, pero el plugin no los recibe. Es una peculiaridad del long polling.

Solución. Añade un reinicio periódico a systemd (cada 24 horas):

Restart=always
RuntimeMaxSec=86400

O configura una tarea cron: 0 5 * * * systemctl restart claude-code (reinicio a las 5 de la mañana).

3. Los límites de Claude Max se agotan a mitad del día

Si usas Claude mucho a través de Telegram, con el plan Max 5x (~$100/mes) puedes alcanzar el límite en 4–6 horas. Las solicitudes de Telegram no son distintas de las que haces en un terminal normal: consumen el mismo presupuesto.

Solución. Programa un recordatorio: «El bot no responde: comprueba /stats». Si alcanzas el límite, espera a que se restablezca o cambia a Max 20x ($200/mes). Puede que te ayuden la guía para ahorrar tokens y la guía sobre los modelos Sonnet y Opus.

4. --dangerously-skip-permissions es peligroso incluso con una lista de permitidos

Esta opción desactiva todas las confirmaciones. Cualquier comando que envíes desde Telegram se ejecutará sin preguntar: borrar archivos, enviar solicitudes externas, cualquier cosa. Una vez le pedí a Claude que «eliminara instrucciones console.log innecesarias» y, en su afán por limpiar, Claude borró la mitad de los registros de depuración de un script de producción. Los restauré mediante git, pero el daño ya estaba hecho.

Solución. No actives --dangerously-skip-permissions si trabajas en un proyecto crítico. En su lugar, usa Remote Control para ejecutar sesiones: las solicitudes de permisos llegan al teléfono y las apruebas manualmente. Channels con --dangerously-skip-permissions es para borradores, refactorizaciones y pruebas.

5. La lista de permitidos «deja de funcionar» después de reinstalar

La lista de permitidos se guarda en ~/.claude/channels/telegram/. Si te pasas a un VPS nuevo, reinstalas Claude o cambias de usuario, no se recuperarán los datos de vinculación anteriores. Falta la antigua lista de remitentes; no supongas que la instancia nueva conserve la política anterior.

Solución. Antes de trasladarte, haz una copia de seguridad de ~/.claude/channels/telegram/. Después, restáurala. O vuelve a vincular la cuenta justo después de reinstalar y no dejes pasar ni un minuto entre el inicio del bot y la configuración de policy allowlist.

¿Channels o Remote Control? ¿Cuál deberías elegir?#

Anthropic lanzó ambas funciones casi al mismo tiempo: Remote Control el 25 de febrero de 2026 y Channels el 20 de marzo de 2026. No se duplican; resuelven problemas distintos.

Así es como los reparto yo: Channels para el trabajo asíncrono cuando estoy lejos del portátil, las notificaciones de CI y las integraciones. Remote Control cuando necesito ver qué está haciendo Claude o aprobar un paso arriesgado.

Puedes usar ambos a la vez. El bot de Telegram te ofrece un canal rápido para «preguntar y obtener una respuesta»; Remote Control te permite «controlar cosas importantes». Ambos usan el mismo límite de Claude.

Preguntas frecuentes#

¿Puedo conectar varios bots al mismo tiempo?

Sí. La opción --channels acepta una lista separada por espacios: --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official. Una sesión de Claude responde en ambos chats.

¿Qué ocurre si cierro el terminal?

La sesión se cierra, el plugin se detiene y el bot se queda en silencio. En un VPS, systemd mantiene la sesión en ejecución. En una máquina local, cierra el portátil y claude se desconectará con SIGHUP al cabo de unos segundos.

¿Puedo recibir notificaciones de CI o Sentry?

Sí. Channels es un canal bidireccional. Puedes escribir tu propio plugin para reenviar webhooks a la sesión siguiendo la referencia de Channels. Claude verá los eventos en tiempo real y responderá.

¿Telegram tiene alguna limitación frente a Discord?

Las funciones básicas son las mismas. Discord requiere activar Message Content Intent en los ajustes del bot. iMessage solo funciona en macOS y lee directamente la base de datos ~/Library/Messages/chat.db. Telegram funciona en todas las plataformas.

Si tengo un plan Team, ¿qué debo hacer?

El administrador de la organización debe activar channelsEnabled: true en los ajustes gestionados o a través de admin-settings/claude-code. Sin esto, el plugin se conectará, pero los mensajes no se transmitirán; aparecerá una advertencia al iniciar en el terminal.

¿Qué puede ver Claude desde mi teléfono: el propio chat de Telegram?

No. Claude solo ve el mensaje que enviaste al bot. No puede acceder al historial de conversaciones de Telegram, la lista de chats ni los contactos. El plugin MCP solo lee los mensajes dirigidos al bot a través de Telegram Bot API.

¿Puedo usar Claude con Channels sin una suscripción Pro/Max?

Sí, también se admite una clave API Anthropic Console, facturada a esa organización. El nivel gratuito claude.ai no es la vía de suscripción descrita. Team/Enterprise y Console gestionado deben cumplir ajustes de habilitación de canales.

Qué hacer a continuación#

Cuando el bot funcione de forma fiable, puedes seguir estos pasos para sacar el máximo partido a Channels:

1. Conecta los webhooks de CI. Si usas GitHub Actions / GitLab CI, puedes configurar el plugin de Channels para enviar los resultados de compilación directamente a la sesión. Claude verá «falló la prueba» justo después de un push y sugerirá una solución. Consulta la documentación channels-reference.
2. Combínalo con Routines. Puedes ejecutar Routines en la misma sesión para tareas periódicas. Por la mañana, el bot envía por su cuenta «Buenos días, aquí tienes el resumen del proyecto», y tú le respondes desde el teléfono: «haz un informe de ingresos».
3. Configura un monitor para el bot. Si el bot se queda en silencio, quiero enterarme. Un pequeño script cron en el VPS envía un ping al bot de Telegram una vez por hora. Si no responde, el script manda una alerta a un canal distinto. Sin esto, el bot podría dejar de funcionar a las 4 de la madrugada y no te enterarías hasta el mediodía.
4. Considera los hooks. Los hooks reaccionan a eventos de Claude (herramienta iniciada, mensaje terminado). Los hooks junto con Channels permiten enviar notificaciones automáticas a Telegram como «Claude terminó la tarea N».

No integres Channels en todo. Es una forma cómoda de ponerte al día con una tarea cuando estás fuera o en una cafetería. Cuando necesites pensar de verdad, abre el portátil y siéntate. Channels te libera de pensar «oh, todavía tengo que preguntarle esto, tengo que abrir el portátil» cuando estás fuera o de viaje.

Para ver más materiales sobre el uso de herramientas, consulta la documentación de Ailoot.