Inicio de sesión y perfiles de la CLI de MAX
Inicia sesión en MAX, gestiona perfiles y sesiones y resuelve problemas de autenticación desde tu ordenador.
Conecta la herramienta a tu cuenta para que el agente pueda leer los chats que elijas y ayudarte a responder. Esta guía explica el acceso, su comprobación y cómo gestionar o cerrar una sesión. Iniciar sesión añade un dispositivo autorizado; no descarga todo el historial.
Lea esta página cuando conecte max por primera vez a una cuenta MAX, agregue una segunda cuenta o max diga que no hay inicio de sesión. Al final, usted sabe cómo iniciar sesión, cómo comprobar quién ha iniciado sesión, cómo cerrar sesión y dónde almacena max lo que necesita para mantener su inicio de sesión en su lugar.
Primero, las palabras que aparecen aquí:
- Sesión: acceso de
maxa tu cuenta MAX en este ordenador. Incluye un token y una identidad de dispositivo; aparece como otro dispositivo en la aplicación. - Token: cadena que MAX entrega al iniciar sesión. Permite leer tus chats: trátala como una contraseña.
maxla guarda en el llavero. - Identidad de dispositivo: cómo se identifica
maxante MAX; mantiene el mismo dispositivo entre comandos. Se guarda junto al estado. - Llavero: almacén de contraseñas del sistema operativo: Keychain en macOS, Secret Service (GNOME Keyring, KWallet) en Linux, Administrador de credenciales en Windows.
- Perfil: nombre de una sesión local con su token, estado y ajustes. El nombre se indica en cada comando (
max personal …) o conMAX_PROFILE;maxnunca elige un perfil por sí mismo. Necesitas otro perfil para otra cuenta o restricciones distintas (perfiles).
No confunda max personal session y max personal account sessions. max personal session — entrada del propio max; max personal account sessions enumera todos los demás dispositivos y aplicaciones que hayan iniciado sesión en su cuenta.
Primer inicio
max personal setup comprueba los directorios locales, guía el acceso con QR, comprueba la cuenta y hasta cinco chats e instala el skill del agente. Opciones: codex, cursor, claude, gemini, all, none. Sin opción pregunta en el terminal; en modo máquina omite el skill. max skill show se puede leer antes de iniciar sesión.
Tarda unos cinco minutos. La historia se descarga por separado luego de seleccionar el chat y el volumen; La instalación no inicia el servicio en segundo plano. Al reiniciar se comprueba la sesión existente. --method token|qr|qr-chrome|sms selecciona el nuevo método de entrada; de forma predeterminada, la configuración toma qr. qr-chrome y sms requieren una persona en la terminal local. Sin terminal, qr imprime el código QR como texto: el agente lo pega en el chat y el propietario lo escanea desde la pantalla (consulte Acceso a través de un agente). No pase el token como argumento. Si se interrumpe la configuración, repita la configuración. Si el token ha caducado, ejecute explícitamente max personal session start qr; Si el llavero es inaccesible, primero corrija el entorno de acuerdo con las indicaciones.
Entrada
max personal session start <способ> permite iniciar sesión de cuatro maneras. En todos los casos, el token solo se guarda en el llavero después de que MAX lo acepte.
| Método | Qué ocurre | Requisitos |
|---|---|---|
token (predeterminado) | Pegar un token emitido por el cliente oficial o pasarlo mediante una tubería | Ninguno |
qr | Muestra el QR en la terminal para escanearlo con MAX. Si la terminal es estrecha, el código no se dibuja: ensancha la ventana y vuelve a ejecutarlo. Sin terminal, el código se imprime como texto para un agente | Unas 70 columnas de ancho o un agente |
qr-chrome | Abre web.max.ru en una ventana separada; escaneas su QR | Chrome, Chromium, Edge o Brave |
sms | Abre la misma ventana de web.max.ru; elige acceso por teléfono en la página | Chrome, Chromium, Edge o Brave |
Acceso a través de un agente
Sin terminal (el agente ejecuta el comando con su herramienta de shell), max <профиль> session start qr
imprime el código QR en stderr como texto plano: caracteres █▀▄, sin color y con los módulos claros dibujados, de
modo que en un tema oscuro el código se lee como negro sobre blanco. El agente:
- ejecuta el comando en segundo plano: espera el escaneo hasta 2 minutos, y una herramienta de shell no muestra nada hasta que el comando termina;
- lee su salida y pega el bloque QR en el chat como bloque de código, tal como se imprimió;
- espera a que termine: el resultado del acceso llega por stdout.
Con --json, cada código también es una línea JSON en stderr: {"event":"qr","qr":{"text":…,"expires_at":…,"scan":…}}.
MAX emite un código por ejecución; si caduca, vuelve a ejecutar el comando. La contraseña en la nube de MAX no se
puede introducir así: solo se pide en una terminal. El acceso no está disponible por MCP (session no se publica en
MCP y el acceso no pasa por serve): un agente que solo tiene MCP debe pedir al propietario que ejecute el comando,
o usar una shell.
max personal session start qr- Mantén visible el QR en el ordenador, en la terminal o en la ventana del navegador abierta por el comando.
- Abre MAX en el teléfono y selecciona la cuenta que quieres conectar.
- Ve a Ajustes → Dispositivos y abre el escáner de acceso por QR. Los nombres pueden variar según la versión.
- Escanea el QR del ordenador desde MAX y confirma la conexión si se solicita.
- Si MAX pide una contraseña adicional de la cuenta, introdúcela en la terminal; los caracteres se ocultan.
- Espera a que termine el comando, comprueba la cuenta con
max personal account showy lee algunos chats conmax personal chats list --limit 5.
Instrucciones oficiales de MAX.
qr-chrome y sms son los métodos más conservadores. El acceso lo realiza web.max.ru en un navegador real: MAX ve su propio cliente web. Se utiliza un perfil temporal separado del tuyo. Cuando termina el acceso, se cierra la ventana y se elimina el perfil, también al pulsar Ctrl-C. Cerrar la ventana no termina la sesión: es como cerrar una pestaña. El navegador se detecta automáticamente; puedes elegir otro con MAX_BROWSER. Los navegadores instalados por snap no sirven porque tienen su propio directorio /tmp.
qr solicita código de MAX con su propia conexión max, haciéndose pasar por un cliente web. Funciona sin navegador, pero ya no es un cliente web real.
Inicie sesión mediante SMS: solo a través del navegador. Cuando el SMS solicita una conexión max, MAX requiere un captcha y solo se puede completar en la página.
Tras cualquiera de esos tres métodos, aparece un dispositivo nuevo en la lista de sesiones de MAX. Si la cuenta tiene una contraseña en la nube, qr la solicita sin mostrarla, con hasta tres intentos; después hay que volver a escanear el código.
Los tres métodos requieren una persona ante el terminal; sin ella, fallan con código 2. Un agente sin terminal debe usar token. Un programa que muestra las preguntas en su propia ventana, como WireCat Desktop, ejecuta max personal session start qr --json --answer-stdin: la contraseña en la nube se pide con una línea needs en stderr y la respuesta es una línea en stdin. Si está definido MAX_TOKEN, los tres también fallan: tiene prioridad sobre el llavero e impediría usar la sesión nueva.
Introducir el token manualmente
max personal session start sin método importa un token ya emitido por el cliente oficial, como web.max.ru u otro cliente, y lo guarda en el llavero. También funciona si el acceso encuentra un CAPTCHA o un segundo factor poco habitual.
max personal session start
MAX token: ▏ # ввод не отображаетсяEl token no se pasa como argumento. Cualquier proceso del comando puede ver los argumentos con ps, y quedan en el historial de la shell. Por eso se solicita sin mostrar lo que escribes o, sin terminal, se lee desde una tubería:
pass show max/token | max personal session startPara CI y ejecuciones puntuales hay una variable con prioridad sobre el llavero: si defines MAX_TOKEN, se utiliza ese valor y no se escribe en el llavero. Con ella no se inicia max personal serve en segundo plano: el propio comando se conecta a MAX.
MAX_TOKEN="$(cat /path/to/token)" max personal chats list --jsonVerificar y salir
max personal account show # под кем выполнен вход: id, имя, последние четыре цифры телефона
max account list # все профили на этом компьютере и аккаунт каждого
max personal account sessions list # все устройства и приложения, вошедшие в аккаунт; ничего не завершает
max personal session end # выйти из MAX и забыть токен на этой машинеsession end primero termina la sesión en el servidor de MAX y después borra el token de este ordenador. Si max serve está en marcha para el perfil, iniciado a mano o por un servicio, session end se niega (código 2): antes ejecuta max personal server stop. La respuesta indica el resultado:
{ "item": { "profile": "personal", "forgotten": true, "revoked_on_server": true }, "meta": { … } }Para olvidar un perfil por completo, usa max personal account remove --keep-data o --delete-data. También cierra primero la sesión en el servidor de MAX. Después borra el token, los archivos del perfil y todo lo que la capa compartida guarda para ese perfil. --keep-data conserva los mensajes en el almacén local y la búsqueda los sigue encontrando. --delete-data también los elimina. El token del bot (bot:personal) se conserva.
Si iniciaste sesión con un token de una pestaña de web.max.ru, comparten la misma sesión: session end también cierra la sesión de MAX de esa pestaña.
Si MAX no responde, se conserva el token para que puedas repetir el comando. Un token que MAX ya no acepta se borra de inmediato: ya no queda una sesión que cerrar.
Una ejecución con carpetas movidas (MAX_CONFIG_DIR y las variables relacionadas, otro HOME o una carpeta XDG) usa el inicio de sesión del propietario, pero no lo cierra: ahí session end no borra nada, no cierra la sesión en MAX y responde "kept": "owners-sign-in". Un inicio de sesión hecho en esa misma ejecución, session end lo cierra como siempre.
¿Cuánto dura una sesión?
MAX no informa de una fecha fija de caducidad del token; el CLI no puede prometer un número de días. Cerrar web.max.ru no termina la autorización. Si MAX rechaza el token guardado, vuelve a conectar por QR:
max personal session start qrPara el perfil laboral, usa max work session start qr. Comprueba después la cuenta con max personal account show o max work account show. El comando max personal session start sin método importa un token existente en lugar de mostrar un QR. max personal doctor muestra el número de accesos del perfil.
Perfiles
El perfil almacena su token y su estado; Se comparte el archivo local de los mensajes, con los datos de la cuenta. El perfil se llama primera palabra, no una bandera:
max personal chats list # профиль personal
max work chats list # профиль work
export MAX_PROFILE=personal # или на всю сессию оболочкиRegla: La primera palabra es perfil a menos que sea la misma que el nombre del comando. Por lo tanto, un perfil no puede llamarse chats, runs o session; max personal session start y max personal setup rechazan dicho nombre. De lo contrario, max personal chats significaría silenciosamente "perfil de chat sin comando". El nombre consta de letras latinas, números, puntos, guiones y guiones bajos y comienza con una letra o un número.
Orden, gana la primera coincidencia: primera palabra, MAX_PROFILE. Si no hay ninguno, un comando que necesita una cuenta termina con el código 2 y enumera los perfiles de este ordenador, aunque solo haya uno:
✗ name a profile: `max <profile> …` — profiles here: personal (or set MAX_PROFILE)En un ordenador sin perfiles, el mensaje indica cómo crear el primero: max personal setup. Sin perfil solo funcionan los comandos que no necesitan una cuenta: --help, --version, commands, skill show, account list, config show.
Si la primera palabra no es un comando y tampoco aparece otro después, el programa explica lo ocurrido en lugar de limitarse a mostrar la ayuda:
"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 asigna el proceso a un perfil. Especifíquelo donde se está ejecutando el agente y se rechazará la primera palabra o MAX_PROFILE con el nombre de otro perfil (código de retorno 5). Sin él, el agente podría elegir un perfil con menos restricciones.
Por qué se necesita cada perfil y cómo funciona el perfil con el bot - en la sección perfiles y bots.
Dónde se guarda cada dato
| Qué | Dónde |
|---|---|
| Token | Llavero del sistema, servicio max-cli, entrada con el nombre del perfil |
| Token sin llavero | credentials.json junto a los ajustes, modo 0600 |
| Token para CI | MAX_TOKEN, con prioridad sobre el llavero |
| Token de bot | Llavero, servicio max-cli, entrada bot:<профиль>; o MAX_BOT_TOKEN |
| Chats vistos por bots | ~/.local/share/max-cli/bots/ |
Dispositivo, contador de inicios, viewerId | ~/.local/share/max-cli/profiles/<профиль>.json, modo 0600 |
| Ajustes | ~/.config/max-cli/config.json |
Los directorios para macOS y Windows se enumeran en la sección donde todo va.
La identidad del dispositivo se guarda en la primera lectura, antes de utilizarse. Presentarse como un dispositivo nuevo con cada comando no reproduce el comportamiento de un cliente real: las sesiones del servidor están vinculadas a esa identidad.
En una máquina sin un llavero (un contenedor típico), la grabación falla; luego el token se coloca en el archivo credentials.json al lado de la configuración, con los derechos 0600, y el comando dice esto en una línea en stderr. En CI, es mejor no confiar ni en uno ni en el otro y pasar MAX_TOKEN.
⚠
MAX_CONFIG_DIR,MAX_STATE_DIRyMAX_CACHE_DIRtambién transfieren la entrada en el porta llaves: el nombre cambia servicios. Una sesión guardada con estas variables no es visible para un comando iniciado sin ellas, y viceversa. O instálalos siempre o nunca.