# Configuración de la CLI de MAX (/es/docs/max/configuration)

Guarda ajustes que repetirías en cada comando. Esta guía explica su ubicación y prioridad para cambiar un valor y comprobar cuál se aplica.

[Cambiar y comprobar ajustes](/llms.mdx/docs/es/configuration/content.md)

Esta página es necesaria cuando escribe el mismo parámetro una y otra vez o desea que `max` se comporte de manera diferente para una cuenta. Después de leerlo, sabrá dónde está el archivo de configuración, qué hacen las configuraciones principales, cómo cambiar una de ellas y cómo verificar qué valor está vigente. No necesita un archivo para comenzar: sin uno, cada configuración tiene un valor incorporado.

Palabras que aparecen en la página:

- **Archivo de configuración** (`config.json`): un archivo de texto en el que `max` almacena sus selecciones guardadas.
- **Perfil** es un conjunto de configuraciones con nombre para una cuenta MAX o un bot, por ejemplo `work`. Su nombre se coloca antes del comando: `max work chats list`. Ver [perfiles y bots](/llms.mdx/docs/es/max/profiles/content.md).
- **Parámetro** (bandera): una palabra agregada a un comando, por ejemplo `--limit 5`. Sólo cambia este ejecución.
- **Variable de entorno** es un valor con nombre que el proceso del terminal o agente pasa a `max`, por ejemplo `MAX_PROFILE=work`.

## ¿Qué se puede configurar? [#qué-se-puede-configurar]

