Установка CLI и MCP-сервера MAX
Установите max, войдите в MAX по QR-коду и подключите ИИ-агента — с его помощью или вручную.
На этой странице вы подключите аккаунт MAX к ИИ-агенту на своём компьютере. После этого агента можно просить читать чаты, искать сообщения и готовить ответы. Понадобится около пяти минут и телефон, на котором вы уже вошли в MAX.
Шаги
- Установите max. max — небольшая программа, которая даёт агенту доступ к вашему аккаунту MAX. Агент может установить её сам, или вы сделаете это вручную.
- Войдите в MAX. Вы сканируете QR-код телефоном. Так компьютер становится новым устройством вашего аккаунта.
- Подключите агента. Агент получает инструкции, чтобы пользоваться max.
- Проверьте, что всё работает. Агент показывает ваш аккаунт и несколько чатов.
Если какой-то шаг не получается, загляните в вопросы и ответы.
1. Установите max
Установить можно двумя способами. Результат одинаковый.
С помощью агента
Подойдёт агент, который умеет запускать программы на этом компьютере, например Claude Code, Codex, Cursor или Gemini CLI. Если вы пользуетесь только чатом с агентом в браузере или на телефоне, откройте подключение из веба или с телефона.
Скопируйте этот запрос в чат с агентом. Он поможет установить инструмент и войти в аккаунт на вашем компьютере.
Помоги подключить мой аккаунт MAX к моему ИИ-агенту на этом компьютере.
Следуй https://wirecat.dev/ru/docs/max/installation: проверь нужные программы и помоги с установкой.
Покажи мне шаги входа, чтобы я сам подтвердил доступ к аккаунту.
Подключи инструкции инструмента к моему агенту. В конце покажи мой аккаунт и несколько чатов. Ничего не отправляй.Агент проведёт вас по шагам:
- Проверит компьютер. Для max нужен Node.js 22.16 или новее. Если его нет, агент объяснит, как его установить.
- Установит max. Ваш аккаунт на этом шаге не затрагивается.
- Запустит вход. Агент запускает
max personal setupв окне терминала, и там появляется QR-код. Вы сканируете его телефоном, как описано в разделе Войдите в MAX. Если агент не может показать вам это окно, он вставит QR-код в чат текстом: см. агент не может показать мне терминал. - Подключит себя к max. Агент устанавливает себе инструкции max.
- Покажет результат. Вы увидите имя аккаунта и несколько чатов. Агент ничего не отправляет.
Вход вы подтверждаете сами, на телефоне. Не вставляйте коды и пароли в чат с агентом.
Вручную в терминале
Откройте «Терминал» в macOS или Linux либо PowerShell в Windows.
-
Установите Node.js 22.16 или новее (22.x или 24+) либо Bun 1.3+. См. Node.js, npm и поиск команды.
-
Установите max:
npm install -g @wirecat/max-cli && max skill install --for allnpm может сообщить о заблокированных сценариях установки. Вторая команда явно устанавливает инструкции агента. Прочитайте предупреждения менеджера пакетов и проверьте версию на следующем шаге. В Windows откройте новый терминал, если команда
maxне найдена.В Windows можно установить одной командой. Она ставит max, добавляет его в
PATH(папки, в которых терминал ищет команды) и подключает все поддерживаемые агенты:& ([scriptblock]::Create((Invoke-RestMethod 'https://wirecat.dev/install.ps1'))) -Tool max -Agent all -
Проверьте установку:
max --versionПоявится номер версии. Если терминал пишет, что команда не найдена, см. max не находится после установки.
-
Запустите вход:
max personal setupДальше — следующий шаг.
2. Войдите в MAX
Вход добавляет компьютер как новое устройство вашего аккаунта MAX — как приложение MAX для компьютера. Это устройство видно в MAX на телефоне, и его можно удалить в любой момент. Вход не скачивает историю чатов.
Вход показывает max personal setup. Его запускает агент или вы сами.
personal — имя этого входа на компьютере, оно называется профилем. Подойдёт любое имя. Следующие команды начинаются с того же имени, например max personal doctor.
- Дождитесь, пока на компьютере появится QR-код для входа. Он появляется в терминале. Если окно слишком узкое, код не рисуется: расширьте окно и запустите setup снова. Если вход без терминала запускает агент, он вставляет код в чат.
- На телефоне откройте MAX, перейдите в «Настройки» → «Устройства» и выберите сканирование QR-кода. Разрешите доступ к камере, если MAX попросит.
- Наведите сканер на код на компьютере. Нужен код входа из setup, а не QR-код вашего профиля для обмена контактами. Подтвердите вход в MAX, если он попросит.
- Если setup попросит дополнительный пароль аккаунта, введите пароль, который вы задали в MAX. Терминал не показывает вводимые символы. Наберите пароль и нажмите Enter.
- Дождитесь, пока setup подтвердит вход и проверит аккаунт и до пяти чатов.
3. Подключите агента
Чтобы пользоваться max, агенту нужны инструкции. Они называются навыком. Setup спрашивает, какой агент вы используете, и устанавливает навык для него. Команда установки выше уже выполняет max skill install --for all.
Чтобы установить навык заново или для другого агента:
max skill install --for allПосле этого откройте новую сессию агента, чтобы он загрузил инструкции. Другие агенты и MCP-приложения описаны в разделе Подключение агента.
4. Проверьте, что всё работает
Попросите агента:
Use max CLI. Покажи мой аккаунт MAX и пять последних чатов. Ничего не отправляй.Проверьте, что имя и чаты относятся к аккаунту, который вы хотели подключить. Если да, max готов к работе.
Setup не скачивает всю историю чатов. Чтобы искать старые сообщения, попросите агента скачать нужную историю.
Вручную: max personal doctor показывает, выполнен ли вход и где max хранит файлы. К MAX он не подключается.
Дальше: попробуйте первую задачу.
Вопросы и ответы
QR-код не сканируется
С агентом: попросите агента войти через браузер. Откроется отдельное окно браузера с web.max.ru. Отсканируйте его QR-код или выберите вход по номеру телефона и пройдите шаги на странице, включая капчу, если она появится.
Вручную: выполните одну из команд:
max personal setup --method qr-chrome # web.max.ru в отдельном окне браузера
max personal setup --method sms # то же окно, вход по номеру телефонаДля входа через браузер нужен Chrome, Chromium, Edge или Brave. Браузеры, установленные через snap, не подходят. Окно использует временный профиль, а не ваш, и закрывается после входа.
Агент не может показать мне терминал с QR-кодом
Агент запускает max personal session start qr в фоне. Без терминала max печатает QR-код текстом. Агент вставляет его в чат блоком кода точно как напечатано, а вы сразу сканируете его с экрана: код MAX действует около 2 минут. Когда код истёк, агент запускает команду снова и получает новый. Дополнительный пароль аккаунта можно ввести только в терминале; если MAX его спросит, запустите max personal setup сами. Подробнее — в разделе если вход запускает агент.
QR-код истёк или setup прервался
Код входа MAX действует около 2 минут.
С агентом: попросите запустить вход ещё раз и сразу отсканируйте новый код.
Вручную: снова выполните max personal setup. Если вход уже выполнен, setup использует его и не спрашивает заново.
max не находится после установки
С агентом: перезапустите агента или попросите его открыть новый терминал. Терминал, открытый во время установки, не видит новую команду. В Windows агенту в уже открытом терминале нужно обновить окружение и прочитать max skill show перед входом.
Вручную: откройте новый терминал и снова выполните max --version. Если не помогло, эта команда объяснит причину и подскажет, что выполнить:
npx @wirecat/max-cli doctorВ Windows npm иногда пропускает шаг, который добавляет max в PATH. Выполните это исправление в PowerShell. Другие записи PATH сохраняются:
$maxNpmPrefix = (npm.cmd prefix -g).Trim()
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$maxNpmPrefix\node_modules\@wirecat\max-cli\install\windows.ps1" -RepairOnly -Prefix $maxNpmPrefix
$env:Path = "$maxNpmPrefix;$env:Path"
max skill install --for all
max --versionПосле обновления max пишет, что профиль не назван
max никогда не выбирает аккаунт сам: каждая команда, которой нужен аккаунт, начинается с имени профиля.
С агентом: назовите агенту имя профиля. Если вы раньше настраивали max без имени профиля, он называется default.
Вручную: пишите имя первым словом (max default chats list) или задайте его один раз: export MAX_PROFILE=default в профиле оболочки. Если вы подключали max к MCP-приложению через max mcp config, выполните эту команду ещё раз.
После обновления max останавливается и называет два файла архива
Обновление один раз переносит архив сообщений в папку WireCat. Если в старом и новом месте лежат разные копии, max останавливается с кодом 3 и называет оба файла. Оставьте нужный, уберите другой и запустите команду снова. Ничего не перенесено и не изменено.
Куда вводить коды и пароли?
В терминал настройки или на странице web.max.ru, но никогда не в чат с агентом. Если не видите окно терминала, попросите агента его показать.
Агент не может пользоваться max после настройки
С агентом: откройте новую сессию агента, чтобы он загрузил инструкции max. Если не помогло, откройте Подключение агента.
Вручную: выполните max skill install --for claude для Claude Code, --for agents для Codex, Gemini CLI и других агентов, которые читают ~/.agents, или --for all.
Нет чата или старых сообщений
Setup проверяет только несколько чатов. Попросите агента скачать нужный чат и период: см. Локальный архив. Пустой результат поиска не значит, что таких сообщений в чате нет.
Можно попробовать max без установки?
Да: npx @wirecat/max-cli --help. Так max запускается один раз. Команда max не появляется, и агент не подключается.
Где хранится вход?
В хранилище паролей операционной системы (ключнице), а не в файле. Если ключницы на компьютере нет, max сохраняет вход в файл рядом с настройками и сообщает об этом. См. Безопасность.
Где хранятся файлы
| Что | Linux и macOS | Windows |
|---|---|---|
| Настройки | ~/.config/max-cli/ | %APPDATA%\max-cli\Config\ |
| Состояние: профили, боты, записи запусков | ~/.local/share/max-cli/ | %LOCALAPPDATA%\max-cli\Data\ |
| Кэш | ~/.cache/max-cli/ | %LOCALAPPDATA%\max-cli\Cache\ |
| Локальный архив сообщений, общий с tg | ~/.local/share/WireCat/wirecat.db | %LOCALAPPDATA%\WireCat\Data\wirecat.db |
| Модели распознавания речи | ~/.local/share/WireCat/models/audio/ | %LOCALAPPDATA%\WireCat\Data\models\audio\ |
max personal doctor показывает точные пути на вашем компьютере. WIRECAT_STATE_DIR переносит всю папку WireCat; он заменяет CLI_COMMON_CACHE_DIR. Как изменить эти папки и другие настройки, описано в разделах Настройки и справочник настроек max.
Первый запуск после обновления со старого max один раз переносит сюда архив и модели из ~/.local/share/cli-messaging/ и ~/.cache/cli-common/models/. Если в обоих местах лежат разные копии, max останавливается и называет оба файла: оставьте один и запустите снова.
Обновление
max upgrade # тем же менеджером пакетов, которым max установлен: npm, pnpm или bun
max upgrade --check # только сообщает, есть ли новая версияЕсли вы обновляетесь с версии, которая хранила сообщения в messages.db, сначала скопируйте заметки и метки, которые есть только на компьютере: старый файл удаляется, когда открывается новый архив. max personal messages sync --all скачает сообщения заново, но не локальные заметки и метки.
Обновляйте tg и memo вместе с max: у них общий архив сообщений, и старый инструмент создаст новый архив на прежнем месте.
max не обновляется сам. Раз в день он проверяет, есть ли новая версия, и пишет об этом одну строку в терминале. Вход после обновления сохраняется.
Удаление
Удаление max убирает команду, но не ваши данные. Сначала выйдите из аккаунта, чтобы вход удалился и из ключницы:
max personal server uninstall # только если ставили фоновую службу
max personal session end # выйти и забыть вход
npm uninstall -g @wirecat/max-cli
rm -rf ~/.config/max-cli ~/.local/share/max-cli ~/.cache/max-cli
rm -rf ~/.claude/skills/max-cli ~/.agents/skills/max-cliЕсли вы подключали ботов, выполните также max <profile> bot auth remove для каждого профиля бота. Удаляйте ~/.local/share/WireCat/ только если сохранённые сообщения больше не нужны другим инструментам, например tg.
Из исходников
Устанавливайте из исходников, если меняете код или нужна ещё не выпущенная версия.
git clone [email protected]:WireCatLabs/max-cli.git
cd max-cli
pnpm install
pnpm build
pnpm link --global # команда max становится доступнойЗапуск без привязки: node dist/bin/max.js --help. Обновление: git pull && pnpm install && pnpm build.