Claude Code menghapus riwayat setelah 30 hari: cara menyimpannya

Untuk bantuan menggunakan layanan ini, lihat dokumentasi Ailoot.

Apakah Claude Code benar-benar menghapus riwayat sesi Anda?#

Anda membuka Claude Code untuk kembali ke sesi dari dua bulan lalu—tetapi sesi itu sudah hilang. Filenya telah dihapus sepenuhnya dari disk. Ini bukan gangguan atau bug langka: begitulah mekanisme pembersihan bawaan bekerja.

Satu pengaturan mengendalikan pembersihan: cleanupPeriodDays. Nilai bawaannya adalah 30. Setiap kali Claude Code dimulai, aplikasi ini memindai folder riwayat dan menghapus semua yang lebih lama dari periode tersebut. Pengaturan ini sama sekali tidak ada di ~/.claude/settings.json saya, yang berarti nilai bawaan berlaku dan beberapa sesi lama saya sudah telanjur hilang.

Beberapa laporan bug tentang hal ini masih terbuka di repositori Anthropic, dan belum ada yang diperbaiki.

Di mana Claude Code menyimpan riwayat sesi?#

Menemukan riwayat Anda mudah. Buka terminal dan lihat isi folder:

ls ~/.claude/projects/

Setiap subfolder adalah proyek terpisah. Namanya mengodekan jalurnya: misalnya, proyek di /Users/alex/dev/shop menjadi folder -Users-alex-dev-shop. Di dalamnya terdapat file sesi:

ls -lt ~/.claude/projects/-Users-alex-dev-shop/
# 3f8a1c2e-....jsonl   ← satu sesi = satu file
# a91b7d40-....jsonl

Setiap file .jsonl adalah log baris demi baris: satu baris sama dengan satu peristiwa sesi. Isinya lebih dari sekadar teks percakapan. File itu menyimpan logika di balik keputusan Anda: alasan Anda memilih struktur basis data tertentu, opsi yang Anda tolak, kesalahan yang dibuat Claude, dan cara Anda memperbaikinya.

Pada dasarnya, ini adalah jurnal pengembangan proyek. Itulah sebabnya kehilangannya terasa berat: yang hilang bukan sekadar “obrolan,” melainkan konteks yang telah Anda bangun selama berminggu-minggu. Saya membahas struktur konteks ini dalam panduan “Claude Memory vs. CLAUDE.md”.

Mengapa Anthropic menghapus transkrip setelah 30 hari?#

Ada alasan untuk penghapusan ini, dan alasan tersebut patut dipahami sebelum Anda mematikannya sepenuhnya. Transkrip berupa teks biasa. Jika Claude membaca file .env selama sesi, memasukkan kunci ke dalam perintah, atau Anda menempelkan kata sandi ke prompt, semuanya tersimpan di .jsonl sebagai teks biasa. Semakin lama file semacam itu berada di disk, semakin besar kemungkinan suatu hari data tersebut bocor.

Anthropic mengatakannya dengan jelas: transkrip mungkin berisi kode sumber, kredensial, dan materi sensitif lainnya, dan menyimpannya di disk lebih lama dari yang diperlukan menimbulkan risiko privasi nyata. Periode 30 hari dipilih sebagai kompromi.

Keberatan komunitas berkenaan dengan tiga hal: penghapusan berlangsung diam-diam (tidak ada peringatan saat penyiapan atau saat mulai), tidak ada persetujuan (Anda tidak ditanya), dan tidak ada pemulihan (Trash tidak digunakan dan tidak ada rollback). Dalam issue #59248, para pengembang meminta satu hal: jadikan pembersihan lebih adil—berikan peringatan, masa pemulihan, dan periode bawaan yang tidak terlalu agresif.

Mengapa skrip pencadangan itu sendiri dapat memicu penghapusan?#

Inilah bagian tersulit, dan bagian ini menjebak orang-orang yang mencoba melindungi data mereka sendiri. Pembersihan melihat mtime, yaitu stempel waktu terakhir file diubah. Pembersihan menganggap mtime mencerminkan kapan Anda terakhir bekerja dalam sesi tersebut. Dalam praktiknya, apa pun dapat mengubah mtime: klien sinkronisasi Dropbox atau iCloud, rsync, perangkat lunak antivirus, pengindeks, atau skrip pencadangan Anda sendiri.

Inilah jebakannya. Anda memutuskan untuk menyimpan riwayat dan menyiapkan sinkronisasi cloud untuk ~/.claude/projects/. Pada suatu saat, layanan sinkronisasi menulis ulang sebuah file dan menetapkan mtime-nya ke tanggal yang lebih awal (ini dapat terjadi saat memulihkan dari salinan cloud). Claude Code melihat file “lama” saat dimulai dan menghapusnya. Anda bermaksud menyimpannya, tetapi malah mempercepat penghapusannya.

