МессенджерыMAX

Вход, сессии и профили CLI MAX

Войдите в MAX, управляйте профилями и сессиями и решайте проблемы авторизации на своём компьютере.

Подключите инструмент к своему аккаунту мессенджера, чтобы агент мог читать выбранные чаты и помогать с ответами. Здесь вы пройдёте вход, проверите подключение и узнаете, как управлять сессией или завершить её. Вход добавляет разрешённое устройство; всю историю чатов он не скачивает.

Прочитайте эту страницу, когда впервые подключаете max к аккаунту MAX, добавляете второй аккаунт или max говорит, что входа нет. В конце вы знаете, как войти, как проверить, под кем выполнен вход, как выйти и где max хранит то, что нужно, чтобы вход не пропадал.

Сначала — слова, которые здесь встречаются:

  • Сессия — вход max в ваш аккаунт MAX на этом компьютере. Она состоит из токена и личности устройства. MAX показывает её в приложении как ещё одно устройство.
  • Токен — строка, которую MAX выдаёт при входе. С ним можно читать ваши чаты, поэтому обращайтесь с ним как с паролем. max держит его в ключнице.
  • Личность устройства — то, чем max представляется MAX: всегда одно и то же устройство, а не новое на каждую команду. Она лежит в файле рядом с остальным состоянием.
  • Ключница (keyring) — хранилище паролей операционной системы: Keychain в macOS, Secret Service (GNOME Keyring, KWallet) в Linux, диспетчер учётных данных в Windows.
  • Профиль — имя для одного входа на этом компьютере, со своим токеном, состоянием и настройками. Имя называется в каждой команде (max personal …) или MAX_PROFILE; сам max профиль не выбирает. Второй профиль нужен только для второго аккаунта или для отдельных ограничений (профили).

Не путайте max personal session и max personal account sessions. max personal session — вход самого max; max personal account sessions перечисляет все остальные устройства и приложения, вошедшие в ваш аккаунт.

Первый запуск

max personal setup проверяет локальные каталоги, проводит через QR-вход, проверяет аккаунт и до пяти чатов и устанавливает навык агента. Варианты агента: codex, cursor, claude, gemini, all, none. Без параметра в терминале задаётся вопрос; машинный режим пропускает установку навыка. Инструкция max skill show доступна до входа.

Выделите около пяти минут. История скачивается отдельно после выбора чата и объёма; setup не запускает фоновый сервис. Повторный запуск проверяет существующую сессию. --method token|qr|qr-chrome|sms выбирает способ свежего входа; по умолчанию setup берёт qr. qr-chrome и sms требуют человека у локального терминала. Без терминала qr печатает QR-код текстом: агент вставляет его в чат, владелец сканирует с экрана (см. Вход через агента). Не передавайте токен аргументом. Если настройка прервана, повторите setup. При истёкшем токене явно выполните max personal session start qr; при недоступной ключнице сначала исправьте окружение по подсказке.

Вход

max personal session start <способ> — четыре способа войти. Каким бы способом ни был получен токен, в ключницу он попадает только после того, как MAX его принял.

СпособЧто происходитЧто нужно
token (по умолчанию)вставить токен, выданный официальным клиентом, или подать его трубой—
qrQR-код рисуется прямо в терминале; вы сканируете его приложением MAX. В узком терминале код не рисуется: расширьте окно и запустите снова. Без терминала код печатается текстом для агентатерминал шириной от ~70 колонок, или агент
qr-chromeоткрывается web.max.ru в отдельном окне браузера; вы сканируете его QR-кодChrome, Chromium, Edge или Brave
smsто же окно web.max.ru; на странице выберите вход по номеру телефонаChrome, Chromium, Edge или Brave

Вход через агента

Без терминала (команду запускает агент через свой инструмент оболочки) max <профиль> session start qr печатает QR-код в stderr обычным текстом: символы █▀▄, без цвета, светлые модули нарисованы, поэтому на тёмной теме код читается как чёрный на белом. Агент:

  1. запускает команду в фоне — она ждёт сканирования до 2 минут, а инструмент оболочки ничего не показывает, пока команда не завершится;
  2. читает её вывод и вставляет блок QR в чат блоком кода, ровно как напечатано;
  3. ждёт завершения: в stdout приходит ответ о входе.

