Claude Code oturumları: devam et, temizle ya da baştan başla

Akşam terminali kapatırsınız ve ajanla yaptığınız konuşmanın pencereyle birlikte gittiği hissine kapılırsınız. Bir saatlik tartışma, bulduğunuz hatalar, anlattığınız görev bağlamı - bütün bunlar sanki yok oluyor.

Yok olmuyor. Konuşma siz çalışırken kendiliğinden diske yazılır ve tek bir komutla geri açılır.

Oturumları bir otel gibi düşünmek en kolayı. Proje klasörü bina, her konuşma bir oda, bütün odaların anahtarları ise resepsiyonun arkasındaki panoda asılı. Akşam ayrılırsınız ama odayı yakıp gitmezsiniz: anahtar panoya geri döner, eşyalar içeride kalır. Sabah resepsiyoniste hangi odayı istediğinizi söylemeniz yeter.

Benzetmenin bir sınırı var ve onu hemen çizmekte fayda var: odalarda konuşmalar yaşar, kod değil. Kod binanın kendisi, bütün konuklar için tek.

Aşağıda oturumun ne olduğunu, ona geri dönmenin üç yolunu, bir konuşmanın neden isme ihtiyaç duyduğunu ve yeni bir görev için eskisini sürdürmek yerine neden yeni bir konuşma açmanın daha iyi olduğunu bulacaksınız.

Oturum nedir

Oturum, ajanla yapılan ve proje klasörüne bağlı, kaydedilmiş bir konuşmadır. Siz çalışırken sürekli diske yazılır: bir metin editöründe olduğu gibi ayrıca kaydetmeye gerek yoktur.

Oturuma yalnızca söylenenler girmez. Sizin mesajlarınızın ve ajanın cevaplarının yanında araç çağrıları ve sonuçları da orada durur: hangi dosyaları açtığı, çalıştırılan komutların ne döndürdüğü, hangi düzenlemeleri uyguladığı. Bu yüzden eski bir konuşmaya döndüğünüzde elinize bir özet değil, resmin tamamı geçer.

Şimdi kafa karışıklığının yarısını çözen iki not.

Bir konuşmanın içeriği başka birine geçmez. Bir ay önce başka bir oturumda bir şey konuştuysanız, proje aynı olsa bile bu konuşmada ondan iz yoktur. Her oturum yalnızca kendi geçmişini bilir.

Oturum, kodun durduğu ikinci bir yer değildir. Proje dosyaları kendi başlarına diskte yaşar. Bir proje onlarca oturumla gayet iyi geçinir ve hepsi aynı kodu paylaşır - o an klasörde ne varsa onu.

Şemada iki fikir birden görülür: klasör tek, içindeki oturum sayısı birden fazla, her biri kendi geçmişini tutar, altta ise dosyalar ortak. Aynı proje için ikinci bir oturum açmak kodun kopyasını çıkarmaz, sadece onun hakkında bir konuşma daha ekler.

İşe nasıl geri dönülür

Üç giriş yolu var, aralarındaki seçim ise tam olarak hangi konuşmaya ihtiyacınız olduğunu hatırlayıp hatırlamadığınıza bağlı.

Tabloda bir şeyi fark etmemek kolay: üstteki iki satır claude ile başlıyor, alttaki ise eğik çizgiyle. Fark kozmetik değil. Üsttekiler ajan henüz ekranda yokken terminale yazılır - bayrak orada başlatma komutunun bir parçasıdır. Yani tek bir eylemle hem ajanı başlatırsınız hem de ona hangi konuşmayı açacağını söylersiniz:

claude              # temiz bir sayfayla başlat
claude --continue   # doğrudan dünkü konuşmaya başlat
claude --resume     # listeden konuşma seçerek başlat

/resume tam tersi yönde, içeriden çalışır: ajan zaten açık, siz onun giriş satırına yazarsınız ve terminale dönmeden başka bir konuşmaya geçersiniz.

Pratikteki fark basit. claude --continue, "dün burada çalışıyordum, devam etmek istiyorum" demektir: ajan sessizce mevcut klasördeki son konuşmayı açar. claude --resume ise "birkaç konuşma var, seçmeme izin ver" demektir.

