# Настройки агентов

Выберите CLI, которые появляются в New Agent, измените их параметры по умолчанию и добавьте свои конфигурации запуска.

## 1. Откройте facade.json

- Откройте меню **…** на панели Facade и выберите **Open Settings**. Команду также можно найти в Палитре команд.
- В разделе **Facade: Home** выберите **Edit in facade.json**. Если удалённое окно открывает настройки в формате JSON, команда открывает facade.json напрямую.
- Измените файл и сохраните его. Facade допускает комментарии и висячие запятые в JSON.

По умолчанию файл находится по пути `~/.facade/facade.json`. Если файла нет, Facade создаёт его с комментариями, встроенными записями CLI и примерами для адаптации. Существующий файл Facade не перезаписывает.

## 2. Измените значение по умолчанию

Например, так задаётся уровень усилий Codex по умолчанию `high` и отключается Pi в New Agent. Добавьте эти поля в существующий файл, сохранив остальные записи, которые используете:

```json
{
  "clis": {
    "codex": {
      "effort": "high"
    },
    "pi": {
      "enabled": false
    }
  }
}
```

Сохраните файл и запустите нового агента. Запущенные агенты сохраняют параметры запуска; возобновлённые и закреплённые агенты используют текущий файл при следующем запуске.

## 3. Добавьте ещё одну конфигурацию

Используйте встроенный ID вроде `codex`, чтобы изменить значения по умолчанию для этого CLI, или новое имя, чтобы добавить отдельную конфигурацию:

```json
{
  "clis": {
    "Codex · review": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "effort": "high"
    }
  }
}
```

Замените `YOUR_MODEL_ID` на модель, которую поддерживает ваша конфигурация Codex. Сохраните файл и выберите `Codex · review` в New Agent. Поле `type` сохраняет интеграцию Codex с Facade, а имя обозначает эту конфигурацию.

Новая запись не наследует настройки `codex`. Добавьте ей собственные аргументы, переменные среды или путь к исполняемому файлу. Чтобы подключить другой API, следуйте руководствам по [Claude Code](https://facadecode.com/ru/docs/providers/claude-code/) или [Codex](https://facadecode.com/ru/docs/providers/codex/). Как изменить её отображение, описано в разделе [Имена и значки](https://facadecode.com/ru/docs/appearance/).

## Используйте настройки нужной машины

Локальные проекты с одной домашней папкой Facade используют общие настройки. Проекты SSH, WSL и контейнеров читают файл в своей среде выполнения. Открывайте настройки из проекта, который хотите настроить.

Параметр **Facade: Home** в настройках VS Code задаёт папку с файлом `facade.json`. Явно заданное значение важнее `FACADE_HOME`, который, в свою очередь, важнее `~/.facade`. После смены домашней папки примите предложение Facade перезагрузить окно.

Команда **Edit in facade.json** открывает активный файл. Определения полей и значения по умолчанию — в [справочнике по конфигурации](https://facadecode.com/ru/docs/reference/).