Configurar los channels de Claude Code con Telegram

Qué son los channels

Un channel es un servidor MCP. Envía eventos a una sesión de Claude Code que ya está en marcha. Puede funcionar en los dos sentidos. Claude lee el mensaje, trabaja y responde por el mismo chat. La documentación de Anthropic incluye Telegram, Discord e iMessage en la research preview (code.claude.com/docs/en/channels, octubre de 2026).

Esto es distinto de Remote Control. Remote Control te deja manejar tu sesión desde la app de Claude. Los channels traen mensajes de otras plataformas, y también webhooks, como un CI que ha fallado.

Requisitos

• Claude Code con sesión iniciada con una cuenta de claude.ai o una clave de API de Console. Los channels no funcionan en Amazon Bedrock, Google Cloud ni Microsoft Foundry.
• En los planes Team y Enterprise, un administrador tiene que activar antes los channels. Los usuarios de Pro y Max sin organización pueden usarlos directamente. La documentación también dice que la disponibilidad se está ampliando poco a poco.
• Bun. Los plugins de channels son scripts de Bun.
• Un token de bot de Telegram de BotFather, para el channel de Telegram.

Instala las piezas

Instala Claude Code y Bun con sus scripts oficiales.

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

En Telegram, abre BotFather y envía el comando newbot. Elige un nombre y un nombre de usuario que termine en bot. Copia el token que te devuelve. Después instala el plugin. Dentro de Claude Code es un comando de barra.

/plugin install telegram@claude-plugins-official

Desde una shell normal, la CLI de plugins hace lo mismo. Si falta el marketplace, añádelo primero.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install telegram@claude-plugins-official

Ejecutamos esto en una máquina macOS 26 alojada en GitHub el 2 de octubre de 2026, sin iniciar sesión. La instalación funcionó. Esto es lo que imprimió.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Conecta el bot y empareja

Dentro de Claude Code, guarda tu token. Se almacena en la carpeta telegram, bajo channels, en tu carpeta de configuración de Claude.

/telegram:configure <token>

Después sal y vuelve a arrancar Claude Code desde la shell, con la opción de channels.

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

Envía cualquier mensaje a tu bot. Te responde con un código de emparejamiento. Aprueba el código en Claude Code y luego limita el bot a tu cuenta.

/telegram:access pair <code>
/telegram:access policy allowlist

Aquí hay dos cosas que confunden. La opción de channels no aparece en la ayuda durante la preview, pero funciona. Y la terminal muestra el mensaje entrante y una nota de enviado, no el texto de la respuesta. La respuesta aparece en Telegram.

Discord en lugar de Telegram

Los pasos de Discord siguen el mismo esquema. Crea una aplicación en el Discord Developer Portal y copia el token del bot. Activa Message Content Intent. Invita al bot a tu servidor con permiso para ver canales, enviar mensajes y leer el historial. Después instala, configura y empareja igual. La línea del reinicio se ejecuta en la shell. Las demás líneas se ejecutan dentro de Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Puedes pasar varios plugins a la opción de channels, separados por espacios. Así una sesión puede escuchar en las dos apps.

Mantén la sesión abierta a todas horas

Los eventos solo llegan a una sesión abierta. Si cierras la terminal, dejas que el Mac entre en reposo o lo reinicias, el bot se queda callado. Tres cosas lo arreglan. Desactiva el reposo. Ejecuta Claude Code dentro de tmux. Arranca esa sesión de tmux al iniciar sesión.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Este LaunchAgent arranca una sesión de tmux llamada channels con Claude Code y el channel de Telegram. Comprueba cada minuto y no hace nada si la sesión ya existe. Guárdalo como dev.local.claude-channels.plist en tu carpeta LaunchAgents.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Instala tmux primero si no lo tienes. Después carga el agente y conéctate para ver cómo va Claude.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Probamos este mismo archivo en una máquina macOS 26 alojada en GitHub el 2 de octubre de 2026. Veinte segundos después de cargarlo, launchd había creado la sesión en la carpeta de inicio, con Claude Code esperando dentro.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

La sesión arranca en tu carpeta de inicio. Pon la ruta de tu proyecto en lugar de la variable HOME si quieres que Claude empiece ahí. La primera vez, conéctate, responde a las preguntas iniciales e inicia sesión.

Hay otro bloqueo que conviene prever. Si Claude llega a una pregunta de permisos mientras no estás, la sesión te espera. La documentación menciona una opción para saltarse los permisos en máquinas de confianza. Lee cómo ejecutar Claude Code sin supervisión con seguridad antes de usarla.

Notas de seguridad

• Cada channel mantiene una lista de remitentes permitidos. Los mensajes de cualquier otra persona se descartan sin aviso.
• Cualquiera en la lista puede dirigir tu sesión. Si el plugin reenvía las preguntas de permisos, también puede aprobar el uso de herramientas. Añade solo a personas a las que confiarías tu máquina.
• El token de tu bot es una contraseña. Si se filtra, revócalo en BotFather y configura el nuevo.
• iMessage lee la base de datos de Mensajes y necesita Acceso total al disco. En un Mac alquilado, eso supone iniciar sesión con tu Apple ID en Mensajes en un hardware que no es tuyo. Telegram o Discord lo evitan.

Ejecutarlo en un Mac de MacRun

Nuestro plan de agentes ya trae Claude Code instalado. Inicias sesión con tu propio plan de Claude. El Mac nunca entra en reposo y su sesión sobrevive a los reinicios. Tú añades Bun y el plugin, lo que lleva unos minutos. Después puedes cerrar el portátil y el bot sigue respondiendo.

Quién no necesita esto. Si solo quieres dirigir una sesión desde el móvil, Remote Control de la app de Claude lo hace sin bot. Y si el administrador de tu plan Team no ha activado los channels, un Mac nuevo no lo va a cambiar.

Para ver el panorama completo, lee cómo ejecutar Claude Code 24/7 en un Mac.