# Настройки CLI MAX (/ru/docs/max/configuration)

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

[Изменить и проверить настройки](/llms.mdx/docs/ru/configuration/content.md)

Эта страница нужна, когда вы снова и снова набираете один и тот же параметр или хотите, чтобы `max`
вёл себя иначе для одного аккаунта. Прочитав её, вы будете знать, где лежит файл настроек, что
делают основные настройки, как изменить одну из них и как проверить, какое значение действует.
Файл для начала работы не нужен: без него у каждой настройки есть встроенное значение.

Слова, которые встречаются на странице:

- **Файл настроек** (`config.json`) — текстовый файл, в котором `max` хранит ваши сохранённые выборы.
- **Профиль** — именованный набор настроек одного аккаунта MAX или одного бота, например `work`.
  Его имя ставится перед командой: `max work chats list`. См. [профили и боты](/llms.mdx/docs/ru/max/profiles/content.md).
- **Параметр** (флаг) — слово, добавленное к одной команде, например `--limit 5`. Он меняет только
  этот запуск.
- **Переменная окружения** — именованное значение, которое терминал или процесс агента передаёт
  `max`, например `MAX_PROFILE=work`.
- **Значение по умолчанию** — то, что `max` берёт, когда ничто другое значение не задало.

## Что можно настроить [#что-можно-настроить]

