Ultrareview beta ile hata bulma (Find bugs with ultrareview)
Ultrareview, Claude Code v2.1.86 ve sonraki sürümlerde kullanılabilen bir araştırma önizleme (research preview) özelliğidir. Özellik, fiyatlandırma ve kullanılabilirlik geri bildirimlere göre değişebilir.
Ultrareview, Claude Code on the web altyapısında çalışan derinlemesine bir kod inceleme aracıdır. /ultrareview komutunu çalıştırdığınızda, Claude Code uzak bir sandbox ortamında bir incelemeci ajan filosu (fleet of reviewer agents) başlatır ve branch'inizde veya pull request'inizde hataları bulur.
Yerel /review ile karşılaştırıldığında ultrareview şunları sunar:
- Daha yüksek sinyal (Higher signal): Bildirilen her bulgu bağımsız olarak yeniden üretilir ve doğrulanır, böylece sonuçlar stil önerilerinden ziyade gerçek hatalara odaklanır.
- Daha geniş kapsam (Broader coverage): Birçok incelemeci ajan değişikliği paralel olarak inceler, tek geçişli bir incelemenin kaçırabileceği sorunları yüzeye çıkarır.
- Yerel kaynak kullanımı yok (No local resource use): İnceleme tamamen uzak bir sandbox'ta çalışır, terminaliniz diğer işler için boş kalır.
Ultrareview, Claude Code on the web altyapısında çalıştığı için bir Claude.ai hesabıyla kimlik doğrulaması gerektirir. Yalnızca API anahtarıyla oturum açtıysanız, önce /login komutunu çalıştırın ve Claude.ai ile kimlik doğrulaması yapın. Ultrareview, Claude Code'u Amazon Bedrock, Google Cloud Vertex AI veya Microsoft Foundry ile kullanırken kullanılamaz ve Zero Data Retention'ı etkinleştirmiş kuruluşlar için de mevcut değildir.
CLI'dan ultrareview çalıştırma (Run ultrareview from the CLI)
Herhangi bir git deposunda Claude Code CLI'dan bir inceleme başlatmak için:
/ultrareview
Argümansız olarak, ultrareview mevcut branch'iniz ile varsayılan branch arasındaki diff'i inceler. Buna çalışma ağacınızdaki (working tree) commit'lenmemiş ve staged değişiklikler de dahildir. Claude Code depo durumunu paketler ve inceleme için uzak sandbox'a yükler.
Bir GitHub pull request'ini incelemek için PR numarasını iletin:
/ultrareview 1234
PR modunda, uzak sandbox pull request'i yerel çalışma ağacınızı paketlemek yerine doğrudan GitHub'dan klonlar. PR modu, depoda bir github.com remote'u gerektirir. Deponuz paketlenemeyecek kadar büyükse, Claude Code sizi PR modunu kullanmaya yönlendirir. Branch'inizi push edin ve bir draft PR açın, ardından /ultrareview <PR-numarası> komutunu çalıştırın.
Başlatmadan önce, Claude Code inceleme kapsamını (branch incelenirken dosya ve satır sayısı dahil), kalan ücretsiz çalıştırma sayınızı ve tahmini maliyeti gösteren bir onay diyaloğu gösterir. Onay verdikten sonra inceleme arka planda devam eder ve siz oturumunuzu kullanmaya devam edebilirsiniz. Komut yalnızca /ultrareview ile çağırdığınızda çalışır; Claude kendi başına bir ultrareview başlatmaz.
Fiyatlandırma ve ücretsiz çalıştırmalar (Pricing and free runs)
Ultrareview, premium bir özelliktir ve planınızın dahili kullanımı yerine ekstra kullanım (extra usage) olarak faturalandırılır.
| Plan | Dahili ücretsiz çalıştırma | Ücretsiz çalıştırmalardan sonra |
|---|---|---|
| Pro | 3 ücretsiz çalıştırma, 5 Mayıs 2026'ya kadar | ekstra kullanım olarak faturalandırılır |
| Max | 3 ücretsiz çalıştırma, 5 Mayıs 2026'ya kadar | ekstra kullanım olarak faturalandırılır |
| Team ve Enterprise | yok | ekstra kullanım olarak faturalandırılır |
Pro ve Max aboneleri, özelliği denemek için üç ücretsiz ultrareview çalıştırması alır. Bu üç çalıştırma, hesap başına tek seferlik bir tahsistir, yenilenmez ve 5 Mayıs 2026'da sona erer. Üçünü de kullandıktan sonra veya ücretsiz çalıştırma süresi sona erdikten sonra, her inceleme ekstra kullanım olarak faturalandırılır ve değişikliğin boyutuna bağlı olarak tipik olarak 5 ila 20 dolar arasında maliyet oluşturur.
Bir çalıştırma, uzak oturum başladığında sayılır; bu nedenle erken durdurduğunuz veya tamamlanamayan bir inceleme yine de bir ücretsiz çalıştırma kullanır. Ücretli bir inceleme için, ekstra kullanım yalnızca çalışan kısım için faturalandırılır.
Ultrareview her zaman ücretsiz çalıştırmaların dışında ekstra kullanım olarak faturalandığından, ücretli bir inceleme başlatmadan önce hesabınızda veya kuruluşunuzda ekstra kullanımın etkinleştirilmiş olması gerekir. Ekstra kullanım etkin değilse, Claude Code başlatmayı engeller ve sizi fatura ayarlarına yönlendirir. /extra-usage komutunu kullanarak mevcut ayarınızı kontrol edebilir veya değiştirebilirsiniz.
Devam eden bir incelemeyi izleme (Track a running review)
Bir inceleme tipik olarak 5 ila 10 dakika sürer. İnceleme bir arka plan görevi olarak çalışır, böylece oturumunuzda çalışmaya devam edebilir, başka komutlar başlatabilir veya terminali tamamen kapatabilirsiniz.
/tasks komutunu kullanarak çalışan ve tamamlanan incelemeleri görebilir, bir incelemenin detay görünümünü açabilir veya devam eden bir incelemeyi durdurabilirsiniz. Bir incelemeyi durdurmak bulut oturumunu arşivler ve kısmi bulgular döndürülmez.
İnceleme tamamlandığında, doğrulanmış bulgular oturumunuzda bir bildirim olarak görünür. Her bulgu, dosya konumunu ve sorunun açıklamasını içerir, böylece Claude'dan doğrudan düzeltmesini isteyebilirsiniz.
Ultrareview'i etkileşimsiz çalıştırma (Run ultrareview non-interactively)
claude ultrareview alt komutunu kullanarak CI veya bir script'ten etkileşimsiz bir ultrareview başlatabilirsiniz. Bu alt komut, /ultrareview ile aynı incelemeyi başlatır, uzak inceleme bitene kadar bloklar, bulguları stdout'a yazdırır ve başarı durumunda 0, hata durumunda 1 çıkış koduyla sonlanır.
claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main
Argümansız olarak, alt komut mevcut branch'iniz ile varsayılan branch arasındaki diff'i inceler. Bir PR numarası iletmek bir pull request'i inceler veya bir base branch iletmek o branch'e karşı diff'i inceler.
Alt komutu çağırmak, etkileşimli komutun gösterdiği fatura ve koşullar istemi için onay sayılır. İlerleme mesajları ve canlı oturum URL'si stderr'e gider, böylece stdout ayrıştırılabilir kalır.
Çıktıyı ve zaman aşımını kontrol etmek için şu bayrakları kullanın:
| Bayrak | Açıklama |
|---|---|
--json |
Biçimlendirilmiş bulgular yerine ham bugs.json yükünü yazdırır |
--timeout <dakika> |
İncelemenin bitmesi için beklenecek maksimum dakika. Varsayılan: 30 |
claude ultrareview çalıştırmak, /ultrareview ile aynı kimlik doğrulama ve ekstra kullanım yapılandırmasını gerektirir. Alt komut, inceleme bulgulu veya bulgusuz tamamlandığında 0, başlatılamadığında, uzak oturum hata verdiğinde veya zaman aşımı oluştuğunda 1 ve Ctrl-C ile kesildiğinde 130 çıkış koduyla sonlanır. Alt komutu keserseniz uzak inceleme çalışmaya devam eder; stderr'e yazdırılan oturum URL'sini takip ederek tarayıcıda izleyebilirsiniz.
GitHub pull request'leri üzerinde otomatik incelemeler için, Code Review doğrudan deponuzla entegre olur ve bulguları CLI adımı olmadan satır içi PR yorumları olarak gönderir.
Ultrareview /review ile karşılaştırması (How ultrareview compares to /review)
Her iki komut da kodu inceler, ancak iş akışınızın farklı aşamalarını hedefler.
| Özellik | /review |
/ultrareview |
|---|---|---|
| Çalışma yeri | yerel, oturumunuzda | uzak, bulut sandbox'ta |
| Derinlik | tek geçişli inceleme | bağımsız doğrulamalı çoklu ajan filosu |
| Süre | saniyelerden birkaç dakikaya | yaklaşık 5 ila 10 dakika |
| Maliyet | normal kullanım sayılır | ücretsiz çalıştırmalar, ardından inceleme başına yaklaşık 5-20 dolar ekstra kullanım |
| En iyi kullanım | yineleme sırasında hızlı geri bildirim | önemli değişikliklerde birleştirme öncesi güven |
/review'u çalışırken hızlı geri bildirim için kullanın. /ultrareview'u önemli bir değişikliği birleştirmeden önce, tek bir incelemenin kaçırabileceği sorunları yakalayan daha derin bir geçiş istediğinizde kullanın.
İlgili kaynaklar (Related resources)
- Claude Code on the web: Uzak oturumların ve bulut sandbox'larının nasıl çalıştığını öğrenin.
- Plan complex changes with ultraplan: Ön tasarım çalışmaları için ultrareview'in planlama karşılığı.
- Manage costs effectively: Kullanımı takip edin ve harcama limitleri belirleyin.
Örnek kullanım senaryosu
Bir ekibin ana branch'e birleştirilmeyi bekleyen büyük bir özellik branch'i olduğunu varsayalım. Geliştirici, birleştirmeden önce gözden kaçan hataları yakalamak için ultrareview kullanmak ister.
Geliştirici, özellik branch'indeyken Claude Code CLI'da
/ultrareviewkomutunu çalıştırır. Claude Code, mevcut branch ile varsayılan branch (örneğinmain) arasındaki diff'i algılar ve bir onay diyaloğu gösterir: kaç dosya ve satır inceleneceği, kalan ücretsiz çalıştırma sayısı ve tahmini maliyet (örneğin 8 dolar).Geliştirici onaylar ve inceleme arka planda başlar. Terminalde çalışmaya devam ederken,
/taskskomutuyla incelemenin durumunu kontrol edebilir.Yaklaşık 7 dakika sonra, Claude Code oturumda bir bildirim gösterir: "Ultrareview tamamlandı. 3 doğrulanmış hata bulundu." Bildirimde her hata için dosya yolu ve açıklama yer alır.
Geliştirici, bulgulardan birini seçer ve Claude'a "Bu hatayı düzelt" der. Claude, ilgili dosyayı açar ve düzeltmeyi önerir.
Alternatif olarak, geliştirici CI pipeline'ında
claude ultrareview --json --timeout 15komutunu kullanarak incelemeyi otomatikleştirir. Çıktıyı JSON formatında alır ve hata varsa pipeline'ı başarısız yapar.Üç ücretsiz çalıştırma bittiğinde, geliştirici
/extra-usageile ekstra kullanımı etkinleştirir ve sonraki incelemeler için faturalandırmaya hazır olur.