# Yapılandırma başvurusu

facade.json dosyasındaki alanlara, varsayılanlarına ve Facade'ın bunları nasıl uyguladığına bakın.

## Üst düzey alanlar

Dosyayı [Aracı ayarları](https://facadecode.com/tr/docs/settings/) üzerinden açın. JSON yorumlarını ve sondaki virgülleri kabul eder. Boş bir nesne varsayılanları kullanır.

| Alan | Değer | Varsayılan |
| --- | --- | --- |
| `yolo` | CLI onaylarını ve aracı erişimini kontrol eden boolean değeri. | `true` |
| `names` | Boş olmayan adlardan oluşan önerilen aracı adları listesi. | Yerleşik ad listesi |
| `clis` | Yerleşik CLI ayarlarını değiştiren değerleri ve ek adlandırılmış kayıtları içeren nesne. | `{}`; yerleşik CLI'lar kullanılabilir kalır |
| `$schema` | Düzenleyici şema üst verisi için dize. | Atlanır |

## CLI kaydı alanları

| Alan | Değer | Varsayılan |
| --- | --- | --- |
| `type` | `claude`, `codex`, `agy`, `muse`, `opencode`, `pi` veya `custom`. | Tam yerleşik kimliklerde örtüktür; eklenen kayıtlarda zorunludur. |
| `command` | Tek bir çalıştırılabilir dosya adı veya yolu. | Türün PATH'teki komutu; custom için zorunludur. |
| `args` | Dize dizisi; argümanlar olduğu gibi iletilir. | `[]` |
| `env` | Dizelere veya null değerine eşlenen değişken adları. | `{}` |
| `model` | Boş olmayan model kimliği. | CLI karar verir. OpenCode veya custom için kabul edilmez. |
| `effort` | CLI ve modelin desteklediği boş olmayan efor. | CLI karar verir. OpenCode veya custom için kabul edilmez. |
| `enabled` | Gelecekteki başlatmaları ve geri yüklemeyi kontrol eden boolean değeri. | `true` |
| `icon` | Yerleşik CLI kimliği veya desteklenen robot simgesi. | Türün simgesi; custom için `facade-pearl`. |

Yerleşik bir kaydı yapılandırmak için tam küçük harfli kimliği kullanın, örneğin `codex`. Yeni bir kayıt, büyük/küçük harf farkı göz ardı edilse bile her yerleşik kimlikten ve görünen addan farklı bir ada sahip olmalıdır. Örneğin `Codex` yerine `Codex · work` kullanın. Eklenen kayıtlar türlerinin yerleşik kaydından ayar devralmaz.

`enabled: false` geçerli bir kaydı gizler ve gelecekteki başlatmaları ve geri yüklemeyi engeller. Çalışan bir aracıyı durdurmaz.

## Ortam değerleri

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

- Bir dize değişkeni ayarlar. `null` değişkeni kaldırır. Atlanan değişken devralınır.
- `${env:NAME}` düzenleyicinin ortamını okur. Aynı nesnedeki başka bir anahtarı okumaz.
- Eksik bir başvuru o kaydı kullanılamaz hale getirir. Başvurular `env` değerlerinde bir kez genişletilir, `args` içinde genişletilmez.
- Doğrudan yazılan bir değer facade.json dosyasında kalır. Bir ortam başvurusu bu değeri dosyanın dışında tutar, ancak CLI genişletilmiş değeri yine alır.

Zaten açık olan tümleşik bir terminalde değişken ayarlamak, düzenleyicinin ortamını güncellemez. Değişkeni düzenleyiciyi başlatmadan önce kullanılabilir hale getirin.

## Öncelik ve başlatma seçenekleri

Facade önce yeni aracı için belirtilen modeli ve eforu, ardından kaydın varsayılanlarını kullanır. İkisi de değer sağlamazsa CLI karar verir. OpenCode bu iki seçimi kendi yapılandırmasında tutar.

Yerleşik türler için model ve efor alanlarını kullanın. Facade ayrıca izinleri, konuşma kimliklerini, çalışma klasörlerini ve kendi araçlarını ayarlar. Bu seçimlerle çakışan veya etkileşimli bir oturumun başlamasını engelleyen argümanları reddeder.

Facade, facade.json dosyasını Facade ana dizininde arar: varsa **Facade: Home** VS Code ayarı, ardından `FACADE_HOME`, ardından `~/.facade`. Etkin dosyayı bulmak için Open Settings komutunu projeden çalıştırın.

## Dosya hataları ve kayıt hataları

Geçersiz JSON, yinelenen anahtar veya bilinmeyen üst düzey alan gibi dosya düzeyinde bir hata yeni başlatmaları ve geri yüklemeyi engeller. Bir CLI kaydının içindeki hata yalnızca o kaydı kullanılamaz hale getirir. Çalışan aracılar çalışmaya devam eder.

Hatanın ayar yolunu izleyin ve o değeri düzeltin. Facade eski ayarları sessizce kullanmaz. Yaygın başlatma ve sağlayıcı hataları için [Sorun giderme](https://facadecode.com/tr/docs/troubleshooting/) bölümüne bakın.