Claude · Gelişmiş · 203 Ölçekle ve otomatikleştir · Konu 1 / 7
4.5 Uzun oturumları yönetmek
Uzun işi önce planla, sonra yolda yönlendir; her adımı başında beklemene gerek kalmasın.
Bu sayfada ne öğreneceksin
- Planı neden okuman gerektiğini ve planı düzeltmenin yollarını
- Claude çalışırken yönlendirme araçlarını: sıkıştırmayı yönlendirmek, rewind, durdurmak, sıfırlamak
/goalile bitiş koşulu koymayı ve/loopile dışarıdaki bir şeyi izletmeyi
Kısaca
Küçük bir iş kolaydır: istersin, Claude yapar, sonucu okursun. Onlarca dosyaya yayılan bir yeniden düzenleme ya da yeni bir özellik ise saatler sürebilir. Kursa göre iş uzadıkça Claude'u yönlendirmen gerekir ve yönlendirme ne kadar çoksa iş o kadar uzar. Çözüm iki alışkanlıktır: işi Claude başlamadan önce kapsamla, çalışırken de yönlendir.
Bu sayfa, 3.8 Bağlam yönetimi ve 3.10 Git ile güvenli çalışmak sayfalarında anlatılanların üstüne kuruludur. Orada /context, /compact, /clear, /resume ve /rewind menüsünün temelini gördün; burada onları uzun işte nasıl birlikte kullanacağını görürsün.
Dokümanın temel gerekçesi şudur: Claude'un bağlam penceresi hızla dolar ve doldukça performans düşer. Pencerede konuşmanın tamamı, okunan her dosya ve her komut çıktısı durur. Uzun oturum yönetimi büyük ölçüde bu pencereyi temiz tutma işidir.
Planı oku, düzelt, sonra onayla
Plan modunda Claude kaynak dosyalarını düzenlemeden araştırır, neyin değişeceğini bulur ve gözden geçirmen için bir plan sunar. Plan modunu 3.6 ve 3.7 sayfalarında tanıdın. Uzun işte asıl ders şudur: planı gerçekten oku, göz gezdirmekle yetinme. Plan ne kadar kapsamlıysa yürütme sırasında o kadar az sürprizle karşılaşırsın. Eksik ya da yanlış bir yer varsa Claude'dan istediğin yere eklemesini iste. Planı yinelemek, Claude'u koşturup arkasından dağınıklığı toplamaktan çok daha hızlıdır.
Dokümana göre plan hazır olunca Claude nasıl devam edeceğini sorar. Seçenekler şunlardır:
| Seçenek | Ne olur |
|---|---|
| Yes, and use auto mode | Planı onaylar ve auto modda başlar. Auto modu oturumun kullanamıyorsa bu seçenek "Yes, auto-accept edits" diye görünür. |
| Yes, manually approve edits | Planı onaylar, her düzenlemeyi tek tek sen onaylarsın. |
| No, keep planning | Plan modunda kalır, Claude'a neyi değiştireceğini söylersin. |
Planı doğrudan düzenlemek istersen Ctrl+G ile planı varsayılan metin düzenleyicinde açabilirsin. Doküman, kapsamı net ve değişikliği tek cümleyle anlatılabilir küçük işlerde planı atlamanı, planlamanın asıl değerini birden çok dosyayı değiştiren, yaklaşımdan emin olmadığın ya da kodu tanımadığın işlerde gösterdiğini söylüyor.
Yönlendirme araçları
| Durum | Araç | Not |
|---|---|---|
| Claude yanlış yöne gidiyor, hemen durdur | Esc | Bağlam korunur, yön değiştirebilirsin. |
| Claude çalışırken ek bir şey söyleyeceksin | Mesajı yaz ve Enter'a bas | Mesaj kuyruğa girir, turu kesmez. Claude araç çağrılarını bitirince aynı turda ona iletilir. |
| Bağlam doluyor, işe devam edeceksin | /compact [talimat] | Talimat özetin neyi tutacağını belirler. |
| Yalnız bir bölümü sıkıştırmak istiyorsun | /rewind, sonra Summarize seçeneği | Özetleme dosyalara dokunmaz. |
| Claude yanlış yola girip kod değiştirdi | /rewind | Kontrol noktasına dönersin. |
| Yeni, ilgisiz bir işe geçiyorsun | /clear | Bağlamı sıfırlar. |
Sıkıştırmayı yönlendir
Sıkıştırma (compact), konuşmayı özetler, özeti yeni bağlam yapar ve eski mesajları siler. Risk, önemli bir şeyin özetten düşmesi ve Claude'un yoldan sapmasıdır. Bu yüzden komutu tek başına yazma; yanına nasıl özetleyeceğini ekle. Yazdığın her şey özetin neyi tutacağını biçimlendirir. Örneğin hata ayıklamayı bitirdin ve artık yalnız API değişiklikleriyle ilgileniyorsan bunu söylersin (aşağıdaki komut bloğu).
Dokümana göre iki şey daha yardım eder. Birincisi, CLAUDE.md içine "sıkıştırırken değiştirilen dosyaların tam listesini ve test komutlarını her zaman koru" gibi bir talimat yazabilirsin. İkincisi, otomatik sıkıştırma bağlam sınırına yaklaşınca zaten kendiliğinden çalışır; elle yaptığında kontrol sende olur.
Rewind ile hem geri dön hem özetle
Rewind menüsünü /rewind ile ya da boş istemde Esc'e iki kez basarak açarsın. Menüdeki seçenekler: Restore code and conversation, Restore conversation, Restore code, Summarize from here, Summarize up to here, Never mind. Kod geri alma seçenekleri yalnız seçtiğin noktadan sonra izlenen dosya değişikliği varsa görünür. Her turu başlatan istem bir kontrol noktası oluşturur.
Uzun işte iki özetleme seçeneği işe yarar. Summarize from here, seçtiğin noktadan sonrasını sıkıştırır: yan bir konuşma yaptıysan ve yer açmak istiyorsan uygundur. Summarize up to here, noktadan öncesini sıkıştırır: uzun bir hazırlık aşamasını küçültürken uygulama kısmını olduğu gibi tutmak istediğinde uygundur. Dokümana göre özetleme dosyaları değiştirmez ve özgün mesajlar oturum kaydında kalır. Özetin neye odaklanacağını da yönlendirebilirsin: ok tuşlarıyla bir Summarize satırını seç, "add context (optional)" yazan yere talimatını yaz ve Enter'a bas. Satırı numara tuşuyla seçersen talimat sormadan hemen özetler.
Rewind'ın sınırlarını 3.10 sayfasında gördün: kabuk komutlarıyla yapılan değişiklikler, alt ajan düzenlemeleri ve Claude Code dışındaki değişiklikler izlenmez. Doküman kontrol noktalarını "hızlı oturum içi kurtarma" olarak tanımlıyor ve kalıcı geçmiş için git kullanmanı söylüyor.
Farklı bir yaklaşımı denerken özgün oturumu bozulmadan tutmak istersen /branch ya da claude --continue --fork-session kullanılır; doküman bunu özetlemeden ayırıyor.
İki düzeltmeden sonra sıfırla
Doküman net bir kural veriyor: aynı sorunu aynı oturumda ikiden fazla düzeltmek zorunda kaldıysan bağlam başarısız denemelerle kirlenmiştir. /clear ile temiz başla ve öğrendiklerini içeren, daha belirgin bir istem yaz. Temiz bir oturum ve daha iyi bir istem, birikmiş düzeltmelerle dolu uzun bir oturumdan hemen hemen her zaman daha iyi sonuç verir. Aynı mantıkla, ilgisiz işleri aynı oturumda karıştırmak ("her şeyin girdiği oturum") bağlamı gereksiz bilgiyle doldurur; işler arasında /clear yaz.
Büyük bir özellikte bir başka yol: dokümana göre önce Claude'a seni röportaj yaptırıp bir spesifikasyon dosyası yazdır, sonra yeni bir oturumda o dosyayla uygula. Yeni oturumun bağlamı yalnız uygulamaya odaklıdır ve elinde başvuracağın yazılı bir spesifikasyon olur.
Elleri çekmek: /goal ve /loop
Buraya kadar her şey elinin işin başında olduğunu varsayar. Daha özerk çalışmak istiyorsan iki araç var.
/goal: "bitti"nin tanımını ver
/goal bir tamamlanma koşulu koyar. Claude, hızlı bir değerlendirici model koşulun sağlandığını doğrulayana kadar turdan tura çalışmaya devam eder; ilk "bitti sandığı" yerde durmaz. Doküman, /goal'ın oturum kapsamlı bir "Stop hook" üstüne kurulu olduğunu söylüyor (hook'ları 4.4 sayfasında gördün). Yani her tur bittiğinde koşul yeniden kontrol edilir.
Önemli bir sınır: değerlendirici komut çalıştırmaz ve dosya okumaz, yalnız konuşma kaydını okur. Bu yüzden koşul, Claude'un kendi çıktısıyla kanıtlanabilir olmalı; örneğin test çalıştırmasının sonucu. Dokümana göre iyi bir koşulun şunları vardır: ölçülebilir tek bir bitiş durumu, bunun nasıl kanıtlanacağının belirtilmesi (ör. testlerin başarıyla bitmesi) ve yol boyunca değişmemesi gereken kısıtlar (ör. başka test dosyasına dokunulmaması). İşin ne kadar süreceğini sınırlamak için koşula "ya da şu kadar tur sonra dur" tarzı bir cümle ekleyebilirsin.
/goal izin modunu değiştirmez. Dokümana göre goal turlarının gözetimsiz çalışması için /goal'ı auto modda çalıştır; Manual modda Claude ayarlarının izin vermediği araç çağrılarından önce yine sorar. Auto mod araç çağrılarını tek tur içinde onaylar ama yeni tur başlatmaz; /goal ise ayrı bir değerlendiriciyle her tur sonunu kontrol eder. İkisi birbirini tamamlar.
Durumu görmek için argümansız /goal yaz, iptal etmek için /goal clear. Doküman stop, off, reset, none ve cancel sözcüklerinin clear yerine kabul edildiğini, /clear ile yeni konuşma başlatmanın da etkin goal'ı sildiğini söylüyor. Kimlik doğrulama hatası ya da bitmiş kredi bakiyesi gibi senin düzeltmen gereken bir hatada goal kendiliğinden temizlenir ve düzelttikten sonra /goal'ı yeniden vermen gerekir.
/loop: aralıkla yinele
/loop bir istemi, turlar arasında sabit ya da kendi kendine ayarlanan bir aralıkla çalıştırır. Dışarıdaki bir şeyi, örneğin bir CI çalışmasını ya da bir dağıtımı izleyip durum değişince harekete geçmek için kullanılır. Süre vermezsen Claude her turdan sonra bekleme süresini kendi seçer. Kendi ayarlı bir döngüyü beklerken durdurmak için Esc'e bas. Sabit aralıklı döngü sen iptal edene kadar çalışır; ayrıca dokümandaki bir süre sonunda kendiliğinden biter (süre için dokümana bak).
Üç aracı karıştırma: /goal "koşul sağlanana kadar" çalıştırır, /loop "zaman aralığı dolunca" çalıştırır, Stop hook ise tur biter bitmez senin yazdığın bir betik ya da istemle karar verir. Oturumdan bağımsız, laptop kapalıyken de çalışacak işler için 4.7 sayfasına bak.
Paralel iş
Aynı kod tabanında birden çok Claude oturumu çalıştırıyorsan aynı dosyaları ezmemeleri için her birine ayrı bir dosya ağacı (worktree) verirsin. Kurs, kök dizindeki .worktreeinclude dosyasının her çalışma ağacına kopyalanacak git tarafından yok sayılan dosyaları (ör. bir ortam değişkenleri dosyası) listelediğini söylüyor. Ayrıntısı 4.10 sayfasında.
Adım adım
- Büyük işi planla.
Shift+Tabile plan moduna geç (durum çubuğunda⏸ plan mode onyazar) ve işi tarif et. Beklenen sonuç: Claude kod dosyalarını değiştirmeden araştırır ve bir plan sunar. - Planı gerçekten oku. Planı baştan sona oku, eksik ya da yanlış yeri bul. İstersen
Ctrl+Gile planı düzenleyicide aç. Beklenen sonuç: eksiklerin Claude'a söylenmiş, plan güncellenmiş olur. - Onay seçeneğini bilerek seç. İlk uzun işte Yes, manually approve edits; planın yönüne güvendiğin işte Yes, and use auto mode. Beklenen sonuç: Claude seçtiğin izin moduyla uygulamaya başlar.
- Bitiş koşulunu yaz. İşin "bitti" halini kanıtlanabilir bir cümleyle tarif ediyorsan
/goalver (aşağıdaki hazır prompt). Beklenen sonuç:◎ /goal activegöstergesi görünür ve Claude turdan tura devam eder. - Gerektiğinde araya gir. Yanlış yöne giderse
Esc. Ek bir şey söyleyeceksen yaz veEnter'a bas. Beklenen sonuç: mesajın kuyruğa girer, turun kesilmeden Claude'a ulaşır. - Bağlam dolarken sıkıştırmayı yönlendir.
/compact'a neyi koruması gerektiğini ekle. Beklenen sonuç: özet, yazdığın odağı tutar. - Yanlış yola girdiyse geri dön.
/rewindaç, doğru noktayı seç ve Restore code, Restore conversation ya da ikisini birden seç. Beklenen sonuç: dosyalar ve ya konuşma o noktaya döner. Kabuk komutları ve alt ajan düzenlemeleri için git'e dön. - İki düzeltmeden sonra bırak. Aynı hatayı ikiden fazla düzelttiysen
/clearyaz ve öğrendiklerinle daha net bir istem ver. Beklenen sonuç: temiz bağlamda yeni başlangıç. - Dışarıdan bir şey bekliyorsan döngü kur. CI ya da dağıtım için
/loopkullan. Beklenen sonuç: Claude aralıkla durumu kontrol eder, değişince harekete geçer.
Sıkıştırmayı yönlendirmek (kurs örneği, kurgusal bir proje):
/compact Focus on the --version flag implementation
Bitiş koşulu koymak (kurs örneğine benzer, yer tutuculu):
/goal all tests in src/billing pass, and the type checker reports zero errors
Goal'ı iptal etmek için:
/goal clear
Bir dağıtımı ya da CI'yı izlemek için (dokümandaki örnek):
/loop 5m check if the deployment finished and tell me what happened
Belirli bir izin modunda ve plan modunda başlamak için:
claude --permission-mode plan
Hazır prompt
Plan sunulduktan sonra, kapsamı sıkılaştırmak için:
Planı okudum. Şunları değiştir: [eksik ya da yanlış kısım]. Planda ayrıca şu iki şeyi açıkça belirt: hangi dosyalara dokunmayacaksın ve işin bittiğini hangi komutun çıktısıyla kanıtlayacaksın. Planı güncelle, henüz uygulamaya geçme.
/goal için koşul yazarken (kendi işine göre doldur):
/goal [tek bir ölçülebilir bitiş durumu, ör. "src/[klasör] altındaki testler geçiyor"]. Kanıt: [çalıştırılacak komut] çıktısı bana gösterilmiş olsun. Kısıt: [değişmemesi gereken şey, ör. başka test dosyasına dokunulmasın]. Ya da [kaç] tur sonunda dur ve nerede kaldığını raporla.
Sık yapılan hata
- Çıplak
/compactyazmak. Özette önemli bir şey düşebilir ve Claude yoldan sapar. Komutun yanına neyi korumasını istediğini yaz. - Planı okumadan onaylamak. Hatalı bir plan, uzun bir koşunun sonunda pahalı bir dağınıklığa dönüşür. Planı yinelemek, koşuyu toparlamaktan hızlıdır.
- Kanıtlanamayan bir goal koşulu yazmak. Değerlendirici yalnız konuşma kaydını okur. "Kod temiz olsun" gibi bir koşulu Claude'un çıktısı kanıtlayamaz; "komut X sıfır hatayla biter" gibi yaz.
- Rewind'ı git sanmak. Kontrol noktaları yalnız Claude'un dosya düzenleme araçlarıyla yaptığı değişiklikleri izler. Önemli bir uzun işe başlamadan önce git ile kayıt altına al.
- Aynı düzeltmeyi tekrar tekrar söylemek. Bağlam başarısız denemelerle dolar. İkiden sonra
/clearve daha net istem. - Goal ile gözetimsiz çalışırken izin modunu unutmak. Manual modda Claude hâlâ onay ister ve gece boyunca takılıp kalır. İzin modlarını 3.7 sayfasında gördün; doğrulamayı da 4.6 sayfasında ele alıyoruz.
Claude'un bu araçlar ve komutlar hakkında verdiği ayrıntılar sürüme göre değişebilir. Emin olmadığın bir komutta Claude'dan kaynağını iste, sonra resmî dokümandan kendin doğrula.
Video
Video: yakında.
Kaynak
- Anthropic Academy, Claude Code in action: Steering long sessions (planı oku, yönlendirmeli compact, rewind menüsü, goal, loop, worktree)
- Claude Code dokümanı: Best practices (bağlam kısıtı, erken düzeltme, iki düzeltme kuralı,
/compacttalimatı, röportajla spesifikasyon, kitchen sink oturumu) - Claude Code dokümanı: Checkpointing (rewind menüsü, Summarize seçenekleri, özeti yönlendirme, sınırlar)
- Claude Code dokümanı: Choose a permission mode (plan modu, planı onaylama seçenekleri,
Ctrl+G) - Claude Code dokümanı: Keep Claude working toward a goal (
/goalkoşulu, değerlendirici, iptal, hatalar, auto mod ilişkisi) - Claude Code dokümanı: Run prompts on a schedule (
/loop, sabit ve kendi ayarlı aralık, durdurma, kendiliğinden bitiş) - Claude Code dokümanı: Interactive mode (
Esc, çiftEsc, çalışırken mesaj kuyruğa alma) - Claude Code dokümanı: Run parallel sessions with worktrees (
.worktreeinclude)
Son doğrulama: 2026-10-21