Claude Code oturumuna devam etme ve geçmişi bulma
Claude Code oturumlarını --continue veya --resume komutlarıyla nasıl geri yükleyeceğinizi öğrenin. Yerel makinenizde saklanan düz metin konuşma dökümlerine erişin.
Claude Code oturumu nasıl devam ettirilir
Bir Claude Code oturumuna devam etmek için, mevcut dizindeki en son konuşmayı açmak üzere claude --continue komutunu veya listeden eski bir oturumu seçmek için claude --resume komutunu çalıştırın. Hâlihazırda çalışan bir oturumun içindeyken, /resume komutu oturumu sonlandırmadan farklı bir konuşmaya geçiş yapmanızı sağlar. Bu komutların kısa biçimleri -c ve -r şeklindedir.
claude --continue
claude --resume
claude --resume auth-refactorOturum adını veya kimlik numarasını (ID) zaten biliyorsanız, bunu bir argüman olarak iletin; Claude Code seçim ekranını göstermeden doğrudan ilgili oturuma gider.
Aşağıdaki tüm bilgiler, Kasım 2026 itibarıyla resmi oturum belgeleri ile uyumludur. Claude Code sık güncellenen bir yazılımdır; bayrak isimleri ve klavye kısayolları sürümler arasında değişebilir. Bu nedenle, buradaki bilgiler terminalinizdeki çıktılarla uyuşmadığında claude --help komutunu ve ilgili sayfayı temel kaynak olarak kabul edin.
Oturumun gerçekte ne olduğu
Oturum, bir proje dizinine bağlı olarak kaydedilmiş tek bir konuşmadır. Claude tarafından yapılan araç çağrılarını ve bu çağrıların döndürdüğü sonuçları içeren tüm mesaj geçmişini tutar. Claude Code, bunu siz çalışırken tek seferde değil, sürekli olarak diske yazar; bu sayede terminali kapatsanız veya SSH bağlantısını kaybetseniz bile konuşma varlığını sürdürür.
Oturumu devam ettirmek, sadece metni geri getirmez. Konuşma geçmişi, oturumun kullandığı model ve eğer kullandıysanız --agent ile başlatılan alt temsilci (subagent) ile birlikte eksiksiz olarak geri yüklenir. İzin modu da --continue veya bir oturum kimliği ile kabuk üzerinden devam ettiğinizde geri gelir; ancak güvenlik nedeniyle bir istisna mevcuttur: bypass-permissions modu asla geri yüklenmez, bu nedenle bu modda biten bir oturum, yeni bir oturumun başlayacağı modda devam eder. Plan modu, oturumu seçiciden (picker) seçtiğinizde veya /resume ile ona geçtiğinizde geri yüklenir; bu iki yöntem normalde kayıtlı bir modu taşımaz. Terminal üzerinden devam etme işlemleri v2.1.290 sürümünden, seçici ve /resume ise v2.1.292 sürümünden beri plan modunu geri yüklemektedir; daha eski sürümler devam ettirme sırasında plan modunu devre dışı bırakıyordu. Kabuk üzerinden, --permission-mode geri gelen mod ne olursa olsun onu geçersiz kılar.
Bazı öğeler geri gelmez, çünkü bunlar kaydedilmiş durumdan ziyade başlatma zamanı bayraklarıdır. --add-dir ile eklenen dizinler ve --mcp-config, --settings ve --plugin-dir gibi seçenekler, devam ettirme sırasında tekrar belirtilmelidir. settings.json gibi ayar dosyaları başlatma sırasında yeniden okunur, bu nedenle bunların içinde yer alan hiçbir şeyin tekrarlanmasına gerek yoktur. Kimlik bilgileri de aynı kategoriye girer: Claude Code, oturumla birlikte geri yüklemek yerine, giriş bilgilerinizden ve ortamınızdan yola çıkarak başlatma sırasında nasıl kimlik doğrulaması yapacağını belirler. Bu nedenle, kabuğa yanlışlıkla bir ANTHROPIC_API_KEY sızmış bir VPS üzerinde devam ettirilen bir oturum, geçen sefer sorunsuz çalışmış olsa bile geçersiz API anahtarı hatası verecektir.
Oturum geçmişi bir VPS üzerinde neden daha önemlidir
İnsanları şaşırtan gerçek şudur: Transkript, aracın çalıştırıldığı makineye yazılır. Hesabınızda tutulmaz ve bulutla senkronize edilmez. O kutunun diskindeki bir dosyadır.
Bu nedenle, VPS'nizdeki bir tmux penceresinde bıraktığınız oturum dizüstü bilgisayarınızdaki seçicide görünmez; dizüstü bilgisayarınızdaki bir oturum da VPS'de görünmez. Aralarında hiçbir veri aktarılmaz. Çoğu insanın Claude Code'u bir VPS üzerinde tmux içinde çalıştırırken yaptığı gibi çalışıyorsanız, sunucu gerçek konuşma geçmişinizin biriktiği yerdir ve yerel olarak gördüğünüz seçici çok daha küçük ve farklı bir küme gösterir.
Aynı ayrım arayüzler arasında da geçerlidir. Masaüstü uygulaması ve VS Code eklentisi kendi oturum geçmişlerini tutar ve masaüstü uygulaması bir CLI oturumunu devam ettirebilse de, hiçbiri CLI'ın geçmişi değildir. Web üzerindeki Claude Code da kendi geçmişini tutar. Cowork ise daha farklı bir konumdadır: Oturumları varsayılan olarak Anthropic bulutunda çalışır ve yerel dağıtımlar için tutulan yerel yürütme dışında, sahip olduğunuz donanım yerine Claude hesabınıza kaydedilir. Dolayısıyla, Cowork ile Claude Code'u karşılaştırıyorsanız, transkriptin nerede sonlandığı kararınızın bir parçasıdır.
Tek bir makine içinde arama beklediğinizden daha geniştir. claude --resume <session-id> önce mevcut proje dizinine ve git çalışma ağaçlarına, ardından o makinedeki diğer tüm projelere bakar. Aklınızda tutmanız gereken ifade "o makine üzerinde" ifadesidir. Başka bir ana bilgisayardan gelen bir oturum kimliği hiçbir sonuç vermez ve Claude Code bunu size No conversation found with session ID: <session-id> ile bildirir.
Claude Code oturum geçmişini nerede saklar
Varsayılan olarak transkriptler, Claude Code yapılandırma dizininiz altında, ~/.claude/projects/<project>/<session-id>.jsonl biçimindeki bir yolda tutulur.
<project>, çalışma dizini yolunuzdaki tüm alfanümerik olmayan karakterlerin tire işaretiyle değiştirilmiş halidir; dolayısıyla /home/deploy/apps/api içinde başlatılan bir oturum, -home-deploy-apps-api adlı bir dizin altında saklanır. Eğer bu dönüştürülmüş isim 200 karakteri aşarsa, Claude Code ismi kısaltır ve tam yolun bir hash değerini ekler; böylece dizin ismi dosya sistemi sınırları içinde kalır.
Dosya JSONL formatındadır: her satırda bir JSON nesnesi bulunur; her satır bir mesajı, bir araç kullanımını veya sonucunu, Claude Code'un modele gönderdiği bir isteğin kaydını ya da bir meta veri girişini temsil eder. Okunabilir bir metin dosyasıdır ve içeriğini incelemenizde bir sakınca yoktur.
Bu dosya üzerinde bir ayrıştırıcı (parser) yazılması önerilmez. Giriş formatı Claude Code'un iç yapısına aittir ve sürümler arasında değişiklik gösterebilir; bu nedenle dosyaları doğrudan okuyan bir betik, herhangi bir güncelleme sonrasında çalışmayabilir. Anthropic'in kendi belgeleri, tam da bu nedenle /export veya belgelenmiş betik arayüzlerinin kullanılmasını tavsiye eder.
İki ayar bu durumu değiştirir. CLAUDE_CONFIG_DIR, tüm yapılandırma dizininin yerini değiştirir; transkriptleri ayrı bir birime veya şifrelenmiş bir alana bu şekilde taşıyabilirsiniz. settings.json içindeki cleanupPeriodDays ayarı, kayıtların ne kadar süre tutulacağını kontrol eder; varsayılan değer 30 gündür ve minimum 1 gün olarak ayarlanabilir.
Bu transkript dosyalarının içinde aslında ne var
Her araç sonucu kaydedilir; bu da bir transkriptin, Claude'un okuduğu dosyaların içeriklerini ve çalıştırdığı komutların çıktılarını barındırdığı anlamına gelir. Anthropic'in veri kullanım sayfası, durumu açıkça belirtir: Claude Code, oturum transkriptlerini yerel olarak ~/.claude/projects/ dizininde düz metin formatında saklar. Transkript, Claude Code'un modele gönderdiği verileri de kaydettiği için sistem istemini, araç tanımlarını, istek parametrelerini ve yüklenen CLAUDE.md dosyalarını içerebilir.
Bunun bir sunucu üzerinde ne anlama geldiğini düşünün. Claude, bir servisin neden başlamadığını anlamak için bir .env dosyasını okuduysa, o dosyanın içeriği artık ev dizininizdeki bir JSONL dosyasının içinde duruyor demektir. Eğer bir komut bir bağlantı dizgisi yazdırdıysa, o dizgi de oradadır. Hiçbir şey sızmamıştır. Transkript, olan biteni kaydetmiştir; zaten amacı da budur ve tam da bu yüzden tehdit modelinizin bir parçası olmalıdır.
- Yedeklemeler:
/homeveya/rootdizinlerinin düz bir yedeği, transkriptlerinizi yedeklerin gittiği her yere kopyalar. Bir dışlama kuralı ekleyin ya da istemlerinizin ve dosya içeriklerinizin kopyalarının artık yedekleme deponuzda yaşadığını kabul edin. - Anlık görüntüler (snapshot) ve imajlar: Herhangi bir nedenle alınan bir VPS anlık görüntüsü, dizinin tamamını içerir. İkinci bir sunucu oluşturmak için klonladığınız bir imaj da aynı şekildedir.
- Sunucudaki diğer hesaplar: Erişim izinlerinin sıkı olduğunu varsaymak yerine
ls -ld ~/.claude ~/.claude/projectsile modları kendiniz kontrol edin. - Kasıtlı yüklemeler:
/feedbackkomutu, konuşma geçmişini bilerek Anthropic'e gönderir;/bugve/sharede aynı yol üzerinden raporlama yapar. Geri bildirim diyaloğu, yalnızca mevcut oturumu değil, aynı proje içindeki son 24 saat veya 7 güne ait diğer oturumları da içerebilir. Bunlar sizin yapmayı seçtiğiniz işlemlerdir, bu nedenle onay vermeden önce neyi kabul ettiğinizi bilin.
Eğer hiçbir transkriptin oluşmamasını tercih ederseniz, CLAUDE_CODE_SKIP_PROMPT_HISTORY transkript yazımını engeller, --no-session-persistence ise bunu etkileşimli olmayan tek bir claude -p çalıştırması için devre dışı bırakır. Her ikisini de ayarlamadan önce takasın ne olduğunu netleştirin. Transkriptler, resume komutunun okuduğu verilerdir; dolayısıyla transkript olmaması, devam ettirme (resume) özelliğinin çalışmaması anlamına gelir.
Eski bir konuşma nasıl bulunur
claude --resume ile veya devam eden bir oturumun içindeyken /resume ile seçiciyi açın. Her satır, eğer belirlediyseniz oturum adını, belirlemediyseniz oluşturulan bir başlığı, son etkinlikten bu yana geçen süreyi, git dalını ve dosya boyutunu gösterir.
Seçici arama yapar. Listeyi filtrelemek için / tuşuna basın veya doğrudan yazmaya başlayın. Öğrenmeye değer kısayollar, kapsamı genişletenlerdir: Ctrl+A bu makinedeki tüm projelerden oturumları gösterir, Ctrl+W mevcut deponun tüm çalışma ağaçlarını (worktree) gösterir ve Ctrl+B mevcut git dalına göre filtreleme yapar. Bir oturumu seçmeden önce içeriğini önizlemek için Space, vurgulanan oturumu yeniden adlandırmak için Ctrl+R tuşuna basın.
Oturumları adlandırmak tüm bu işlemleri çok daha kolaylaştırır. claude -n auth-refactor ile bir oturum başlatın veya konuşmanın gerçek bir işe dönüştüğünü fark ettiğiniz noktada /rename auth-refactor komutunu çalıştırın. Adlandırılmış bir oturum, doğrudan shell üzerinden ismiyle devam ettirilebilir.
Adlandırılmamış bir oturum yine de ilk isteminizi özetleyen küçük ve hızlı bir modele yapılan arka plan isteğiyle oluşturulmuş bir başlık alır. Bu başlık, seçicideki satırı tanımanıza yardımcı olur ve aynı zamanda bir devam ettirme etiketi olarak da çalışır: claude --resume, bunu kendi belirlediğiniz bir isimle aynı şekilde çözer. Çalışmayan şey, adlandırılmamış etkileşimli bir oturumun çalışan oturum listelerinde taşıdığı my-app-3f gibi varsayılan görünen isimdir. Bunu claude --resume komutuna parametre olarak verirseniz, Claude Code oturumu bulamaz.
Transkriptlerde arama yaparak doğru oturumu bulma
Bazen sadece bir ifadeyi hatırlarsınız ve başka hiçbir şey aklınızda kalmaz. Transkriptler metin tabanlıdır, bu nedenle arama yapabilirsiniz.
grep -rl "nftables" ~/.claude/projects/Bu komut, eşleşen transkriptlerin yollarını yazdırır. .jsonl uzantısı olmayan dosya adı oturum kimliğidir (session ID) ve claude --resume <session-id> bu kimliği kabul eder. claude --resume ayrıca transkriptin mutlak yolunu doğrudan kabul eder. Hangi oturumu istediğinizi belirlemek için grep kullanın, ardından oturumu devam ettirin veya okumak için dışa aktarın.
İki önemli uyarı mevcuttur. İçerik JSON-escaped formatındadır; bu nedenle tırnak işareti içeren veya satır sonu ile bölünmüş bir ifade, düz metin olarak eşleşmeyebilir. Ayrıca bir araç sonucundaki eşleşme, o metnin birisi tarafından yazıldığı anlamına gelmez; Claude'un o metni gördüğü anlamına gelir.
Sohbeti okuma ve dışa aktarma
/export, mevcut sohbeti JSON yerine mesajların ve araç çıktılarının okunabilir biçimde yazıldığı düz metin olarak oluşturur. Herhangi bir argüman verilmediğinde, panoya kopyalama veya bir dosyaya kaydetme seçeneklerini sunan bir menü açılır. Bir dosya adı belirtildiğinde, /export handover.txt doğrudan ilgili yola yazma işlemini gerçekleştirir. Bu yöntem, bir sohbeti sunucudan yerel bilgisayarınıza taşımak veya bir destek talebine eklemek için en doğru yoldur.
Otomasyon gerektiren işlemler için kararlı olması hedeflenen arayüzleri kullanın. Kancalar (hooks) ve durum satırı komutları girdi olarak bir transcript_path alanı alır; bu sayede bir SessionEnd kancası, oturum sona erdiğinde transkripti arşivleyebilir. Ayrıca kayıtlı bir oturumu açmadan da ona soru sorabilirsiniz:
claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'Bu komut, eski sohbetin devamı niteliğinde bir istem gönderir ve yapılandırılmış JSON çıktısı döndürür. Bu yöntem, sonraki sürümlerde değişebilecek bir JSONL formatını ayrıştırmaktan çok daha sağlam bir temel sağlar.
Sıfırdan başlamak, kaldığı yerden devam etmekten daha avantajlı olduğunda
Kaldığı yerden devam etmek tüm geçmişi geri getirir ve sonraki her istek bu geçmişin tamamını taşır. Dün dört saat süren bir konuşmayı bugün devam ettirmek maliyetlidir; uzun bir oturumda token kullanımının nasıl arttığı konusu, bu maliyetin gerçek kaynağını açıklar.
Claude Code bazen sizin için orta yolu seçer. Uzun bir konuşmayı etkileşimli bir terminal oturumunda boşta bırakırsanız ve konuşma bir saatlik prompt cache üzerindeyse (ki Claude aboneliği planınız dahilinde ana konuşmaya bunu varsayılan olarak sağlar), boşta sıkıştırma (idle compaction) işlemi, önbellek süresi dolmadan kısa bir süre önce, yaklaşık 54 dakika sonra devreye girer. Bu işlem, konuşma bağlamı bir token eşiğine (varsayılan olarak 200.000) ulaştığında, otomatik sıkıştırma açıkken ve makine o anda uyanıkken uygulanır. v2.1.314 sürümünden önce, Claude Code'un Anthropic'ten özellik bayraklarını (feature flags) çekmesi gerekiyordu; bu nedenle telemetrisi kapalı olan aboneler bu özellikten yararlanamıyordu. v2.1.314 sürümünden itibaren bu özellik onlar için de çalışmaktadır ve ayrıca VS Code eklentisinin sohbet panelinde ve masaüstü uygulamasının Code sekmesinde de mevcuttur. Herhangi bir onay diyaloğu çıkmaz. Geri döndüğünüzde konuşmada Compacted while idle, before the prompt cache expired ile başlayan bir satır görürsünüz ve bir sonraki mesajınız tüm geçmiş yerine bir özet gönderir.
- Özelliği açık bırakırsanız sonraki istekler daha ucuz olur, ancak özetin dışarıda bıraktığı bilgiler artık erişilebilir değildir.
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENSile eşiği düşürebilirsiniz, ancak 100.000'in altındaki değerler 100.000'e yükseltilir. - Özelliği kapatmak için
settings.jsondosyasındaidleCompactiondeğerinifalseolarak ayarlayın veya v2.1.302 ve sonraki sürümlerde/configiçindeki boşta sıkıştırma satırını kullanın. Bu durumda konuşma bütün kalır ve istek başına maliyet, konuşmanın boyutuna göre ölçeklenir. Bir sonraki mesajınızı gönderdiğinizde önbellek süresi dolmuşsa, o istek tüm geçmişi bir kez yeniden işler.
Pro ve Max planlarında v2.1.304 sürümü bir kontrol daha ekledi ve mevcut belgeler Ultra planlarını da listeliyor. Uzun bir aradan sonra veya farklı bir model üzerinde uzun bir konuşmaya devam ederken, 5 saatlik kullanım limitinizin önemli bir kısmını harcayacak bir durum oluşursa, bir Resume this conversation? diyaloğu tahmini kullanım oranını gösterir ve devam etmenize ya da yeni bir konuşma başlatmanıza olanak tanır. Yeni konuşma seçeneği belirtildiğinde, Claude önceki konuşmaya atıfta bulunursanız ona bakabilir.
Karar verme süreci göründüğünden daha basittir. Yazacağınız bir sonraki şey daha önce söylenenlere bağlıysa devam edin. Bağlı değilse sıfırdan başlayın. Sapma (drift), dikkat ettiğinizde kolayca fark edilir: Claude'un bir saat önce sildiğiniz bir dosyadan bahsetmesi veya oturumun başında karara bağladığınız bir konuyu yeniden tartışması gibi. Bu bayat bağlamdır ve onu taşımak size hem token maliyeti getirir hem de doğruluk kaybına yol açar.
Eski bir konuşmanın faydalı kısmı, tekrar ihtiyaç duyacağınız bir karar veya gerçekse, bunu taşımak için kaldığı yerden devam etmeye güvenmeyin. Bunu her oturumun görebileceği bir yere yazın; Claude Code'un bellek dosyaları tam olarak bunun içindir.
/branch komutunu da bilmekte fayda vardır. Konuşmayı mevcut noktaya kadar kopyalar ve sizi kopyanın içine aktarır; orijinali bozulmadan bırakır ve seçicide tutar. İlkini kaybetmeden ikinci bir yaklaşımı denemek için bunu kullanın.
Resume, compaction ve memory kavramlarının farkları
Bu kavramlar sürekli birbirine karıştırılmaktadır ancak her biri farklı sorunları çözmek için tasarlanmıştır.
Resume, uygulamadan çıktığınızda, sistemi yeniden başlattığınızda veya başka bir göreve geçtiğinizde bir konuşmaya kaldığınız yerden devam etmenizi sağlar. Compaction ise aktif bir konuşma içerisindeki bağlam penceresi (context window) ile ilgilidir: /compact, Claude'un taşıdığı veriyi bir özetle değiştirir; böylece sonraki istekler daha az token tüketir. Sorununuz bağlam penceresinin dolması ise, kullanmanız gereken araç compaction'dır ve Claude Code bağlam penceresini yönetme konusu bunu detaylıca açıklar.
Memory ise tamamen farklı bir yapıdır. CLAUDE.md dosyaları ve otomatik bellek (auto memory), her oturumun başında yüklenen talimatları ve gerçekleri tutar; dolayısıyla bunlar geri döndüğünüz bir konuşma geçmişi değildir. Bunlar, bir daha hiçbir konuşmaya geri dönmek zorunda kalmamanız için not aldığınız bilgilerdir.
Eğer aynı anda çalışan ve birbiriyle koordineli iki konuşma istiyorsanız, bu ayrı bir mekanizmadır. Claude Code oturumları birbirine mesaj gönderebilir; bu özellik her iki oturum da aktifken çalışır ve dünkü oturumu diskten geri çağırmaktan tamamen farklı bir sorunu çözer.
FAQ
Claude Code oturum geçmişimi nerede saklar?
Varsayılan olarak yapılandırma dizininizin altında, ~/.claude/projects/<project>/<session-id>.jsonl konumunda saklar; burada <project>, alfanümerik olmayan karakterlerin tire işaretiyle değiştirildiği çalışma dizini yoludur. Her dosya JSONL formatındadır: her satırda bir mesaj, bir araç kullanımı veya sonucu, modele gönderilen bir isteğin kaydı ya da bir meta veri girişi için tek bir JSON nesnesi bulunur. CLAUDE_CONFIG_DIR yapılandırma dizinini başka bir yere taşır ve settings.json içindeki cleanupPeriodDays, transkriptlerin ne kadar süre saklanacağını belirler; varsayılan değer 30 gün olup minimum 1 gündür.
Neden dizüstü bilgisayarımdaki seçicide VPS oturumumu göremiyorum?
Çünkü transkriptler, ajanın çalıştığı makinenin diskine yazılır ve makineler arasında herhangi bir senkronizasyon yapılmaz. VPS'nizdeki tmux içinde yaptığınız bir konuşma yalnızca o VPS üzerinde mevcuttur. Oturuma SSH üzerinden orada devam edin veya yerel bir kayıt istiyorsanız içinde /export komutunu çalıştırıp metin dosyasını kopyalayın.
Farklı bir dizinde başlattığım bir oturuma devam edebilir miyim?
Evet, oturum kimliğine (session ID) sahipseniz devam edebilirsiniz. claude --resume <session-id> önce mevcut proje dizinine ve git çalışma ağaçlarına (worktrees), ardından aynı makinedeki diğer tüm projelere bakar. Seçici içinde Ctrl+A listeyi makinedeki tüm projelere genişletir, Ctrl+W ise mevcut deponun tüm çalışma ağaçlarına genişletir. Hiçbir eşleşme bulunamazsa, Claude Code No conversation found with session ID: <session-id> hatasını bildirir.
Eski bir oturuma mı devam etmeliyim yoksa yeni bir tane mi başlatmalıyım?
Bir sonraki mesajınız, o konuşmada daha önce söylenenlere bağlıysa oturuma devam edin. Bağlı değilse yeni bir oturum başlatın; çünkü devam etmek tüm geçmişi yeniden yükler ve sonraki her istek bu geçmişi taşır. Sapmalara dikkat edin: sildiğiniz dosyalara sürekli atıfta bulunan bir oturum, güncelliğini yitirmiş bir bağlam taşıyordur ve bu bağlam her adımda size token maliyeti ve doğruluk kaybı olarak geri döner.
Claude Code'un diske transkript yazmasını engelleyebilir miyim?
Evet. CLAUDE_CODE_SKIP_PROMPT_HISTORY transkript yazımını engeller, --no-session-persistence ise tek bir etkileşimli olmayan claude -p çalıştırması için bunu devre dışı bırakır. Öncelikle bu işlemin sonucunu değerlendirin; çünkü transkriptler --continue ve --resume komutlarının okuduğu verilerdir, dolayısıyla bunları kapatmak yükleyecek hiçbir şeyin kalmaması anlamına gelir. Eğer endişeniz dosyaların varlığı değil de nerede durdukları ise, CLAUDE_CONFIG_DIR değerini şifreli bir birime yönlendirin ve cleanupPeriodDays değerini düşürün.