Di mana Claude Code menyimpan scratchpad-nya, dan mengapa ia menghilang

Setiap sesi Claude Code dimulai dengan satu baris yang mungkin Anda lewati begitu saja. Baris kami, malam ini, berbunyi seperti ini:

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

Setelah itu CLI tidak pernah menyebutnya lagi. Tidak ada perintah yang menampilkannya, tidak ada panel yang membukanya, dan pada hari Anda mencari file CSV yang kata agen sudah ditulis di sana, foldernya mungkin sudah lenyap.

Kami menjalankan tujuh agen terjadwal di sebuah Mac mini setiap malam, dan masing-masing menulis ke folder itu. Jadi kami pergi melihat apa sebenarnya folder ini, di mana letaknya di tiap sistem, apa yang menghapusnya, dan apa yang kami perintahkan kepada agen tentangnya. Semua di bawah ini diperiksa pada Claude Code 2.1.278 tanggal 19 September 2026, dan pada issue GitHub yang dibuka orang-orang ketika mereka kehilangan pekerjaan di dalamnya.

Apa yang Claude Code katakan kepada agen

Baris itu adalah bagian dari prompt sistem. Instruksi yang mengikutinya, di versi saat ini, mengatakan agen harus selalu memakai direktori itu untuk file sementara, yaitu hasil perantara, skrip dan keluaran yang tidak termasuk dalam proyek, alih-alih /tmp atau direktori sementara sistem lainnya, bahwa direktori itu khusus per sesi dan terisolasi dari proyek, bahwa umumnya bisa dipakai tanpa permintaan izin, dan bahwa /tmp hanya boleh dipakai kalau Anda memintanya secara eksplisit.

Bagian terakhir itulah yang berguna bagi Anda. File yang ditulis di dalam scratchpad tidak memicu dialog izin tulis, itulah sebabnya agen menaruh skrip pembantu dan ekspornya di sana alih-alih bertanya kepada Anda setiap kali. Itu juga sebabnya Anda tidak pernah ditanya, dan tidak pernah diberi tahu, ke mana file-file itu pergi.

Kalau Anda ingin path-nya di sesi yang sedang berjalan, tanyakan kepada agen. « Cetak direktori scratchpad-mu » dijawab dari prompt sistem, tanpa menjalankan apa pun.

Path-nya, sistem demi sistem

Folder ini berada di bawah direktori sementara sistem operasi, dan namanya mengodekan siapa Anda, proyek mana yang sedang Anda buka, dan sesi yang mana.

Di macOS dan Linux:

/tmp/claude-<uid>/<path proyek, garis miring diganti tanda hubung>/<id sesi>/scratchpad

Di Mac, /tmp adalah tautan ke /private/tmp, jadi folder yang sama ditampilkan sebagai /private/tmp/claude-501/…. Angkanya adalah id pengguna Anda, apa yang dicetak id -u: 501 untuk akun pertama di Mac, 1000 di sebagian besar distribusi Linux, 0 untuk root. Laporan Linux yang kami kutip di bawah menunjukkan /tmp/claude-0/, karena pipeline-nya berjalan sebagai root di dalam kontainer. Issue yang dibuka lebih awal pada 2026 menunjukkan /tmp/claude/<slug proyek>/… tanpa uid sama sekali, jadi akhiran itu ditambahkan di tengah jalan. Kalau Anda memakai build yang lebih lama, buang saja akhirannya.

Di Windows, seperti dilaporkan di Windows 11 pada Juli 2026:

%TEMP%\claude\<slug proyek>\<id sesi>\scratchpad

yang biasanya berarti C:\Users\<Anda>\AppData\Local\Temp\claude\…. Path ini diturunkan dari variabel TEMP, jadi kalau Anda mengarahkan TEMP ke tempat lain, scratchpad ikut pindah.

Slug proyek adalah direktori kerja Anda dengan setiap garis miring diganti tanda hubung. Repositori kami ada di /Users/jbchauvin/Projets/AgentsRoom, jadi slug-nya adalah -Users-jbchauvin-Projets-AgentsRoom. Satu folder per proyek, lalu satu folder per sesi di dalamnya.

Untuk menampilkan semua folder sesi yang masih Anda miliki untuk pengguna saat ini di mesin Mac atau Linux:

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

Apa yang ada di sebelahnya

Folder sesi bukan hanya scratchpad. Di mesin yang menjalankan agen malam kami, tujuh dari sembilan folder sesi hari itu berisi dua entri: scratchpad dan tasks. Folder tasks adalah tempat keluaran tugas latar belakang mendarat, perintah-perintah yang dijalankan agen secara terpisah lalu dibaca kemudian.

