Checkpointing

Lacak, putar ulang, dan ringkas edit dan percakapan Claude untuk mengelola status sesi.

Claude Code secara otomatis melacak edit file Claude saat Anda bekerja, memungkinkan Anda dengan cepat membatalkan perubahan dan memutar ulang ke status sebelumnya jika ada yang tidak sesuai.

Cara kerja checkpoints

Saat Anda bekerja dengan Claude, checkpointing secara otomatis menangkap status kode Anda sebelum setiap edit. Jaring pengaman ini memungkinkan Anda mengejar tugas-tugas yang ambisius dan berskala besar dengan mengetahui Anda selalu dapat kembali ke status kode sebelumnya.

Pelacakan otomatis

Claude Code melacak semua perubahan yang dibuat oleh alat pengeditan filenya:

• Setiap prompt pengguna membuat checkpoint baru
• Checkpoints bertahan di seluruh sesi, sehingga Anda dapat mengaksesnya dalam percakapan yang dilanjutkan
• Dibersihkan secara otomatis bersama dengan sesi setelah 30 hari (dapat dikonfigurasi)

Putar ulang dan ringkas

Tekan Esc dua kali (Esc + Esc) atau gunakan perintah /rewind untuk membuka menu putar ulang. Daftar yang dapat digulir menunjukkan setiap prompt Anda dari sesi. Pilih titik yang ingin Anda tindaklanjuti, kemudian pilih tindakan:

• Pulihkan kode dan percakapan: kembalikan kode dan percakapan ke titik tersebut
• Pulihkan percakapan: putar ulang ke pesan tersebut sambil mempertahankan kode saat ini
• Pulihkan kode: kembalikan perubahan file sambil mempertahankan percakapan
• Ringkas dari sini: kompres percakapan dari titik ini ke depan menjadi ringkasan, membebaskan ruang context window
• Ringkas hingga di sini: kompres percakapan sebelum titik ini menjadi ringkasan, menjaga pesan-pesan selanjutnya tetap utuh
• Tidak jadi: kembali ke daftar pesan tanpa membuat perubahan

Setelah memulihkan percakapan atau memilih Ringkas dari sini, prompt asli dari pesan yang dipilih dipulihkan ke dalam bidang input sehingga Anda dapat mengirimnya kembali atau mengeditnya.

Memilih Ringkas hingga di sini membuat Anda tetap berada di akhir percakapan dengan input kosong.

Pulihkan vs. ringkas

Opsi pemulihan mengembalikan status: mereka membatalkan perubahan kode, riwayat percakapan, atau keduanya. Opsi ringkas mengompres bagian dari percakapan menjadi ringkasan yang dihasilkan AI tanpa mengubah file di disk:

• Ringkas dari sini: pesan sebelum pesan yang dipilih tetap utuh. Pesan yang dipilih dan semua pesan berikutnya diganti dengan ringkasan. Gunakan ini untuk membuang diskusi sampingan sambil menjaga konteks awal dalam detail lengkap.
• Ringkas hingga di sini: pesan sebelum pesan yang dipilih diganti dengan ringkasan. Pesan yang dipilih dan semua pesan berikutnya tetap utuh, dan Anda tetap berada di akhir percakapan. Gunakan ini untuk mengompres diskusi setup awal sambil menjaga pekerjaan terbaru dalam detail lengkap.

Dalam kedua kasus, pesan asli disimpan dalam transkrip sesi, sehingga Claude dapat mereferensikan detail jika diperlukan. Anda dapat mengetik instruksi opsional untuk memandu fokus ringkasan. Ini mirip dengan /compact, tetapi ditargetkan: alih-alih meringkas seluruh percakapan, Anda memilih sisi mana dari pesan yang dipilih untuk dikompres.

Kasus penggunaan umum

Checkpoints sangat berguna ketika:

• Menjelajahi alternatif: coba pendekatan implementasi berbeda tanpa kehilangan titik awal Anda
• Memulihkan dari kesalahan: dengan cepat batalkan perubahan yang memperkenalkan bug atau merusak fungsionalitas
• Iterasi pada fitur: bereksperimen dengan variasi mengetahui Anda dapat kembali ke status yang berfungsi
• Membebaskan ruang konteks: ringkas sesi debugging yang bertele-tele dari titik tengah ke depan, menjaga instruksi awal Anda tetap utuh

Keterbatasan

Perubahan perintah Bash tidak dilacak

Checkpointing tidak melacak file yang dimodifikasi oleh perintah bash. Misalnya, jika Claude Code menjalankan:

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

Modifikasi file ini tidak dapat dibatalkan melalui rewind. Hanya edit file langsung yang dibuat melalui alat pengeditan file Claude yang dilacak.

Perubahan eksternal tidak dilacak

Checkpointing hanya melacak file yang telah diedit dalam sesi saat ini. Perubahan manual yang Anda buat pada file di luar Claude Code dan edit dari sesi bersamaan lainnya biasanya tidak ditangkap, kecuali jika kebetulan memodifikasi file yang sama dengan sesi saat ini.

Bukan pengganti kontrol versi

Checkpoints dirancang untuk pemulihan cepat tingkat sesi. Untuk riwayat versi permanen dan kolaborasi:

• Terus gunakan kontrol versi (mis. Git) untuk commit, branch, dan riwayat jangka panjang
• Checkpoints melengkapi tetapi tidak menggantikan kontrol versi yang tepat
• Pikirkan checkpoints sebagai "undo lokal" dan Git sebagai "riwayat permanen"

Lihat juga

• Mode interaktif - Pintasan keyboard dan kontrol sesi
• Commands - Mengakses checkpoints menggunakan /rewind
• CLI reference - Opsi baris perintah