comunidadbóvedaclaude canales

Claude Canales

Conecta tu Claude Code a Telegram y Discord con los plugins oficiales de Anthropic. Guía paso a paso desde cero — no necesitas experiencia previa.

Plugins oficiales de Anthropic (open source)

Los plugins de Telegram y Discord son código abierto mantenido por Anthropic.

01 intro

¿Qué son los Canales?

Los Canales (Channels) son una forma de hablar con Claude Code desde otras aplicaciones. En vez de solo usar la terminal, puedes escribirle desde Telegram o Discord y Claude te responde ahí mismo.

Piénsalo así

Imagina que Claude tiene un teléfono. Normalmente solo le puedes hablar por la terminal. Los Canales son como darle otro número de teléfono — uno en Telegram y otro en Discord. Le escribes ahí y Claude te contesta.

Telegram

Crea un bot, instala el plugin, y escríbele desde la app

Discord

Crea un bot, agrégalo a tu servidor, y habla con él por DM

02 telegram

Conectar a Telegram

Vamos a conectar Claude Code a Telegram. Al final vas a tener un bot al que le puedes escribir y Claude te responde directo en Telegram.

Prerequisitos

Bun — el servidor MCP del plugin corre sobre Bun. Instálalo con:

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

Paso 1: Crear tu bot en Telegram

BotFather es el "creador de bots" oficial de Telegram. Es un bot que crea otros bots. Así de simple.

  1. Abre Telegram en tu teléfono o computadora
  2. En la barra de búsqueda, escribe @BotFather
  3. Toca en el resultado que tiene una palomita azul
  4. Escribe /newbot y envía el mensaje
  5. BotFather te pide un nombre para tu bot (ejemplo: "Mi Asistente Claude")
  6. Después te pide un username — debe terminar en "bot" (ejemplo: mi_claude_bot)
  7. BotFather te responde con tu TOKEN — es un texto largo como 123456:ABC-DEF1234ghIkl...
  8. Copia ese token y guárdalo en un lugar seguro
Importante: El token es como la llave de tu bot. Quien tiene el token controla el bot. NO lo compartas con nadie.

Paso 2: Instalar el plugin de Telegram

/plugin install telegram@claude-plugins-official

Ejecuta este comando dentro de una sesión de Claude Code. Esto descarga el plugin oficial de Telegram hecho por Anthropic. Solo necesitas hacerlo una vez.

Paso 3: Configurar tu token

/telegram:configure TU_TOKEN_AQUI

Reemplaza TU_TOKEN_AQUI con el token que copiaste del BotFather. Esto guarda el token en .claude/channels/telegram/.env.

Paso 4: Iniciar Claude Code con Telegram

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

La bandera --channels le dice a Claude Code que escuche mensajes de Telegram. Cuando alguien le escriba al bot, Claude lo recibe y responde.

Paso 5: Emparejar tu cuenta

  1. Abre Telegram
  2. Busca tu bot (el username que elegiste, ejemplo: @mi_claude_bot)
  3. Envíale cualquier mensaje (ejemplo: "hola")
  4. Claude Code te muestra un código de 6 caracteres en la terminal
  5. Ejecuta el comando de abajo con ese código:

Comando de emparejamiento

/telegram:access pair CODIGO

Reemplaza CODIGO con el código de 6 caracteres que apareció en tu terminal. ¡Listo! Ya puedes chatear con Claude desde Telegram.

Paso 6: Configurar seguridad (allowlist)

Después de emparejar, configura una allowlist (lista de permitidos). Esto asegura que solo tú puedas hablar con el bot. Sin esto, cualquier persona que encuentre tu bot podría usarlo.

Activar allowlist

/telegram:access policy allowlist

Herramientas disponibles en Telegram

Responder

Envía mensajes de texto y archivos adjuntos (hasta 50MB cada uno).

Reaccionar

Agrega reacciones con emojis a los mensajes que recibes.

Editar Mensaje

Modifica mensajes que el bot ya envió anteriormente.

Limitación importante de Telegram

Telegram NO tiene historial de mensajes. El bot solo puede recibir mensajes en tiempo real. Si alguien escribió mientras Claude estaba apagado, no los va a ver. Piénsalo como una llamada telefónica — si no contestas, se pierde el mensaje.

03 discord

Conectar a Discord

Ahora vamos con Discord. Tiene más pasos que Telegram porque Discord requiere más configuración, pero es igual de fácil — solo sigue cada paso.

Paso 1: Instalar Bun