Liste her konuşma için bir satır gösterir: adını verdiyseniz onu, yoksa otomatik bir başlığı, son etkinlikten bu yana geçen süreyi, dalı ve boyutu. Satır çoksa aramaya yazmaya başlamanız yeter, listeyi mevcut klasörün dışına da genişletebilirsiniz: Ctrl+A bu makinedeki tüm projelerin konuşmalarını gösterir.

Konuşmayla birlikte içindeki her şey de geri döner: araç çağrıları ve sonuçları dahil tüm geçmiş. Kullanılabilirliği ve ayarları değişmediyse model de genellikle korunur. Tam olarak bıraktığınız yerden devam edebilirsiniz.

Oturuma isim neden gerekir

Tek bir konuşma varken isme gerek yok. Üç tane olur olmaz liste bir bilmeceye dönüşür: ikisi aynı şekilde başlar, üçüncüsü ise neyle ilgili olduğu hiç belli değildir.

İsim vermenin iki yolu var:

claude -n feedback-form   # başlatırken
/rename feedback-form     # zaten açık bir oturumda

İsim vermezseniz Claude Code ilk mesajınızdan kısa bir başlık uydurur. O da bir referans noktası olarak işe yarar: sayesinde oturum listede görünür ve açılabilir. Sadece kendi isminiz daha kesindir - otomatik başlık ilk cümlenizi tarif eder, görevin tamamını değil.

Açıkçası, bir konuşmanın başında isim uydurulması nadirdir: onun neye dönüşeceğini henüz bilmiyorsunuzdur. Oturumların yarısı "tek bir satıra bakayım" diye başlar ve bir kısmı beklenmedik şekilde yarım günlük bir işe dönüşür.

Bu yüzden şöyle yapmak daha basit. Kısa bir uğrağı olduğu gibi bırakın, otomatik başlık yeter. Uzun süreceğini fark ettiniz mi - /rename ile yolda. Bitirdiniz mi - /clear'ı isimle: görev zaten geride kaldı ve ona ne ad vereceğiniz artık bir soru değil.

Yeni görev - yeni konuşma

İş boyunca sormaya devam edeceğiniz tek bir soru var: bu hâlâ aynı görev mi? Aynıysa devam edersiniz. Değiştiyse temiz bir sayfa açarsınız. Kulağa bir formalite gibi geliyor, ama konuşmaların en sık kargaşaya dönüştüğü yer tam olarak burası.

Cazibe anlaşılır: ajan projeyi zaten biliyor, neden baştan başlayasınız. Ama üst üste üç görevin yığıldığı bir konuşma, tahmin edilebilir şekilde kötü davranır:

• eski görevden aldığı kararları yeniye taşır. Bir saat önce bir yöntemde anlaştınız, şimdi başka bir şey yapıyorsunuz - o ise ilk anlaşmayı hatırlıyor ve ona geri dönüyor;
• zaten reddettiğiniz fikirler yeniden yüzeye çıkar. Başka bir görevde reddettiniz, ama onun için hepsi tek bir akış;
• bu arada önceki işe ait olan şeyleri de düzeltir. Formu istediniz, üstüne ödeme kodunda da değişiklik almış oldunuz;
• değişiklikler birbirine karışır. Tek bir konuşmada iki konuya dair düzeltmeler olur ve sonra hangisinin neye ait olduğunu ayırmak zorlaşır;
• konuşma listede bulunamaz. Her şey hakkında olduğu için aslında hiçbir şey hakkında değildir.

Buradan basit bir kural çıkar: bir konuşma tam olarak bir göreve yardımcı olduğu kadar yaşar. Görev bittiğinde o da biter. Oturum burada özenle saklanan bir şey değil, sarf malzemesidir.

Temiz bir sayfayı iki yoldan başlatabilirsiniz, aralarındaki fark göründüğünden küçüktür.

Şimdi /clear hakkında, çünkü insanlar en çok burada ürküyor. Komut bir silme gibi görünür ama bir geçiş gibi çalışır: konuşmayı silmez, kenara ayırıp boş bir tane açar. Kenara ayrılan konuşma listede kalır ve /resume ile tam olarak bıraktığınız gibi açılır.

