# Sorun giderme

Bir sorunun başlatma kurulumundan mı, CLI'dan mı yoksa model sağlayıcısından mı kaynaklandığını öğrenin.

## İstenen başlatmayı kontrol edin

**Show Agent Launch** komutunu Komut Paleti'nden çalıştırın ve çalışma konumunu seçin. Rapor, her CLI'nın orada şu anda nasıl başlayacağını gösterir: çalıştırılabilir dosya, dizin, argümanlar ve ortam değişkeni adları. Özel değerler gizlenir.

Rapor, mevcut ayarlarınızla bir sonraki başlatmayı açıklar. Zaten çalışan bir aracıyı açıklamaz. Bir istek başarılı olursa sağlayıcı kullanım kayıtları, hangi hesabın isteği işlediğini doğrulamaya yardımcı olabilir.

## Belirtiyi bulun

| Sorun | Neye bakmalısınız |
| --- | --- |
| Ayar dosyasını bulamıyorsunuz | Open Settings komutunu çalıştırın, ardından Facade: Home altındaki Edit in facade.json seçeneğini belirleyin. Uzak pencere Ayarlar'ı JSON olarak açıyorsa komut doğrudan facade.json dosyasını açar. |
| New Agent listesinde bir kayıt yok | Kaydın adını ve `type` alanını kontrol edin; `enabled: false` ile devre dışı bırakılmadığından emin olun. Geçersiz kayıtlar, geçersizlik nedeni belirtilerek Unavailable altında görünür. |
| Çalıştırılabilir dosya bulunamıyor | CLI'yı projenin çalıştığı makineye yükleyin veya `command` alanında tam yolunu belirtin. OpenCode için 2. sürümü (`@opencode/cli`) kullanın. |
| Bir ortam başvurusu eksik | Bu değişken, aracı başlamadan önce düzenleyicinin ortamında tanımlı olmalıdır. Değişkeni açık bir terminalde dışa aktarmak düzenleyicinin ortamını güncellemez. |
| Bir argüman Facade'ın kontrol ettiği bir seçenekle çakışıyor | Seçeneği `args` içinden kaldırın. Bunun yerine `model`, `effort` veya üst düzey `yolo` alanını kullanın. |
| Kimlik doğrulama başarısız oluyor veya bir model kullanılamıyor | Sağlayıcının anahtarını, uç noktasını, bölgesini, model kimliğini ve hesap erişimini kontrol edin. |
| Bir Codex sağlayıcısı yanıt vermiyor | Uç noktasının Responses API'sini desteklediğini doğrulayın. |
| Bir aracı başka bir aracıyı bulamıyor | Projelerinin aynı Facade ana dizini üzerinden bağlı olduğunu ve erişim ayarlarının iletişime izin verdiğini kontrol edin. |
| Özel bir program hiç mesaj almıyor | Terminaline yazın. Özel kayıtlar Facade mesajlaşmasını veya araçlarını almaz. |
| Kaydedilen ayarlar çalışan bir aracıyı değiştirmedi | Yeni bir aracı başlatın. Konuşmayı korumak için aracıyı sonlandırın, ardından yeni ayarlarla yeniden başlatmak için Resume Agent komutunu kullanın. |

SSH kurulumu için [Aracıları uzak bir makinede çalıştırın](https://facadecode.com/tr/docs/remote-ssh/) bölümüne bakın. Telefon bağlantısı hataları için [Telefonunuzdan devam edin](https://facadecode.com/tr/docs/remote-control/) bölümüne bakın.

## Bir sorun bildirin

Neler denediğinizi, tam hata mesajını, işletim sisteminizi, düzenleyici ve uzantı sürümlerinizi, CLI sürümünüzü ve seçili kaydı ekleyin. Mümkünse ilgili ayarları anahtarlar ve özel değerler çıkarılmış olarak ekleyin.

[GitHub'da bir sorun açın ↗](https://github.com/y5ez3g/facadecode/issues)