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

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

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

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

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

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

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

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

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

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

{
  "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 или Codex. Как изменить её отображение, описано в разделе Имена и значки.

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

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

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

Команда Edit in facade.json открывает активный файл. Определения полей и значения по умолчанию — в справочнике по конфигурации.