Anla Dene

Claude · Gelişmiş · 201 Claude Code temeli · Konu 9 / 10

3.9 Kod incelemesi

Yazan oturum, kendi işinin en iyi hakemi değildir.

Bu sayfada ne öğreneceksin

Kısaca

Claude Code bir işi bitirince genellikle kısa bir özet verir. Özetin altında küçük ya da büyük pek çok dosya değişmiş olabilir. Kursa göre değişikliği yazan ve açıklayan oturum, o değişikliğin en kaliteli hakemi değildir. İyi alışkanlık iki aşamalıdır: önce her değişikliğe kendin bak, sonra Claude'a bu kez geçmiş oturum olmadan, temiz bir bağlamdan yeniden incelet.

Bu inceleme tek başına yeterli değildir. Claude Code dokümanı yapay zekâ incelemesinin hata, güvenlik açığı ya da başka sorunları kaçırabileceğini yazıyor; bulgu çıkmaması kodun hatasız ya da güvenli olduğu anlamına gelmez.

Adım adım

  1. Gerçek değişikliği aç. Claude Code'da /diff yaz. Kurs bunu, commit edilmemiş değişikliklerin önce/sonra görünümünü açan etkileşimli bir görüntüleyici olarak tanımlıyor; Claude'un her turda neyi değiştirdiğini de gösterebiliyor. Yukarı ve aşağı oklarla dosyalar arasında gez, Enter ile bir dosyayı aç.
  2. Üç şeye bak. Kursa göre her seferinde ikinci kez bakmaya değer olanlar: (a) istemediğin değişiklikler, yani Claude dosyadayken değişen bir ayar ya da değinmediğin yeniden yazılmış bir yardımcı fonksiyon; (b) zayıflayan testler, yani atlanmış, silinmiş ya da geçsin diye gevşetilmiş testler; (c) yeni paketler ve koda gömülmüş değerler, yani tek fonksiyon için eklenmiş bir bağımlılık ya da doğrudan koda yazılmış bir adres ya da anahtar.
  3. Tamamı yanlışsa geri al. /rewind yaz (ya da boş istemde Esc'e iki kez bas), o değişikliği üreten istemi seç ve Restore code and conversation seçeneğini seç. Bir sınır var: Claude'un çalıştırdığı kabuk komutlarının değiştirdiği dosyalar, örneğin bir paket kurulumu, geri alınmaz (bkz. 3.10).
  4. İkinci görüş iste. /code-review yaz. Bu komut değişikliği temiz bir bağlamda, bu oturumun geçmişi olmadan inceler ve bulduklarını bildirir. Sen istemedikçe hiçbir şeyi düzenlemez. İnceleme arka planda çalışır, bulgular bitince konuşmana düşer. Düz Türkçe ile istersen de Claude aynı incelemeyi başlatabilir; başlatmazsa komutu kendin çalıştır.
  5. Neyin incelendiğini seç. Hedef yazmazsan inceleme, bulunduğun daldaki commit'leri ve commit edilmemiş değişiklikleri kapsar. Bir dalı, bir dosya yolunu ya da bir pull request numarasını (PR) de hedef verebilirsin (örnekler aşağıda).
  6. Her bulguyu üç yığından birine koy. Hemen düzelt: gerçek ve önemli sorun. Nedenini sor: doğrulayamadığın ya da yanlış görünen bulgu; soğuk okuyan bir inceleyici de bir şeyi kaçırabilir. Bırak: gerçek ama küçük ve önemsiz sorun; bunları toplayıp başka bir oturumda tek seferde düzeltebilirsin.
  7. "Nedenini sor" için bulguyu geri oku. Bulguyu aynen yaz ve Claude'dan yeniden kontrol etmesini iste (aşağıdaki hazır prompt).
  8. Düzeltme isterken kanıt da iste. Düzeltmeyi istedikten sonra testleri çalıştırmasını ve çıktıyı göstermesini söyle.
  9. Büyürse tekrar incele. Düzeltme kendi başına büyük bir değişikliğe dönüşürse incelemeyi yeniden çalıştır.

Claude Code içinde yazılan komutlar:

/diff
/code-review

Dokümandaki hedef örneklerinden bazıları (aynı komutun sonuna yazılır):

/code-review main...my-feature
/code-review src/auth
/code-review 1234

Dokümana göre /review, /code-review komutunun takma adıdır. --fix bayrağı bulguları çalışma ağacına uygulatır; düzenlemeler izin modundan geçer. --comment bulguları GitHub pull request'ine satır içi yorum olarak yazar. Güvenlik notu: --fix ile arka planda çalışan bir inceleme dosyaları kontrol noktalarının dışında değiştirebilir, bu yüzden /rewind hepsini geri almayabilir; git kullan. Kurs, incelemenin diğer görevler gibi kullanımına sayıldığını söylüyor; bu yüzden ikinci göz gerektiren değişiklikler için sakla.

Ne zaman daha yakından incele

Tek satırlık basit bir değişiklik çoğu zaman /diff'e hızlıca bakmaktan fazlasını istemez. Kursa göre hem kendin hem Claude ile incelemeyi şu durumlarda yap: değişiklik aklında tutabileceğinden büyükse, hassas bir şeye dokunuyorsa ya da yıkıcı bir şey yapıyorsa, ve işi bir takım arkadaşına devretmeden önce.

Hazır prompt

Yeni yazılan değişikliği, düzeltmeden önce yalnız raporlatmak için:

Az önce yaptığın değişiklikleri incele. Sorunları raporla; henüz hiçbir şeyi düzeltme.

Bir bulgudan şüphelendiğinde:

Şunu raporladın: "[bulguyu aynen buraya yapıştır]". Ama [dosya ve satır] satırında [gördüğün şey] var. Tekrar kontrol et ve bulgunun geçerli olup olmadığını söyle.

Düzeltme isterken kanıtla birlikte:

Şu bulguyu düzelt: [bulgu]. Sonra testleri çalıştır ve çıktısını bana göster.

Değişikliği plana karşı kontrol ettirmek için (alt ajanla, dokümandaki örneğe dayanır):

Bir alt ajan kullanarak [değişiklik] farkını (diff) [PLAN.md] ile karşılaştır. Her gereksinimin uygulanıp uygulanmadığına, listelenen uç durumların testi olup olmadığına ve görev kapsamı dışında bir şeyin değişip değişmediğine bak. Üslup tercihlerini değil, eksikleri raporla.

Sık yapılan hata

GitHub'da otomatik inceleme

Aynı işi pull request'ler için GitHub'da otomatik yapan ayrı bir hizmet var: Code Review. Dokümana göre bu hizmet Team ve Enterprise planları içindir, kurumunun Owner'ı açar, bulguları satır içi yorum olarak yazar ve pull request'i asla onaylamaz ya da engellemez; birleştirme kararı ekibinde kalır. /code-review ise bu hizmet olmadan, herhangi bir planda, kendi oturumunda çalışır.

Video

Video: yakında.

Kaynak

Son doğrulama: 2026-10-21

Anla Dene bağımsız bir eğitim sitesidir; Anthropic, OpenAI ya da Google ile bağlantılı değildir. Ürün adları sahiplerine aittir.

anladene.com · Anla Dene Akademi · Gizlilik