# Configuración y mantenimiento (/es/docs/max/commands-setup)

Esta referencia reúne comandos de configuración y mantenimiento. Consulta opciones de acceso, perfiles, configuración, servidor en segundo plano, almacén local, diagnóstico y conexión del agente.

Acceso, perfiles, configuración, servidor en segundo plano, almacén local, diagnóstico, conexión del agente y actualizaciones.

## Opciones generales [#opciones-generales]

Se aplican a todos los comandos.

| Opción | Para qué sirve |
| --- | --- |
| `-V, --version` | generar el número de versión. |
| `-v, --verbose` | más detalle en lo que se muestra: -v ids, -vv todo lo que sabemos. Por defecto: `0`. |
| `--json` | salida legible por máquina: un valor JSON en la salida estándar, nada más. |
| `--agent-json` | JSON para agentes de IA: muestra los controles invisibles; --json normal conserva el texto. |
| `--jsonl` | Salida legible por máquina: un objeto JSON por línea, para streaming y jq. |
| `--quiet` | diagnóstico desactivado. |
| `--trace` | una línea por solicitud en stderr: identificadores y tiempos, nunca contenido del mensaje. |
| `--debug` | si algo falla, su registro completo (causa y pila) en lugar de la línea breve. |
| `--timeout <duration>` | abandone todo el comando después de esto: 30 s, 2 m, 500 ms. |
| `--offline` | responder de lo grabado y nunca conectarse; falla si no fuera nada. |
| `--no-input` | no pedir entrada ni abrir un inicio de sesión interactivo; la entrada mediante una tubería sigue disponible. |
| `--max-input-bytes <bytes>` | máximo de bytes de entrada almacenados en búfer (predeterminado: 16777216). |
| `--max-output-bytes <bytes>` | máximo de bytes de salida para máquinas (predeterminado: 4194304; 0 desactiva el límite). |
| `--fields <paths>` | campos de elementos o del objeto separados por comas: id,text; conservar la paginación y los identificadores de operaciones. |
| `--brief` | los mensajes y correos encontrados solo con referencia, título, hora, remitente y fragmento. |
| `--full` | los mensajes y correos encontrados con todo su texto y todos los campos del proveedor. |
| `--dry-run` | previsualizar los argumentos analizados y los permisos antes de ejecutar la acción. |
| `--yes` | Continúe sin la pregunta que un nivel de pregunta pone antes de escribir. |
| `--record` | mantenga esto ejecutándose en `max runs`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-runs "Referencia del comando: max runs"): identificadores y horarios, nunca contenido de mensajes. |
| `--no-record` | no lo guardes, diga lo que diga la configuración. |
| `--serve` | inicie `max serve`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-serve "Referencia del comando: max serve") en segundo plano si no se está ejecutando (el valor predeterminado). |
| `--no-serve` | no lo inicies; inicie sesión en la propia conexión de este comando a menos que se esté ejecutando uno. |

## Comandos [#comandos]

## `max session` [#max-session]

la sesión MAX almacenada para este perfil

### `max session start` [#max-session-start]

inicie sesión en este perfil en MAX

