Code Review

Code Review, GitHub pull request'lerindeki değişiklikleri Claude'un incelemesini sağlayan yönetilen bir hizmettir. Her değişikliği çevresindeki kodla birlikte okuyan birden fazla agent, mantık hataları, güvenlik açıkları veya bozuk edge case'ler gibi sorunları arar. Bulgular raporlanmadan önce bir doğrulama adımından geçer. Sonuçlar ilgili satırlara inline yorum olarak, önem derecesine göre sıralanmış şekilde, bir özet ve pull request üzerinde bir check run ile birlikte gelir. Bir inceleme pull request'i hiçbir zaman onaylamaz veya engellemez; merge kararı ekibinizde kalır.

Not: Code Review kodu incelemek için AI kullanır ve hataları, güvenlik açıklarını veya diğer sorunları kaçırabilir. Bulgu çıkmayan bir inceleme, kodunuzun hatasız veya güvenli olduğu anlamına gelmez.

Code Review'u açmak için Claude organizasyonunuzun bir Owner'ı "Set up Code Review" adımlarını izler. Claude bu hizmet olmadan da kodu inceleyebilir: herhangi bir planda Claude Code oturumunuzda /code-review çalıştırabilir veya tüm seçenekleri karşılaştırabilirsiniz.

Kullanılabilirlik (Availability)

Code Review'u kurmadan önce organizasyonunuzun uygun olduğunu doğrulayın:

• Planlar: Team ve Enterprise
• Kod barındırıcıları: GitHub üzerinde barındırılan depolar; buna GitHub Enterprise Server ve data residency'li GitHub Enterprise Cloud dahildir. Data residency için bir Owner'ın GitHub Enterprise Server admin kurulumunu izlemesi ve enterprise'ınızın ghe.com hostname'ini girmesi gerekir.
• Veri saklama: Code Review, Zero Data Retention etkinleştirilmiş veya HIPAA yapılandırması uygulanmış organizasyonlarda kullanılamaz ve Anthropic'in Business Associate Agreement (BAA) kapsamına girmez.
• Şifreleme anahtarları: Code Review, customer-managed encryption keys (CMEK) kullanan organizasyonlar için henüz kullanılamaz.
• Bulut sağlayıcıları: Geliştiricileriniz Claude Code'u Amazon Bedrock, Google Cloud'un Agent Platform'u veya Microsoft Foundry üzerinden kullansa bile bu planlardan birinde bir Claude organizasyonuna ihtiyacınız vardır.

Code Review'u kurmak ve kullanmak (Set up and use Code Review)

İhtiyacınıza göre ilgili sayfayı seçin:

• Set up Code Review: Gereksinimleri kontrol edin, Claude GitHub App'i kurun ve depoları, bir review level ve incelemelerin ne zaman çalışacağını seçin.
• Customize Code Review: Deponuzdaki REVIEW.md ve CLAUDE.md dosyalarıyla nelerin işaretleneceğini ayarlayın.
• Read and request reviews on a pull request: Bulguları ve önem derecelerini okuyun, bir yorumla yeni bir inceleme isteyin.
• Troubleshoot Code Review: Başlamayan, başarısız olan veya bütçe nedeniyle atlanan bir incelemeyi düzeltin.
• Code Review costs and usage: İncelemelerin nasıl faturalandırıldığını görün, harcamayı tahmin edin, aylık harcama limitini belirleyin ve inceleme etkinliğini takip edin.

İncelemeler nasıl çalışır (How reviews work)

Varsayılan olarak Code Review doğruluğa odaklanır: production'ı bozacak hatalar; biçimlendirme tercihleri veya eksik test kapsamı değil. Neyin işaretleneceğini değiştirmek için deponuza rehberlik dosyaları ekleyin.

Bir inceleme Anthropic altyapısında dört aşamada çalışır:

1. Find: birkaç agent, diff'i ve çevresindeki kodu paralel olarak inceler.
2. Verify: bir doğrulama adımı, aday bulguları koda karşı kontrol eder ve yanlış pozitifleri filtreler.
3. Rank: kalan bulgular tekilleştirilir ve önem derecesine göre sıralanır.
4. Post: inceleme sonuçlarını pull request üzerinde yayınlar.

Her inceleme pull request üzerinde şunları bırakır:

• Bulgular (Findings): ilgili satırlara inline yorumlar, inceleme gövdesinde bir özetle birlikte.
• Bir check run: Claude Code Review adıyla, bulgular detaylarında listelenir. Check run başarısız (failure) olarak sonuçlanmaz.
• Hiçbir şey bulamadığında: check run'ın başlığı Code review found no issues okunur ve Claude pull request üzerinde aynı kısa notu paylaşır.

Code Review, incelemelerin üzerinde çalışacağı Claude modellerini kendisi seçer ve admin ayarlarında model seçimi sunulmaz. İncelemeleri daha az veya daha çok kapsamlı yapmak için review level'ı değiştirin.

Bir Owner Code Review'u açtıktan sonra her deponun incelemelerin ne zaman çalışacağına dair bir ayarı vardır: pull request açıldığında bir kez, her push'tan sonra veya yalnızca istek üzerine. Hangisi olursa olsun, depoya yazma erişimi olan biri bir pull request'e @claude review yorumu yaparak inceleme başlatabilir.

Review level'lar (Review levels)

Review level, her incelemenin ne kadar kapsamlı olduğunu belirler ve daha kapsamlı bir inceleme daha pahalıdır:

• Quick: daha hafif bir geçiş. En hızlı seviye, en düşük maliyet.
• Standard: dengeli derinlik, hız ve maliyet. Varsayılan seviye.
• Deep: en kapsamlı geçiş. En uzun sürer ve en pahalıdır.

