Аутентификация#

tgs подключается к Telegram через ваш реальный аккаунт по протоколу MTProto. Аутентификация нужна один раз для каждого профиля — сессия сохраняется локально и используется повторно при последующих командах.

Быстрый старт#

Метод по умолчанию импортирует существующую сессию из Telegram Desktop:

tgs login

Или выберите другой метод:

tgs login --type code   # Phone number + SMS/Telegram code
tgs login --type qr     # Scan QR code from another device

Методы входа#

Импорт из Desktop (по умолчанию)#

Импортирует существующую сессию из Telegram Desktop. tgs автоматически определяет директорию tdata на macOS, Linux и Windows.

# Auto-detect Telegram Desktop data
tgs login

# Custom tdata path
tgs login --desktop-dir /path/to/tdata

# Passcode-protected Telegram Desktop client
tgs login --passcode SECRET

Ввод номера телефона или кода не требуется — сессия передаётся напрямую.

Телефон + код#

Интерактивный вход с номером телефона. Поддерживает двухфакторную аутентификацию (облачный пароль).

# Interactive — prompts for phone and code
tgs login --type code

# Provide phone upfront
tgs login --type code --phone +1234567890

tgs запросит код подтверждения, отправленный Telegram. Если включена 2FA, передайте облачный пароль через флаг --password — tgs не запрашивает его интерактивно.

Неинтерактивный вход (для AI-агентов)#

Метод code поддерживает полностью неинтерактивный двухшаговый вход. Это рекомендуемый способ для AI-агентов и средств автоматизации.

# Step 1: request the code
tgs login --type code --phone +1234567890
# → {"status":"code_sent","profile":"default"}

# Step 2: complete login with the received code
tgs login --type code --phone +1234567890 --code 12345
# → {"status":"logged_in","user":{...}}

# With 2FA
tgs login --type code --phone +1234567890 --code 12345 --password mysecret

QR-код#

Отображает QR-код в терминале. Отсканируйте его в приложении Telegram на другом устройстве.

tgs login --type qr

После сканирования tgs автоматически завершает аутентификацию. QR-вход не поддерживает аккаунты с включённой 2FA — для них используйте метод code с --password.

Вход в конкретный профиль#

Используйте --profile для аутентификации в именованный профиль. Профиль создаётся автоматически, если не существует.

tgs login --profile work
tgs login --type code --profile personal

Подробнее о мульти-аккаунте — в разделе Профили.

Проверка входа#

После входа убедитесь, что активный аккаунт определён верно:

tgs whoami

Выход#

tgs logout                  # logout current profile
tgs logout --profile work   # logout specific profile

Выход отзывает сессию на серверах Telegram и удаляет локальные данные сессии.

Полный справочник флагов#

Смотрите tgs login и tgs logout для полного списка флагов.