# Instrucciones para el agente: Telegram para Claude Code: lleva mensajes a una sesión activa

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.

- Dificultad: principiante
- Proyecto: https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/claude-code-channels

---

## 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](https://code.claude.com/docs/en/channels). Crea el bot con BotFather e instala desde Claude Code:

```text
/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](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/README.md). No pegues su valor en el chat ni en el repositorio. Reinicia desde esa terminal con:

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

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

El segundo comando restringe el acceso a los usuarios ya emparejados. Consulta [ACCESS.md](https://github.com/anthropics/claude-plugins-official/blob/main/external_plugins/telegram/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.