# Ejecuta agentes en una máquina remota

Ejecuta agentes en otro ordenador mientras trabajas desde tu editor local.

## 1. Conéctate a tu proyecto por SSH

Instala **Remote - SSH** en VS Code y comprueba que puedes iniciar sesión en el host desde una terminal:

```shell
ssh user@hostname
```

Ejecuta **Remote-SSH: Connect to Host…** desde la Paleta de comandos. Conéctate al host y abre la carpeta del proyecto en esa máquina. Comprueba el host en la barra de estado del editor.

[Instalación de Remote SSH y requisitos del host ↗](https://code.visualstudio.com/docs/remote/ssh)

## 2. Prepara el entorno remoto

En la ventana conectada por SSH, abre la vista Extensiones, busca Facade Code e instálala en el host SSH. Window Component permanece en tu ordenador y conecta el proyecto remoto con tus demás proyectos de Facade.

En la terminal integrada remota, instala la CLI que quieras usar y completa su inicio de sesión o la configuración de su proveedor. Comprueba que responde a una petición allí.

| Tu ordenador | Máquina remota |
| --- | --- |
| Interfaz del editor y conexión SSH | La extensión de proyecto de Facade, la CLI del agente, los archivos del proyecto, las compilaciones y las pruebas |

El agente remoto usa las herramientas y las credenciales de esa máquina. Una CLI instalada solo en tu ordenador no estará disponible para un agente remoto.

## 3. Inicia el agente remoto

Abre Facade en el proyecto conectado, elige **New Agent** y selecciona la CLI. Comprueba que la ubicación seleccionada es la carpeta del proyecto remoto.

```text
Dime en qué sistema operativo y en qué directorio del proyecto estás trabajando y cómo ejecutar las comprobaciones de este proyecto.
```

Confirma que la respuesta describe el entorno y la ruta esperados. El agente ejecuta comandos y modifica archivos en esa máquina.

## Edita la configuración donde se ejecuta el agente

Con la carpeta remota abierta, elige **Open Settings → Facade: Home → Edit in facade.json**. Si tu ventana remota abre la configuración como JSON, **Open Settings** abre facade.json directamente. Consulta [Configuración de los agentes](https://facadecode.com/es/docs/settings/) para ver los campos.

Prepara las claves de API, las rutas de ejecutables y otras variables de entorno en la máquina remota; tu entorno local no se traslada.

## Conecta el trabajo local y el remoto

Mantén abiertos el proyecto local y la conexión SSH. Los agentes pueden encontrarse y enviarse mensajes a través de Facade cuando su configuración de acceso lo permite.

```text
Usa Facade para preguntar al agente remoto en qué proyecto está trabajando y qué comprobaciones hay disponibles allí.
```

Consulta [Aprobaciones y acceso entre agentes](https://facadecode.com/es/docs/permissions/) si un agente no encuentra a otro. Para seguir varios agentes de funcionalidad, locales o remotos, desde una sola conversación, usa el [patrón Facade](https://facadecode.com/es/docs/collaboration/phone-led-team/).

Cada máquina tiene sus propios archivos de proyecto. Haz checkout del mismo commit en cada máquina antes de comparar resultados de pruebas entre sistemas operativos.