# Dokumentacja referencyjna konfiguracji

Sprawdź pola pliku facade.json, ich wartości domyślne i sposób, w jaki Facade je stosuje.

## Pola najwyższego poziomu

Plik otwórz zgodnie z opisem w artykule [Ustawienia agentów](https://facadecode.com/pl/docs/settings/). Akceptuje komentarze w JSON i przecinki na końcu. Pusty obiekt oznacza użycie wartości domyślnych.

| Pole | Wartość | Wartość domyślna |
| --- | --- | --- |
| `yolo` | Wartość logiczna kontrolująca zatwierdzenia CLI i dostęp agentów. | `true` |
| `names` | Lista niepustych proponowanych nazw agentów. | Wbudowana lista nazw |
| `clis` | Obiekt z nadpisaniami wbudowanych CLI i dodatkowymi nazwanymi wpisami. | `{}`; wbudowane CLI pozostają dostępne |
| `$schema` | Ciąg z metadanymi schematu dla edytora. | Pomijane |

## Pola wpisu CLI

| Pole | Wartość | Wartość domyślna |
| --- | --- | --- |
| `type` | `claude`, `codex`, `agy`, `muse`, `opencode`, `pi` lub `custom`. | Niejawne dla dokładnych identyfikatorów wbudowanych; wymagane w dodanych wpisach. |
| `command` | Jedna nazwa lub ścieżka pliku wykonywalnego. | Polecenie typu w PATH; wymagane dla custom. |
| `args` | Tablica dosłownych ciągów argumentów. | `[]` |
| `env` | Nazwy zmiennych przypisane do ciągów znaków lub wartości null. | `{}` |
| `model` | Niepusty identyfikator modelu. | Decyduje CLI. Nieprzyjmowane dla OpenCode i custom. |
| `effort` | Niepusty effort obsługiwany przez CLI i model. | Decyduje CLI. Nieprzyjmowane dla OpenCode i custom. |
| `enabled` | Wartość logiczna kontrolująca przyszłe uruchomienia i przywracanie. | `true` |
| `icon` | Identyfikator wbudowanego CLI lub obsługiwana ikona robota. | Ikona typu; `facade-pearl` dla custom. |

Aby skonfigurować wbudowany wpis, użyj dokładnego identyfikatora pisanego małymi literami, np. `codex`. Nazwa nowego wpisu musi różnić się od wszystkich wbudowanych identyfikatorów i nazw wyświetlanych także przy porównaniu bez uwzględniania wielkości liter. Zamiast `Codex` użyj na przykład `Codex · work`. Dodane wpisy nie dziedziczą ustawień od wbudowanego wpisu swojego typu.

`enabled: false` ukrywa prawidłowy wpis i blokuje przyszłe uruchomienia oraz przywracanie. Nie zatrzymuje agenta, który już działa.

## Wartości środowiskowe

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

- Ciąg znaków ustawia zmienną. Wartość `null` usuwa ją. Pominięta zmienna jest dziedziczona.
- `${env:NAME}` odczytuje środowisko hosta edytora. Nie odczytuje innego klucza z tego samego obiektu.
- Brak zmiennej wskazanej w odwołaniu powoduje, że wpis staje się niedostępny. Odwołania są rozwijane jednokrotnie w wartościach `env`, a nie w `args`.
- Wartość dosłowna pozostaje w pliku facade.json. Odwołanie do zmiennej środowiskowej pozwala trzymać tę wartość poza plikiem, ale CLI i tak otrzymuje rozwiniętą wartość.

Ustawienie zmiennej w już otwartym zintegrowanym terminalu nie zmienia środowiska hosta edytora. Udostępnij ją przed uruchomieniem edytora.

## Kolejność pierwszeństwa i opcje uruchamiania

Facade najpierw używa modelu i effortu podanych dla nowego agenta, a potem wartości domyślnych wpisu. Jeśli wartości nie podano w żadnym z tych miejsc, decyduje CLI. OpenCode przechowuje oba wybory we własnej konfiguracji.

W przypadku typów wbudowanych używaj dedykowanych pól model i effort. Facade ustawia też uprawnienia, identyfikatory rozmów, foldery robocze i własne narzędzia. Odrzuca argumenty, które kolidują z tymi wyborami lub uniemożliwiają uruchomienie sesji interaktywnej.

Facade szuka pliku facade.json w katalogu Facade: najpierw w ustawieniu VS Code **Facade: Home**, potem w zmiennej `FACADE_HOME`, a na końcu w `~/.facade`. Uruchom polecenie Open Settings w danym projekcie, aby znaleźć jego aktywny plik.

## Błędy pliku i błędy wpisów

Błąd na poziomie pliku, np. nieprawidłowy JSON, zduplikowany klucz lub nieznane pole najwyższego poziomu, blokuje nowe uruchomienia i przywracanie. Błąd w jednym wpisie CLI powoduje, że niedostępny jest tylko ten wpis. Działający agenci nadal działają.

Odszukaj ustawienie wskazane w komunikacie błędu i popraw jego wartość. Facade nie podstawia po cichu starych ustawień. Typowe błędy uruchamiania i błędy dostawców opisuje artykuł [Rozwiązywanie problemów](https://facadecode.com/pl/docs/troubleshooting/).