Claude Code plan modu, bir ajanın yanlış yöne koşturmasını engellemenin en basit yolu. Claude dosyaları hemen düzenlemek yerine kodunu keşfediyor, bilmesi gerekenleri soruyor ve bir plan yazıyor. Sen okuyorsun, itiraz ediyorsun ve ancak doğru göründüğünde yapmasına izin veriyorsun. Bu rehberde plan modunun bugün nasıl çalıştığını, nasıl açıldığını, ne zaman değdiğini ve alt ajanlar ile CLAUDE.md’yle nasıl birleştirileceğini anlatıyoruz.
Buradaki her şey Ekim 2026’da Anthropic’in izin modları dokümanı ve yaygın iş akışları sayfasıyla karşılaştırıldı.
Claude Code plan modu nedir?
Plan modu, Claude Code’un izin modlarından biri. Bu modda Claude:
- dosya okuyabilir ve kod tabanında arama yapabilir,
- keşif için shell komutları çalıştırabilir; dosyaları listelemek ya da git geçmişini okumak gibi,
- sana netleştirici sorular sorabilir,
- bir plan yazabilir.
Yapmadığı şey kaynak kodunu düzenlemek. Plan bir değişiklik değil, bir öneri. Plan modu açıkken durum çubuğunda ⏸ plan mode on yazar.
Amaç düşünmeyle yapmayı ayırmak. Varsayılan modda Claude kısa bir göz gezdirmeden sonra genelde düzenlemeye başlar. Küçük işlerde tam istediğin şey bu. Büyük bir değişiklikte ise yanlış bir varsayımı on dosyaya dokunulduktan sonra öğrenirsin.
Plan moduna nasıl girilir?
Ne kadar süre kalmak istediğine göre üç yol var.
Shift+Tab: mevcut oturumu değiştir
İzin modları arasında dolaşmak için Shift+Tab’e bas. Sıra şöyle:
- Varsayılan (Claude düzenleme ve komutlardan önce sorar)
- Düzenlemeleri kabul et
- Plan modu
- İzinleri atla; yalnızca bununla başlattıysan
- Otomatik mod; yalnızca sana açıksa
Sonra başa, varsayılana döner. Durum çubuğunda plan modunu görünce dur. Hiçbir şeyi onaylamadan plan modundan çıkmak için tekrar Shift+Tab’e bas.
/plan: tek bir prompt’u planla
Yalnızca o isteği planlamak için prompt’un başına /plan yaz:
/plan oturum deposunu Redis'ten Postgres'e taşıÇoğunlukla varsayılan modda çalışıp yalnızca ara sıra gelen büyük işler için plan istiyorsan kullanışlı.
Oturumu plan modunda başlat
claude --permission-mode planHer oturumun plan modunda başlamasını istiyorsan .claude/settings.json içinde varsayılan yap:
{
"permissions": {
"defaultMode": "plan"
}
}VS Code eklentisinde claudeCode.initialPermissionMode ayarını "plan" yap.
Plan modu ve diğer modlar
| Mod | Okur ve keşfeder | Dosya düzenler | Komut çalıştırır |
|---|---|---|---|
| Varsayılan | Evet | Sana sorduktan sonra | Sana sorduktan sonra |
| Düzenlemeleri kabul et | Evet | Sormadan | Sana sorduktan sonra |
| Plan modu | Evet | Hayır, ancak planı onaylayınca | Keşif için; incelenir ya da önce sorulur |
| Otomatik mod | Evet | Evet, güvenlik kontrolleriyle | Evet, güvenlik kontrolleriyle |
Düzenlemelerin tek bir değişikliği değil, bütün bir planı beklediği tek mod plan modu. Ölçeğin riskli ucu için Claude Code izinlerini atlamak yazısına bak.
Shift+Tab, izin modları ve diğer kısayollar Claude Code komutları yazısında bir arada.
Plan hazır olunca ne olur?
Claude planlamayı bitirince planı gösterir ve nasıl devam edileceğini sorar. Seçenekler:
- Yes, and use auto mode: onayla ve Claude otomatik modun güvenlik kontrolleriyle çalışsın. Otomatik mod yoksa bu seçenek “Yes, auto-accept edits” olarak görünür.
- Yes, manually approve edits: onayla ama her düzenlemeyi geldikçe incele.
- No, keep planning: geri bildirim gönder ve düzeltilmiş bir plan al.
showClearContextOnPlanAccept ayarını açarsan en başa bir seçenek daha gelir: planı onaylar ve planlama konuşmasını temizler. Böylece yapım aşaması yalnızca planı içeren temiz bir bağlamla başlar.
Onaylamak plan modundan çıkarır. Bilmeye değer birkaç şey daha:
- Ctrl+G planı editöründe açar; onaylamadan önce doğrudan düzenleyebilirsin.
- Planlar dosya olarak kaydedilir; varsayılan olarak
~/.claude/plans/içine ya daplansDirectoryile belirlediğin klasöre. - Planı kabul etmek oturuma otomatik bir başlık verir; sonradan bulmak kolaylaşır.
Planlama sırasında shell komutları
Keşfetmek çoğu zaman komut çalıştırmak demek. Otomatik mod sana açıksa ve useAutoModeDuringPlan açıksa (varsayılan olarak açık), bu komutları otomatik moddaki gibi bir sınıflandırıcı inceler. Değilse, salt okunur komutlar dışındaki her şey önce onayını ister. Her iki durumda da plan modu, rastgele komutlar için bir sandbox değil; Claude’un kodunu düzenlemediği bir mod.
Plan modu ne zaman kullanılır?
Yanlış bir ilk adımın pahalıya patladığı yerde plan modu değer.
| Plan modunu kullan | Atla |
|---|---|
| Birkaç dosya ya da modüle yayılan değişiklikler | Tek satırlık düzeltmeler ve yazım hataları |
| İyi bilmediğin bir kod tabanı ya da bölüm | Az önce yazdığın kod |
| Refactor’lar ve migration’lar | Bir değişkeni yeniden adlandırmak |
| Yaklaşımın belli olmadığı özellikler | Her adımını zaten bildiğin işler |
| Veriye, kimlik doğrulamaya ya da ödemeye dokunan her şey | Formatlama ve lint düzeltmeleri |
| Kod incelemesinden önce incelenebilir bir plan istediğinde | Atacağın hızlı denemeler |
İşe yarar bir kural: değişikliği kendin yapsan önce kâğıda çizecek olsaydın, Claude’dan da önce plan iste.
Plan modu bir kod tabanını öğrenirken de işe yarar. Plan modunda “giriş formundan oturum deposuna kimlik doğrulama nasıl akıyor?” diye sor; Claude hiçbir şeye dokunma riski olmadan keşfeder ve anlatır.
Önce plan, sonra uygulama akışı
Anthropic’in önerdiği döngü dört adımlı: keşfet, planla, uygula, commit’le. Pratikte şöyle görünüyor.
1. Keşfet
Plan moduna gir ve Claude’u ilgili bölüme yönlendir:
src/billing'i ve tests/billing altındaki testleri oku.
Faturaların nasıl oluşturulduğunu ve vergilerin nerede uygulandığını anlat.
Henüz değişiklik önerme.Yanlış anladığı ne varsa şimdi düzelt. Yanlış anlamalar en ucuz bu aşamada.
2. Planla
Önemli kısıtlarla birlikte planı iste:
Ülke bazında vergi oranı eklemeyi planla.
Public API değişmesin, bir migration ekle ve ekleyeceğin testleri listele.İyi bir plan değiştireceği dosyaları, sırayı, riskleri ve sonucu nasıl doğrulayacağını adıyla söyler.
3. İtiraz et
İlk taslağı refleksle onaylama. “No, keep planning” seç ve neyin değişmesini istediğini söyle: “Migration’ı ayrı bir adımda yap”, “PDF oluşturucuya dokunma”. Ya da Ctrl+G’ye basıp planı kendin düzenle.
4. Uygula
Onayla. Plana güveniyorsan “Yes, and use auto mode” Claude’un her düzenlemede durmadan plan boyunca ilerlemesini sağlar. Değişiklik riskliyse elle onayı seç.
5. Doğrula ve commit’le
Claude’dan planda listelediği testleri çalıştırmasını iste. Bir şeyler ters giderse Escape Claude’u durdurur; /rewind (ya da iki kez Escape) seni daha önceki bir kontrol noktasına götürür. Testler geçince commit’le.
Daha büyük bir değişiklikte plan dosyasını sakla ve yapım aşamasını yeni bir oturumda başlat. Plan prompt’un olur ve yapım, keşifle değil kararlarla dolu bir bağlamla başlar.
Planlama için daha güçlü model kullan
opusplan model takma adı plan modundayken Opus’u kullanır, uygulamaya geçince Sonnet’e geçer. Kararlarda Opus düzeyinde akıl yürütme, yazma kısmında Sonnet’in düşük maliyeti. /model opusplan ile ayarla. Abonelikte bu, kullanım limitlerini de uzatır.
Plan modu ve alt ajanlar
Plan modu alt ajanlarla iyi çalışıyor; Claude Code zaten bunun için onları kullanıyor.
- Yerleşik Plan alt ajanı: plan modunda Claude araştırmayı bir Plan alt ajanına devredebilir. Salt okunur araçları var, ana konuşmayla aynı modeli kullanır ve kazısını kendi bağlamında yapar; ana konuşmaya yalnızca bulgular gelir. CLAUDE.md’n ve git durum özeti olmadan başlar ve bir kez çalışır; devam ettirilemez.
- Explore alt ajanı: kod tabanında hızlı arama ve okuma için ayarlanmış bir başka salt okunur yerleşik ajan.
- Alt ajanlar plan modunda kalır: ana konuşma plan modundayken başlattığı alt ajanlar da plan modunda kalır. Bir yardımcıdan sürpriz bir düzenleme gelmez.
Araştırma ayrı bağlamlarda yapıldığı için ana konuşma küçük kalır. Bu planı odaklı tutar ve yapım için bağlam penceresinde daha çok yer bırakır.
Paralel araştırmayı doğrudan da isteyebilirsin: “Plan modunda alt ajanlarla API katmanına, veritabanı katmanına ve frontend’e ayrı ayrı bak, sonra bana tek bir plan ver.” Anthropic’in maliyet dokümanından bir uyarı: ekip üyeleri plan modunda çalışan ajan ekipleri standart bir oturumun kabaca yedi katı token harcıyor; bunu hak eden değişikliklere sakla.
Plan modu ve CLAUDE.md
Plan modu, Claude’un başladığı bağlam kadar iyidir. CLAUDE.md burada devreye giriyor. Oraya eklenen birkaç satır planları gözle görülür biçimde iyileştirir:
## Planlama
- Planlar değişecek dosyaları sırasıyla ve eklenecek testleri listeler.
- Veritabanı değişiklikleri her zaman kendi migration adımını alır.
- Public API imzaları belirtilmeden değiştirilmez.
- Doğrulamak için `pnpm test` ve `pnpm lint` çalıştır.İki ayrıntıyı aklında tut:
- Yerleşik Plan alt ajanı CLAUDE.md’yi görmez. Proje genelindeki kuralları ana konuşma için oraya yaz, araştırma isterken kritik olan her şeyi prompt’una da ekle.
- CLAUDE.md’yi kısa tut. Her turda gönderiliyor; uzun bir CLAUDE.md her modda token harcar. Uzun prosedürleri skill’lere taşı.
Ekibin her zaman önce planlıyorsa paylaşılan .claude/settings.json içinde plan modunu varsayılan yap ve iyi bir planın neye benzediğini CLAUDE.md’de anlat. Herkes hatırlamak zorunda kalmadan aynı davranışı alır.
Sık yapılan hatalar
- Okumadan onaylamak. Okumadığın bir plan, sadece daha yavaş bir varsayılan mod.
- Minik işleri planlamak. Bir yazım hatası düzeltmesinde plan modu yalnızca bir tur ekler.
- Fazla belirsiz planlar. “Auth modülünü refactor et” bir plan değil. Dosyaları, sırayı ve doğrulama adımlarını iste.
- Planlamadan sonra hiç temizlememek. Keşif bağlamı doldurur. Büyük işlerde bağlamı temizleyen seçenekle onayla ya da plan dosyasından yeni bir oturum başlat.
- Plan modunu sandbox sanmak. Kaynak düzenlemeyi durdurur; terminali güvenli bir oyun alanına çevirmez. Komutları her yerde incelediğin gibi incele.
AgentVera’da planlamak
AgentVera; macOS, Windows ve Linux için, Claude Code’u ve diğer CLI ajanlarını proje bazında yan yana çalıştıran bir masaüstü uygulaması. Her panel gerçek Claude Code terminali; Shift+Tab, /plan ve plan onay seçenekleri tek başına nasıl çalışıyorsa öyle çalışır. AgentVera bunların etrafına yapı ekler:
- Görev hattı: bir görev Analiz, Plan, Yapım ve İnceleme aşamalarından geçer. Her aşama çıktısını
02-plan.mdgibi bir dosyaya yazar ve sonraki aşama oradan başlar; plan tek bir konuşmada kalmaz, görevle birlikte taşınır. - Akışlar: araştırma, plan ve yapım gibi adımları zincirle; aynı önce-plan-sonra-uygula döngüsü her seferinde aynı şekilde çalışsın.
- Otomatik onay: plan onaylandıktan sonra güvenli okumalar ve testler sorusuz geçer;
git pushya darmgibi işler yine sorar. - Turlar ve oturum tekrarı: ajan başına son 60 tur saklanır; yapım plandan saparsa geri dönebilirsin.
Turlar ve oturum tekrarı ücretsiz planda. Görev hattı ve otomatik onay Pro ve Team’de. Birden fazla ajan çalıştırmaya yeniysen Claude Code nasıl kullanılır yazısıyla başla ve AgentVera’yı indir.
Toparlarsak
Plan modu Claude’un düzenlemeden önce keşfetmesini ve önermesini sağlar. Shift+Tab, /plan ya da --permission-mode plan ile aç, planı gerçekten oku, “No, keep planning” ya da Ctrl+G ile itiraz et ve ancak ondan sonra onayla. Çok dosyalı değişikliklerde, tanımadığın kodda ve riskli her işte kullan; küçük düzeltmelerde atla. Kısa ve net bir CLAUDE.md ile eşleştir, kazıyı salt okunur alt ajanlara bırak ve Opus’la planlayıp Sonnet’le yapmak için opusplan’ı dene.