Ada tempat ketiga yang perlu Anda ketahui, dan letaknya sama sekali bukan di bawah direktori sementara: ~/.claude/projects/<slug proyek>/<id sesi>/tool-results/. Ketika sebuah alat mengembalikan lebih dari yang bisa ditampung konteks, Claude Code menyimpan keluaran lengkapnya di sana dan memberikan path-nya kepada agen. Malam ini, sebuah ekspor Search Console 68 KB pergi ke sana alih-alih ke scratchpad. Lokasi itu permanen, di sebelah transkrip sesi. Jadi pembagiannya: transkrip dan keluaran alat yang terlalu besar di bawah ~/.claude, yang tetap ada; skrip, file perantara dan keluaran tugas latar belakang di bawah direktori sementara, yang tidak.

Mengapa ia menghilang

Karena direktori sementara berarti « aman untuk dihapus » bagi setiap sistem operasi, dan tidak ada apa pun di Claude Code yang membantah itu.

Di Linux, systemd-tmpfiles menerapkan apa pun yang dikatakan /usr/lib/tmpfiles.d/tmp.conf. Seorang pelapor kehilangan seluruh keluaran pipeline pembuatan data selama 24 jam, termasuk vonis review, skrip dan sebuah virtualenv Python, ketika host-nya reboot: aturan di kontainer Debian itu adalah D /tmp 1777 root root 30d, yang membuat ulang /tmp dalam keadaan kosong pada setiap boot. Itu Claude Code 2.1.260, dan prompt sistem tidak mengatakan apa pun soal sifat mudah hilangnya. Periksa aturan Anda sendiri dengan cat /usr/lib/tmpfiles.d/tmp.conf: baris D mengosongkan saat boot, umur seperti 10d menghapus berdasarkan pewaktu.

Di Windows, foldernya berada di bawah %TEMP%, yang disapu Storage Sense dan Disk Cleanup. Pada Juli 2026 seseorang menjalankan pembersihan disk saat dua sesi sedang aktif dan kehilangan worktree git tempat kedua agen sedang bekerja, termasuk suntingan yang belum di-commit. Suntingan itu hanya bisa dipulihkan karena masih ada di dalam konteks percakapan.

Di macOS, /private/tmp dikosongkan saat reboot dan file lama dihapus oleh sistem. Di Mac mini kami malam ini, /private/tmp/claude-501 menyimpan sembilan folder sesi untuk proyek ini, 452 file dan 25 MB, dan tidak ada yang lebih tua dari hari ini. Apa pun yang ditinggalkan agen malam-malam sebelumnya di sana sudah hilang.

Tidak satu pun dari ini adalah bug dalam arti ada yang berperilaku salah. Foldernya persis di tempat yang dikatakan CLI, dan sistem operasi melakukan persis apa yang selalu dilakukannya pada folder sementara. Celahnya adalah prompt menyebutnya scratchpad, dan scratchpad terdengar seperti sesuatu yang Anda simpan.

Apa yang bisa Anda konfigurasi, dan apa yang tidak

Per 2.1.278 tidak ada pengaturan untuk lokasi scratchpad. Folder mengikuti direktori sementara, jadi TEMP di Windows dan TMPDIR di Unix memindahkannya. CLAUDE_CODE_TMPDIR, yang ada untuk file sementara lainnya, dilaporkan tidak memindahkan scratchpad, dan permintaan itu ditutup sebagai tidak direncanakan. Begitu pula permintaan untuk variabel CLAUDE_CODE_SCRATCHPAD_DIR dan untuk lokasi bawaan di bawah ~/.claude/scratchpad/. Folder scratchpad yang terlihat di aplikasi desktop adalah permintaan fitur yang masih terbuka.

Dua hal yang benar-benar berfungsi hari ini. Sesi yang dilanjutkan (claude --resume) mempertahankan id sesinya, jadi ia mencari folder yang sama, dan menemukannya kalau tidak ada yang menghapusnya di antara waktu itu. Dan Anda bisa meminta agen, dengan kata-kata biasa, untuk menulis file tertentu ke tempat yang permanen. Itulah seluruh solusi kami.

Aturan yang kami berikan kepada agen malam kami

Tujuh agen mulai pukul 20:00 di mesin yang sama: SEO, produk, media sosial, seorang fixer, seorang documentalist, sebuah laporan CEO dan seorang rapporteur yang mengirimkan ringkasan malam itu lewat email pukul 22:00. Masing-masing menghasilkan banyak sekali bahan perantara: ekspor Search Console, JSON yang sudah difilter, skrip yang menghitung string di dua puluh bahasa. Semuanya masuk ke scratchpad, dengan sengaja, karena tidak satu pun termasuk dalam repositori dan tidak satu pun boleh memicu permintaan izin pada pukul dua pagi.

