Copiado ✓
Comunidad  /  Recursos  /  Conecta tu copiloto a Telegram
Guía del Constructor

Conecta tu copiloto a Telegram

Imagina mandarle una tarea a tu sistema desde el teléfono, en el sofá o en el aeropuerto, y que tu copiloto trabaje solo en tu servidor y te responda por chat. Eso es exactamente lo que vas a lograr en esta guía: tu negocio en el bolsillo, sin abrir la computadora.

15–20 minutos Sin programar Función avanzada

Antes de empezar necesitas: tu sistema ya construido y tu copiloto funcionando en el servidor (si aún no, sigue primero la guía Construye tu sistema IA), una cuenta Claude Pro o Max (el plan gratis no sirve), y la app de Telegram en tu teléfono.

1

Crea tu bot en Telegram

Un "bot" es un contacto automático dentro de Telegram. Será la puerta por la que le hablarás a tu copiloto. Lo creas con el ayudante oficial de Telegram, que se llama BotFather. Hazlo desde tu teléfono:

  1. Abre Telegram y, en el buscador, escribe @BotFather. Entra al que tiene el palomita azul de verificado.
  2. Toca Iniciar (o escribe /start) y luego envía /newbot.
  3. Te pedirá un nombre visible (ej: Mi Copiloto) y luego un usuario único que debe terminar en bot (ej: micopiloto_2026_bot).
  4. Al terminar, BotFather te dará un mensaje con una llave secreta (token): una línea larga parecida a 8123456789:AAH...k9Q. Cópiala y guárdala — la usarás en el paso 4.

Esa llave es como la contraseña de tu bot: no la compartas con nadie ni la pegues en sitios al azar. Quien la tenga puede controlar tu bot. Si alguna vez se te escapa, vuelve a BotFather y usa /revoke para generar una nueva.

2

Abre la terminal de tu servidor

Ahora vamos a tu servidor, donde vive tu copiloto. Entra a la "terminal" (la pantalla donde le das instrucciones), igual que cuando construiste tu sistema:

Confirma que tu copiloto está en una versión reciente (necesitas la 2.1.80 o más nueva para esta función). Pega esto:

bash
$ claude --version

Si el número es menor a 2.1.80, actualízalo pegando curl -fsSL https://claude.ai/install.sh | bash y vuelve a comprobar.

3

Instala la pieza que falta (Bun)

El conector de Telegram necesita un motorcito llamado Bun para funcionar. Se instala una sola vez. Pega estas líneas una por una, esperando a que cada una termine:

bash · 1 de 3
$ apt install -y unzip
bash · 2 de 3
$ curl -fsSL https://bun.com/install | bash
bash · 3 de 3
$ source ~/.bashrc

Comprueba que quedó instalado:

bash
$ bun --version

Si ves un número (por ejemplo 1.3.4), ¡quedó! Si dice command not found, cierra y vuelve a abrir la terminal del navegador y prueba otra vez.

4

Instala el conector de Telegram

Enciende tu copiloto dentro de la carpeta de tu sistema. Copia la línea completa:

bash
$ cd ~/mi-sistema && claude

Ya dentro de Claude (verás el símbolo para escribir), pega este comando para instalar el conector oficial de Telegram:

dentro de Claude
 /plugin install telegram@claude-plugins-official

Cuando termine, activa el conector con:

dentro de Claude
 /reload-plugins

Ahora dale tu llave secreta (el token del paso 1). Donde dice PEGA-AQUÍ-TU-TOKEN, borra ese texto y pega tu token de BotFather:

dentro de Claude
 /telegram:configure PEGA-AQUÍ-TU-TOKEN

Tu copiloto guarda la llave en un lugar seguro del servidor y nunca la muestra en pantalla. Es normal.

Si al instalar dice "plugin not found", primero pega /plugin marketplace add anthropics/claude-plugins-official dentro de Claude y vuelve a intentar el /plugin install.

5

Enciende tu copiloto "escuchando" a Telegram

Para que el bot quede atento a tus mensajes, hay que reiniciar el copiloto con el conector activado. Primero sal de Claude:

dentro de Claude
 /exit

Y vuelve a encenderlo así (copia la línea completa). Esta vez quedará escuchando a tu bot:

bash · el comando que activa todo
$ cd ~/mi-sistema && claude --channels plugin:telegram@claude-plugins-official

Deja esta ventana abierta. Mientras tu copiloto esté encendido así, tu bot responde. Si cierras la terminal, deja de escuchar (más abajo te enseñamos a dejarlo prendido siempre).

6

Vincula tu cuenta (solo tú das órdenes)

Falta un candado de seguridad para que únicamente tú puedas mandarle tareas a tu copiloto. Hazlo así:

  1. Abre Telegram en tu teléfono, entra a tu bot y envíale cualquier mensaje (por ejemplo, "hola").
  2. El bot te responderá con un código de emparejamiento (unos números o letras).

Vuelve a la terminal del servidor (donde dejaste a Claude encendido) y pega este comando, reemplazando PEGA-AQUÍ-EL-CÓDIGO por el que te dio el bot:

dentro de Claude
 /telegram:access pair PEGA-AQUÍ-EL-CÓDIGO

Y cierra el candado para que nadie más pueda entrar:

dentro de Claude
 /telegram:access policy allowlist

Listo. Ahora solo tu cuenta puede darle tareas a tu copiloto. Cualquier otra persona que le escriba al bot queda ignorada automáticamente.

7

¡Pruébalo desde tu teléfono!

Este es el momento mágico. Desde Telegram, escríbele a tu bot una tarea normal, como se la dirías a un asistente. Por ejemplo:

Verás cómo tu copiloto, allá en el servidor, se pone a trabajar sobre tus archivos reales y te responde por el mismo chat de Telegram. Acabas de ganar el poder de manejar tu sistema desde cualquier lugar, solo con tu teléfono. 🎉

Bonus: déjalo encendido siempre (opcional)

Tu bot solo responde mientras el copiloto está prendido en esa terminal. Si cierras la pestaña o apagas la computadora, deja de escuchar. Para que siga despierto 24/7 en tu servidor —aunque cierres todo— usamos una herramienta llamada tmux, que mantiene la sesión viva por dentro.

Primero ábrela (instálala si hace falta) y entra a una sesión llamada copiloto:

bash
$ apt install -y tmux && tmux new -s copiloto

Dentro de esa sesión, enciende tu copiloto escuchando a Telegram (el mismo comando del paso 5):

dentro de tmux
$ cd ~/mi-sistema && claude --channels plugin:telegram@claude-plugins-official

Ahora "suéltalo" sin apagarlo: presiona Ctrl + B y luego, soltando, la tecla D. La sesión sigue viva por dentro y ya puedes cerrar la terminal con tranquilidad. Para volver a verla cuando quieras:

bash
$ tmux attach -t copiloto

¿Algo salió mal?

Esta es una función nueva de Claude Code (aún en vista previa), así que con el tiempo algún comando podría cambiar. Si algo no calza exactamente como aquí, escríbenos y te ayudamos.

Tu copiloto, ahora en tu bolsillo 📲

¿Te atoraste en algún paso? Estamos a un mensaje de distancia.

Escribir por WhatsApp