İsteğe bağlı bir argümanı var - isim. /clear feedback-form, sonra tanıyabilmeniz için listedeki ayrılan konuşmayı etiketler. Bir saniyelik iş, ama sonradan aramak fark edilir derecede kolaylaşır.

Bir de madalyonun öbür yüzü var. Konuşma zaten adlandırıldıysa - başlangıçta -n ile ya da yolda /rename ile - argümansız /clear bu ismi yeni konuşmaya devreder ve bir sonraki görev öncekinin ismiyle etiketlenmiş olur. Argümanla isim eski konuşmada kalır, yenisi isimsiz başlar.

Üst satıra bakın. Bu başlatmada aktif konuşma komuttan önce de sonra da tek. /clear ilkinin yanına ikinci bir oturum açmaz: aktif konuşmayı temiz bir taneyle değiştirir ve öncekini aşağıya, listeye taşır. Ona yeniden dönmek ancak bilinçli bir adımla olur, /resume üzerinden.

Yeni oturum, /clear'dan şu yönüyle ayrılır: genellikle farklı bir iş de anlamına gelir - başka proje, başka klasör, başka gün. /clear ise sizi ne mevcut dizinden ne de mevcut başlatmadan çıkarır - durduğunuz yerde temiz bir sayfa açar.

Bir de /compact var. Bu komut görev değişikliğiyle değil, konuşmanın uzunluğuyla ilgilidir: şimdiye kadar söylenenleri kısa bir özete sıkıştırır ve sizi aynı oturumda bırakır. Onu bağlam penceresinin nasıl çalıştığı ve bittiğinde ne olduğuyla birlikte ele almak daha uygun - bu ayrı bir konu.

Bunların hepsi nerede duruyor ve ne kadar saklanıyor

Konuşmalar kendi diskinizde, Claude Code'un hizmet klasöründe durur:

~/.claude-codegym/projects/

~ işareti kullanıcının ev klasörü anlamına gelir. Windows'ta buna %USERPROFILE% karşılık gelir, bu yüzden kurs yolu %USERPROFILE%\.claude-codegym\projects\ ile başlar.

.claude-codegym kurs profilidir. Claude Code onsuz çalıştırılırsa standart yol şöyle görünür: ~/.claude/projects/. İçinde her proje için bir alt klasör, onun içinde de her konuşma için bir ana dosya vardır.

Konuşmalar sonsuza kadar saklanmaz: yaklaşık bir ay sonra eskileri, onlara ait geri dönüş noktalarıyla birlikte otomatik olarak temizlenir, süre isteğe göre ayarlanabilir. Yani oturum bir görev üzerinde çalışmak için iyi, projenin uzun vadeli geçmişi için ise kötü bir yerdir. Geçmişin uzun süre nasıl saklandığı ayrı ve büyük bir konu.

Bu, işinizde neyi değiştirir

Yarın işinize yarayacak birkaç sonuç:

• oturum tek bir görevin kabıdır, ajanla ömür boyu süren bir yazışma değil. Onu buna ne kadar yakın tutarsanız, ajan o kadar az karışır;
• konuşma kendiliğinden kaydedilir, özellikle kaydetmeye gerek yoktur. Akşam kapatılan bir terminalin bedeli yoktur;
• oturumlar klasörlere göre dağıtılmıştır. Ajanı proje klasöründen başlattınız mı, konuşmaları elinizin altındadır; liste boşsa klasörü kontrol edin: Ctrl+A tüm projelerin konuşmalarını gösterir ve nereye gitmeniz gerektiğini söyler;
• eski bir konuşmaya döndüğünüzde çıkmaz sokaklar ve bir kenara bırakılmış fikirler dahil bütün bağlamı geri getirirsiniz. Bazen üç saatlik bir tartışmayı canlandırmaktansa baştan başlamak daha hızlıdır;
• tek bir klasörde onlarca oturum olması normal bir çalışma tablosudur, düzensizlik işareti değil.

Oturum dosyalarının konumu, listenin içeriği ve saklama süresi Claude Code sürümüne ve ayarlara bağlıdır, bu yüzden sizde burada anlatılandan farklı olabilir.