Bir Owner organizasyon için tek bir seviye seçer ve tek bir depoya kendi seviyesini verebilir; örneğin rutin bir kod tabanı için Quick, kritik bir kod tabanı için Deep. Her incelemenin maliyetini başka nelerin etkilediğini "Code Review costs and usage" sayfasında bulabilirsiniz.

Bir incelemenin erişebildikleri (What a review can access)

Bir inceleme, deponuza kurulum sırasında bir Owner'ın yüklediği Claude GitHub App üzerinden erişir:

• Nerede çalışır: Anthropic altyapısında, yönetilen bir ortamda. İncelemeler self-hosted ortamlarda çalışmaz.
• Neyi okur ve yazar: bir inceleme içinde deponuza erişim salt okunurdur ve inceleme commit push etmez. Pull request üzerinde yorumları ve check run'ı yayınlar, kendi önceki yorum thread'lerini çözer ve bir yorum komutuna 👀 ile tepki verebilir. App'in kendisi, diğer Claude özelliklerinin paylaştığı daha geniş bir izin setine sahiptir.
• Kodunuzu nasıl inceler: bir inceleme, diff'i ve çevresindeki kodu okuyarak çalışır; kodunuzu derlemez veya çalıştırmaz.

Bir incelemeyi kim kontrol eder (Who controls a review)

• Kim başlatabilir: incelemelerin otomatik çalıştığı yerlerde, bir pull request'i açmak veya ona push yapmak bir inceleme başlatır; draft'lar ve fork'lar hariç. Bazı push'lardan sonra Code Review önceki sonucu korur. Bir yorum komutu yalnızca depoya yazma erişimi olan bir kişiden geldiğinde inceleme başlatır.
• Hangi talimatları izler: REVIEW.md dosyasını base veya default branch'ten okur ve asla pull request'in kendi değişikliklerinden okumaz.

İnceleme almanın yollarını karşılaştırma (Compare ways to get a review)

Size açık seçenekleri bulmak için "Who can use it" sütununu planınız ve kod barındırıcınızla karşılaştırın:

İlgili kaynaklar (Related resources)

• GitHub Enterprise Server: Code Review'u self-hosted bir GitHub örneğiyle kullanın.
• GitHub App permissions: Claude GitHub App'in talep ettiği tam izin seti.
• How Anthropic secures its AI-native software development lifecycle: otomatik incelemenin Anthropic'in güvenli geliştirme sürecinin bir katmanı olarak nasıl oturduğu.

Örnek kullanım senaryosu

Diyelim ki Team planındaki bir organizasyonda çalışıyorsunuz ve ekibiniz GitHub üzerinde bir Node.js servisi geliştiriyor. Pull request'lerdeki mantık hatalarını ve güvenlik açıklarını yakalamak için Code Review'u devreye almak istiyorsunuz.

1. Organizasyonunuzun uygun olduğunu doğrulayın: Team planındasınız, depo GitHub'da, Zero Data Retention veya HIPAA yapılandırması yok, CMEK kullanmıyorsunuz. Koşullar sağlanıyor.

2. Organizasyonun bir Owner'ı "Set up Code Review" sayfasını izleyerek Claude GitHub App'i kurar ve incelemelerin çalışacağı depoları seçer.

3. Owner, organizasyon için varsayılan review level'ı Standard olarak bırakır. Ancak ödeme akışını içeren kritik payments-service deposuna kendi seviyesini verir:

Repository: payments-service
Review level: Deep

4. Aynı depo için incelemelerin ne zaman çalışacağını "her push'tan sonra" olarak ayarlar; böylece her commit'te geri bildirim alınır.

5. Depoya bir REVIEW.md ekleyerek neyin işaretleneceğini yönlendirirsiniz. Örneğin, para birimi hesaplamalarında yuvarlama hatalarının özellikle kontrol edilmesini istersiniz:

## Review guidance

- Flag any floating-point arithmetic used for currency amounts.
- Treat missing input validation on public endpoints as a security issue.
- Ignore formatting and naming preferences.

Bu dosya base branch'ten okunur, pull request'in kendi değişikliklerinden değil.

6. Bir geliştirici payments-service deposunda bir pull request açar. Code Review otomatik olarak çalışır: birkaç agent diff'i ve çevresindeki kodu paralel inceler, doğrulama adımı yanlış pozitifleri eler, kalan bulgular önem derecesine göre sıralanır ve pull request'e inline yorumlar, bir özet ve Claude Code Review adlı bir check run olarak yayınlanır.

7. İnceleme, ödeme toplamında float kullanıldığını yüksek önem derecesiyle işaretler. Ekip bulguyu okur, düzeltmeyi yapar ve push eder. Push sonrası inceleme yeniden çalışır.

8. Bir geliştirici, otomatik incelemenin kaçırdığını düşündüğü bir konu için pull request'e yorum yazar:

@claude review

Yazma erişimi olduğu için inceleme yeniden başlar ve önceki yorum thread'lerini çözer.

9. İnceleme hiçbir sorun bulamazsa check run başlığı Code review found no issues olur ve pull request'e kısa bir not düşülür. Check run başarısız olarak sonuçlanmaz, dolayısıyla merge'i engellemez; merge kararı ekipte kalır.

10. Ay sonunda bir Owner "Code Review costs and usage" sayfasından harcamayı gözden geçirir ve aylık harcama limitini ayarlar. Deep seviyesinin Standard'dan daha pahalı olduğunu, bu yüzden yalnızca kritik depoda kullanıldığını doğrular.