Aturan di setiap prompt hanya satu kalimat: scratchpad menyimpan apa yang dibutuhkan perintah berikutnya, repositori menyimpan apa yang dibutuhkan malam berikutnya. Apa pun yang ingin dibaca agen besok, laporannya, penanda run-nya, file yang sedang disuntingnya, ditulis di bawah reports/nuit/<tanggal>/ dan di-commit begitu selesai, bukan di akhir run. Agen yang terputus di tengah tugas meninggalkan laporan parsial di git dan 25 MB file kerja yang tidak akan dirindukan siapa pun.

Cermin dari aturan itu adalah pelajaran yang didapat pelapor Linux dengan cara yang pahit: jangan pernah biarkan pekerjaan panjang menumpuk satu-satunya salinannya di scratchpad. Kalau sebuah pipeline berjalan seharian, keluarannya masuk ke path yang Anda pilih, dan scratchpad menyimpan alat bantunya.

Membuka folder tanpa keluar dari aplikasi

Kalau Anda menjalankan Claude Code di dalam AgentsRoom, File > Open File (Cmd/Ctrl+O) membuka file apa pun dari folder itu di pratinjau, ditandai sebagai di luar proyek agar Anda tidak mengiranya sebagai sesuatu yang dilacak. Ini cara tercepat yang kami temukan untuk membaca ekspor yang baru saja dihasilkan agen, tanpa menempelkan path /private/tmp ke terminal.

Dan untuk menutup soal nama: Scratchpad AgentsRoom adalah hal lain. Itu editor prompt yang terintegrasi di komposer agen, tempat prompt panjang ditulis dan disimpan sebagai draf per agen di antara sesi. Kata yang sama, dipilih sebelum Claude Code memakainya untuk sebuah folder. Yang satu adalah tempat Anda menulis kepada agen; yang lain adalah tempat agen menulis untuk dirinya sendiri.

Pertanyaan yang sering diajukan

Di mana scratchpad Claude Code di macOS dan Linux?

Di bawah direktori sementara sistem: /tmp/claude-<uid Anda>/<path proyek dengan garis miring diganti tanda hubung>/<id sesi>/scratchpad. Di macOS folder yang sama muncul sebagai /private/tmp/claude-501/… karena /tmp adalah tautan ke /private/tmp. Uid Anda adalah apa yang dicetak id -u: 501 untuk pengguna pertama di Mac, 1000 di sebagian besar distribusi Linux, 0 untuk root. Versi lama memakai /tmp/claude/ tanpa akhiran uid.

Di mana scratchpad Claude Code di Windows?

Di bawah folder TEMP: %TEMP%\claude\<slug proyek>\<id sesi>\scratchpad, yang biasanya berarti C:\Users\<Anda>\AppData\Local\Temp\claude\…. Mengubah variabel lingkungan TEMP memindahkannya, karena path ini diturunkan dari TEMP dan bukan dari pengaturan Claude Code.

Mengapa scratchpad Claude Code saya hilang?

Karena ia berada di bawah direktori sementara, dan setiap sistem operasi menganggap direktori sementara aman untuk dihapus. Di Linux, systemd-tmpfiles menerapkan aturan yang tertulis di /usr/lib/tmpfiles.d/tmp.conf, sering kali pengosongan saat boot atau setelah sejumlah hari. macOS mengosongkan /private/tmp saat reboot dan menghapus file lama. Di Windows, Storage Sense dan Disk Cleanup menyapu %TEMP%. Tidak ada apa pun di Claude Code yang melindungi folder ini dari semua itu.

Bisakah saya mengubah tempat Claude Code menaruh scratchpad-nya?

Tidak dengan pengaturan khusus, per Claude Code 2.1.278. Folder ini mengikuti direktori sementara sistem operasi, jadi memindahkan TEMP di Windows atau TMPDIR di Unix memindahkannya. Permintaan untuk variabel terpisah atau lokasi persisten di bawah ~/.claude sudah ditutup sebagai tidak direncanakan. Pilihan yang andal adalah meminta agen menulis apa pun yang penting ke dalam proyek.

Apakah scratchpad sama dengan ~/.claude/projects?

Tidak. ~/.claude/projects/<slug proyek>/ menyimpan transkrip sesi dan, per sesi, folder tool-results tempat keluaran alat yang terlalu besar disimpan. Lokasi itu permanen. Scratchpad di bawah direktori sementara adalah ruang kerja yang dipakai agen untuk skrip dan file perantara, dan yang itu mudah hilang.

Apakah ini Scratchpad AgentsRoom?

Kata yang sama, hal yang berbeda. Scratchpad AgentsRoom adalah editor prompt yang terintegrasi di komposer agen, tempat Anda menulis dan menyimpan satu draf per agen. Scratchpad Claude Code adalah folder yang dibuat CLI untuk setiap sesi. AgentsRoom bisa membuka file apa pun dari folder itu dengan File > Open File, dan ditandai « Di luar proyek ».