Sorun giderme · Yuli Code

Bir şey çalışmadığında ne yapmalı: başlatma, dizinleme, yapay zekâ, Claude Code, Git, veritabanı ve build.

Her şeyden önce, her zaman işe yarayan iki araç:

Yardım → Hata günlüğü… IDE'nin son hatalarını gösterir.
Yardım → Sorun bildir… tanılama için gerekenleri kodunuz ve konuşmalarınız olmadan bir .zip içinde hazırlar. Özeti kopyala yapıştırmaya hazır metni verir.

Ajana «ne bozuk?» diye sorun. yuli_health ile sorunları, çalıştırmayı, testleri, terminalleri ve Yuli günlüklerini tek seferde inceler.

Kurulum ve başlatma

Belirti	Ne yapmalı
Windows yükleyiciyi çalıştırırken uyarı veriyor	Resmi kaynaktan indirdiğinizi ve sertifika yayıncısının «Yuli Code» olduğunu doğrulayın.
AppImage Linux'ta açılmıyor	`chmod +x` ile çalıştırma izni verin.
Taşınabilir sürüm ilk seferde gecikiyor	Bu normaldir: uygulamayı her sürüm için bir kez açar. Sonrasında anında başlar.
Arayüz başka bir dilde	Genel seçenekler → Görünüm → Dil. Bkz. Diller.
Başlatmanın neden geciktiğini ölçmek istiyorsunuz	Yardım → Başlangıç performansı….

Belirti	Ne yapmalı
Başvurular eksik veya gezinme tamamlanmamış	Dizinlemenin bitmesini bekleyin (düzenleyicinin üst çubuğu).
Lombok veya bağımlılıklar çözümlenmiyor	Proje kısıtlı modda olabilir. Genel seçenekler → Güvenlik → Güvenilen projeler → Güven.
«… için dil sunucusu yok» uyarısı	Yükle… düğmesine basın ve indirmeye izin verin.
Dizin güncel görünmüyor	Araçlar → Önbelleği temizle… dizinleri ve kayıtlı durumu siler; Yuli bunları yeniden üretir.
JDK, Maven veya Gradle eksik	Yuli indirmeyi önerir. Proje → Build, çalıştırma ve hata ayıklama… bölümünden yapılandırın.

Belirti	Ne yapmalı
Platform modunda kimlik doğrulama hatası	Model ayarlarında API anahtarını kontrol edin ve Bağlantıyı test et düğmesine basın.
Yerel bir model yanıt vermiyor	Sunucunun çalıştığını ve Sunucu URL'si değerinin doğru olduğunu doğrulayın.
Sağlayıcı çalışmıyor	Yuli sağlayıcının `retry-after` değerine uyar. Bekleyin veya sağlayıcı değiştirin.
Bir arka plan görevi durdu	Token veya maliyet sınırına ulaştı: Sınırı artır ve devam et.
Ajan ekibi duraklatıldı	Bütçesine ulaştı. Diğer eylemler → Ajan ekibi bölümünden artırın.

Belirti	Ne yapmalı
Yuli ajanı bulamıyor	Resmi yükleyicisiyle kurun ve Yeniden algıla düğmesine basın.
«Claude Code'un Yuli araçlarını kullanması bekleniyor»	`yuli` sunucusunu onaylayın veya Şimdi onayla düğmesine basın. `/mcp` ile kontrol edin.
`/mcp`, `yuli` için hata gösteriyor	Projeyi Yuli'de açın: araçlar yalnızca Yuli açıkken çalışır. `yuli_status` nedenini açıklar.
Kurallar değişmedi	Oturum başlarken yüklenir: oturumu ajan çubuğundan yeniden başlatın.
Codex bağdaştırıcının eksik olduğunu söylüyor	`codex-acp`'yi kurun: `npm install -g @openai/codex @agentclientprotocol/codex-acp`.
Kiro güncelleme istiyor	Yuli, Kiro CLI 1.28.2 veya üzerini gerektirir.
Yuli'nin hiçbir şeyi engellemesini istemiyorum	Kuralları uygula seçeneğini kapatın («Yalnızca uyar»). Git ve gizli bilgiler her zaman korunur.

Belirti	Neden	Ne yapmalı
Commit veya push yapmıyor	Git yalnızca açık bir istekle etkinleşir.	İngilizce veya İspanyolca isteyin: «commit and push». Her eylemi onaylayın.
Dal oluşturmuyor	Dallar kendi isteklerini gerektirir.	Dalı açıkça isteyin.
Bir dosyayı okumuyor	Bu bir gizli bilgi dosyası (`.env`, anahtarlar, kimlik bilgileri).	Bu kasıtlıdır. Bilgiyi gizli değer olmadan iletin.
Proje dışına yazamıyor	Sandbox onu projeyle sınırlar.	Proje → Klasör erişimi…
Veritabanında bir ifadeyi çalıştırmıyor	Bağlantının o sınıf için Süper yetkisi yok.	Bağlantının Ajan erişimi ayarını düzenleyin.
Test aşamasına geçmiyor	Ölçüm bekliyor veya tekrarlama istedi.	Kalite panelinin Ölçüm sekmesine bakın.
Turu bitirmiyor	Yeşil doğrulama eksik.	Çalıştırma, Testler veya Sorunlar'da neyin başarısız olduğuna bakın.

Belirti	Ne yapmalı
Bir işlem çok uzun sürüyor	Sınır aşıldığında Yeniden dene görünür.
Dahili bir sunucuda sertifika hatası	Sertifikasına güveni işaretleyin; Yuli kararı sunucu bazında hatırlar.
Gate yüzünden commit yapamıyorum	Başarısız olan denetimi okuyun (gizli bilgiler, test bütünlüğü, boyut, korunan yollar). Düzeltin veya süresi olan bir istisna isteyin.
Yuli hook'ları kurulmadı	`core.hooksPath` içinde zaten başka bir araç var (örneğin husky). Yuli onun yerini almaz.

Belirti	Ne yapmalı
«Oracle'a bağlanmak için Oracle Instant Client gerekir»	Instant Client 19c veya üzerini kurun ve `PATH`'e ekleyin.
Sertifika hatası	Bağlantıda Sertifikaya güven seçeneğini işaretleyin.
Ajan bir bağlantıyı görmüyor	Erişimi Erişim yok olarak ayarlı.
Ajanın bir sorgusu kesildi	45 saniyeyi aştı veya planı çok büyük bir tarama öngörüyor. Sorguyu daraltın.

Belirti	Ne yapmalı
«Docker kullanılamıyor.»	Docker'ı başlatın ve Yeniden dene düğmesine basın.
«kubectl yapılandırılmamış»	`kubectl`'i kurun ve bir bağlam (kubeconfig) yapılandırın.