Claude · Gelişmiş · 201 Claude Code temeli · Konu 6 / 10
3.6 Keşfet, planla, kodla, commit
Önce oku, sonra planla, sonra yazdır, en son kaydet.
Bu sayfada ne öğreneceksin
- Dört aşamanın (keşfet, planla, kodla, commit) her birinde ne yapıldığını
- Plan modunu nasıl açacağını ve planı nasıl onaylayacağını
- Neden kod yazdırmadan önce plan istediğini ve planın ne zaman gereksiz olduğunu
Kısaca
Anthropic'in Claude Code kursu bu akışı kursun en önemli çıkarımı olarak veriyor. Akış olmadan çoğu kişi doğrudan kod yazdırıyor ve sonradan daha çok düzeltme yapıyor. Claude Code dokümanının gerekçesi de aynı: Claude'un doğrudan kod yazmaya girişmesi, yanlış sorunu çözen bir kod üretebilir.
Keşfetme ve planlama için en hızlı yol plan modu. Bu modda Claude dosyaları okur ve keşif için komut çalıştırır, ama kaynak dosyalarını düzenlemez. Sonunda sana bir plan sunar. Kodun henüz yazılmadığı bu an, yön değiştirmek için en ucuz andır.
Plan her iş için gerekmez. Doküman, kapsamı net ve düzeltmesi küçük işlerde (yazım hatası, bir log satırı, bir değişkeni yeniden adlandırmak) doğrudan istemeni söylüyor. Değişikliği tek cümleyle anlatabiliyorsan planı atla.
Adım adım
- Plan moduna gir. Claude Code'da
Shift+Tabtuşuna, durum çubuğunda plan modunun yazdığını görene kadar bas. Alternatif olarak oturumu doğrudan plan modunda başlat (aşağıdaki terminal komutu) ya da tek bir isteminin başına/planyaz. Beklenen sonuç: durum çubuğunda⏸ plan mode ongörünür. - Keşfet. Claude'dan ilgili dosyaları okumasını ve işin nerede, nasıl yapılacağını anlamasını iste. Henüz hiçbir şey yazdırma. Beklenen sonuç: Claude dosyaları okur, gerekirse komut çalıştırır ve bulduklarını anlatır.
- Planla. Ayrıntılı bir uygulama planı iste. Planı gerçekten oku. Eksik ya da yanlış bir yer varsa belirli kısmı düzeltmesini söyle. Kurs, düzeltme için en iyi yerin burası olduğunu söylüyor, çünkü henüz tek satır kod yazılmadı. Planı kendi metin düzenleyicinde değiştirmek istersen
Ctrl+Gile aç. - Onayla. Plan hazır olunca Claude nasıl devam edeceğini sorar. Dokümana göre seçenekler şunlar: Yes, and use auto mode (onayla, auto modda başla), Yes, manually approve edits (onayla, her düzenlemeyi tek tek gör) ve No, keep planning (planlamaya devam et, neyi değiştireceğini yaz). Auto mod oturumunda yoksa ilk seçenek Yes, auto-accept edits olarak görünür. Onay, plan modundan çıkarır ve Claude düzenlemeye başlar.
- Kodla. Claude plandaki maddelerin üzerinden geçer. İzin modun, her adımda sorup sormayacağını belirler (bkz. 3.7 İzin modları). Claude sorunları kendi gidermeye çalışır, ama bazen araya girmen gerekir. Planın bağlamı elinde olduğu için sonraki kararlarında Claude'u yönlendirmek kolaylaşır.
- Kendin dene. Değişiklikleri kendi gözünle test et. Beğenmediğin yer varsa aynı oturumda düzeltme iste.
- Commit öncesi ikinci göz. Kurs, commit etmeden önce bir alt ajan (subagent) kod inceleyicisi çalıştırmayı öneriyor. Alt ajan koda taze bakar, ana ajanın oturum boyunca edindiği önyargıyı taşımaz. Ayrıntısı için 3.9 Kod incelemesi.
- Commit. Claude'dan, kendi üslubunda bir commit mesajı üretmesini iste. Doküman bunun için "commit with a descriptive message" cümlesini örnek veriyor. Sonra bir sonraki özelliğe geç ve döngüyü tekrarla.
Oturumu plan modunda başlatmak için terminal komutu:
claude --permission-mode plan
Hazır prompt
Aşama 1 ve 2 için. Plan modundayken gönder; köşeli parantezleri kendi işine göre doldur.
[Eklemek istediğin özelliği anlat. Örn: Sitemize ziyaretçilerin e-posta adresi bırakabileceği bir bülten formu eklemek istiyorum.]
Önce ilgili dosyaları oku. Bu işin hangi dosyalarda yapılması gerektiğini, yeni bir paket gerekip gerekmediğini ve nasıl bir yol izleyeceğini anlat.
Sonra adım adım bir plan yaz. Planın sonunda, işin doğru bittiğini nasıl anlayacağımızı (hangi test ya da kontrol) yaz. Henüz hiçbir dosyayı değiştirme.
Plan onaylandıktan sonra, aşama 3 için:
Planı uygula. Bitirince testleri çalıştır, sonucu bana göster ve geçmeyen bir şey varsa nedenini söyleyip düzelt.
Aşama 4 için:
Yaptığımız değişiklikleri özetleyen, açıklayıcı bir commit mesajı yaz ve commit et.
Sık yapılan hata
- Planı okumadan onaylamak. Kurs, planı gerçekten okumanı söylüyor: plan ne kadar kapsamlıysa uygulama sırasında o kadar az sürprizle karşılaşırsın. Plan üzerinde düzeltme yapmak, Claude'u çalıştırıp sonra dağınıklığı toplamaktan çok daha hızlı.
- Başarı ölçütü vermemek. Claude'un sonucundan emin olması için "doğru"nun neye benzediğini bilmesi gerekir. Bunu planda açıkça yaz. Elinde bir test takımı varsa Claude onu sürekli çalıştırabilir; yalnız testlerin güvenilir bir kaynak olduğundan emin ol, yoksa yanlış olumlu sonuç alırsın.
- Her işe plan yapmak. Plan modu ek yük getirir. Küçük ve net işlerde doğrudan iste.
- Aynı hatayla tekrar tekrar karşılaşmak. Claude aynı sorunlara takılıyorsa çözümü CLAUDE.md dosyasına kaydetmesini iste (bkz. 3.5).
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code 101: The explore → plan → code → commit workflow (dört aşama, plan modu, Shift+Tab, başarı ölçütü, test takımı, alt ajan incelemesi, commit mesajı)
- Anthropic Academy, Claude Code in action: Steering long sessions (planı okuma, plan üzerinde yineleme)
- Claude Code dokümanı: Best practices (keşfet, planla, uygula, commit; planın ne zaman atlanacağı)
- Claude Code dokümanı: Choose a permission mode (plan modu,
/plan, plan onay seçenekleri,Ctrl+G) - Claude Code dokümanı: Common workflows (plan modunda başlatma komutu, durum çubuğu göstergesi)
Son doğrulama: 2026-10-21