Kesimpulannya hanya satu: cadangan harus berada di luar ~/.claude/projects/. Pembersihan hanya bekerja di dalam folder ini. Salinan yang disimpan di luarnya berada di luar jangkauan pembersihan. Saya akan menyusun solusinya berdasarkan prinsip ini.

Bagaimana cara menghentikan penghapusan riwayat sekarang juga?#

Hentikan penghapusan dalam tiga langkah:

1. Buka file pengaturan: ~/.claude/settings.json (jika file tersebut tidak ada, buatlah).
2. Tambahkan pengaturan cleanupPeriodDays dengan nilai besar:

{
  "cleanupPeriodDays": 3650
}

3. Simpan file. Pengaturan ini akan berlaku saat Claude Code dimulai berikutnya.

Nilai 3650 berarti sepuluh tahun: dalam praktiknya, penghapusan tidak akan berlangsung lagi. Jika Anda ingin pembersihan tetap aktif tetapi memberi lebih banyak waktu, tetapkan nilainya ke 365 (satu tahun); hanya sesi yang lebih lama dari setahun yang akan hilang. Anda dapat memeriksa apakah pengaturan sudah diterapkan dengan perintah ini:

grep cleanupPeriodDays ~/.claude/settings.json

Satu catatan yang mudah terlewat: memperpanjang periode TIDAK memulihkan apa yang sudah dihapus. Pembersihan berjalan saat mulai, dan apa pun yang terhapus dalam proses sebelumnya sudah hilang selamanya. Karena itu, Anda harus menetapkan ini terlebih dahulu—pengaturan ini mencegah kehilangan di kemudian hari, tetapi tidak mengembalikan apa yang sudah dihapus. Jika Anda ingin menghindari kehilangan riwayat Claude Code sekaligus proyek Anda akibat perintah yang tidak disengaja, lihat panduan “Cara Mengonfigurasi Claude Code Agar Tidak Merusak Proyek Anda”.

Riwayat sesi Anda adalah bagian dari otak kedua proyek Anda: riwayat itu berisi logika keputusan yang belum Anda catat di tempat lain. cleanupPeriodDays menyimpan file, tetapi tidak mengubahnya menjadi sistem yang memungkinkan Anda mengambil hal yang diperlukan enam bulan dari sekarang.

Bagaimana mengarsipkan riwayat otomatis di luar folder pembersihan?#

Idenya sederhana: biarkan Claude Code melakukan apa pun yang dikehendakinya dengan foldernya, sementara Anda menyimpan arsip terpisah di luar folder itu. Arsip dilindungi dari mekanisme pembersihan tersebut, tetapi masih dapat hilang akibat kerusakan disk, penghapusan tidak sengaja, atau penyalinan gagal. Siapkan seperti ini:

1. Buat folder arsip di luar direktori yang dikelola:

mkdir -p ~/claude-history-archive

2. Salin riwayat Anda saat ini ke sana. Tanda -a mempertahankan struktur dan stempel waktu; --ignore-existing membiarkan file yang sudah disalin tetap utuh:

rsync -a ~/.claude/projects/ ~/claude-history-archive/

3. Otomatiskan proses ini sekali sehari. Di macOS, gunakan launchd. Buat file ~/Library/LaunchAgents/com.example.claudearchive.plist:

<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.example.claudearchive</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/bin/rsync</string>
    <string>-a</string>
    <string>/Users/YOUR_NAME/.claude/projects/</string>
    <string>/Users/YOUR_NAME/claude-history-archive/</string>
  </array>
  <key>StartInterval</key>
  <integer>86400</integer>
</dict>
</plist>

4. Muat agen agar berjalan di latar belakang:

launchctl load ~/Library/LaunchAgents/com.example.claudearchive.plist

Di Linux, hal yang sama dilakukan dengan satu baris di crontab (crontab -e):

0 3 * * * rsync -a ~/.claude/projects/ ~/claude-history-archive/

Mengapa cara ini berhasil sementara sinkronisasi di bagian sebelumnya gagal? Arsip berada DI LUAR ~/.claude/projects/, sehingga pembersihan tidak dapat melihatnya sama sekali. Penyalinan berlangsung satu arah (dari folder aktif ke arsip), dan kita tidak menyentuh mtime file aktif—jadi bug mtime tidak terjadi. Sekalipun Claude Code menghapus sebuah sesi dari foldernya sendiri besok, salinannya akan tetap ada di arsip.

Bagaimana cara mengubah arsip sesi menjadi otak kedua yang dapat ditelusuri?#

Sekadar mengumpulkan file tidak cukup—Anda perlu dapat mengaksesnya. Dua langkah mengubah arsip menjadi alat yang dapat digunakan.

Pertama, beri versi dengan git. Inisialisasi repositori di folder arsip:

