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
- Claude'un değişikliklerini
/diffile nasıl okuyacağını ve nelere dikkat edeceğini /code-reviewile temiz bir bağlamda ikinci görüş nasıl alınır- Gelen bulguları nasıl sınıflayacağını ve düzeltme isterken kanıtı nasıl isteyeceğini
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
- Gerçek değişikliği aç. Claude Code'da
/diffyaz. 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,Enterile bir dosyayı aç. - Üç ş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.
- Tamamı yanlışsa geri al.
/rewindyaz (ya da boş istemdeEsc'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). - İkinci görüş iste.
/code-reviewyaz. 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. - 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).
- 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.
- "Nedenini sor" için bulguyu geri oku. Bulguyu aynen yaz ve Claude'dan yeniden kontrol etmesini iste (aşağıdaki hazır prompt).
- Düzeltme isterken kanıt da iste. Düzeltmeyi istedikten sonra testleri çalıştırmasını ve çıktıyı göstermesini söyle.
- 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
- Yalnız Claude'un özetine güvenmek. Kursun alıştırması şunu gösteriyor: özetteki her cümle doğru olabilir, yine de özet, dikkat edilmesi gereken değişiklikleri anlatmayabilir. Dosya farklarını kendin aç.
- Her bulguyu körü körüne düzeltmek. Doküman, eksik arayan bir inceleyicinin sağlam işte bile genellikle bir şey bulacağını, her bulguyu kovalamanın gereksiz soyutlama ve savunma kodu gibi aşırı mühendisliğe götürdüğünü söylüyor. İnceleyiciye yalnız doğruluğu ve belirtilen gereksinimleri etkileyen eksikleri raporlamasını söyle, kalanı isteğe bağlı say.
- Bulgu çıkmadı diye rahatlamak. Doküman, bulgusuz incelemenin kodun hatasız ya da güvenli olduğu anlamına gelmediğini yazıyor.
- Testleri atlamak. Düzeltme kabul ederken "testler geçti" cümlesine değil, komutun kendisine ve çıktısına bak.
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
- Anthropic Academy, Claude Code 101: Code review (
/diff, dikkat edilecek üç şey,/rewind,/code-review, üç yığın, kanıt isteme, ne zaman daha yakından incelenir) - Claude Code dokümanı: Review locally with /code-review (hedef örnekleri,
--fix,--comment,/reviewtakma adı, arka plan alt ajanı, rewind sınırı) - Claude Code dokümanı: Code Review (GitHub hizmeti, plan koşulu, onaylamaz ya da engellemez, hata kaçırabilir)
- Claude Code dokümanı: Best practices (taze bağlamda karşıt inceleme, aşırı mühendislik uyarısı, plana karşı inceleme istemi)
- Claude Code dokümanı: Commands (
/diff,/code-review,/review) - Claude Code dokümanı: Interactive mode (
/diffile değişiklikleri gözden geçirmek)
Son doğrulama: 2026-10-21