Estas son las configuraciones que se cambian con más frecuencia. Una descripción exacta de cada tipo y todos los métodos de anulación en [referencia de configuración](/llms.mdx/docs/es/max/configuration-reference/content.md#%D1%84%D0%B0%D0%B9%D0%BB).

|Ajustes|¿Qué hace?|Valor incorporado|
|---|---|---|
| `limit` |¿Cuántas líneas muestra la lista si no se especifica `--limit`?| `20` |
| `sends_per_hour` |cuántos mensajes puede enviar un perfil en una hora; detiene el ciclo de envío|`30`; el bot no tiene límite hasta que se especifica en la sección `bot`|
| `requests_per_minute` |¿Con qué frecuencia accede `max` a MAX después de una breve serie de solicitudes? `0` apaga el tempo ([limitaciones y expectativas](/llms.mdx/docs/es/max/limits/content.md))| `20` |
| `permissions` |qué puede hacer el perfil: sólo leer, preguntar antes de cambiar o hacer sin preguntar ([permisos](/llms.mdx/docs/es/max/permissions/content.md))|todo está permitido excepto: primero se solicita la eliminación y algunos cambios irreversibles más; las respuestas automáticas no se envían|
| `record` | registrar también las ejecuciones correctas, no solo las fallidas ([diagnóstico](/llms.mdx/docs/es/max/diagnostics/content.md)) | `true` |
| `record_input` | si el registro de ejecución guarda la línea de comandos tal como la escribiste; los secretos se ocultan siempre ([diagnóstico](/llms.mdx/docs/es/max/diagnostics/content.md#%D1%87%D1%82%D0%BE-%D0%B2%D1%8B-%D0%BD%D0%B0%D0%B1%D1%80%D0%B0%D0%BB%D0%B8)) | `true` |
| `keep_runs_for_days` |¿Cuántos días se almacenan los registros de ejecución?| `30` |
| `color` |color en tablas|por terminal|
| `sender_colors` |Cada autor tiene un color diferente en la lista de mensajes.| `false` |
| `timeout_ms` |cuánto tiempo esperar una respuesta a **una** solicitud a MAX, en milisegundos. Para restringir todo el comando, use `--timeout`|en transporte|
| `serve` |ejecute el servidor en segundo plano `max personal serve` cuando el comando necesite MAX ([una entrada para todos los](/llms.mdx/docs/es/max/limits/content.md#%D0%BE%D0%B4%D0%B8%D0%BD-%D0%B2%D1%85%D0%BE%D0%B4-%D0%BD%D0%B0-%D0%B2%D1%81%D1%91))| `true` |
| `transcribe_model` |qué modelo reconocer mensajes de voz| `gigaam-v3` |
| `update_check` |una vez al día para informar que se ha lanzado una nueva versión de `max`| `true` |

No hay ningún secreto en un archivo. No hay lugar en él para un token, un número de teléfono o una identificación de chat: el token se almacena en el llavero del sistema y, donde no está, en un archivo que solo usted puede leer ([donde vive token](/llms.mdx/docs/es/max/security/content.md#%D0%B3%D0%B4%D0%B5-%D0%B6%D0%B8%D0%B2%D1%91%D1%82-%D1%82%D0%BE%D0%BA%D0%B5%D0%BD)).

## Archivo de configuración de ejemplo [#archivo-de-configuración-de-ejemplo]

El primer comando que lee la configuración crea el archivo inicial; `max personal doctor` no lo crea. Aquí está, con un perfil agregado:

```json
{
  "defaults": { "limit": 20, "keep_runs_for_days": 30, "sends_per_hour": 30, "update_check": true, "skill_hint": true },
  "profiles": {
    "work": { "limit": 50 }
  }
}
```

- `defaults` es válido para todos los perfiles.
- `profiles.work` es válido sólo para el perfil `work` y es más importante que `defaults`.

Por lo tanto, `max work chats list` mostrará 50 líneas y `max personal chats list` mostrará 20. Agregue `--limit 5` para obtener cinco líneas en un comando. Elimine `limit` del perfil y el valor de `defaults` volverá a ser válido.

<details> <summary>Ejemplo completo con todas las secciones</summary>

```json
{
  "defaults": {
    "limit": 20,
    "keep_runs_for_days": 14,
    "sends_per_hour": 30,
    "requests_per_minute": 20,
    "update_check": true,
    "skill_hint": true,
    "transcribe_model": "gigaam-v3"
  },
  "profiles": {
    "personal": {
      "limit": 50,
      "color": true,
      "sender_colors": true,
      "record": true
    },
    "work": {
      "permissions": { "messages": "readonly", "messages.send": "allow" },
      "sends_per_hour": 10,
      "serve": false
    }
  },
  "personal": {
    "defaults": { "search_catch_up": true }
  },
  "bot": {
    "defaults": { "permissions": { "bot": "readonly", "bot.messages.send": "allow" } },
    "profiles": {
      "shop": { "sends_per_hour": 200, "read_other_bots": false }
    }
  }
}
```

Qué hace cada parte:

- `defaults`: cada perfil recibe estos valores si no ha especificado los suyos propios. `update_check`, `skill_hint` y `transcribe_model` sólo son válidos aquí: el programa y los modelos de voz son los mismos para todos los perfiles.
- `profiles.personal`: más líneas, colores y grabación de cada ejecución - sólo para `personal`.
- `profiles.work`: se pueden leer mensajes, se pueden enviar mensajes, se prohíben otros cambios en los mensajes. No más de 10 envíos por hora. El servidor en segundo plano no se inicia: cada comando ingresa MAX.
- `personal.defaults`: sólo para comandos de cuentas personales, nunca para `max … bot`. Aquí `messages sync` también prepara chats descargados para búsqueda.
- `bot.defaults`: sólo para comandos de bot (`max shop bot …`). Los bots pueden leer y enviar, y nada más.
- `bot.profiles.shop`: El bot `shop` puede enviar 200 mensajes por hora y no lee lo que otros bots en esta computadora han guardado. `read_other_bots` sólo es válido en la sección `bot`; Allí, por el contrario, no se aceptan `serve`, `sender_colors`.

</details>

## ¿Dónde está el archivo? [#dónde-está-el-archivo]

|Sistema|Camino|
|---|---|
| Linux y macOS | `~/.config/max-cli/config.json` |
| Windows | `%APPDATA%\max-cli\Config\config.json` |

`max config show` imprime la ruta que esta computadora realmente usa y cada configuración con su valor, de dónde salió ese valor, el valor integrado y lo que hace la configuración. En PowerShell, escriba `max.cmd` en lugar de `max`. Un archivo existente nunca se reemplaza por el inicial.

`max config migrate` añade a `defaults` cada configuración que falta en el archivo, con su valor integrado, para que todas las configuraciones se vean y se editen directamente en el archivo. Sus valores, su orden y las claves desconocidas quedan como están. Cualquier escritura de `max` en el archivo, por ejemplo `config set`, hace lo mismo; `config unset` no vuelve a escribir la configuración eliminada.

## Tres formas de establecer un valor [#tres-formas-de-establecer-un-valor]

- **En archivo:** el valor se guardará para los siguientes comandos. `max personal config set limit 50` lo anota.
- **Variable de entorno:** el valor es válido en un terminal o en un proceso de agente. Por ejemplo, `MAX_PROFILE` selecciona el perfil y `MAX_TIMEOUT` limita el tiempo del comando. No todas las configuraciones tienen una variable.
- **Parámetro:** `--limit 5` cambia solo este comando.

## ¿Qué valor tiene prioridad? [#qué-valor-tiene-prioridad]

El parámetro es más importante que la variable de entorno. Luego viene el valor del perfil en el archivo, luego `defaults` en el archivo y luego el valor integrado. La configuración está involucrada sólo en los métodos que admite; [la referencia de configuración](/llms.mdx/docs/es/max/configuration-reference/content.md#%D0%BA%D0%B0%D0%BA%D0%BE%D0%B5-%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BE%D0%B1%D0%B5%D0%B6%D0%B4%D0%B0%D0%B5%D1%82) las enumera para cada configuración.

## Cambiar valor [#cambiar-valor]

El archivo se puede editar en cualquier editor de texto o confiar a `max`. `config set` verifica el valor antes de escribir, por lo que nunca guarda un archivo que el siguiente comando descartará.

```sh
max personal config set limit 50                 # профилю, с которым вы работаете
max work config set limit 50            # профилю work
max config set sends_per_hour 10 --defaults   # всем профилям
max personal config unset limit                  # вернуть значение по умолчанию
max config show                         # проверить, что действует и откуда взялось каждое значение
```

Un error tipográfico en el nombre de una configuración es un error, no el valor predeterminado silencioso: cada comando se detiene y nombra la clave incorrecta ([errores tipográficos en el archivo](/llms.mdx/docs/es/max/configuration-reference/content.md#%D0%BE%D0%BF%D0%B5%D1%87%D0%B0%D1%82%D0%BA%D0%B0--%D1%8D%D1%82%D0%BE-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B0-%D0%B0-%D0%BD%D0%B5-%D1%83%D0%BC%D0%BE%D0%BB%D1%87%D0%B0%D0%BD%D0%B8%D0%B5)).

## Perfiles y bots [#perfiles-y-bots]

Un perfil almacena la configuración de una cuenta o un bot. Su nombre se coloca antes del comando, por ejemplo `max work config show`. Para trabajar como un bot en lugar de una cuenta personal, agregue `bot` después del nombre. Cómo crear perfiles y cambiar entre ellos se explica en la página [perfiles y bots](/llms.mdx/docs/es/max/profiles/content.md).

## Más [#más]

- [Permisos](/llms.mdx/docs/es/max/permissions/content.md): decide qué se permite para el perfil y el agente que trabaja con él.
- [Directorio de configuración](/llms.mdx/docs/es/max/configuration-reference/content.md): cada configuración, su tipo, dónde es válida y todas las variables de entorno.
- [Modelos externos](/llms.mdx/docs/es/max/external-models/content.md): proveedores, claves y selección de modelo para reconocimiento de texto en imágenes (OCR).
