# Exécuter des agents sur une machine distante

Exécutez des agents sur un autre ordinateur tout en travaillant depuis votre éditeur local.

## 1. Connectez-vous à votre projet en SSH

Installez **Remote - SSH** dans VS Code et vérifiez que vous pouvez vous connecter à l’hôte depuis un terminal :

```shell
ssh user@hostname
```

Exécutez **Remote-SSH: Connect to Host…** depuis la palette de commandes. Connectez-vous à l’hôte, puis ouvrez le dossier du projet sur cette machine. La barre d’état de l’éditeur confirme l’hôte actif.

[Configuration et prérequis de Remote SSH ↗](https://code.visualstudio.com/docs/remote/ssh)

## 2. Préparez l’environnement distant

Dans la fenêtre connectée en SSH, ouvrez la vue Extensions, recherchez Facade Code et installez-le sur l’hôte SSH. Window Component reste sur votre ordinateur et relie le projet distant à vos autres projets Facade.

Dans le terminal intégré distant, installez la CLI que vous voulez utiliser, puis connectez-vous à votre compte ou configurez le fournisseur de modèles. Vérifiez qu’elle répond bien à une demande depuis cette machine.

| Votre ordinateur | Machine distante |
| --- | --- |
| Interface de l’éditeur et connexion SSH | Extension Facade du projet, CLI d’agent, fichiers du projet, compilations et tests |

L’agent distant utilise les outils et les identifiants de sa machine. Une CLI installée uniquement sur votre ordinateur ne sera pas disponible pour un agent distant.

## 3. Démarrez l’agent distant

Ouvrez Facade dans le projet connecté, choisissez **New Agent** et sélectionnez la CLI. Vérifiez que l’emplacement sélectionné est bien le dossier du projet distant.

```text
Indiquez le système d’exploitation et le dossier de projet dans lesquels vous travaillez, ainsi que la façon d’exécuter les vérifications de ce projet.
```

Vérifiez que la réponse décrit l’environnement et le chemin attendus. L’agent exécute les commandes et modifie les fichiers sur cette machine.

## Modifiez les paramètres là où l’agent s’exécute

Avec le dossier distant ouvert, choisissez **Open Settings → Facade: Home → Edit in facade.json**. Si votre fenêtre distante ouvre les paramètres au format JSON, **Open Settings** mène directement à facade.json. Voir [Paramètres des agents](https://facadecode.com/fr/docs/settings/) pour les champs.

Préparez les clés d’API, les chemins d’exécutables et les autres variables d’environnement sur la machine distante ; votre environnement local n’est pas transféré.

## Reliez le travail local et le travail distant

Gardez le projet local et la connexion SSH ouverts. Les agents peuvent se découvrir et s’écrire via Facade lorsque leurs paramètres d’accès l’autorisent.

```text
Demandez à l’agent distant, via Facade, dans quel projet il travaille et quelles vérifications sont disponibles sur sa machine.
```

Voir [Approbations et accès des agents](https://facadecode.com/fr/docs/permissions/) si un agent n’en trouve pas un autre. Pour suivre plusieurs agents en charge des fonctionnalités, locaux ou distants, depuis une seule conversation, utilisez le [modèle Facade](https://facadecode.com/fr/docs/collaboration/phone-led-team/).

Chaque machine a ses propres fichiers de projet. Vérifiez que les copies du projet correspondent au même commit avant de comparer des résultats de tests entre systèmes d’exploitation.