Perintah Memori dan Pemadatan

Claude Code berjalan di dalam jendela konteks yang terbatas. Seiring sesi berkembang, muncul dua kebutuhan: Anda ingin beberapa catatan bertahan di setiap sesi, dan Anda ingin percakapan yang sedang berlangsung tetap cukup kecil agar dapat ditalar dengan baik.

Dua perintah menangani kebutuhan tersebut:

• /memory — menyunting CLAUDE.md agar instruksi bertahan lintas sesi.
• /compact — memadatkan konteks saat ini untuk membebaskan ruang, dengan mengorbankan sebagian detail.

Pelajaran ini berasal dari Domain 5 (Manajemen Konteks & Keandalan) dan Domain 3 (Konfigurasi Claude Code). Mengetahui dengan tepat apa yang dilakukan setiap perintah—dan apa biayanya—merupakan topik yang sering muncul dalam ujian.

/memory membuka CLAUDE.md untuk disunting. Apa pun yang Anda tulis di sana dimuat ke dalam konteks pada awal setiap sesi — isinya bertahan lama dan tidak terikat pada satu percakapan.

Gunakan untuk fakta stabil yang harus selalu diketahui model: konvensi proyek, perintah pembangunan, aturan arsitektur, dan standar penulisan kode. Anggap CLAUDE.md sebagai memori jangka panjang proyek Anda; /memory hanyalah penyunting yang membukanya.

/memory dapat menargetkan cakupan yang berbeda, dan cakupan menentukan siapa yang melihat catatan tersebut:

• Tingkat pengguna ~/.claude/CLAUDE.md — bersifat pribadi, tidak dibagikan melalui kendali versi. Anggota tim baru tidak akan melihatnya.
• Tingkat proyek ./CLAUDE.md atau .claude/CLAUDE.md — dikomit ke VCS, dibagikan kepada seluruh tim.
• Tingkat direktori — berlaku untuk subtree repositori tertentu.

Jebakan ujian: jika suatu aturan harus diterima setiap anggota tim, aturan itu harus berada di file tingkat proyek. Menaruh konvensi bersama hanya di memori tingkat pengguna berarti anggota tim yang baru bergabung akan melewatkannya tanpa menyadarinya.

CLAUDE.md yang sangat besar menghabiskan konteks pada setiap sesi. Dua teknik dapat menjaganya tetap ringkas:

• Impor @path memodulkan konten; misalnya, @./standards/coding-style.md mengambil sebuah file berdasarkan referensi.
• File .claude/rules/ dengan frontmatter YAML paths hanya dimuat saat Anda menyunting file yang cocok — sehingga menghemat token dibandingkan file memori monolitik.

Jadi, /memory bukan sekadar "menuliskan semuanya"; perintah ini digunakan untuk memilih instruksi tahan lama mana yang selalu aktif dan mana yang dimuat saat diperlukan.

Jika /memory berkaitan dengan persistensi, /compact berkaitan dengan kapasitas. Perintah ini memadatkan percakapan saat ini—dengan meringkas giliran-giliran sebelumnya—sehingga Anda memperoleh kembali ruang dan dapat terus bekerja dalam sesi yang sama.

Ini adalah bentuk perangkuman progresif. Cara ini benar-benar berguna dalam sesi panjang sebelum Anda mencapai batas konteks. Namun, perangkuman bersifat kehilangan informasi, dan kehilangan tersebut cukup dapat diprediksi untuk diperiksa.

Inilah biaya yang perlu Anda ketahui untuk ujian. Perangkuman progresif membuat angka, persentase, dan tanggal yang tepat menjadi samar. "Pengembalian dana sebesar $487.10 pada 2026-03-14" dapat berubah menjadi "pengembalian dana sebelumnya."

Bagi seorang arsitek, ini adalah kesalahan keandalan, bukan sekadar masalah tampilan. Jika keputusan lanjutan bergantung pada angka atau penanda waktu yang tepat, /compact dapat secara diam-diam mengikis fakta yang menjadi dasar tugas tersebut.

Perbaikan tingkat arsitek: jangan mempercayai rangkuman untuk menyimpan angka penting. Pindahkan fakta transaksional ke dalam blok "fakta kasus" terpisah yang dipertahankan secara verbatim di luar rangkuman.

