Claude Code scratchpad'ini nerede tutar ve neden kaybolur

Her Claude Code oturumu, muhtemelen göz ucuyla geçtiğiniz bir satırla başlar. Bizimki bu gece şöyle:

Scratchpad directory: /private/tmp/claude-501/-Users-jbchauvin-Projets-AgentsRoom/5a506305-…/scratchpad

Sonra CLI bir daha ondan hiç söz etmez. Hiçbir komut onu listelemez, hiçbir panel onu açmaz ve ajanın oraya yazdığını söylediği CSV'yi aramaya gittiğiniz gün klasör çoktan gitmiş olabilir.

Her gece bir Mac mini üzerinde zamanlanmış yedi ajan çalıştırıyoruz ve her biri o klasöre yazıyor. Biz de gidip bunun ne olduğuna, her sistemde nerede yaşadığına, onu neyin sildiğine ve ajanlara bu konuda ne söylediğimize baktık. Aşağıdaki her şey 19 Eylül 2026'da Claude Code 2.1.278 üzerinde ve orada iş kaybeden insanların açtığı GitHub issue'larında doğrulandı.

Claude Code ajana ne söylüyor

Bu satır sistem promptunun bir parçası. Mevcut sürümde onu izleyen talimat, ajanın geçici dosyalar için, yani projeye ait olmayan ara sonuçlar, betikler ve çıktılar için /tmp veya başka herhangi bir sistem geçici klasörü yerine her zaman o dizini kullanması gerektiğini, dizinin oturuma özel ve projeden yalıtılmış olduğunu, genellikle izin istemi olmadan kullanılabileceğini ve /tmp'nin yalnızca siz açıkça istediğinizde kullanılması gerektiğini söylüyor.

Sizin için işe yarayan kısım o son cümle. Scratchpad içine yazılan dosyalar yazma izni diyaloğunu tetiklemez; ajanın yardımcı betiklerini ve dışa aktarımlarını her seferinde size sormak yerine oraya koymasının nedeni bu. Nereye gittiklerinin size hiç sorulmamasının ve hiç söylenmemesinin nedeni de bu.

Çalışan bir oturumda yolu istiyorsanız ajana sorun. «Scratchpad dizinini yazdır» sorusu hiçbir şey çalıştırılmadan sistem promptundan yanıtlanır.

Yol, sistem sistem

Klasör işletim sisteminin geçici klasörünün altında durur ve adı sizin kim olduğunuzu, hangi projede olduğunuzu ve hangi oturum olduğunu kodlar.

macOS ve Linux'ta:

/tmp/claude-<uid>/<eğik çizgileri tireye çevrilmiş proje yolu>/<oturum id>/scratchpad

Mac'te /tmp, /private/tmp'ye bir bağlantıdır, dolayısıyla aynı klasör /private/tmp/claude-501/… olarak gösterilir. Sayı sizin kullanıcı kimliğiniz, id -u komutunun yazdırdığı şey: Mac'teki ilk hesap için 501, çoğu Linux dağıtımında 1000, root için 0. Aşağıda alıntıladığımız Linux raporu /tmp/claude-0/ gösteriyor, çünkü pipeline bir konteynerde root olarak çalışıyordu. 2026'nın başlarında açılan issue'lar hiç uid olmadan /tmp/claude/<proje slug>/… gösteriyor, yani son ek yol boyunca eklendi. Eski bir derlemedeyseniz onu atın.

Windows'ta, Temmuz 2026'da Windows 11 üzerinde bildirildiği gibi:

%TEMP%\claude\<proje slug>\<oturum id>\scratchpad

bu da genellikle C:\Users\<siz>\AppData\Local\Temp\claude\… olarak açılır. Yol TEMP değişkeninden türetilir, dolayısıyla TEMP'i başka bir yere yönlendirirseniz scratchpad onu izler.

Proje slug'ı, her eğik çizgisi tireye çevrilmiş çalışma dizininizdir. Depomuz /Users/jbchauvin/Projets/AgentsRoom altında yaşıyor, dolayısıyla slug -Users-jbchauvin-Projets-AgentsRoom. Proje başına bir klasör, sonra onun içinde oturum başına bir klasör.

Bir Mac veya Linux makinede geçerli kullanıcı için hâlâ elinizde olan her oturum klasörünü listelemek için:

ls /tmp/claude-$(id -u)/

Yanında ne duruyor

Oturum klasörü yalnızca scratchpad değil. Gece ajanlarımızı çalıştıran makinede, günün dokuz oturum klasöründen yedisi iki giriş içeriyor: scratchpad ve tasks. tasks klasörü, arka plan görevlerinin çıktısının düştüğü yer; ajanın ayrık çalıştırıp sonra okuduğu komutlar.

