# Konfigurationsreferenz

Schlagen Sie die Felder in facade.json, ihre Vorgabewerte und ihre Anwendung durch Facade nach.

## Felder auf oberster Ebene

Öffnen Sie die Datei über die [Agenteneinstellungen](https://facadecode.com/de/docs/settings/). Sie akzeptiert JSON-Kommentare und abschließende Kommas. Ein leeres Objekt verwendet die Vorgabewerte.

| Feld | Wert | Standard |
| --- | --- | --- |
| `yolo` | Boolescher Wert für CLI-Genehmigungen und Agentenzugriff. | `true` |
| `names` | Liste nicht leerer vorgeschlagener Agentennamen. | Integrierte Namensliste |
| `clis` | Objekt mit Überschreibungen integrierter CLIs und zusätzlichen benannten Einträgen. | `{}`; integrierte CLIs bleiben verfügbar |
| `$schema` | String für Schema-Metadaten des Editors. | Nicht gesetzt |

## Felder eines CLI-Eintrags

| Feld | Wert | Standard |
| --- | --- | --- |
| `type` | `claude`, `codex`, `agy`, `muse`, `opencode`, `pi` oder `custom`. | Implizit bei exakt passenden integrierten IDs; erforderlich für hinzugefügte Einträge. |
| `command` | Ein Programmname oder Pfad. | Befehl des Typs im PATH; erforderlich für custom. |
| `args` | Array unveränderter Argument-Strings. | `[]` |
| `env` | Variablennamen mit Strings oder null als Wert. | `{}` |
| `model` | Nicht leere Modell-ID. | Die CLI entscheidet. Für OpenCode und custom nicht akzeptiert. |
| `effort` | Nicht leerer Effort, den CLI und Modell unterstützen. | Die CLI entscheidet. Für OpenCode und custom nicht akzeptiert. |
| `enabled` | Boolescher Wert für künftige Starts und Wiederherstellung. | `true` |
| `icon` | ID einer integrierten CLI oder unterstütztes Roboter-Icon. | Icon des Typs; bei custom `facade-pearl`. |

Um einen integrierten Eintrag zu konfigurieren, verwenden Sie die exakte ID in Kleinbuchstaben, etwa `codex`. Ein neuer Eintrag braucht einen Namen, der sich von allen integrierten IDs und Anzeigenamen unterscheidet, auch wenn die Großschreibung ignoriert wird. Verwenden Sie also `Codex · work` statt `Codex`. Hinzugefügte Einträge übernehmen keine Einstellungen des integrierten Eintrags ihres Typs.

`enabled: false` blendet einen gültigen Eintrag aus und verhindert künftige Starts und Wiederherstellungen. Ein bereits laufender Agent wird dadurch nicht beendet.

## Umgebungswerte

```json
{
  "clis": {
    "codex": {
      "env": {
        "WORK_API_KEY": "${env:WORK_API_KEY}",
        "OLD_TOKEN": null
      }
    }
  }
}
```

- Ein String setzt eine Variable. `null` entfernt sie. Eine ausgelassene Variable wird geerbt.
- `${env:NAME}` liest die Umgebung des Editor-Hosts. Ein anderer Schlüssel im selben Objekt wird nicht gelesen.
- Fehlt eine referenzierte Variable, ist dieser Eintrag nicht verfügbar. Referenzen werden in `env`-Werten einmal aufgelöst, nicht in `args`.
- Ein fester Wert bleibt in facade.json. Ein Verweis auf eine Umgebungsvariable hält den Wert aus der Datei heraus, die CLI erhält aber weiterhin den aufgelösten Wert.

Setzen Sie eine Variable in einem bereits geöffneten integrierten Terminal, ändert das die Umgebung des Editor-Hosts nicht. Stellen Sie sie bereit, bevor Sie den Editor starten.

## Vorrang und Startoptionen

Facade verwendet zuerst Modell und Effort, die für den neuen Agenten angegeben wurden, dann die Vorgaben des Eintrags. Liefert beides keinen Wert, entscheidet die CLI. OpenCode verwaltet Modell und Effort in seiner eigenen Konfiguration.

Für integrierte Typen verwenden Sie die eigenen Felder für Modell und Effort. Facade setzt außerdem Berechtigungen, Unterhaltungs-IDs, Arbeitsordner und seine eigenen Werkzeuge. Argumente, die diesen Vorgaben widersprechen oder eine interaktive Sitzung verhindern, lehnt es ab.

Facade sucht facade.json im Facade-Home: zuerst in der VS Code-Einstellung **Facade: Home**, falls gesetzt, dann in `FACADE_HOME`, dann in `~/.facade`. Rufen Sie im betreffenden Projekt Open Settings auf, um die aktive Datei zu finden.

## Datei- und Eintragsfehler

Ein Fehler auf Dateiebene, etwa ungültiges JSON, ein doppelter Schlüssel oder ein unbekanntes Feld auf oberster Ebene, blockiert neue Starts und Wiederherstellungen. Ein Fehler in einem CLI-Eintrag macht nur diesen Eintrag unverfügbar. Laufende Agenten laufen weiter.

Folgen Sie dem Einstellungspfad aus der Fehlermeldung und korrigieren Sie den Wert. Facade greift nicht stillschweigend auf alte Einstellungen zurück. Häufige Start- und Provider-Fehler behandelt die [Fehlerbehebung](https://facadecode.com/de/docs/troubleshooting/).