С --json каждый код ещё и одна строка JSON в stderr: {"event":"qr","qr":{"text":…,"expires_at":…,"scan":…}}. У MAX один код на запуск; истёк — запустите команду снова. Облачный пароль MAX так не ввести: он спрашивается только в терминале. Через MCP вход недоступен (session не публикуется в MCP, вход не идёт через serve): агенту только с MCP нужно попросить владельца запустить команду или воспользоваться оболочкой.

max personal session start qr
  1. Оставьте QR-код видимым на компьютере — в терминале или в окне браузера, которое открыла команда.
  2. На телефоне откройте MAX и выберите аккаунт, который хотите подключить.
  3. Перейдите в Настройки → Устройства и откройте сканер для входа по QR. Названия пунктов могут отличаться в вашей версии приложения.
  4. Отсканируйте QR на компьютере сканером внутри MAX и подтвердите подключение, если появится запрос.
  5. Если MAX запрашивает дополнительный пароль аккаунта, введите его по запросу терминала; символы не отображаются.
  6. Дождитесь успешного завершения команды. Проверьте аккаунт через max personal account show, затем прочитайте несколько чатов через max personal chats list --limit 5.

Официальная инструкция входа MAX.

qr-chrome и sms — самые осторожные. Вход делает сам web.max.ru в настоящем браузере, и MAX видит свой собственный веб-клиент. Браузер запускается с отдельным временным профилем, а не с вашим; как только web.max.ru вошёл, окно закрывается, а профиль удаляется — и при Ctrl-C тоже. Закрытие окна не завершает сессию: это как закрыть вкладку. Браузер ищется сам; другой можно указать в MAX_BROWSER. Браузеры из snap не подходят — у них своя папка /tmp.

qr просит код у MAX собственным соединением max, изображая веб-клиент. Он работает без браузера, но это уже не настоящий веб-клиент.

Вход по SMS — только через браузер. Когда SMS просит соединение max, MAX требует капчу, а её можно пройти только на странице.

После любого из трёх входов в списке сессий приложения MAX появится новое устройство. Если у аккаунта есть облачный пароль, qr спросит его без эха, до трёх раз; потом код придётся сканировать заново.

Все три требуют человека у терминала: без него команда откажет с кодом 2. Если вход запускает ваш ИИ-агент без терминала, ему остаётся token. Программа, которая показывает вопросы в своём окне, например WireCat Desktop, запускает max personal session start qr --json --answer-stdin: облачный пароль спрашивается строкой needs в stderr, ответ — одна строка в stdin. Пока задана MAX_TOKEN, эти три способа тоже откажут: она старше ключницы и перекрыла бы новую сессию.

Токен вручную

max personal session start без способа импортирует токен, который уже выдан официальным клиентом — веб-версией web.max.ru или другим клиентом, — и кладёт его в ключницу. Он работает и тогда, когда вход упирается в капчу или в необычный второй фактор.

max personal session start
MAX token: ▏          # ввод не отображается

Токен не передаётся аргументом. Аргумент команды виден в ps любому процессу на машине и остаётся в истории оболочки. Поэтому он спрашивается у терминала без эха — или читается из трубы, если терминала нет:

pass show max/token | max personal session start

Для CI и разовых запусков есть переменная. Она старше ключницы: если MAX_TOKEN задана, берётся она, и в ключницу ничего не пишется. Фоновый сервер max personal serve с ней не запускается: команда подключается к MAX сама.

MAX_TOKEN="$(cat /path/to/token)" max personal chats list --json

Проверить и выйти

max personal account show             # под кем выполнен вход: id, имя, последние четыре цифры телефона
max account list             # все профили на этом компьютере и аккаунт каждого
max personal account sessions list    # все устройства и приложения, вошедшие в аккаунт; ничего не завершает
max personal session end              # выйти из MAX и забыть токен на этой машине

session end сначала завершает сессию на сервере MAX, потом стирает токен на этой машине. Если для профиля работает max serve, запущенный руками или службой, session end отказывает (код 2): сначала max personal server stop. Ответ говорит, что получилось:

{ "item": { "profile": "personal", "forgotten": true, "revoked_on_server": true }, "meta": { … } }

Чтобы забыть профиль целиком, есть max personal account remove --keep-data или --delete-data: он так же завершает сессию на сервере MAX, потом стирает токен, файлы профиля и всё, что для него хранит общий слой. --keep-data оставляет сообщения в хранилище, поиск их находит; --delete-data удаляет и их. Токен бота (bot:personal) остаётся.

