lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

caso de uso principiante assistantsclaude-codeagentesherramientasdesarrollo

Telegram para Claude Code: lleva mensajes a una sesión activa

Consulta una sesión de Claude Code desde un bot de Telegram y recibe respuestas sin volver a la terminal.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que Bun está disponible y que tu Claude Code admite --channels. Comprueba la autenticación directa con Anthropic (cuenta claude.ai o clave de Console); Bedrock, Google Cloud y Microsoft Foundry no admiten canales. En Team, Enterprise o Console administrada, el administrador debe habilitarlos expresamente. Consulta las condiciones oficiales de canales. Crea el bot con BotFather e instala desde Claude Code:

/plugin install telegram@claude-plugins-official

Antes de relanzar, carga TELEGRAM_BOT_TOKEN en el entorno privado de la terminal que iniciará Claude Code, como admite el README de Telegram. No pegues su valor en el chat ni en el repositorio. Reinicia desde esa terminal con:

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

Con esa sesión activa, envía un mensaje privado al bot. Usa el código recibido dentro de Claude Code:

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

El segundo comando restringe el acceso a los usuarios ya emparejados. Consulta ACCESS.md para grupos o varios usuarios.

Comprobación

Envía un mensaje desde tu cuenta permitida y verifica recepción y respuesta.

Si algo falla

Comprueba que la sesión usa --channels y que tu cuenta está autorizada. Si falta el catálogo, registra /plugin marketplace add anthropics/claude-plugins-official. Si el catálogo existe pero no encuentra Telegram, actualiza con /plugin marketplace update claude-plugins-official. Después repite /plugin install telegram@claude-plugins-official: registrar, actualizar e instalar son operaciones distintas.

ver en .md ¿Prefieres el recurso entero?

Qué es

Este plugin conecta un bot de Telegram con Claude Code mediante MCP y canales. El servidor entrega mensajes a la sesión y expone herramientas para responder o editar mensajes.

Para qué te sirve

  • Cuando necesitas consultar una sesión mientras estás lejos del equipo.
  • Cuando quieres separar la conversación con el agente mediante un bot dedicado.

Cómo funciona

El servidor entra como bot y usa el mecanismo de canales para llevar mensajes al agente. El acceso se configura con emparejamiento y lista de usuarios permitidos; el proceso de Claude Code debe permanecer activo.

Antes de empezar

Necesitas Bun, Claude Code compatible y un bot creado con BotFather. Guarda el token fuera de Git y sigue ACCESS.md para grupos o varios usuarios. La configuración de permisos merece revisión antes de aceptar mensajes externos.

Límites y alternativas

No es una sesión alojada que continúe si apagas el equipo. El agente conserva sus permisos locales, por lo que debes limitar quién puede enviarle trabajo. Discord es otra integración del mismo catálogo, con su propia carpeta.

Recursos