Entrar en Better-TG-CLI
Con una clave de acceso entras en tu cuenta de Telegram desde la CLI sin crear tus propias claves de API en my.telegram.org. Confirma tu correo con un código: un correo, una clave de acceso, válida para iniciar sesión en hasta 3 equipos; si la pides otra vez, la nueva sustituye a la anterior. Tus mensajes y tu sesión se quedan solo en tu equipo. ¿Ya tienes tus propias claves? Ir a la instalación.
Tu clave de acceso
Solo se muestra una vez. Guárdala y no se la envíes a un agente ni a nadie: la necesitarás al iniciar sesión, y otra vez en tus otros equipos (hasta 3).
Pasando la clave de acceso a la CLI… Si la página de la CLI no se abrió, copia la clave y pégala allí.
Cómo instalarlo
Pega el prompt en tu agente
Claude Code, Codex, Cursor o cualquier otro agente con terminal. Instalará la CLI y la skill y abrirá la página de inicio de sesión.
Conecta mi Telegram con Better-TG-CLI (https://github.com/TheVilfer/better-tg-cli): 1. Instala la CLI: `brew install thevilfer/tap/better-tg-cli`. Sin Homebrew: `npm install -g better-tg-cli` (necesita Node 20+). En Windows: `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket` y `scoop install better-tg-cli`. 2. Ejecuta `telegram onboard --json` (en segundo plano si tu tiempo límite es menor de 15 minutos). Se abrirá una página donde yo mismo obtengo la clave de acceso, escaneo el código QR e introduzco mi contraseña. Espera al evento `done`. No me pidas códigos, contraseñas ni la clave de acceso, y no rellenes la página tú. 3. Instálate la skill: `telegram skill install`. 4. Comprueba el inicio de sesión con `telegram whoami` y cuéntame brevemente qué puedes hacer ahora en Telegram.
Completa la página de inicio de sesión
El agente la abre en el navegador de tu equipo. Allí obtienes una clave de acceso (tu correo se confirma con un código y la clave vuelve sola), escaneas el código QR en Telegram (Ajustes → Dispositivos → Vincular dispositivo de escritorio) e introduces tu contraseña en la nube si la tienes. El agente no ve nada de esto.
Listo
Pregúntale a tu agente, por ejemplo: «¿qué tengo sin leer en Telegram?». Solo podrá escribir en tu nombre cuando lo permitas: telegram write-access on --for 1h.
Claude Desktop no tiene terminal, así que no puede hacerlo. Para él, usa el modo PRO.
Instala la CLI
macOS o Linux, en una terminal:
brew install thevilfer/tap/better-tg-cli
¿Sin Homebrew? npm install -g better-tg-cli (Node 20+). En Windows: scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket y después scoop install better-tg-cli.
Inicia sesión en Telegram tú mismo
El inicio de sesión es interactivo, así que lo haces tú y no el agente:
telegram auth --login-key --qr
Pega la clave de acceso de esta página y escanea el código QR en Telegram: Ajustes → Dispositivos → Vincular dispositivo de escritorio. Con tus propias claves de my.telegram.org: telegram auth --qr. En versiones anteriores a la 0.37 la opción es --invite.
Conecta tu agente
Instala el plugin
En Claude Code, escribe estos comandos uno a uno. El plugin incluye la skill y el servidor MCP.
/plugin marketplace add TheVilfer/better-tg-cli
/plugin install better-tg-cli@better-tg-cli
Reinicia Claude Code
Y pregunta, por ejemplo: «¿qué tengo sin leer en Telegram?»
Instala el plugin
En una terminal normal:
codex plugin marketplace add TheVilfer/better-tg-cli
codex plugin add better-tg-cli@better-tg-cli
Vuelve a abrir Codex
La skill y el servidor MCP se cargan solos. Pregunta: «¿qué escribió Alice?»
Instala el servidor MCP
Cursor pedirá confirmación: pulsa Install.
Añade la skill (opcional)
Enseña al agente a trabajar con Telegram con cuidado:
npx skills add TheVilfer/better-tg-cli -g -a cursor -y
Descarga la extensión
Abre el archivo con doble clic: Claude mostrará una tarjeta, pulsa Install. La extensión no necesita Node ni brew.
Pregunta en el chat
Por ejemplo: «resume lo que tengo sin leer en Telegram».
Listo
Por defecto el agente solo lee. Podrá escribir en tu nombre cuando lo permitas:
telegram write-access on --for 1h