---
title: "Cómo conectar Claude Code a Telegram"
seoTitle: "Conectar Claude Code a Telegram: configuración nativa"
navTitle: "Claude Code + Telegram"
description: "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."
slug: how-to-connect-claude-code-to-telegram
lang: es
date: 2026-06-08
updated: 2026-07-30
author: "Chatcode"
category: guide
faq:
  - q: "¿Tiene Claude Code una integración oficial con Telegram?"
    a: "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."
  - q: "¿Puedo aprobar desde Telegram las solicitudes de permiso de Claude Code?"
    a: "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."
  - q: "¿Qué diferencia hay entre Channels y Remote Control?"
    a: "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."
  - q: "¿Funciona el bot de Telegram con Claude Code cerrado?"
    a: "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."
---

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](https://code.claude.com/docs/en/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](https://bun.sh/) instalado en el host; el plugin oficial del canal se
  ejecuta sobre Bun.
- Una cuenta de Telegram y un token de bot de
  [@BotFather](https://t.me/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:

```text
/plugin install telegram@claude-plugins-official
```

Si el marketplace aún no está registrado, añádelo y vuelve a intentarlo:

```text
/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:

```text
/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:

```bash
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:

```bash
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:

```text
/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](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/server.ts)
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](https://code.claude.com/docs/en/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](/articles/claude-code-telegram-with-chatcode).