Sebelum memadatkan, simpan nilai yang tepat—ID pesanan, jumlah, tanggal, ambang batas—di tempat yang tidak akan dirangkum (misalnya file catatan atau bagian fakta verbatim). Dengan demikian, /compact dapat memadatkan percakapan sementara fakta penting tetap utuh.

/compact membuat Anda tetap berada dalam sesi yang sama. Terkadang, itu bukan langkah yang tepat. Pola terkaitnya adalah memulai sesi baru dengan rangkuman terstruktur, yang dapat lebih baik daripada membawa riwayat panjang dan berisik ke depan.

Ini mencerminkan pertukaran dalam penggunaan sesi: --resume <name> melanjutkan sesi bernama, tetapi hasil alat yang dilanjutkan dapat menjadi STALE jika basis kode berubah tanpa Anda sadari. Saat riwayat sudah terlalu besar sekaligus kedaluwarsa, sesi bersih yang diawali rangkuman ringkas lebih dapat diandalkan daripada memadatkan konteks yang sudah kedaluwarsa.

Manajemen konteks lebih luas daripada satu perintah. Model lebih memperhatikan awal dan akhir konteks daripada bagian tengah—efek "kehilangan di tengah". Jadi, di mana suatu fakta berada itu penting, bukan hanya apakah fakta tersebut bertahan setelah /compact.

Kebiasaan yang melengkapinya: pangkas keluaran alat yang terlalu panjang hingga hanya menyisakan bidang yang relevan sebelum masuk ke konteks. Menjaga konteks tetap kecil dan tertata dengan baik mengurangi frekuensi Anda perlu memadatkannya serta menjauhkan fakta penting dari bagian tengah yang kurang diperhatikan.

Kedua perintah ini menyelesaikan aspek yang berbeda, dan arsitek yang baik menggunakan keduanya secara sengaja:

• /memory → persistensi lintas sesi (instruksi tahan lama dalam CLAUDE.md).
• /compact → kapasitas dalam satu sesi (perangkuman yang kehilangan informasi untuk membebaskan ruang).

Contoh tugas panjang: simpan konvensi dalam CLAUDE.md proyek melalui /memory; tetapkan angka yang tepat dalam blok fakta verbatim; gunakan /compact saat konteks penuh; dan jika riwayat yang dibawa sudah kedaluwarsa atau sangat besar, mulai sesi baru dengan rangkuman terstruktur.

Terapkan semuanya dalam pemfaktoran ulang yang berlangsung beberapa jam:

• Saat penyiapan, /memory mencatat perintah pembangunan dan aturan "tinjau dalam sesi terisolasi."
• Di tengah sesi, Anda mengekstrak nama pengujian yang gagal dan nomor baris yang tepat ke dalam blok verbatim.
• Konteks penuh → /compact memadatkan narasi eksplorasi, sementara fakta verbatim dan giliran terbaru tetap jelas.
• Beberapa jam kemudian cabang telah menyimpang → Anda meninggalkan riwayat yang membengkak dan membuka sesi baru yang diawali rangkuman ringkas.

Perhatikan: persistensi, perlindungan ketepatan, dan kapasitas dikelola sebagai keputusan terpisah—jangan pernah menganggapnya gratis.

Hal-hal penting:

• /memory menyunting CLAUDE.md—instruksi tahan lama yang bertahan lintas sesi. Tingkat proyek dibagikan melalui VCS; tingkat pengguna bersifat pribadi dan tidak terlihat oleh anggota tim baru.
• Jaga memori tetap ringkas dengan impor @path dan .claude/rules/ (frontmatter paths) yang hanya dimuat saat relevan.
• /compact memadatkan konteks aktif untuk membebaskan ruang, tetapi perangkuman progresif membuat angka, tanggal, dan persentase menjadi samar.
• Lindungi angka penting dalam blok 'fakta kasus' verbatim di luar rangkuman sebelum melakukan pemadatan.
• Saat riwayat sudah kedaluwarsa atau membengkak, sesi baru dengan rangkuman terstruktur dapat lebih baik daripada /compact atau --resume. Waspadai kehilangan di tengah dan pangkas keluaran alat yang terlalu panjang.