# Агенты на удалённой машине

Работайте в локальном редакторе, а агентов запускайте на другом компьютере.

## 1. Подключитесь к проекту по SSH

Установите в VS Code расширение **Remote - SSH** и убедитесь, что можете войти на хост из терминала:

```shell
ssh user@hostname
```

Выполните **Remote-SSH: Connect to Host…** в Палитре команд. Подключитесь к хосту и откройте на этой машине папку проекта. Проверьте имя хоста в строке состояния редактора.

[Настройка Remote SSH и требования к хосту ↗](https://code.visualstudio.com/docs/remote/ssh)

## 2. Подготовьте удалённую среду

В окне, подключённом по SSH, откройте раздел расширений, найдите Facade Code и установите расширение на SSH-хост. Window Component остаётся на вашем компьютере и связывает удалённый проект с остальными проектами Facade.

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

| Ваш компьютер | Удалённая машина |
| --- | --- |
| Интерфейс редактора и SSH-подключение | Расширение проекта Facade, CLI агента, файлы проекта, сборки и тесты |

Удалённый агент использует инструменты и учётные данные той машины. CLI, установленный только на вашем компьютере, удалённому агенту недоступен.

## 3. Запустите удалённого агента

Откройте Facade в подключённом проекте, выберите **New Agent** и укажите CLI. Проверьте, что в качестве расположения выбран удалённый каталог проекта.

```text
Скажи, какая у тебя операционная система, в каком каталоге проекта ты работаешь и как запускать проверки этого проекта.
```

Убедитесь, что в ответе указаны ожидаемая среда и путь. Агент выполняет команды и меняет файлы на этой машине.

## Меняйте настройки там, где работает агент

С открытой удалённой папкой выберите **Open Settings → Facade: Home → Edit in facade.json**. Если удалённое окно открывает настройки в формате JSON, **Open Settings** сразу ведёт к facade.json. Описание полей — в разделе [Настройки агентов](https://facadecode.com/ru/docs/settings/).

API-ключи, пути к исполняемым файлам и другие переменные среды готовьте на удалённой машине: локальная среда туда не переносится.

## Свяжите локальную и удалённую работу

Оставьте локальный проект и SSH-подключение открытыми. Агенты могут находить друг друга и обмениваться сообщениями через Facade, если это позволяют их настройки доступа.

```text
Через Facade спроси удалённого агента, в каком проекте он работает и какие проверки там доступны.
```

Если агент не видит другого, см. раздел [Подтверждения и доступ агентов](https://facadecode.com/ru/docs/permissions/). Чтобы следить за несколькими агентами — локальными или удалёнными — из одного диалога, используйте [сценарий Facade](https://facadecode.com/ru/docs/collaboration/phone-led-team/).

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