Guía

Claude Code en Telegram y Discord: Canales para Controlar tu Agente desde Cualquier Lugar

Claude Code no tiene que vivir solo en la terminal: los Canales permiten conectarlo a Telegram o Discord y controlarlo desde el celular, en equipo, sin abrir una laptop. Esta guía cubre el setup completo de ambas plataformas, las diferencias clave entre ellas, y cómo configurar la seguridad para no exponer tu agente al mundo.

1 fuente30 de junio de 2026

Claude Code en Telegram y Discord: Canales para Controlar tu Agente desde Cualquier Lugar

La terminal es el entorno natural de Claude Code, pero no siempre es el entorno más práctico. Si lanzás un agente de larga duración —un scraper, un proceso de generación masiva, un workflow de deployment— quedarte pegado a la terminal esperando es un cuello de botella innecesario. Los Canales resuelven eso: son plugins oficiales de Anthropic que conectan Claude Code a Telegram o Discord y permiten comunicarte con él como si fuera un colaborador más.

El caso de uso más directo: lanzás Claude Code en tu servidor, te vas a hacer otra cosa, y cuando el agente necesita input o termina su tarea, te manda un mensaje al celular. También funciona para equipos donde más de una persona necesita interactuar con el mismo proceso.

Prerequisito común: Bun

Ambos plugins requieren Bun como runtime. Si no lo tenés instalado:

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

Verificá con bun --version antes de continuar.


Telegram: Setup en 6 Pasos

Telegram es la opción más rápida de configurar. El bot llega en minutos y la limitación principal —que no puede leer mensajes anteriores— raramente importa para el uso típico.

1. Crear el bot con BotFather

Abrí Telegram y buscá @BotFather. Ejecutá /newbot, elegí un nombre para el bot y un username que termine en bot (por ejemplo mi_claude_bot). BotFather te devuelve un token: copialo y guardalo como si fuera una contraseña, porque lo es.

2. Instalar el plugin

Dentro de Claude Code:

/plugin install telegram@claude-plugins-official

3. Configurar el token

/telegram:configure TU_TOKEN_AQUI

Reemplazá TU_TOKEN_AQUI con el token que te dio BotFather.

4. Arrancar Claude Code con el canal activo

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

5. Vincular tu cuenta (pairing)

Mandá cualquier mensaje al bot desde Telegram. El bot responde con un código de 6 caracteres. Usalo en Claude Code:

/telegram:access pair CODIGO

6. Activar la allowlist de seguridad

/telegram:access policy allowlist

Esto es crítico: sin allowlist, cualquier persona que encuentre tu bot podría mandarle comandos a tu Claude Code.

Lo que puede hacer el bot de Telegram

  • Responder con texto y archivos (hasta 50MB)
  • Agregar reacciones emoji a mensajes
  • Editar mensajes anteriores

Limitación importante: Telegram no tiene historial de mensajes. El bot solo puede interactuar con mensajes que recibe en tiempo real desde que Claude Code está corriendo. Si Claude Code se cae y se reinicia, los mensajes anteriores no son accesibles.


Discord: Setup en 10 Pasos

Discord tiene más pasos de configuración, pero a cambio ofrece historial de mensajes, lo que lo hace mejor candidato para workflows donde el contexto de conversación importa o para equipos que trabajan en horarios distintos.

1. Bun (mismo que Telegram)

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

2. Crear la aplicación en el portal de developers

Entrá a discord.com/developers/applications, hacé click en New Application, dale un nombre y confirmá.

3. Activar el intent de contenido de mensajes

En la sección Bot del portal, buscá Privileged Gateway Intents y activá Message Content Intent. Sin esto, el bot puede existir en el servidor pero no puede leer lo que escriben los usuarios.

4. Copiar el token del bot

En la misma sección Bot, hacé click en Reset Token. El token se muestra una sola vez —copialo ahora. Si cerrás esa pantalla sin copiarlo, tenés que resetearlo de nuevo.

5. Invitar el bot al servidor

Navegá a OAuth2 > URL Generator. Marcá el scope bot y seleccioná estos permisos:

  • Send Messages
  • Read Message History
  • Add Reactions
  • Attach Files

Generá la URL, abrila en el browser, y autorizá el bot en tu servidor de Discord.

6. Instalar el plugin

/plugin install discord@claude-plugins-official

7. Configurar el token

/discord:configure

El comando te va a pedir el token que copiaste en el paso 4.

8. Arrancar con el canal activo

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

9. Vincular tu cuenta

Mandá un DM directo al bot en Discord. Seguí las instrucciones para confirmar el código de pairing.

10. Configurar la allowlist con Snowflake IDs

Discord usa IDs numéricas únicas (llamadas Snowflakes) para identificar usuarios. Para encontrar tu Snowflake: activá el modo desarrollador en Discord (Ajustes > Avanzado > Modo desarrollador), hacé click derecho en tu nombre de usuario y copiá el ID.

Agregá esos IDs a la allowlist para que solo las personas autorizadas puedan interactuar con el bot.

Lo que puede hacer el bot de Discord

  • Responder con texto y adjuntos
  • Agregar reacciones emoji
  • Editar mensajes
  • Leer el historial de mensajes — diferencia clave frente a Telegram
  • Descargar archivos enviados al canal

Telegram vs. Discord: Cuándo Usar Cuál

Criterio Telegram Discord
Velocidad de setup Más rápido (6 pasos) Más lento (10 pasos)
Historial de mensajes No
Uso en equipo Funciona, más simple Mejor para equipos con roles y canales
Uso personal / celular Ideal También funciona
Archivos Hasta 50MB Límites del servidor

La regla práctica: si sos el único que va a usar el bot y lo querés en el celular de forma rápida, Telegram. Si hay un equipo involucrado o necesitás que el agente recuerde la conversación entre sesiones, Discord.


Seguridad: Lo que No Podés Ignorar

Activar la allowlist siempre. Tanto en Telegram como en Discord, el paso de security no es opcional. Un bot sin allowlist acepta comandos de cualquier persona que lo encuentre. Eso significa que alguien podría ejecutar código en tu máquina o servidor simplemente mandándole un mensaje.

Tratá los tokens como contraseñas. No los pongas en archivos que vas a commitear a git. No los compartas por Slack o email. Si un token se filtra, resetéalo inmediatamente desde el portal del bot.

Un bot por proyecto. Si manejás varios proyectos o clientes con Claude Code, creá bots separados. Mezclar proyectos en un solo bot complica la trazabilidad y expande la superficie de ataque: si ese bot se compromete, afecta a todos los proyectos.

Diferencia de modelo de acceso: En Telegram, la allowlist controla por ID de usuario de Telegram. En Discord, controla por Snowflake ID. Ambos funcionan bien, pero en Discord es más granular si tenés un servidor compartido con gente que no debería tener acceso.


El Flujo Real de Uso

Una vez configurado, el loop de trabajo es simple:

  1. Lanzás Claude Code en tu máquina o servidor con --channels
  2. Te alejás de la terminal
  3. Cuando necesitás actualizar al agente o él necesita input, el intercambio ocurre en tu app de mensajería
  4. El agente puede mandarte archivos de resultado, confirmaciones, o pedirte decisiones que requieren criterio humano

Para workflows de larga duración —generar cientos de páginas, procesar datasets grandes, hacer deploys que toman tiempo— este modelo cambia bastante la dinámica. Claude Code pasa de ser algo que requiere tu atención constante a algo que trabaja en background y te avisa cuando necesita que intervengas.

📎