# Pengaturan agen

Pilih CLI yang muncul di New Agent, ubah default-nya, dan tambahkan setelan peluncuran Anda sendiri.

## 1. Buka facade.json

- Buka menu **…** di panel Facade lalu pilih **Open Settings**. Perintah ini juga bisa dijalankan dari Command Palette.
- Di bagian **Facade: Home**, pilih **Edit in facade.json**. Jika jendela remote membuka Settings sebagai JSON, perintah itu langsung membuka facade.json.
- Edit berkasnya lalu simpan. Facade menerima komentar JSON dan koma di akhir.

Lokasi default: `~/.facade/facade.json`. Jika berkasnya belum ada, Facade membuatnya lengkap dengan komentar, entri CLI bawaan, dan contoh untuk diadaptasi. Facade tidak menulis ulang berkas yang sudah ada.

## 2. Ubah satu nilai default

Misalnya, setelan berikut menjadikan effort default Codex `high` dan menghapus Pi dari New Agent. Tambahkan field ini ke berkas Anda, sambil mempertahankan entri lain yang Anda pakai:

```json
{
  "clis": {
    "codex": {
      "effort": "high"
    },
    "pi": {
      "enabled": false
    }
  }
}
```

Simpan, lalu mulai agen baru. Agen yang sedang berjalan mempertahankan setelan peluncurannya; agen yang dilanjutkan dan disematkan memakai berkas saat ini ketika berikutnya dimulai.

## 3. Tambahkan penyiapan lain

Gunakan ID bawaan seperti `codex` untuk mengubah default CLI tersebut, atau nama baru untuk menambahkan penyiapan terpisah:

```json
{
  "clis": {
    "Codex · review": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "effort": "high"
    }
  }
}
```

Ganti `YOUR_MODEL_ID` dengan model yang didukung penyiapan Codex Anda. Simpan, lalu pilih `Codex · review` di New Agent untuk memakainya. Field `type` mempertahankan integrasi Codex dengan Facade, sedangkan namanya yang membedakan penyiapan ini.

Entri baru tidak mewarisi pengaturan dari `codex`. Tambahkan argumen, variabel lingkungan, atau path executable sendiri sesuai kebutuhan. Untuk menghubungkan API lain, ikuti panduan [Claude Code](https://facadecode.com/id/docs/providers/claude-code/) atau [Codex](https://facadecode.com/id/docs/providers/codex/). Lihat [Nama dan ikon](https://facadecode.com/id/docs/appearance/) untuk mengubah tampilannya.

## Gunakan pengaturan untuk mesin yang tepat

Proyek lokal yang memakai home Facade sama akan berbagi pengaturannya. Proyek SSH, WSL, dan container membaca berkas di lingkungan eksekusinya masing-masing. Jalankan Open Settings dari proyek yang ingin Anda konfigurasi.

Pengaturan **Facade: Home** di VS Code Settings menentukan folder yang berisi `facade.json`. Nilai eksplisit mengalahkan `FACADE_HOME`; jika variabel itu tidak diatur, `~/.facade` yang dipakai. Setelah mengubah home, terima prompt Facade untuk memuat ulang jendela.

Gunakan **Edit in facade.json** untuk membuka berkas yang aktif. Untuk definisi field dan nilai default-nya, lihat [referensi konfigurasi](https://facadecode.com/id/docs/reference/).