Bilmeniz gereken üçüncü bir yer daha var ve o hiç geçici klasörün altında değil: ~/.claude/projects/<proje slug>/<oturum id>/tool-results/. Bir araç bağlamın alabileceğinden fazlasını döndürdüğünde Claude Code tam çıktıyı oraya kaydeder ve ajana yolu verir. Bu gece 68 KB'lık bir Search Console dışa aktarımı scratchpad yerine oraya gitti. O konum kalıcı, oturum transkriptinin yanında. Yani ayrım şöyle: transkriptler ve fazla büyük araç çıktıları kalan ~/.claude altında; betikler, ara dosyalar ve arka plan görevi çıktısı kalmayan geçici klasörün altında.

Neden kaybolur

Çünkü geçici klasör her işletim sistemi için «silinmesi güvenli» demektir ve Claude Code'da hiçbir şey buna itiraz etmez.

Linux'ta systemd-tmpfiles, /usr/lib/tmpfiles.d/tmp.conf ne diyorsa onu uygular. Bir kullanıcı, host yeniden başlatıldığında 24 saatlik bir veri üretim pipeline'ının tüm çıktısını, inceleme kararları, betikler ve bir Python virtualenv dahil, kaybetti: o Debian konteynerindeki kural D /tmp 1777 root root 30d idi ve bu, her açılışta /tmp'yi boş olarak yeniden oluşturur. O Claude Code 2.1.260'tı ve sistem promptu uçuculuk hakkında hiçbir şey söylememişti. Kendi kuralınızı cat /usr/lib/tmpfiles.d/tmp.conf ile kontrol edin: bir D satırı açılışta siler, 10d gibi bir yaş ise zamanlayıcıyla eski dosyaları temizler.

Windows'ta klasör, Depolama Algılayıcısı ve Disk Temizleme'nin süpürdüğü %TEMP% altındadır. Temmuz 2026'da biri iki oturum canlıyken bir disk temizliği çalıştırdı ve her iki ajanın da içinde çalıştığı git worktree'lerini, commit edilmemiş düzenlemeler dahil, kaybetti. Düzenlemeler yalnızca konuşma bağlamında hâlâ var oldukları için kurtarılabildi.

macOS'ta /private/tmp yeniden başlatmada boşaltılır ve eski dosyalar sistem tarafından temizlenir. Bu gece Mac mini'mizde /private/tmp/claude-501, bu proje için dokuz oturum klasörü, 452 dosya ve 25 MB tutuyor ve günden eski hiçbir şey yok. Önceki gecelerin ajanlarının orada bıraktığı her şey gitmiş.

Bunların hiçbiri, bir şeyin yanlış davrandığı anlamında bir bug değil. Klasör tam olarak CLI'ın söylediği yerde ve işletim sistemi geçici klasörlerle tam olarak yaptığı şeyi yaptı. Boşluk şurada: prompt ona scratchpad diyor ve scratchpad, saklanan bir şey gibi geliyor kulağa.

Neyi yapılandırabilirsiniz, neyi yapılandıramazsınız

2.1.278 itibarıyla scratchpad konumu için bir ayar yok. Klasör geçici klasörü izler, dolayısıyla Windows'ta TEMP ve Unix'te TMPDIR onu taşır. Diğer geçici dosyalar için var olan CLAUDE_CODE_TMPDIR'ın scratchpad'i taşımadığı bildirildi ve o istek planlanmadı olarak kapatıldı. Bir CLAUDE_CODE_SCRATCHPAD_DIR değişkeni ve ~/.claude/scratchpad/ altında bir varsayılan için açılan istekler de öyle. Masaüstü uygulamasında görünür bir scratchpad klasörü ise açık bir özellik isteği.

Bugün iki şey işe yarıyor. Sürdürülen bir oturum (claude --resume) oturum id'sini korur, dolayısıyla aynı klasörü arar ve arada hiçbir şey silmediyse onu bulur. Ve ajandan, düz sözlerle, belirli bir dosyayı kalıcı bir yere yazmasını isteyebilirsiniz. Çözümümüzün tamamı bu.

Gece ajanlarımıza verdiğimiz kural

Yedi ajan aynı makinede 20:00'de başlıyor: SEO, ürün, sosyal, bir fixer, bir dokümantalist, bir CEO raporu ve gecenin özetini 22:00'de e-postayla gönderen bir rapporteur. Her biri bol miktarda ara malzeme üretiyor: Search Console dışa aktarımları, filtrelenmiş JSON, yirmi locale'de string sayan betikler. Hepsi bilerek scratchpad'e gidiyor, çünkü hiçbiri depoya ait değil ve hiçbiri sabahın ikisinde bir izin istemi tetiklememeli.

Her prompttaki kural tek cümle: scratchpad bir sonraki komutun ihtiyaç duyduğunu tutar, depo bir sonraki gecenin ihtiyaç duyduğunu tutar. Bir ajanın yarın okumak isteyeceği her şey, raporu, run işareti, düzenlemekte olduğu dosya, reports/nuit/<tarih>/ altına yazılır ve run'ın sonunda değil, biter bitmez commit edilir. Görevin ortasında kesilen bir ajan git'te kısmi bir rapor ve kimsenin özlemeyeceği 25 MB'lık çalışma dosyası bırakır.

