# Claude Code plan modu: önce planla, sonra yaptır

Adres: https://agentvera.dev/blog/claude-code-plan-modu/ · Yayın: 2026-10-25

Claude Code plan modu nedir, Shift+Tab ya da /plan ile nasıl açılır, ne zaman kullanılır; önce plan sonra uygulama akışı, alt ajanlar ve CLAUDE.md ile birlikte kullanım.

**Kısaca:**

- Plan modunda Claude Code dosyaları okur, kod tabanını keşfeder ve bir plan yazar; ama sen onaylayana kadar hiçbir dosyayı değiştirmez.
- Durum çubuğunda plan modu görünene kadar Shift+Tab’e bas, tek bir prompt’un başına /plan yaz ya da claude --permission-mode plan ile başlat.
- Birkaç dosyaya dokunan ya da kafanda henüz canlanmayan değişikliklerde kullan; tek satırlık düzeltmelerde atla.

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ı](https://code.claude.com/docs/en/permission-modes "Claude Code izin modları") ve [yaygın iş akışları](https://code.claude.com/docs/en/common-workflows "Claude Code 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:

1. Varsayılan (Claude düzenleme ve komutlardan önce sorar)
2. Düzenlemeleri kabul et
3. Plan modu
4. İzinleri atla; yalnızca bununla başlattıysan
5. 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

```bash
claude --permission-mode plan
```

Her oturumun plan modunda başlamasını istiyorsan `.claude/settings.json` içinde varsayılan yap:

```json
{
  "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](/blog/claude-code-izinleri-atlamak/ "Claude Code izinlerini atlamak") yazısına bak.

Shift+Tab, izin modları ve diğer kısayollar [Claude Code komutları](/blog/claude-code-komutlari/ "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 da `plansDirectory` ile 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](/blog/claude-code-limit/ "Claude Code limit") de uzatır.

## Plan modu ve alt ajanlar

Plan modu [alt ajanlarla](/blog/claude-code-alt-ajanlar/ "Claude Code alt ajanlar") 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](/blog/claude-code-baglam-yonetimi/ "Claude Code bağlam yönetimi") 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](/blog/claude-md-nasil-yazilir/ "CLAUDE.md nasıl yazılır") burada devreye giriyor. Oraya eklenen birkaç satır planları gözle görülür biçimde iyileştirir:

```markdown
## 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ı](/ozellikler/gorev-hatti/ "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.md` gibi bir dosyaya yazar ve sonraki aşama oradan başlar; plan tek bir konuşmada kalmaz, görevle birlikte taşınır.
- **[Akışlar](/ozellikler/akislar/ "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](/ozellikler/otomatik-onay/ "Otomatik onay"):** plan onaylandıktan sonra güvenli okumalar ve testler sorusuz geçer; `git push` ya da `rm` gibi işler yine sorar.
- **[Turlar ve oturum tekrarı](/ozellikler/turlar-ve-oturum-tekrari/ "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](/blog/claude-code-nasil-kullanilir/ "Claude Code nasıl kullanılır") yazısıyla başla ve [AgentVera’yı indir](/indir/ "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.

## Sık sorulanlar

**Claude Code’da plan modu nasıl açılır?** Durum çubuğunda “plan mode on” görünene kadar Shift+Tab’e bas, tek bir prompt’un başına /plan yaz ya da oturumu claude --permission-mode plan ile başlat.

**Plan modunda Claude dosya değiştirebilir mi?** Hayır. Keşfetmek için dosya okuyabilir ve komut çalıştırabilir ama sen planı onaylayana kadar kaynak kodunu düzenlemez.

**Plan modundan nasıl çıkılır?** Planı onaylarsın, bu plan modundan çıkıp işi başlatır; ya da onaylamadan çıkmak için tekrar Shift+Tab’e basarsın.

**Plan modunu varsayılan yapabilir miyim?** Evet. .claude/settings.json içinde permissions altına "defaultMode": "plan" yazarsan her yeni oturum plan modunda başlar.

**Plan modu daha fazla token harcar mı?** Planlama başta biraz token harcar ama büyük işlerde yeniden yapmayı önlediği için genelde daha fazlasını kazandırır. Anthropic’in maliyet önerileri de karmaşık değişiklikler için plan modunu öneriyor.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/