Facade CodeСправочник по конфигурации
Поля facade.json, их значения по умолчанию и порядок применения в Facade.
Поля верхнего уровня
Файл открывается через настройки агентов. Он допускает комментарии и висячие запятые в JSON. Пустой объект означает значения по умолчанию.
| Поле | Значение | По умолчанию |
|---|---|---|
yolo | Логическое значение, управляющее подтверждениями CLI и доступом агентов. | true |
names | Список предлагаемых имён агентов, без пустых строк. | Встроенный список имён |
clis | Объект со встроенными переопределениями и дополнительными именованными записями. | {}; встроенные CLI остаются доступными |
$schema | Строка для метаданных схемы в редакторе. | Не задано |
Поля записи CLI
| Поле | Значение | По умолчанию |
|---|---|---|
type | claude, codex, agy, muse, opencode, pi или custom. | Определяется автоматически для точных встроенных ID; обязателен для добавленных записей. |
command | Одно имя или путь исполняемого файла. | Команда типа из PATH; обязательна для custom. |
args | Массив строковых аргументов, передаваемых буквально. | [] |
env | Имена переменных, сопоставленные со строками или null. | {} |
model | Непустой идентификатор модели. | Решает CLI. Не поддерживается для OpenCode и custom. |
effort | Непустой уровень усилий, поддерживаемый CLI и моделью. | Решает CLI. Не поддерживается для OpenCode и custom. |
enabled | Логическое значение, управляющее будущими запусками и восстановлением. | true |
icon | ID встроенного CLI или поддерживаемый значок робота. | Значок типа; facade-pearl для custom. |
Чтобы настроить встроенную запись, используйте точный ID в нижнем регистре, например codex. Имя новой записи должно отличаться от всех встроенных ID и отображаемых имён, даже без учёта регистра. Например, используйте Codex · work, а не Codex. Добавленные записи не наследуют настройки встроенной записи своего типа.
enabled: false скрывает корректную запись и запрещает её будущие запуски и восстановление. Уже запущенный агент при этом не останавливается.
Значения переменных среды
{
"clis": {
"codex": {
"env": {
"WORK_API_KEY": "${env:WORK_API_KEY}",
"OLD_TOKEN": null
}
}
}
}- Строка задаёт переменную.
nullудаляет её. Если переменная не упомянута, она наследуется. - Выражение
${env:NAME}считывает значение из среды хоста редактора. Оно не читает другие ключи того же объекта. - Если такой переменной нет, запись становится недоступной. Ссылки раскрываются один раз в значениях
env, но не вargs. - Литеральное значение остаётся в facade.json. При использовании ссылки на переменную среды её значение не записывается в файл, но CLI всё равно получает раскрытое значение.
Если задать переменную в уже открытом встроенном терминале, среда хоста редактора не обновится. Сделайте её доступной до запуска редактора.
Приоритет и параметры запуска
Facade сначала использует модель и уровень усилий, указанные для нового агента, затем значения по умолчанию записи. Если ни там, ни там значения нет, решение принимает CLI. OpenCode хранит оба выбора в собственной конфигурации.
Для встроенных типов используйте отдельные поля модели и уровня усилий. Facade также задаёт разрешения, идентификаторы диалогов, рабочие папки и свои инструменты. Он отклоняет аргументы, которые противоречат этим параметрам или мешают интерактивной сессии запуститься.
Facade ищет facade.json в домашней папке Facade: в параметре Facade: Home настроек VS Code, если он задан, затем в FACADE_HOME, затем в ~/.facade. Вызовите Open Settings из проекта, чтобы найти активный файл конфигурации.
Ошибки файла и ошибки записей
Ошибка уровня файла (некорректный JSON, повторяющийся ключ или неизвестное поле верхнего уровня) блокирует новые запуски и восстановление. Ошибка в одной записи CLI делает недоступной только эту запись. Запущенные агенты продолжают работать.
Найдите в сообщении об ошибке путь к настройке и исправьте значение. Facade не подставляет старые настройки молча. Частые ошибки запуска и провайдеров описаны в разделе Устранение неполадок.