# Вход, сессии и профили CLI MAX (/ru/docs/max/sessions)

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

Прочитайте эту страницу, когда впервые подключаете `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` (по умолчанию) | вставить токен, выданный официальным клиентом, или подать его трубой | — |
| `qr` | QR-код рисуется прямо в терминале; вы сканируете его приложением 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 нужно попросить владельца запустить команду или воспользоваться оболочкой.

```sh
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](https://help.max.ru/help/account/dostup_k_prophilyu/kak_voiti_v_prophil_max_esli_on_uzhe_est).

**`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` или другим клиентом, — и кладёт его в ключницу. Он работает и тогда,
когда вход упирается в капчу или в необычный второй фактор.

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

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

```sh
pass show max/token | max personal session start
```

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

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

## Проверить и выйти [#проверить-и-выйти]

```sh
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`. Ответ говорит, что получилось:

```json
{ "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:

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

## Профили [#профили]

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

```sh
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` и
перечисляет профили этого компьютера — даже когда профиль один:

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

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

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

```text
"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`). Без неё
агент мог бы выбрать профиль с меньшими ограничениями.

Зачем нужен каждый профиль и как профиль работает с ботом — в разделе [профили и боты](/llms.mdx/docs/ru/max/profiles/content.md).

## Где что лежит [#где-что-лежит]

| Что | Где |
|---|---|
| токен | ключница ОС, служба `max-cli`, запись — имя профиля |
| токен, если ключницы нет | `credentials.json` рядом с настройками, режим `0600` |
| токен для CI | `MAX_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 перечислены в разделе [куда всё ложится](/llms.mdx/docs/ru/max/installation/content.md#%D0%BA%D1%83%D0%B4%D0%B0-%D0%B2%D1%81%D1%91-%D0%BB%D0%BE%D0%B6%D0%B8%D1%82%D1%81%D1%8F).

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

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

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

## Дальше [#дальше]

- [Прочитайте первые чаты](/llms.mdx/docs/ru/max/usage/content.md)
- [Настройки и порядок, в котором они применяются](/llms.mdx/docs/ru/max/configuration/content.md)
- [Что попадает на диск, а что не попадает никогда](/llms.mdx/docs/ru/max/security/content.md)