El plugin de Discord necesita un programa llamado Bun para funcionar. Es como Node.js pero más rápido. Solo tienes que instalarlo una vez.

Instalar Bun

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

Después de instalar, cierra y abre tu terminal. Verifica con bun --version.

Paso 2: Crear tu aplicación en Discord

  1. Abre tu navegador y ve a discord.com/developers/applications
  2. Si no tienes cuenta de Discord, crea una (es gratis)
  3. Inicia sesión con tu cuenta de Discord
  4. Haz clic en "New Application" (botón azul arriba a la derecha)
  5. Ponle un nombre a tu app (ejemplo: "Claude Bot")
  6. Acepta los términos y haz clic en "Create"

Paso 3: Activar permisos de lectura

  1. Dentro de tu aplicación, ve a la sección "Bot" (menú de la izquierda)
  2. Baja hasta encontrar "Privileged Gateway Intents"
  3. Activa el switch de "Message Content Intent" (se pone verde)
  4. Haz clic en "Save Changes"
¿Por qué? Esto le permite a tu bot leer los mensajes. Sin esto, el bot puede ver que alguien escribió pero no puede leer qué escribió.

Paso 4: Copiar el token del bot

  1. En la sección "Bot", busca el botón "Reset Token"
  2. Haz clic y confirma
  3. Aparece tu token — cópialo inmediatamente
  4. Guárdalo en un lugar seguro
Cuidado: El token solo se muestra una vez. Si lo pierdes, tendrás que generar uno nuevo con "Reset Token".

Paso 5: Invitar al bot a tu servidor

  1. Ve a la sección "OAuth2" > "URL Generator"
  2. En "Scopes", marca la casilla "bot"
  3. En "Bot Permissions", marca:Send MessagesRead Message HistoryAdd ReactionsAttach Files
  4. Copia la URL generada que aparece abajo
  5. Pega esa URL en tu navegador
  6. Selecciona el servidor donde quieres agregar el bot
  7. Haz clic en "Authorize"

Tu bot ya está en tu servidor de Discord. Ahora solo falta conectarlo a Claude Code.

Paso 6: Instalar el plugin de Discord

/plugin install discord@claude-plugins-official

Ejecuta este comando dentro de Claude Code. Descarga el plugin oficial de Discord hecho por Anthropic.

Paso 7: Configurar el token

/discord:configure

Cuando te lo pida, pega el token que copiaste en el Paso 4 y presiona Enter.

Paso 8: Iniciar Claude Code con Discord

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

Esto inicia Claude Code escuchando mensajes de Discord. Cuando alguien le escriba al bot, Claude responde.

Paso 9: Emparejar tu cuenta

  1. Abre Discord
  2. Busca tu bot en la lista de miembros del servidor
  3. Envíale un mensaje directo (DM)
  4. Claude Code muestra un código de emparejamiento en la terminal
  5. Confirma el código y ¡listo!

Paso 10: Configurar seguridad (allowlist)

Igual que con Telegram, configura una allowlist para que solo las personas autorizadas puedan hablar con tu bot. Discord usa IDs numéricos (llamados "snowflakes") para identificar usuarios.

El plugin te guiará paso a paso para configurar quién tiene acceso.

Herramientas disponibles en Discord

Responder

Envía mensajes de texto con archivos adjuntos opcionales.

Reaccionar

Agrega reacciones con emojis a cualquier mensaje.

Editar Mensaje

Modifica mensajes que el bot ya envió.

Ver Historial

Lee mensajes anteriores del canal — incluso los de antes de encender el bot.

Descargar Archivos

Descarga archivos adjuntos que te envían (fotos, PDFs, etc.).

Ventaja de Discord vs Telegram

A diferencia de Telegram, Discord sí puede leer mensajes anteriores con la herramienta de historial. Si alguien escribió mientras Claude estaba apagado, puede recuperar esos mensajes cuando se encienda.

04 seguridad

Tips y Seguridad

Siempre usa allowlist

Después de emparejar, cambia a modo allowlist. Así solo las personas que tú autorices pueden hablar con tu bot.

No compartas tu token

Los tokens de bot son como contraseñas. Quien tenga tu token puede controlar tu bot. Guárdalos en un lugar seguro.

Un bot por proyecto

Si tienes varios proyectos, crea un bot diferente para cada uno. Así mantienes todo organizado y separado.

Tiempo real vs historial

Telegram solo recibe mensajes en vivo. Discord puede leer historial. Elige según lo que necesites.