Cómo conectar Claude Code a Telegram
Conecta Claude Code a Telegram con el plugin oficial de Channels: emparejamiento del bot, permisos en remoto, límites de la sesión y una configuración más segura.
Claude Code tiene una integración oficial con Telegram llamada Channels. Encaja bien cuando quieres enviar una tarea a una sesión que ya tienes en marcha, recibir la respuesta en Telegram y gestionar las aprobaciones habituales de herramientas sin abrir el portátil.
La limitación importante es sencilla: Telegram no ejecuta Claude Code. El trabajo lo sigue haciendo un proceso de Claude Code en tu ordenador o servidor, y ese proceso tiene que seguir en línea.
Respuesta rápida
Crea un bot privado con BotFather de Telegram, instala el plugin oficial de Telegram en Claude Code, configura su token, inicia Claude con el canal activado y empareja tu cuenta de Telegram. Mantén el bot restringido a una lista de permitidos en lugar de hacerlo público.
Por ahora la integración es una versión preliminar de investigación (research preview). Consulta la documentación de Channels de Anthropic antes de automatizarla en una máquina sensible, porque los comandos y las capacidades pueden cambiar.
Qué necesitas
- Una instalación actual de Claude Code autenticada con una cuenta de Anthropic compatible.
- Bun instalado en el host; el plugin oficial del canal se ejecuta sobre Bun.
- Una cuenta de Telegram y un token de bot de @BotFather.
- Un terminal que pueda quedarse abierto, o una sesión persistente como
tmux.
Trata el token del bot como una contraseña. No lo pegues en un repositorio, en un historial de shell compartido con otros usuarios ni en una captura de pantalla.
1. Crea un bot privado de Telegram
Abre BotFather en Telegram, envía /newbot y sigue sus indicaciones. El nombre
de usuario del bot debe terminar en bot. Copia el token en algún sitio
temporal y privado.
No hay ningún motivo para añadir el bot a un grupo en una sesión de programación personal. Los mensajes directos con una lista de permitidos son más fáciles de controlar.
2. Instala el plugin oficial
Dentro de Claude Code, instala el plugin de Telegram:
/plugin install telegram@claude-plugins-official
Si el marketplace aún no está registrado, añádelo y vuelve a intentarlo:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
Usa el nombre oficial del marketplace y no un paquete de terceros con un nombre parecido.
3. Configura el token del bot
Ejecuta el comando del plugin dentro de Claude Code:
/telegram:configure <BOT_TOKEN>
El plugin guarda el token en la configuración local del canal. Si el token ha aparecido en registros o en un chat, revócalo con BotFather y configura uno nuevo.
4. Inicia Claude Code con Telegram activado
Sal de la sesión actual y vuelve a iniciarla con el canal:
claude --channels plugin:telegram@claude-plugins-official
Ejecútalo dentro del repositorio en el que debe trabajar Claude. En un host
siempre encendido, inícialo en una sesión de tmux con nombre para que una
desconexión de SSH no termine el proceso:
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
tmux conserva el proceso; no evita que un portátil entre en suspensión ni
restablece una conexión de red caída.
5. Empareja tu cuenta y añádela a la lista de permitidos
Envía un mensaje al bot. Te devolverá un código de emparejamiento. En el terminal de Claude Code, aprueba ese código y mantén el acceso restringido:
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
Haz una prueba con una petición de solo lectura, como pedirle a Claude que resuma el directorio actual. Confirma que el mensaje aparece en la sesión correcta antes de conceder un acceso más amplio a las herramientas.
Cómo funcionan ahora las solicitudes de permiso
Las descripciones más antiguas de Channels suelen decir que cada solicitud de permiso obliga a volver al terminal. Eso ya no es exacto. El plugin oficial de Telegram actual declara la capacidad de retransmisión de permisos de Claude Code y puede enviar a Telegram las solicitudes de las herramientas compatibles con los botones Allow (permitir) y Deny (denegar).
Eso no hace que las aprobaciones desatendidas estén libres de riesgo. Una pequeña tarjeta de chat puede ocultar contexto que sería evidente en un diff en el terminal. Lee el comando y la ruta afectada, evita reglas amplias de «permitir siempre» y usa una cuenta con pocos privilegios para una sesión siempre activa. La confianza inicial en el proyecto, el consentimiento de MCP y la configuración del plugin pueden seguir requiriendo interacción en el terminal local.
Límites que importan en la práctica
- El proceso del host debe seguir vivo. Si cierras Claude Code, el canal se detiene.
- Telegram es un flujo de eventos, no un almacén de la sesión. La Bot API entrega las actualizaciones nuevas; no le da al plugin un historial completo en el que buscar.
- La respuesta vive en Telegram. El terminal puede mostrar el evento entrante y el estado de entrega en lugar de una transcripción idéntica al chat.
- Es exclusivo de Claude. El plugin no expone Codex ni otros agentes.
- Es software en versión preliminar. Vuelve a revisar la documentación oficial después de cada actualización y no dependas de comportamientos no documentados.
Channels frente a Remote Control
Remote Control, de Anthropic, es una opción distinta. Permite que Claude en la web o en la app de iOS/Android maneje una sesión que se ejecuta en el host. Los archivos y las herramientas se quedan en el host, y el teléfono actúa como interfaz remota.
Elige Channels cuando Telegram sea la interfaz que quieres o cuando eventos externos deban llegar a una sesión. Elige Remote Control cuando quieras la interfaz oficial de Claude y una vista más cercana de la sesión activa. Ambos siguen dependiendo del proceso en el host.
Cuándo tiene sentido otra capa remota
El plugin nativo suele ser la respuesta más sencilla para una sola sesión de Claude. Otra configuración pasa a ser relevante cuando cambian los requisitos: por ejemplo, un terminal completo en el navegador, varios agentes de programación o un VPS siempre encendido que se gestiona por separado del portátil.
Chatcode es una de esas opciones: conecta un servidor con un terminal en el navegador y con Telegram, y puede ejecutar Claude Code junto a Codex, Gemini y OpenCode. Eso añade un intermediario de terceros y la responsabilidad de gestionar un servidor, así que no es una mejora automática. La configuración práctica y sus contrapartidas se explican en Claude Code en Telegram con Chatcode.
Preguntas frecuentes
¿Tiene Claude Code una integración oficial con Telegram?
Sí. Claude Code Channels incluye un plugin oficial de Telegram. Conecta un bot de Telegram restringido a una lista de permitidos con una sesión de Claude Code que sigue en marcha en tu ordenador o servidor.
¿Puedo aprobar desde Telegram las solicitudes de permiso de Claude Code?
Sí. El plugin oficial de Telegram actual retransmite las solicitudes de permiso de las herramientas compatibles como botones Allow y Deny. La confianza inicial en el proyecto, el consentimiento del plugin y parte de la configuración local siguen requiriendo el terminal.
¿Qué diferencia hay entre Channels y Remote Control?
Channels permite que Telegram u otro servicio envíe eventos a una sesión de Claude Code en marcha. Remote Control expone la sesión a través de Claude en la web o en el móvil. Ambos usan un proceso de Claude en el host, pero la interfaz y el modelo de activación son distintos.
¿Funciona el bot de Telegram con Claude Code cerrado?
No. El servidor del canal se ejecuta junto con la sesión de Claude Code. Mantén vivo el proceso en un terminal persistente o en un host siempre encendido si necesitas que siga accesible.