Kod Projenizi Yapay Zekaya İnceletmek: ZIP ile Yükleme Rehberi

Tek bir dosyayı kopyalayıp yapıştırmak kolay. Ama hata üç dosyaya yayılmışsa, ya da "bu projeyi baştan sona gözden geçir" demek istiyorsanız, dosyaları tek tek yapıştırmak hem yorucu hem de hataya açık. Çözüm basit: projeyi ZIP olarak sıkıştırıp yüklemek. Bu yazıda nasıl yapılacağını, nelerin okunup nelerin okunmadığını ve maliyeti nasıl düşük tutacağınızı anlatıyoruz.

Nasıl çalışıyor?

Mesaj kutusundaki ataç simgesinden ZIP dosyanızı seçtiğinizde arşiv tarayıcınızda açılır. İçindeki okunabilir dosyalar bir araya getirilir ve her birinin başına dosya yolu yazılır. Böylece yapay zeka hangi kodun hangi dosyada olduğunu bilir ve cevabında dosya adlarıyla konuşabilir.

ZIP arşivinin kendisi sunucumuza yüklenmez, mesajınızla birlikte yalnızca okunan metin gönderilir. Bu yüzden tek dosyalardaki 4 MB sınırı ZIP'e uygulanmaz. Yine de çok büyük arşivler tarayıcıyı yavaşlatabilir.

Hangi dosyalar okunur?

İçeriği metin olan her dosya: kaynak kodlar, yapılandırma dosyaları, loglar, Markdown belgeleri, Dockerfile ve Makefile gibi uzantısız dosyalar da dahil. Sistem uzantıya değil dosyanın içeriğine bakar. Eski Windows'ta kaydedilmiş Türkçe metinler de doğru karakterlerle okunur.

Hangi dosyalar otomatik atlanır?

• Bağımlılık ve derleme klasörleri: node_modules, .git, dist, build, .next, __pycache__, vendor. Bunlar hem devasa hem de sizin yazdığınız kod değil.
• Nokta ile başlayan dosyalar: .env, .gitignore gibi. Şifre ve API anahtarı içeren .env dosyalarının yanlışlıkla gönderilmesini de önler.
• Belgeler: PDF, Word, Excel ve PowerPoint dosyaları.
• Resimler, fontlar, ses/video dosyaları ve programlar.
• Çok büyük dosyalar: Tek dosya için 500 KB üstü atlanır. Toplam metin 500.000 karakteri aşarsa geri kalanı kesilir.

Hata alırsanız ne yapmalı?

ZIP açılamazsa ekranda neyin neden okunmadığını ve ne yapmanız gerektiğini gösteren bir mesaj çıkar. En sık durumlar:

• "İçinde okunabilir metin dosyası yok": ZIP'te sadece PDF, Word veya resim var demektir. PDF'leri ve resimleri ZIP'lemeden tek tek yükleyin, Word ve Excel dosyalarını önce PDF olarak kaydedin.
• RAR veya 7z dosyası: Bu formatlar desteklenmiyor. Dosyaları ZIP olarak yeniden sıkıştırın. Windows'ta sağ tık → "Sıkıştırılmış klasöre gönder" yeterli.
• Şifreli ZIP: Şifresiz olarak yeniden sıkıştırın.
• ZIP içinde ZIP: İçteki arşivi çıkarıp ayrıca yükleyin.

İyi bir inceleme isteği nasıl yazılır?

ZIP'i yükleyip sadece "bak" demek yerine görevi net tarif edin:

• "Bu projede giriş yaparken 'token geçersiz' hatası alıyorum. Hatanın kaynağını bul, hangi dosyanın kaçıncı satırı olduğunu söyle."
• "Güvenlik açısından incele: SQL enjeksiyonu, açıkta kalan anahtar, yetki kontrolü eksikliği var mı?"
• "Projenin yapısını bana 10 maddede özetle; yeni katılan bir geliştiriciye anlatır gibi."

Daha fazla örnek için yapay zeka ile kod yazma rehberimize bakabilirsiniz.

Maliyeti düşük tutmak

Yüklediğiniz kod, o sohbette gönderdiğiniz her mesajla birlikte yeniden okunur. Büyük bir projeyle on soru sorarsanız, projenin bedelini kabaca on kez ödersiniz. Bu yüzden:

• Sorularınızı mümkün olduğunca tek mesajda toplayın.
• Proje hakkındaki işiniz bitince yeni bir sohbet açın.
• İşe uygun model seçin. Kod incelemesi için Sonnet 5 veya GPT-5.6 Terra çoğu zaman yeterli; çok dosyalı büyük değişiklikler için Opus 5 gibi güçlü bir modele geçin. Detaylar model seçim rehberimizde.