# Fehlerbehebung

Finden Sie heraus, ob ein Problem an der Startkonfiguration, der CLI oder ihrem Modell-Provider liegt.

## Den angeforderten Start prüfen

Führen Sie **Show Agent Launch** in der Befehlspalette aus und wählen Sie den Arbeitsort. Der Bericht zeigt, wie jede CLI dort jetzt starten würde: Programm, Verzeichnis, Argumente und Namen der Umgebungsvariablen. Private Werte sind ausgeblendet.

Der Bericht beschreibt den nächsten Start mit Ihren aktuellen Einstellungen, nicht einen bereits laufenden Agenten. War eine Anfrage erfolgreich, können die Nutzungsdaten des Providers helfen zu prüfen, welches Konto sie verarbeitet hat.

## Das Symptom finden

| Problem | Prüfen |
| --- | --- |
| Die Einstellungsdatei ist nicht zu finden | Wählen Sie Open Settings und dann Edit in facade.json unter Facade: Home. Öffnet das Remote-Fenster die Einstellungen als JSON, öffnet der Befehl direkt facade.json. |
| Ein Eintrag fehlt in New Agent | Prüfen Sie Name und `type` des Eintrags und stellen Sie sicher, dass er nicht mit `enabled: false` deaktiviert ist. Ungültige Einträge erscheinen unter Unavailable mit Begründung. |
| Das Programm wird nicht gefunden | Installieren Sie die CLI dort, wo das Projekt läuft, oder tragen Sie den vollständigen Pfad in `command` ein. Für OpenCode verwenden Sie Version 2 (`@opencode/cli`). |
| Eine Umgebungsreferenz fehlt | Die Variable muss in der Umgebung des Editor-Hosts verfügbar sein, bevor der Agent startet. Ein Export in einem bereits geöffneten Terminal aktualisiert den Host nicht. |
| Ein Argument widerspricht einer Option, die Facade steuert | Entfernen Sie die Option aus `args`. Verwenden Sie stattdessen das Feld `model` oder `effort` im CLI-Eintrag oder das Feld `yolo` auf oberster Ebene. |
| Die Anmeldung schlägt fehl oder ein Modell ist nicht verfügbar | Prüfen Sie Schlüssel, Endpunkt, Region, Modell-ID und Kontozugriff des Providers. |
| Ein Codex-Provider antwortet nicht | Prüfen Sie, ob sein Endpunkt die Responses API unterstützt. |
| Ein Agent findet einen anderen Agenten nicht | Prüfen Sie, ob ihre Projekte über dasselbe Facade-Home verbunden sind und ihre Zugriffseinstellungen die Kommunikation erlauben. |
| Ein eigenes Programm erhält keine Nachrichten | Tippen Sie in sein Terminal. Eigene Einträge erhalten keine Facade-Nachrichten und keine Werkzeuge. |
| Gespeicherte Einstellungen haben einen laufenden Agenten nicht geändert | Starten Sie einen neuen Agenten. Um die Unterhaltung zu behalten, beenden Sie den Agenten und starten Sie ihn mit Resume Agent und den neuen Einstellungen neu. |

Zur SSH-Einrichtung lesen Sie [Agenten auf einem Remote-Rechner ausführen](https://facadecode.com/de/docs/remote-ssh/). Bei Verbindungsfehlern vom Smartphone lesen Sie [Vom Smartphone aus weiterarbeiten](https://facadecode.com/de/docs/remote-control/).

## Ein Problem melden

Nennen Sie, was Sie versucht haben, den genauen Fehler, Ihr Betriebssystem, die Versionen von Editor und Erweiterung, die CLI-Version und den gewählten Eintrag. Wenn möglich, fügen Sie die relevanten Einstellungen bei, ohne Schlüssel und andere private Werte.

[Ein GitHub-Issue eröffnen ↗](https://github.com/y5ez3g/facadecode/issues)