# Устранение неполадок

Определите, где возникла проблема: в конфигурации запуска, в 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 описана в разделе [Агенты на удалённой машине](https://facadecode.com/ru/docs/remote-ssh/). Ошибки подключения с телефона — в разделе [Продолжайте работу с телефона](https://facadecode.com/ru/docs/remote-control/).

## Сообщите о проблеме

Укажите, что вы пробовали, точный текст ошибки, операционную систему, версии редактора и расширения, версию CLI и выбранную запись. По возможности приложите относящиеся к делу настройки без ключей и приватных значений.

[Открыть issue на GitHub ↗](https://github.com/y5ez3g/facadecode/issues)