Bu kuralın ayna görüntüsü, Linux kullanıcısının zor yoldan öğrendiği şey: uzun bir işin tek kopyasını scratchpad'de biriktirmesine asla izin vermeyin. Bir pipeline bir gün çalışıyorsa çıktıları sizin seçtiğiniz bir yola gider ve scratchpad yardımcıları tutar.

Klasörü uygulamadan çıkmadan açmak

Claude Code'u AgentsRoom içinde çalıştırıyorsanız, File > Open File (Cmd/Ctrl+O) o klasördeki herhangi bir dosyayı önizlemede, takip edilen bir şeyle karıştırmamanız için proje dışı olarak işaretlenmiş halde açar. Ajanın az önce ürettiği bir dışa aktarımı, bir terminale /private/tmp yolu yapıştırmadan okumak için bulduğumuz en hızlı yol bu.

Ve isim konusunda döngüyü kapatmak için: AgentsRoom Scratchpad'i başka bir şey. Ajan düzenleyicisine entegre prompt editörü; uzun bir prompt orada yazılır ve oturumlar arasında her ajan için taslak olarak saklanır. Aynı kelime, Claude Code onu bir klasör için kullanmadan önce seçilmiş. Biri sizin ajana yazdığınız yer; diğeri ajanın kendisi için yazdığı yer.

Sıkça sorulan sorular

Claude Code scratchpad'i macOS ve Linux'ta nerede?

Sistemin geçici klasörünün altında: /tmp/claude-<uid'iniz>/<eğik çizgileri tireye çevrilmiş proje yolu>/<oturum id>/scratchpad. macOS'ta aynı klasör /private/tmp/claude-501/… olarak görünür, çünkü /tmp, /private/tmp'ye bir bağlantıdır. uid'iniz id -u komutunun yazdırdığı şeydir: Mac'teki ilk kullanıcı için 501, çoğu Linux dağıtımında 1000, root için 0. Eski sürümler uid son eki olmadan /tmp/claude/ kullanıyordu.

Claude Code scratchpad'i Windows'ta nerede?

TEMP klasörünün altında: %TEMP%\claude\<proje slug>\<oturum id>\scratchpad, bu da genellikle C:\Users\<siz>\AppData\Local\Temp\claude\… olarak açılır. TEMP ortam değişkenini değiştirmek onu taşır, çünkü yol bir Claude Code ayarından değil TEMP'ten türetilir.

Claude Code scratchpad'im neden kayboldu?

Çünkü geçici klasörün altında yaşıyor ve her işletim sistemi geçici klasörü silinmesi güvenli sayar. Linux'ta systemd-tmpfiles, /usr/lib/tmpfiles.d/tmp.conf içinde yazılı kuralı uygular, bu çoğu zaman açılışta ya da belirli bir gün sayısından sonra bir silmedir. macOS, /private/tmp'yi yeniden başlatmada boşaltır ve eski dosyaları temizler. Windows'ta Depolama Algılayıcısı ve Disk Temizleme, %TEMP%'i süpürür. Claude Code'da hiçbir şey klasörü bunların hiçbirinden korumaz.

Claude Code'un scratchpad'ini koyduğu yeri değiştirebilir miyim?

Claude Code 2.1.278 itibarıyla özel bir ayarla değil. Klasör işletim sisteminin geçici klasörünü izler, dolayısıyla Windows'ta TEMP'i veya Unix'te TMPDIR'ı taşımak onu taşır. Ayrı bir değişken ya da ~/.claude altında kalıcı bir konum için açılan istekler planlanmadı olarak kapatıldı. Güvenilir seçenek, ajana önemli olan her şeyi bunun yerine projeye yazmasını söylemektir.

Scratchpad, ~/.claude/projects ile aynı şey mi?

Hayır. ~/.claude/projects/<proje slug>/ oturum transkriptlerini ve her oturum için, fazla büyük araç çıktılarının kaydedildiği bir tool-results klasörünü tutar. O konum kalıcıdır. Geçici klasörün altındaki scratchpad, ajanın betikler ve ara dosyalar için kullandığı çalışma alanıdır ve o uçucudur.

Bu AgentsRoom Scratchpad'i mi?

Aynı kelime, farklı şey. AgentsRoom Scratchpad'i, ajan düzenleyicisine entegre prompt editörüdür; orada her ajan için bir taslak yazar ve saklarsınız. Claude Code'un scratchpad'i ise CLI'ın her oturum için oluşturduğu bir klasördür. AgentsRoom o klasördeki herhangi bir dosyayı File > Open File ile açabilir ve dosya proje dışı olarak işaretlenir.