Facade CodeУстранение неполадок
Определите, где возникла проблема: в конфигурации запуска, в CLI или у провайдера моделей.
Проверьте запрошенный запуск
Выполните Show Agent Launch в Палитре команд и выберите рабочее расположение. Отчёт показывает, как каждый CLI запустился бы там сейчас: исполняемый файл, каталог, аргументы и имена переменных среды. Приватные значения скрыты.
Отчёт описывает следующий запуск с текущими настройками. Он не описывает уже запущенного агента. Если запрос выполняется успешно, статистика использования провайдера поможет понять, какой аккаунт его обработал.
Найдите симптом
| Проблема | Что проверить |
|---|---|
| Не удаётся найти файл настроек | Выберите Open Settings, затем Edit in facade.json в разделе Facade: Home. Если удалённое окно открывает настройки в формате JSON, команда открывает facade.json напрямую. |
| Запись отсутствует в New Agent | Проверьте имя записи и type, а также что она не отключена через enabled: false. Некорректные записи отображаются в разделе Unavailable с указанием причины. |
| Исполняемый файл не найден | Установите CLI там, где выполняется проект, или укажите полный путь в command. Для OpenCode нужна версия 2 (@opencode/cli). |
| Переменная среды из ссылки не найдена | К моменту запуска агента переменная должна быть в среде хоста редактора. Экспорт переменной в уже открытом терминале не обновляет среду хоста. |
| Аргумент конфликтует с параметром, которым управляет Facade | Уберите параметр из args. Вместо него используйте поле model или effort в записи CLI либо поле yolo верхнего уровня. |
| Ошибка аутентификации или модель недоступна | Проверьте ключ провайдера, эндпоинт, регион, идентификатор модели и доступ к аккаунту. |
| Провайдер Codex не отвечает | Убедитесь, что его эндпоинт поддерживает Responses API. |
| Агент не находит другого агента | Проверьте, что их проекты подключены через одну домашнюю папку Facade, а настройки доступа разрешают обмен. |
| Пользовательская программа не получает сообщений | Вводите текст в её терминале. Записи custom не получают сообщения и инструменты Facade. |
| Сохранённые настройки не изменили работающего агента | Запустите нового агента. Чтобы сохранить диалог, завершите агента, а затем перезапустите его командой Resume Agent с новыми настройками. |
Настройка SSH описана в разделе Агенты на удалённой машине. Ошибки подключения с телефона — в разделе Продолжайте работу с телефона.
Сообщите о проблеме
Укажите, что вы пробовали, точный текст ошибки, операционную систему, версии редактора и расширения, версию CLI и выбранную запись. По возможности приложите относящиеся к делу настройки без ключей и приватных значений.