Вход в Better-TG-CLI
Ключ входа позволяет войти в свой Telegram через CLI без своих API-ключей с my.telegram.org. Подтвердите почту кодом из письма: одна почта — один ключ входа, по нему можно войти на 3 компьютерах; повторный запрос заменяет прежний. Сообщения и сессия остаются только на вашем компьютере. Уже есть свои ключи? Сразу к установке.
Ваш ключ входа
Показываем один раз. Сохраните его и не отправляйте агенту или кому-то ещё — он понадобится на шаге входа и потом на других ваших компьютерах (до 3).
Передаём ключ входа в CLI… Если страница CLI не открылась, скопируйте ключ и вставьте его там.
Как установить
Вставьте промпт своему агенту
Claude Code, Codex, Cursor или любой другой агент с терминалом. Он поставит CLI и скилл и откроет страницу входа.
Подключи мне Telegram через Better-TG-CLI (https://github.com/TheVilfer/better-tg-cli): 1. Установи CLI: `brew install thevilfer/tap/better-tg-cli`. Если Homebrew нет — `npm install -g better-tg-cli` (нужен Node 20+). На Windows — `scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket` и `scoop install better-tg-cli`. 2. Запусти `telegram onboard --json` (в фоне, если твой таймаут короче 15 минут). Откроется страница, где я сам получу ключ входа, отсканирую QR и введу пароль. Дождись события `done`. Не проси у меня коды, пароли и ключ входа и не заполняй страницу сам. 3. Установи себе скилл: `telegram skill install`. 4. Проверь вход командой `telegram whoami` и коротко расскажи, что ты теперь умеешь в Telegram.
Пройдите страницу входа
Агент откроет её в браузере на вашем компьютере. Там: «Получить ключ входа» (почта подтверждается кодом, ключ вернётся сам), QR в Telegram — Настройки → Устройства → Подключить устройство, и облачный пароль, если он есть. Агент ничего из этого не видит.
Готово
Спросите агента, например: «что у меня непрочитанного в телеге?» Писать от вашего имени он сможет, только когда вы разрешите: telegram write-access on --for 1h.
Claude Desktop без терминала так не умеет — для него режим PRO.
Поставьте CLI
macOS или Linux, в терминале:
brew install thevilfer/tap/better-tg-cli
Нет Homebrew — npm install -g better-tg-cli (Node 20+). На Windows: scoop bucket add thevilfer https://github.com/TheVilfer/scoop-bucket, затем scoop install better-tg-cli.
Войдите в Telegram сами
Вход интерактивный, поэтому его делаете вы, а не агент:
telegram auth --login-key --qr
Вставьте ключ входа с этой страницы и отсканируйте QR в Telegram: Настройки → Устройства → Подключить устройство. Со своими ключами с my.telegram.org — telegram auth --qr. В версиях до 0.37 флаг называется --invite.
Подключите своего агента
Поставьте плагин
В Claude Code наберите по очереди. Плагин — это скилл и MCP-сервер сразу.
/plugin marketplace add TheVilfer/better-tg-cli
/plugin install better-tg-cli@better-tg-cli
Перезапустите Claude Code
И попросите, например: «что у меня непрочитанного в телеге?»
Поставьте плагин
В обычном терминале:
codex plugin marketplace add TheVilfer/better-tg-cli
codex plugin add better-tg-cli@better-tg-cli
Откройте Codex заново
Скилл и MCP-сервер подхватятся сами. Спросите: «что пишет Алиса?»
Поставьте MCP-сервер
Cursor спросит подтверждение — нажмите Install.
Добавьте скилл (по желанию)
Он учит агента аккуратной работе с Telegram:
npx skills add TheVilfer/better-tg-cli -g -a cursor -y
Скачайте расширение
Откройте файл двойным кликом — Claude покажет карточку, нажмите Install. Node и brew для расширения не нужны.
Спросите в чате
Например: «сделай сводку непрочитанного в Telegram».
Готово
По умолчанию агент только читает. Писать от вашего имени он сможет, когда вы разрешите:
telegram write-access on --for 1h