# Agenten auf einem Remote-Rechner ausführen

Führen Sie Agenten auf einem anderen Rechner aus und arbeiten Sie dabei in Ihrem lokalen Editor.

## 1. Per SSH mit Ihrem Projekt verbinden

Installieren Sie **Remote - SSH** in VS Code und prüfen Sie, ob Sie sich von einem Terminal aus am Host anmelden können:

```shell
ssh user@hostname
```

Führen Sie **Remote-SSH: Connect to Host…** in der Befehlspalette aus. Stellen Sie die Verbindung zum Host her und öffnen Sie dann den Projektordner auf dieser Maschine. Die Statusleiste des Editors zeigt den Host an.

[Remote SSH einrichten und Host-Anforderungen ↗](https://code.visualstudio.com/docs/remote/ssh)

## 2. Remote-Umgebung vorbereiten

Öffnen Sie im SSH-verbundenen Fenster die Ansicht Erweiterungen, suchen Sie Facade Code und installieren Sie die Erweiterung auf dem SSH-Host. Die Window Component bleibt auf Ihrem Rechner und verbindet das Remote-Projekt mit Ihren anderen Facade-Projekten.

Installieren Sie im entfernten integrierten Terminal die gewünschte CLI und schließen Sie die Anmeldung oder Provider-Einrichtung ab. Prüfen Sie, ob sie dort eine Anfrage beantworten kann.

| Ihr Rechner | Remote-Rechner |
| --- | --- |
| Editor-Oberfläche und SSH-Verbindung | Projekterweiterung von Facade, Agenten-CLI, Projektdateien, Builds und Tests |

Der Remote-Agent nutzt die Werkzeuge und Anmeldedaten dieser Maschine. Eine CLI, die nur auf Ihrem Rechner installiert ist, steht einem Remote-Agenten nicht zur Verfügung.

## 3. Den Remote-Agenten starten

Öffnen Sie Facade im verbundenen Projekt, wählen Sie **New Agent** und dann die CLI. Prüfen Sie, ob als Ort der Remote-Projektordner ausgewählt ist.

```text
Sag mir, welches Betriebssystem du verwendest, in welchem Projektverzeichnis du arbeitest und wie ich die Checks dieses Projekts ausführe.
```

Die Antwort sollte die erwartete Umgebung und den erwarteten Pfad nennen. Der Agent führt Befehle aus und ändert Dateien auf dieser Maschine.

## Einstellungen dort bearbeiten, wo der Agent läuft

Wählen Sie bei geöffnetem Remote-Ordner **Open Settings → Facade: Home → Edit in facade.json**. Öffnet Ihr Remote-Fenster die Einstellungen als JSON, führt **Open Settings** direkt zu facade.json. Die Felder sind unter [Agenteneinstellungen](https://facadecode.com/de/docs/settings/) beschrieben.

Bereiten Sie API-Schlüssel, Pfade zu Programmen und andere Umgebungsvariablen auf dem Remote-Rechner vor. Ihre lokale Umgebung wird nicht übertragen.

## Lokale und entfernte Arbeit verbinden

Lassen Sie das lokale Projekt und die SSH-Verbindung geöffnet. Agenten können einander über Facade finden und Nachrichten senden, wenn ihre Zugriffseinstellungen das erlauben.

```text
Frag den Remote-Agenten über Facade, in welchem Projekt er arbeitet und welche Checks dort verfügbar sind.
```

Wenn ein Agent einen anderen nicht findet, lesen Sie [Genehmigungen und Agentenzugriff](https://facadecode.com/de/docs/permissions/). Um mehrere Feature-Agenten – lokal oder entfernt – aus einer Unterhaltung zu verfolgen, nutzen Sie das [Facade-Muster](https://facadecode.com/de/docs/collaboration/phone-led-team/).

Jeder Rechner hat eigene Projektdateien. Checken Sie auf beiden Rechnern denselben Commit aus, bevor Sie Testergebnisse über Betriebssysteme hinweg vergleichen.