cd ~/claude-history-archive
git init
git add -A && git commit -m "Cuplikan pertama riwayat Claude Code"

Tambahkan git add -A && git commit ke proses harian yang sama dengan rsync. Kini Anda memiliki riwayat versi: Anda dapat melihat apa yang muncul dan kapan, serta membatalkan penimpaan yang tidak disengaja dengan satu perintah.

Kedua, lakukan pencarian. File .jsonl adalah JSON yang dipisahkan baris, jadi Anda dapat menggunakan alat yang sudah dikenal. Temukan sesi yang membahas topik tertentu:

grep -rl "migrasi basis data" ~/claude-history-archive/

Ekstrak hanya teks prompt Anda dari suatu sesi (menggunakan jq, karena formatnya JSON):

jq -r 'select(.type=="user") | .message.content' session.jsonl

Pada titik ini, riwayat sesi Anda mulai berfungsi sebagai otak kedua proyek: sebuah basis data yang memungkinkan Anda mengambil “bagaimana kita memutuskan ini pada bulan Maret” dalam hitungan detik. Untuk penjelasan terpisah tentang ke mana konteks ditempatkan dalam sesi dan cara mengelolanya, lihat “Ke Mana Token Pergi di Claude Code”.

Dapatkah Anda memulihkan sesi yang sudah dihapus?#

Jawaban jujurnya: mungkin tidak. Claude Code tidak memiliki fitur pemulihan, Trash, atau log pembatalan untuk transkrip yang dihapus. File itu begitu saja menghilang dari disk.

Ada satu pilihan: cadangan sistem, jika sudah diaktifkan sebelumnya:

1. macOS Time Machine—jika sebuah snapshot menangkap ~/.claude/projects/ sebelum penghapusan, Anda dapat mengambil file dari cadangan untuk tanggal yang diperlukan.
2. Riwayat versi OneDrive / Dropbox—jika folder disinkronkan dengan pembuatan versi aktif, cari file tersebut di riwayat versi cloud (tetapi ingat jebakan mtime: sinkronisasi mungkin juga memicu penghapusan).
3. Salinan manual—setiap rsync/cp yang Anda jalankan secara manual ke lokasi di luar folder yang dikelola.

Jika semua ini tidak ada, sesi tersebut hilang. Dan ini bukan kejadian langka: seorang penulis bug di repositori Anthropic mengalami kerusakan pada 26 dari 38 catatan, yang mewakili pekerjaan selama berbulan-bulan. Satu-satunya perlindungan yang dapat diandalkan adalah perlindungan yang sudah ada SEBELUM kehilangan terjadi. Tetapkan cleanupPeriodDays dan pengarsipan otomatis hari ini, selagi masih ada sesuatu yang bisa diselamatkan.

Nilai apa yang sebaiknya dipilih untuk cleanupPeriodDays?#

Hanya ada satu pengaturan, tetapi maknanya bisa berbeda-beda. Bandingkan pilihan berikut dan pilih yang sesuai dengan kebutuhan Anda:

Satu catatan keamanan penting: jika Anda menetapkan 3650 dan menyimpan semuanya, berarti Anda setuju menyimpan transkrip yang mungkin berisi kunci dan kode di disk. Ini adalah kompromi yang disengaja: kemudahan arsip versus risiko. Kurangi risikonya: simpan arsip di disk terenkripsi (FileVault di macOS), jangan letakkan di cloud publik, dan jangan masukkan ke repositori git publik. Saya telah menyusun panduan terpisah tentang data yang mungkin bocor melalui Claude Code: “Keamanan Data di Claude Code”.

Yang perlu dilakukan hari ini: daftar periksa#

Siapkan perlindungan langkah demi langkah:

1. Tetapkan cleanupPeriodDays: 3650 di ~/.claude/settings.json—penghapusan sudah dihentikan.
2. Buat ~/claude-history-archive di luar folder yang dikelola dan jalankan rsync -a pertama.
3. Jadwalkan proses harian menggunakan launchd (macOS) atau cron (Linux).
4. Inisialisasi git di arsip dan tambahkan git add -A && git commit ke proses yang sama.
5. Pastikan arsip berada di disk terenkripsi dan tidak disinkronkan ke cloud publik.
6. Periksa setiap proses terjadwal untuk memastikan penyalinan berhasil, lalu tinjau sesi arsip terbaru dan pulihkan sampel secara berkala ke folder sementara terpisah untuk memverifikasi keterbacaannya.
7. Jika kehilangan perangkat atau disk termasuk risiko yang ditangani, simpan cadangan independen dengan kontrol akses yang sesuai dan uji pemulihannya juga. Riwayat Git pada disk yang sama bukan cadangan independen.

Riwayat sesi hanyalah satu lapisan konteks yang membuat Claude dapat diandalkan.

Kenali Ailoot.