# Pemecahan masalah

Cari tahu apakah masalahnya berasal dari setelan peluncuran, CLI, atau penyedia modelnya.

## Periksa peluncuran yang diminta

Jalankan **Show Agent Launch** dari Command Palette lalu pilih lokasi kerjanya. Laporan itu menunjukkan bagaimana setiap CLI akan dimulai di sana saat ini: executable, direktori, argumen, dan nama variabel lingkungan. Nilai rahasia disembunyikan.

Laporan itu menjelaskan peluncuran berikutnya dengan pengaturan Anda saat ini. Laporan itu tidak menggambarkan agen yang sudah berjalan. Jika sebuah permintaan berhasil, catatan penggunaan penyedia bisa membantu memastikan akun mana yang menanganinya.

## Temukan gejalanya

| Masalah | Yang perlu diperiksa |
| --- | --- |
| Anda tidak menemukan berkas pengaturannya | Pilih Open Settings, lalu Edit in facade.json di bagian Facade: Home. Jika jendela remote membuka Settings sebagai JSON, perintah itu langsung membuka facade.json. |
| Ada entri yang tidak muncul di New Agent | Periksa nama dan `type` entri tersebut, dan pastikan entri itu tidak dinonaktifkan dengan `enabled: false`. Entri yang tidak valid muncul di bagian Unavailable beserta alasannya. |
| Executable tidak ditemukan | Pasang CLI di tempat proyek berjalan, atau setel path lengkapnya di `command`. Untuk OpenCode, gunakan versi 2 (`@opencode/cli`). |
| Referensi lingkungan tidak ditemukan | Host editor harus memiliki variabel itu sebelum agen dimulai. Mengekspornya di terminal yang sudah terbuka tidak memperbarui host. |
| Ada argumen yang bertentangan dengan opsi yang dikelola Facade | Hapus opsi itu dari `args`. Gunakan field `model` atau `effort` pada entri CLI, atau `yolo` di tingkat atas. |
| Autentikasi gagal atau model tidak tersedia | Periksa kunci, endpoint, region, ID model, dan akses akun dari penyedia Anda. |
| Penyedia Codex tidak merespons | Pastikan endpoint-nya mendukung Responses API. |
| Agen tidak dapat menemukan agen lain | Pastikan proyek mereka terhubung lewat home Facade yang sama dan pengaturan aksesnya mengizinkan komunikasi. |
| Program custom tidak menerima pesan | Ketik di terminalnya. Entri custom tidak menerima pesan atau alat Facade. |
| Pengaturan yang disimpan belum mengubah agen yang sedang berjalan | Mulai agen baru. Untuk mempertahankan percakapannya, akhiri agennya, lalu jalankan Resume Agent untuk memulainya kembali dengan pengaturan baru. |

Untuk penyiapan SSH, lihat [Jalankan agen di mesin jarak jauh](https://facadecode.com/id/docs/remote-ssh/). Untuk kesalahan koneksi ponsel, lihat [Lanjutkan dari ponsel](https://facadecode.com/id/docs/remote-control/).

## Laporkan masalah

Sertakan apa yang sudah Anda coba, kesalahan persisnya, sistem operasi, versi editor dan ekstensi, versi CLI, dan entri yang dipilih. Jika memungkinkan, sertakan pengaturan yang relevan tanpa kunci dan nilai rahasia.

[Buka issue di GitHub ↗](https://github.com/y5ez3g/facadecode/issues)