# Rozwiązywanie problemów

Ustal, czy problem wynika z konfiguracji uruchamiania, z CLI czy z dostawcy modeli.

## Sprawdź konfigurację uruchamiania

Uruchom polecenie **Show Agent Launch** z palety poleceń i wybierz folder roboczy. Raport pokazuje, jak każde CLI uruchomiłoby się teraz w tym miejscu: plik wykonywalny, katalog, argumenty i nazwy zmiennych środowiskowych. Wartości prywatne są ukryte.

Raport opisuje następne uruchomienie z bieżącymi ustawieniami. Nie opisuje agenta, który już działa. Jeśli żądanie się powiedzie, statystyki użycia dostawcy mogą potwierdzić, które konto je obsłużyło.

## Znajdź swój problem

| Problem | Co sprawdzić |
| --- | --- |
| Nie możesz znaleźć pliku ustawień | Wybierz Open Settings, a następnie Edit in facade.json w sekcji Facade: Home. Jeśli zdalne okno otwiera ustawienia jako JSON, polecenie otwiera facade.json bezpośrednio. |
| Wpis nie pojawia się w New Agent | Sprawdź nazwę wpisu i jego pole `type` oraz upewnij się, że nie jest wyłączony przez `enabled: false`. Nieprawidłowe wpisy są widoczne w sekcji Unavailable wraz z przyczyną. |
| Nie można znaleźć pliku wykonywalnego | Zainstaluj CLI tam, gdzie działa projekt, albo podaj pełną ścieżkę w polu `command`. W przypadku OpenCode użyj wersji 2 (`@opencode/cli`). |
| Brakuje zmiennej wskazanej w odwołaniu środowiskowym | Host edytora musi mieć tę zmienną przed uruchomieniem agenta. Wyeksportowanie jej w otwartym terminalu nie zmienia środowiska hosta. |
| Argument koliduje z opcją kontrolowaną przez Facade | Usuń tę opcję z pola `args`. Zamiast tego użyj pola `model`, `effort` lub `yolo` na najwyższym poziomie. |
| Uwierzytelnianie kończy się niepowodzeniem lub model jest niedostępny | Sprawdź u dostawcy klucz, endpoint, region, identyfikator modelu i dostęp do konta. |
| Dostawca Codex nie odpowiada | Upewnij się, że jego endpoint obsługuje Responses API. |
| Agent nie widzi innego agenta | Sprawdź, czy ich projekty są połączone przez ten sam katalog Facade i czy ustawienia dostępu pozwalają na komunikację. |
| Własny program nie otrzymuje wiadomości | Wpisuj polecenia w jego terminalu. Wpisy custom nie otrzymują komunikacji ani narzędzi Facade. |
| Zapisane ustawienia nie zmieniły działającego agenta | Uruchom nowego agenta. Aby zachować rozmowę, zakończ agenta, a następnie uruchom go ponownie poleceniem Resume Agent z nowymi ustawieniami. |

Konfigurację SSH opisuje artykuł [Uruchamiaj agentów na zdalnej maszynie](https://facadecode.com/pl/docs/remote-ssh/), a błędy połączenia z telefonem — [Kontynuuj z telefonu](https://facadecode.com/pl/docs/remote-control/).

## Zgłoś problem

Podaj, co próbowałeś zrobić, dokładny komunikat błędu, system operacyjny, wersje edytora i rozszerzenia, wersję CLI oraz wybrany wpis. Jeśli to możliwe, dołącz odpowiednie ustawienia z usuniętymi kluczami i wartościami prywatnymi.

[Otwórz zgłoszenie w GitHubie ↗](https://github.com/y5ez3g/facadecode/issues)