```sh
max session start [method]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `method` | opcional | token (pegado o por stdin), qr, qr-chrome o sms. Uno de: `token`, `qr`, `qr-chrome`, `sms`. Por defecto: `token`. |

### `max session end` [#max-session-end]

cerrar la sesión de este perfil en MAX y eliminar la sesión guardada aquí

**Cambia algo en MAX.**

```sh
max session end
```

## `max setup` [#max-setup]

configure su cuenta MAX personal y conecte a su agente

**Cambia algo en MAX.**

```sh
max setup [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--agent <agent>` | instalar la habilidad para este agente; pregunta en una terminal, de lo contrario ninguno. Uno de: `none`, `codex`, `cursor`, `claude`, `gemini`, `all`. |
| `--method <method>` | cómo iniciar sesión cuando no hay sesión. Uno de: `token`, `qr`, `qr-chrome`, `sms`. Por defecto: `qr`. |

## `max account` [#max-account]

la cuenta iniciada

### `max account list` [#max-account-list]

todos los perfiles de este ordenador y sus cuentas; no consulta el servicio de mensajería

```sh
max account list
```

### `max account show` [#max-account-show]

con quién se ha iniciado sesión en este perfil; el número de teléfono muestra sus últimos cuatro dígitos

```sh
max account show [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--show-phone` | mostrar el número de teléfono completo. |

### `max account update` [#max-account-update]

cambia el nombre, la descripción o la foto que todos ven en tu perfil

**Cambia algo en MAX.**

```sh
max account update [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--first-name <name>` | your first name. |
| `--last-name <name>` | your last name. |
| `--description <text>` | about you. |
| `--photo <file>` | una nueva foto de perfil: un archivo de imagen. |

### `max account sessions` [#max-account-sessions]

¿En qué otro lugar se inició sesión con esta cuenta? No en `max session`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-session "Referencia del comando: max session"), que es el inicio de sesión propio de esta herramienta.

#### `max account sessions list` [#max-account-sessions-list]

cada dispositivo y aplicación que haya iniciado sesión en esta cuenta; nada ha terminado

```sh
max account sessions list
```

#### `max account sessions end` [#max-account-sessions-end]

cierre sesión en todos los demás dispositivos, incluido su teléfono; este se queda

**Cambia algo en MAX.**

```sh
max account sessions end [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--others` | todas las sesiones excepto ésta. |

### `max account privacy` [#max-account-privacy]

quién puede encontrar la cuenta, llamar o añadirla

#### `max account privacy show` [#max-account-privacy-show]

ajustes de privacidad de la cuenta; leerlos no cambia nada

```sh
max account privacy show
```

#### `max account privacy set` [#max-account-privacy-set]

cambiar quién puede encontrar la cuenta, llamar o añadirla; los demás ajustes se conservan

**Cambia algo en MAX.**

```sh
max account privacy set [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--find-by-phone <who>` | quién encuentra la cuenta por su número: everyone, contacts o nobody; MAX admite everyone y contacts. |
| `--phone-number <who>` | quién ve el número: everyone, contacts o nobody. |
| `--calls <who>` | quién puede llamar: everyone, contacts o nobody. |
| `--chat-invites <who>` | quién puede añadir la cuenta a grupos y canales: everyone, contacts o nobody. |
| `--hide-online <on\|off>` | ocultar el estado en línea y la última conexión. |

## `max store` [#max-store]

el almacén local de mensajes

### `max store status` [#max-store-status]

por chat: mensajes almacenados, los más antiguos y más nuevos, y los tramos retenidos por completo

```sh
max store status [chat]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chat` | opcional | un chat: su ID o parte de su título. |

### `max store gaps` [#max-store-gaps]

inspeccionar las lagunas internas de cobertura registradas y descargar explícitamente los datos que faltan

#### `max store gaps plan` [#max-store-gaps-plan]

plan de cobertura local; los identificadores de mensajes ausentes no implican por sí solos que falte historial

```sh
max store gaps plan <chat>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chat` | obligatorio | un chat: su ID o parte de su título. |

#### `max store gaps repair` [#max-store-gaps-repair]

descargar datos de lagunas internas con límites y volver a comprobar la cobertura; nunca eliminar los mensajes no encontrados

```sh
max store gaps repair <chat> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chat` | obligatorio | un chat: su ID o parte de su título. |

| Opción | Para qué sirve |
| --- | --- |
| `--limit <n>` | total de mensajes en esta reparación, 500 de forma predeterminada. |
| `--max-gaps <n>` | como máximo este número de lagunas, 5 de forma predeterminada. |
| `--repair-time <duration>` | tiempo disponible para la reparación, 30s por defecto. Por defecto: `30s`. |
| `--page-size <n>` | mensajes por página del proveedor. |
| `--pause <duration>` | pausa entre las páginas del proveedor. Por defecto: `5s`. |
| `--fingerprint <hash>` | rechazar si este plan de cobertura previamente revisado ha cambiado. |
| `--catch-up` | preparar la búsqueda local después de reparar; anula searchCatchUp. |
| `--no-catch-up` | omitir la preparación de la búsqueda local después de reparar. |
| `--catch-up-chunks <n>` | máximo de fragmentos locales que se preparan. |
| `--catch-up-messages <n>` | máximo de mensajes almacenados que se leen para la preparación. |
| `--catch-up-time <duration>` | tiempo de preparación dentro del tiempo restante de la reparación. |
| `--background` | reparar mediante el mecanismo existente de trabajos del almacenamiento; consultar store jobs show. |

### `max store jobs` [#max-store-jobs]

tareas de sincronización en segundo plano

#### `max store jobs list` [#max-store-jobs-list]

tareas de sincronización en segundo plano, las más recientes primero

```sh
max store jobs list [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--state <state>` | Solo tareas `running`, `done`, `failed`, `cancelled` o `died`. |

#### `max store jobs show` [#max-store-jobs-show]

un trabajo en segundo plano (el más nuevo cuando no se nombra ninguno) y lo que el archivo tiene ahora de su chat

```sh
max store jobs show [job]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `job` | opcional | el ID de la tarea que imprimió `messages sync --background`[↗](/llms.mdx/docs/es/max/commands-personal/content.md#max-messages-sync "Referencia del comando: max messages sync"). |

#### `max store jobs cancel` [#max-store-jobs-cancel]

detener una tarea en segundo plano en curso tras su página actual; una sincronización posterior continúa donde se detuvo

```sh
max store jobs cancel <job>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `job` | obligatorio | la identificación del trabajo. |

#### `max store jobs retry` [#max-store-jobs-retry]

volver a iniciar una tarea parcial, fallida o muerta como tarea nueva; la sincronización continúa donde se detuvo el almacén

```sh
max store jobs retry [job] [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `job` | opcional | ID del trabajo. |

| Opción | Para qué sirve |
| --- | --- |
| `--failed` | todos los chats cuyo último trabajo falló o se interrumpió. |

#### `max store jobs clear` [#max-store-jobs-clear]

olvidar trabajos terminados y borrar sus registros; se conservan los trabajos en curso

**Cambia algo solo en este ordenador.**

```sh
max store jobs clear
```

### `max store export` [#max-store-export]

los mensajes guardados de un chat, del más antiguo al más reciente: --jsonl un mensaje por línea, --json un objeto \{ items, page, limit, hasMore }; nunca consulta el servicio de mensajería

```sh
max store export [chats] [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `chats`[↗](/llms.mdx/docs/es/max/commands-personal/content.md#max-chats "Referencia del comando: max chats") | opcional | un chat: su id, o parte de su título; varios con --to. |

| Opción | Para qué sirve |
| --- | --- |
| `--format <format>` | jsonl: un mensaje por línea, el valor predeterminado con --output; markdown: una transcripción con un encabezado por día, respuestas y reenvíos citados. |
| `--since-time <time>` | solo a partir de esta hora ISO 8601, o hace 30 m/2 h/1 d en adelante. |
| `--output <file>` | escriba líneas JSON, o la transcripción, en este nuevo archivo, que solo usted podrá leer. |
| `--to <dir>` | escribe en esta carpeta, un archivo por chat y un manifiesto; ejecútelo nuevamente para ver solo lo que cambió desde entonces. |
| `--kind <kinds>` | con --to: cada chat almacenado de este tipo, separado por comas: diálogo, grupo, canal, guardado. |
| `--all` | con --to: cada chat almacenado de esta cuenta. |
| `--encrypt` | comprimir y cifrar con una contraseña, escrita en un mensaje oculto o canalizada en stdin; nunca se conserva; si se pierde, el archivo no se podrá abrir. |

### `max store clear` [#max-store-clear]

eliminar de el archivo los chats que ha dejado esta cuenta, con sus mensajes

```sh
max store clear [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--left` | los chats que ha dejado esta cuenta: lo único que esto borra. |
| `--allow-dangerous` | sí, eliminar: no se puede deshacer y un chat que abandonaste no se puede recuperar de nuevo. |

### `max store info` [#max-store-info]

el archivo de almacenamiento: dónde está, su tamaño, su esquema y cuántas filas contiene; no cambia nada

```sh
max store info
```

### `max store check` [#max-store-check]

si el archivo está en buen estado: integridad, índices de búsqueda, disco y qué chats están detrás

```sh
max store check
```

### `max store migrate` [#max-store-migrate]

actualizar el esquema y normalizar e indexar mensajes y notas, incluidas sus raíces

```sh
max store migrate
```

### `max store reindex` [#max-store-reindex]

reconstruir índices de palabras, erratas, raíces, archivos y notas sin perder datos

```sh
max store reindex
```

### `max store backup` [#max-store-backup]

copie el archivo en un archivo nuevo, mientras esté en uso; nunca sobrescribe un archivo

```sh
max store backup <file> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `file` | obligatorio | el nuevo archivo. |

| Opción | Para qué sirve |
| --- | --- |
| `--encrypt` | comprimir y cifrar con una contraseña, escrita en un mensaje oculto o canalizada en stdin; nunca se conserva; si se pierde, el archivo no se podrá abrir. |

### `max store restore` [#max-store-restore]

poner una copia de seguridad en lugar de el archivo; el archivo a la que reemplaza se mantiene a su lado, nunca se elimina

```sh
max store restore <file>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `file` | obligatorio | un archivo que escribió `store backup`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-store-backup "Referencia del comando: max store backup"); uno escrito con --encrypt solicita su contraseña. |

### `max store decrypt` [#max-store-decrypt]

abra un archivo escrito con --encrypt en un archivo nuevo; pide su contraseña

```sh
max store decrypt <file> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `file` | obligatorio | un archivo que escribió `store backup --encrypt`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-store-backup "Referencia del comando: max store backup") o `store export --encrypt`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-store-export "Referencia del comando: max store export"). |

| Opción | Para qué sirve |
| --- | --- |
| `--output <file>` | el nuevo archivo, legible sólo por usted. |

### `max store repair` [#max-store-repair]

traer cada tabla a la forma de esta construcción, sin eliminar nada: una tabla con la forma incorrecta se guarda como una copia junto a una nueva

```sh
max store repair [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--dry-run` | diga lo que haría y no cambiará nada. |

### `max store reset` [#max-store-reset]

back the store up beside itself, then delete it and start an empty one at this build's schema; asks first, or --yes

```sh
max store reset [options]
```

| Opción | Qué hace |
| --- | --- |
| `--no-backup` | delete the store without backing it up first. |

### `max store copies` [#max-store-copies]

las tablas `store repair`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-store-repair "Referencia del comando: max store repair") se conservan como copias

#### `max store copies delete` [#max-store-copies-delete]

eliminar una copia guardada de `store repair`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-store-repair "Referencia del comando: max store repair"), con el nombre exacto; rechaza cualquier otra mesa

```sh
max store copies delete <name>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `name` | obligatorio | el nombre de la copia, tal como lo imprimió `store repair`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-store-repair "Referencia del comando: max store repair"). |

## `max flood` [#max-flood]

las esperas MAX solicitaron que este perfil se mantuviera y se retuvieran sus escrituras

### `max flood clear` [#max-flood-clear]

olvidarlos y levantar la pausa y el límite de ritmo del perfil cuando MAX ya no limite la cuenta; no cambia nada en MAX

```sh
max flood clear
```

## `max models` [#max-models]

Modelos que se ejecutan en esta máquina.

### `max models audio` [#max-models-audio]

modelos de voz para transcribir mensajes de voz

#### `max models audio list` [#max-models-audio-list]

los modelos de voz, el más adecuado primero, cuáles se descargan y cuál es el predeterminado

```sh
max models audio list
```

#### `max models audio download` [#max-models-audio-download]

descargue un modelo de voz una vez, comparado con el sha256 que espera esta versión

```sh
max models audio download <model>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `model` | obligatorio | una identificación de modelo de `models audio list`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-models-audio-list "Referencia del comando: max models audio list"). |

### `max models text` [#max-models-text]

modelos de búsqueda por significado

#### `max models text list` [#max-models-text-list]

los modelos de incrustación, el más adecuado primero, cuáles se descargan y cuál es el predeterminado

```sh
max models text list
```

#### `max models text download` [#max-models-text-download]

descargue un modelo de incrustación una vez, comparado con el sha256 que espera esta versión

```sh
max models text download <model> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `model` | obligatorio | una identificación de modelo de `models text list`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-models-text-list "Referencia del comando: max models text list"). |

| Opción | Para qué sirve |
| --- | --- |
| `--accept-terms` | aceptar los términos de licencia del modelo, para un modelo que tiene los suyos propios. |

#### `max models text key` [#max-models-text-key]

Claves API para proveedores de incrustación y análisis

#### `max models text key set` [#max-models-text-key-set]

guardar una clave mediante entrada oculta o stdin; nunca como argumento

```sh
max models text key set <provider>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `provider` | obligatorio | openai, anthropic o el host de un servidor --base-url que quiere una clave. |

#### `max models text key remove` [#max-models-text-key-remove]

olvidar una clave almacenada

```sh
max models text key remove <provider>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `provider` | obligatorio | openai, anthropic o el host de un servidor. |

## `max serve` [#max-serve]

manténgase conectado a MAX y transmita nuevos mensajes a `max watch`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-watch "Referencia del comando: max watch"), hasta Ctrl-C

```sh
max serve [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--idle <duration>` | deténgase después de tanto tiempo sin que nadie lo use: 15 m, 1 h son 60 m. |

## `max server` [#max-server]

`max serve`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-serve "Referencia del comando: max serve") en segundo plano: inicio, parada, reinicio, estado, registros; instalar agrega una unidad systemd o launchd

### `max server start` [#max-server-start]

comience a servir en segundo plano (a través de la unidad si hay una instalada) y responda una vez que se conecte

```sh
max server start [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--idle <duration>` | detenerse tras este tiempo sin uso — 15m, 1h. |

### `max server stop` [#max-server-stop]

detener el servicio de este perfil: a través de la unidad si se ejecuta bajo uno

```sh
max server stop
```

### `max server restart` [#max-server-restart]

detenerlo y empezar de nuevo

```sh
max server restart [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--idle <duration>` | detenerse tras este tiempo sin uso — 15m, 1h. |

### `max server status` [#max-server-status]

si el servicio se ejecuta para este perfil, desde cuándo, quién lo inició y la unidad, si la hay

```sh
max server status
```

### `max server logs` [#max-server-logs]

Las últimas líneas de registro del servidor: del diario en systemd; de lo contrario, su archivo de registro.

```sh
max server logs [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `-n, --lines <n>` | how many lines. Por defecto: `50`. |

### `max server install` [#max-server-install]

escriba una unidad de usuario systemd o un agente de lanzamiento para este perfil; no empieza nada

```sh
max server install
```

### `max server uninstall` [#max-server-uninstall]

eliminar la unidad de este perfil; detenlo primero

```sh
max server uninstall
```

## `max watch` [#max-watch]

imprimir nuevos mensajes a medida que llegan, desde un `max serve`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-serve "Referencia del comando: max serve") en ejecución

```sh
max watch [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--events` | mostrar también ediciones, eliminaciones, reacciones, lecturas y cambios de chats; cada línea indica su evento. |

## `max config` [#max-config]

las configuraciones vigentes, y de dónde vino cada una

### `max config show` [#max-config-show]

el perfil, los perfiles que existen y cada configuración con su origen

```sh
max config show [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--bot` | la configuración que obtiene un comando `max bot`[↗](/llms.mdx/docs/es/max/commands-bot/content.md#max-bot "Referencia del comando: max bot") en este perfil, en lugar de la de la cuenta personal. |

### `max config migrate` [#max-config-migrate]

reemplazar la configuración de acceso heredada con permisos, preservando los niveles efectivos

**Cambia algo solo en este ordenador.**

```sh
max config migrate [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--dry-run` | muestra la migración sin escribir el archivo. |

### `max config set` [#max-config-set]

guardar una configuración en el archivo de configuración

**Cambia algo solo en este ordenador.**

```sh
max config set <setting> <value> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `setting` | obligatorio | uno de: límite, timeoutMs, color, registro, keepRunsForDays, readOnly, permitir, permisos, sendsPerHour, requestPerMinute, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, análisisProvider, análisisModel, análisisBaseUrl, modelos, senderColors, catchUpMarksRead, searchCatchUp, servir, mcpTools, readOtherBots, updateCheck, SkillHint, transcribeModel, defaultProfile, searchStemmers.cyrillic, searchStemmers.latin. |
| `value` | obligatorio | un número, verdadero o falso, o para permitir una lista como enviar, reacción. |

| Opción | Para qué sirve |
| --- | --- |
| `--defaults` | cambiar lo que reciben todos los perfiles, no solo este. |
| `--personal` | solo para cuentas personales — la sección personal del archivo. |
| `--bot` | solo para bots — la sección bot del archivo. |

### `max config unset` [#max-config-unset]

eliminar una configuración del archivo de configuración

**Cambia algo solo en este ordenador.**

```sh
max config unset <setting> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `setting` | obligatorio | uno de: límite, timeoutMs, color, registro, keepRunsForDays, readOnly, permitir, permisos, sendsPerHour, requestPerMinute, embeddingProvider, embeddingModel, embeddingBaseUrl, embeddingDims, análisisProvider, análisisModel, análisisBaseUrl, modelos, senderColors, catchUpMarksRead, searchCatchUp, servir, mcpTools, readOtherBots, updateCheck, SkillHint, transcribeModel, defaultProfile, searchStemmers.cyrillic, searchStemmers.latin. |

| Opción | Para qué sirve |
| --- | --- |
| `--defaults` | cambiar lo que reciben todos los perfiles, no solo este. |
| `--personal` | solo para cuentas personales — la sección personal del archivo. |
| `--bot` | solo para bots — la sección bot del archivo. |

## `max doctor` [#max-doctor]

el estado en que se encuentra esta instalación, sin contactar a MAX a menos que --online

```sh
max doctor [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--online` | también inicie sesión una vez, lea un chat e inicie el servidor MCP; no envía nada. |

### `max doctor report` [#max-doctor-report]

qué contiene un informe de problema y hacia dónde va; no escribe nada

#### `max doctor report create` [#max-doctor-report-create]

escribir un informe de problema en un archivo e imprimir cómo enviarlo

```sh
max doctor report create [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--run <id>` | la ejecución sobre la que trata el informe; el más nuevo falló si no se proporciona. |
| `--output <file>` | dónde escribirlo; un nuevo archivo en este directorio si no se proporciona. |

## `max runs` [#max-runs]

ejecuciones registradas: qué hizo esta herramienta y cuándo

### `max runs list` [#max-runs-list]

ejecuciones registradas, las más recientes primero

```sh
max runs list [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--limit <n>` | how many to show. Por defecto: `20`. |

### `max runs show` [#max-runs-show]

una ejecución: qué fue, cómo terminó y qué salió mal; -v para todos los eventos

```sh
max runs show <run-id>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `run-id` | obligatorio | un ID de `max runs list`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-runs-list "Referencia del comando: max runs list"). |

### `max runs search` [#max-runs-search]

search recorded diagnostic metadata and events; no message contents

```sh
max runs search [query] [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `query` | opcional | case-insensitive literal diagnostic text. |

| Opción | Qué hace |
| --- | --- |
| `--status <status>` | run outcome. Uno de: `success`, `failed`, `partial`, `running`. |
| `--error-code <code>` | one stable error code. |
| `--operation <name>` | one operation, such as messages.download. |
| `--profile <name>` | one recorded profile. |
| `--since-time <time>` | runs starting on or after an ISO time or 2h / 1d ago. |
| `--limit <n>` | matches per page, at most 100. Por defecto: `20`. |
| `--page <n>` | result page. Por defecto: `1`. |

### `max runs path` [#max-runs-path]

el directorio que contiene una ejecución

```sh
max runs path <run-id>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `run-id` | obligatorio | un ID de `max runs list`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-runs-list "Referencia del comando: max runs list"). |

## `max skill` [#max-skill]

las instrucciones que recibe un agente para esta herramienta

### `max skill show` [#max-skill-show]

print SKILL.md: `max skill install`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-skill-install "Referencia del comando: max skill install") lo coloca donde lo buscan Claude Code, Codex y Gemini CLI

```sh
max skill show [name]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `name` | opcional | una de las habilidades incluidas para una tarea: follow-ups, link-conversations. |

### `max skill install` [#max-skill-install]

escriba SKILL.md en \~/.claude/skills/max-cli/ (Claude Code) y \~/.agents/skills/max-cli/ (Codex, Gemini CLI)

```sh
max skill install [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--for <agents>` | which agents to install for. Uno de: `claude`, `agents`, `all`. Por defecto: `all`. |

## `max commands` [#max-commands]

Comandos, opciones y códigos de salida como JSON: inspecciona una ruta de comando por llamada.

### `max commands schema` [#max-commands-schema]

argv y esquemas de resultados de un comando, efectos, permisos y orientación sobre reintentos

```sh
max commands schema <path>
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `path` | obligatorio | una ruta de comando, por ejemplo: stats messages show. |

## `max upgrade` [#max-upgrade]

actualice max con el administrador de paquetes que lo instaló; --comprobar sólo miradas

```sh
max upgrade [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--check` | diga si existe una versión más nueva y no instale nada. |

## `max complete` [#max-complete]

finalización del shell: `max complete zsh`[↗](/llms.mdx/docs/es/max/commands-setup/content.md#max-complete "Referencia del comando: max complete") imprime el script en el código fuente

```sh
max complete [words]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `words` | opcional | |

## `max mcp` [#max-mcp]

servir este perfil a un agente a través de MCP, en stdin y stdout - `claude mcp add max -- max mcp`

```sh
max mcp [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleto: usa permissions.messages.send en la configuración; no concede acceso. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-mark-read` | obsoleto: usa permissions.chats.mark-read en la configuración; no concede acceso. |
| `--allow-delete` | obsoleto: usa permissions.messages.delete en la configuración; no concede acceso. |
| `--allow-moderate` | obsoleto: usa permissions.chats.moderate y las reglas del grupo; no concede acceso. |
| `--http` | ofrece el servidor HTTP en 127.0.0.1 para ChatGPT y Claude en el navegador a través de tu túnel; se aplican los permisos del perfil. |
| `--http-confirmation <mode>` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--port <port>` | el puerto local para --http (predeterminado 8765). |
| `--public-url <url>` | la dirección https del túnel que utilizan las aplicaciones del navegador, p. https\://<name>.ts.net. |
| `--revoke` | olvide cada inicio de sesión proporcionado a una aplicación de navegador; cada uno debe iniciar sesión nuevamente. |

### `max mcp config` [#max-mcp-config]

imprima la entrada mcpServers para Claude Desktop, Cursor y otros, con las rutas completas; no escribe nada

```sh
max mcp config [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleto: usa permissions.messages.send en la configuración; no concede acceso. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-mark-read` | obsoleto: usa permissions.chats.mark-read en la configuración; no concede acceso. |
| `--allow-delete` | obsoleto: usa permissions.messages.delete en la configuración; no concede acceso. |
| `--allow-moderate` | obsoleto: usa permissions.chats.moderate y las reglas del grupo; no concede acceso. |

### `max mcp setup` [#max-mcp-setup]

agregue el servidor MCP local de este perfil a Codex o Claude Code

**Cambia algo solo en este ordenador.**

```sh
max mcp setup <client> [options]
```

| Argumento | Obligatoriedad | Qué es |
| --- | --- | --- |
| `client` | obligatorio | codex o claude-code. |

| Opción | Para qué sirve |
| --- | --- |
| `--allow-writes` | Reconocer que este perfil ofrece herramientas de escritura. |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleto: usa permissions.messages.send en la configuración; no concede acceso. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-mark-read` | obsoleto: usa permissions.chats.mark-read en la configuración; no concede acceso. |
| `--allow-delete` | obsoleto: usa permissions.messages.delete en la configuración; no concede acceso. |
| `--allow-moderate` | obsoleto: usa permissions.chats.moderate y las reglas del grupo; no concede acceso. |

### `max mcp doctor` [#max-mcp-doctor]

consulte la lista de herramientas y protocolo de enlace MCP local de este perfil

```sh
max mcp doctor [options]
```

| Opción | Para qué sirve |
| --- | --- |
| `--permission <key=level>` | sobrescribir un permiso solo para este servidor; repetir para más claves. |
| `--allow-dangerous` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-send` | obsoleto: usa permissions.messages.send en la configuración; no concede acceso. |
| `--confirm-send` | ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil. |
| `--allow-mark-read` | obsoleto: usa permissions.chats.mark-read en la configuración; no concede acceso. |
| `--allow-delete` | obsoleto: usa permissions.messages.delete en la configuración; no concede acceso. |
| `--allow-moderate` | obsoleto: usa permissions.chats.moderate y las reglas del grupo; no concede acceso. |

## Códigos de salida [#códigos-de-salida]

Los scripts deciden según el código de salida, no según el texto: el texto puede cambiar; el código no.

| Código | Cuándo |
| --- | --- |
| `0` | Operación completada |
| `2` | `validation_error` |
| `3` | `configuration_error` |
| `4` | `authentication_error` |
| `5` | `permission_error` |
| `6` | `not_found` |
| `7` | `confirmation_required` |
| `8` | `rate_limited` |
| `9` | `timeout` |
| `10` | `network_error` |
| `11` | `provider_error` |
| `12` | `provider_unavailable` |
| `13` | `invalid_response` |
| `14` | `outcome_unknown` |
| `130` | `cancelled` |
| `1` | Cualquier otro caso |

`0`, y solo `0`, significa que la operación se completó. `14`, `outcome_unknown`, significa que
el mensaje **podría** haberse enviado: no se confirma éxito ni fallo. Solo puedes repetirlo con el mismo
`--send-id`.