Это настройки, которые меняют чаще всего. Точное описание каждой — тип и все способы
переопределения — в [справочнике настроек](/llms.mdx/docs/ru/max/configuration-reference/content.md#%D1%84%D0%B0%D0%B9%D0%BB).

| Настройка | Что делает | Встроенное значение |
|---|---|---|
| `limit` | сколько строк показывает список, если не указан `--limit` | `20` |
| `sends_per_hour` | сколько сообщений профиль может отправить за час; останавливает цикл отправок | `30`; у бота — без лимита, пока не задан в разделе `bot` |
| `requests_per_minute` | как часто `max` обращается к MAX после короткой серии запросов; `0` выключает темп ([ограничения и ожидания](/llms.mdx/docs/ru/max/limits/content.md)) | `20` |
| `permissions` | что профилю можно: только читать, спрашивать перед изменением или делать без вопроса ([права](/llms.mdx/docs/ru/max/permissions/content.md)) | всё разрешено, кроме: удаление и ещё несколько необратимых изменений сначала спрашивают; автоответы не отправляют |
| `record` | записывать и удачные запуски, не только неудачные ([диагностика](/llms.mdx/docs/ru/max/diagnostics/content.md)) | `true` |
| `record_input` | хранить ли в записи запуска командную строку так, как вы её набрали; секреты скрыты всегда ([диагностика](/llms.mdx/docs/ru/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` | сколько дней хранятся записи запусков | `30` |
| `color` | цвет в таблицах | по терминалу |
| `sender_colors` | свой цвет у каждого автора в списке сообщений | `false` |
| `timeout_ms` | сколько ждать ответа на **один** запрос к MAX, в миллисекундах. Чтобы ограничить команду целиком, используйте `--timeout` | по транспорту |
| `serve` | запускать фоновый сервер `max personal serve`, когда команде нужен MAX ([один вход на всё](/llms.mdx/docs/ru/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` | какой моделью распознавать голосовые сообщения | `gigaam-v3` |
| `update_check` | раз в сутки сообщать, что вышла новая версия `max` | `true` |

Секрета в файле не бывает. В нём нет места для токена, номера телефона или идентификатора чата:
токен хранится в ключнице системы, а где её нет — в файле, который можете читать только вы ([где живёт токен](/llms.mdx/docs/ru/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)).

## Пример файла настроек [#пример-файла-настроек]

Первая команда, которая читает настройки, создаёт начальный файл; `max personal doctor` его не создаёт. Вот он, с одним добавленным
профилем:

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

- `defaults` действует для всех профилей.
- `profiles.work` действует только для профиля `work` и важнее `defaults`.

Поэтому `max work chats list` покажет 50 строк, а `max personal chats list` — 20. Добавьте `--limit 5`, чтобы
получить пять строк в одной команде. Уберите `limit` у профиля — и снова действует значение из
`defaults`.

<details>
<summary>Полный пример со всеми разделами</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 }
    }
  }
}
```

Что делает каждая часть:

- `defaults`: эти значения получает каждый профиль, если не задал своё. `update_check`, `skill_hint` и
  `transcribe_model` допустимы только здесь: программа и модели речи одни на все профили.
- `profiles.personal`: больше строк, цвета и запись каждого запуска — только для `personal`.
- `profiles.work`: читать сообщения можно, отправлять можно, остальные изменения сообщений
  запрещены. Не больше 10 отправок в час. Фоновый сервер не запускается: каждая команда входит в
  MAX сама.
- `personal.defaults`: только для команд личного аккаунта, никогда для `max … bot`. Здесь
  `messages sync` ещё и готовит скачанные чаты к поиску.
- `bot.defaults`: только для команд бота (`max shop bot …`). Боты могут читать и отправлять, и
  больше ничего.
- `bot.profiles.shop`: бот `shop` может отправить 200 сообщений в час и не читает то, что сохранили
  другие боты на этом компьютере. `read_other_bots` допустим только в разделе `bot`; `serve`,
  `sender_colors` там, наоборот, не принимаются.

</details>

## Где лежит файл [#где-лежит-файл]

| Система | Путь |
|---|---|
| Linux и macOS | `~/.config/max-cli/config.json` |
| Windows | `%APPDATA%\max-cli\Config\config.json` |

`max config show` печатает путь, который действительно использует этот компьютер, и каждую настройку
со значением, откуда оно взялось, встроенным значением и тем, что настройка делает. В PowerShell набирайте
`max.cmd` вместо `max`. Существующий файл начальным никогда не заменяется.

`max config migrate` дописывает в `defaults` каждую настройку, которой в файле нет, со встроенным значением, так что
все настройки видны и правятся прямо в файле. Ваши значения, их порядок и незнакомые ключи остаются как есть. То же
делает любая запись `max` в файл, например `config set`; `config unset` убранную настройку обратно не пишет.

## Три способа задать значение [#три-способа-задать-значение]

- **В файле:** значение сохранится для следующих команд. `max personal config set limit 50` записывает его.
- **Переменной окружения:** значение действует в одном терминале или одном процессе агента.
  Например, `MAX_PROFILE` выбирает профиль, а `MAX_TIMEOUT` ограничивает время команды.
  Переменная есть не у каждой настройки.
- **Параметром:** `--limit 5` меняет только эту команду.

## Какое значение побеждает? [#какое-значение-побеждает]

Параметр важнее переменной окружения. Дальше идёт значение профиля в файле, затем `defaults` в
файле, затем встроенное значение. Настройка участвует только в тех способах, которые она
поддерживает; [справочник настроек](/llms.mdx/docs/ru/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) перечисляет их
для каждой настройки.

## Изменить значение [#изменить-значение]

Файл можно править в любом текстовом редакторе или поручить это `max`. `config set` проверяет
значение до записи, поэтому никогда не сохраняет файл, от которого откажется следующая команда.

```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                         # проверить, что действует и откуда взялось каждое значение
```

Опечатка в имени настройки — ошибка, а не тихое значение по умолчанию: каждая команда
останавливается и называет неверный ключ ([опечатки в файле](/llms.mdx/docs/ru/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)).

## Профили и боты [#профили-и-боты]

Профиль хранит настройки одного аккаунта или одного бота. Его имя ставится перед командой, например
`max work config show`. Чтобы работать от имени бота, а не личного аккаунта, добавьте `bot` после
имени. Как создавать профили и переключаться между ними, объясняет страница
[профили и боты](/llms.mdx/docs/ru/max/profiles/content.md).

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

- [Права](/llms.mdx/docs/ru/max/permissions/content.md): решить, что можно профилю и агенту, который с ним работает.
- [Справочник настроек](/llms.mdx/docs/ru/max/configuration-reference/content.md): каждая настройка, её тип, где она допустима, и
  все переменные окружения.
- [Внешние модели](/llms.mdx/docs/ru/max/external-models/content.md): провайдеры, ключи и выбор модели для распознавания текста
  на картинках (OCR).