Если вход был токеном из вкладки web.max.ru, это одна и та же сессия: session end выведет из MAX и эту вкладку.

Если MAX не ответил, токен не стирается: команду можно повторить. Токен, который MAX уже не принимает, стирается сразу — выходить уже не из чего.

Запуск с перенесёнными папками (MAX_CONFIG_DIR и соседние переменные, другой HOME или папка XDG) пользуется входом владельца, но не завершает его: session end там ничего не стирает, не выходит из MAX и отвечает "kept": "owners-sign-in". Вход, сделанный в самом таком запуске, session end завершает как обычно.

Сколько живёт сессия

MAX не сообщает фиксированный срок истечения токена, поэтому CLI не может обещать конкретное число дней. Закрытие вкладки web.max.ru не завершает авторизацию. Если MAX перестал принимать сохранённый токен, подключитесь заново по QR:

max personal session start qr

Для рабочего профиля используйте max work session start qr. Затем проверьте аккаунт командой max personal account show или max work account show. Команда max personal session start без способа импортирует существующий токен, а не показывает QR-код. Число входов для профиля показывает max personal doctor.

Профили

Профиль хранит свой токен и своё состояние; локальная копия сообщений общая, с данными по аккаунтам. Профиль называется первым словом, а не флагом:

max personal chats list     # профиль personal
max work chats list         # профиль work
export MAX_PROFILE=personal # или на всю сессию оболочки

Правило: первое слово — это профиль, если оно не совпадает с именем команды. Поэтому профиль нельзя назвать chats, runs или session — max personal session start и max personal setup отвергают такое имя. Иначе max personal chats молча значило бы «профиль chats без команды». Имя состоит из латинских букв, цифр, точки, дефиса и подчёркивания и начинается с буквы или цифры.

Порядок, первое совпадение побеждает: первое слово, MAX_PROFILE. Если ничего из этого нет, команда, которой нужен аккаунт, завершается с кодом 2 и перечисляет профили этого компьютера — даже когда профиль один:

✗ name a profile: `max <profile> …` — profiles here: personal (or set MAX_PROFILE)

На компьютере без профилей сообщение говорит, как создать первый: max personal setup. Без профиля работают только команды, которым аккаунт не нужен: --help, --version, commands, skill show, account list, config show.

Если первое слово не команда и команды за ним нет, программа не показывает справку молча, а говорит, что произошло:

"nonsense" is not a command, so it was read as a profile name — and no command followed it.
Run `max --help` for the commands, or `max nonsense account show` if "nonsense" is your profile.

MAX_PROFILE_LOCK закрепляет процесс за одним профилем. Задайте её там, где работает агент, и первое слово или MAX_PROFILE с именем другого профиля будут отвергнуты (код возврата 5). Без неё агент мог бы выбрать профиль с меньшими ограничениями.

Зачем нужен каждый профиль и как профиль работает с ботом — в разделе профили и боты.

Где что лежит

ЧтоГде
токенключница ОС, служба max-cli, запись — имя профиля
токен, если ключницы нетcredentials.json рядом с настройками, режим 0600
токен для CIMAX_TOKEN; она старше ключницы
токен ботаключница ОС, служба max-cli, запись bot:<профиль>; или MAX_BOT_TOKEN
чаты, которые видел бот~/.local/share/max-cli/bots/
устройство, счётчик входов, viewerId~/.local/share/max-cli/profiles/<профиль>.json, режим 0600
настройки~/.config/max-cli/config.json

Каталоги для macOS и Windows перечислены в разделе куда всё ложится.

Личность устройства записывается при первом же чтении, до того как будет использована. Клиент, который представляется MAX новым устройством на каждую команду, — это не подражание настоящему клиенту, и сессии на стороне сервера привязаны именно к нему.

На машине без ключницы (типичный контейнер) запись не удаётся — тогда токен ложится в файл credentials.json рядом с настройками, с правами 0600, и команда говорит об этом одной строкой на stderr. В CI правильнее не полагаться ни на то, ни на другое и передавать MAX_TOKEN.

⚠ MAX_CONFIG_DIR, MAX_STATE_DIR и MAX_CACHE_DIR переносят и запись в ключнице: меняется имя службы. Сессия, сохранённая с этими переменными, не видна команде, запущенной без них, и наоборот. Либо ставьте их всегда, либо никогда.

Дальше