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
TekanEsc 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
- Tidak jadi: kembali ke daftar pesan tanpa membuat perubahan
Pulihkan vs. ringkas
Tiga opsi pemulihan mengembalikan status: mereka membatalkan perubahan kode, riwayat percakapan, atau keduanya. “Ringkas dari sini” bekerja berbeda:- Pesan sebelum pesan yang dipilih tetap utuh
- Pesan yang dipilih dan semua pesan berikutnya diganti dengan ringkasan yang dihasilkan AI yang ringkas
- Tidak ada file di disk yang diubah
- Pesan asli disimpan dalam transkrip sesi, sehingga Claude dapat mereferensikan detail jika diperlukan
/compact, tetapi ditargetkan: alih-alih meringkas seluruh percakapan, Anda menyimpan konteks awal dalam detail lengkap dan hanya mengompres bagian yang menggunakan ruang. Anda dapat mengetik instruksi opsional untuk memandu fokus ringkasan.
Ringkas membuat Anda tetap berada di sesi yang sama dan mengompres konteks. Jika Anda ingin bercabang dan mencoba pendekatan berbeda sambil mempertahankan sesi asli tetap utuh, gunakan fork sebagai gantinya (
claude --continue --fork-session).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: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
- Perintah bawaan - Mengakses checkpoints menggunakan
/rewind - Referensi CLI - Opsi baris perintah