AI
Checkpointing Claude Code: Mundurkan Perubahan Berisiko
Agustus 20268 menit baca
Checkpointing adalah fitur Claude Code yang otomatis menyimpan snapshot proyek Anda sebelum tiap perubahan yang dibuat agen. Setiap checkpoint menangkap baik berkas dalam keadaan saat itu maupun titik dalam percakapan yang menghasilkannya, sehingga Anda bisa kembali ke keadaan yang diketahui baik nanti. Ia memberi Anda undo instan yang terbatas pada sesi untuk suntingan agen tanpa penyiapan manual.
Buka menu rewind dengan menekan tombol Escape dua kali secara cepat, atau dengan mengetik perintah rewind. Anda akan melihat daftar checkpoint terbaru, dan memilih salah satunya menampilkan pratinjau apa yang akan terjadi jika kembali ke sana. Claude Code lalu menanyakan apakah memulihkan hanya kode, hanya percakapan, atau keduanya sekaligus.
Tidak. Checkpoint terikat pada sesi Anda dan bisa kedaluwarsa atau hilang saat sesi berakhir, serta tidak mencakup suntingan manual atau berkas yang diubah oleh perintah bash. Perlakukan checkpointing sebagai undo cepat sementara untuk kesalahan agen dan teruslah commit ke git untuk keadaan apa pun yang benar-benar ingin Anda pertahankan.
Bisa. Saat Anda rewind, Claude Code membiarkan Anda memilih mengembalikan hanya kode, hanya percakapan, atau keduanya. Memulihkan percakapan tanpa kode membuat Anda bisa menyimpan suntingan yang Anda sukai sambil mundur ke titik lebih awal dalam diskusi, dan sebaliknya membuat Anda bisa membuang suntingan sambil menjaga apa yang telah didiskusikan.
Tidak dengan andal. Checkpointing melacak suntingan yang dibuat Claude Code melalui tool penyuntingnya sendiri, sehingga berkas yang ditulis ulang oleh perintah shell yang dijalankannya, suntingan yang Anda buat manual di editor lain, dan apa pun di luar workspace yang dilacak bisa berada di luar sebuah checkpoint. Rewind mungkin tidak memulihkan perubahan itu, itulah mengapa git tetap menjadi sumber kebenaran Anda.
Ringkasan Utama
Checkpointing Claude Code otomatis menyimpan snapshot proyek Anda sebelum tiap suntingan, sehingga Anda bisa mundur ke keadaan sebelumnya ketika sebuah perubahan salah. Tekan Escape dua kali atau jalankan perintah rewind, lalu pilih memulihkan kode, percakapan, atau keduanya. Ini adalah undo instan untuk kesalahan agen, bukan pengganti commit git.
Membiarkan agen menyunting kode Anda dengan cepat terasa mengasyikkan sampai ia me-refactor modul yang salah, menghapus fungsi yang berjalan, atau membawa rencana ke arah yang tak pernah Anda inginkan. Membatalkannya secara manual lambat dan rawan salah, dan pintasan undo di editor Anda hanya menjangkau satu berkas yang kebetulan sedang terbuka.
Checkpointing Claude Code hadir persis untuk momen ini. Ia merekam keadaan proyek Anda sebelum tiap perubahan yang dibuat agen, sehingga Anda bisa melompat kembali ke titik yang diketahui baik dalam satu langkah. Panduan ini menjelaskan bagaimana checkpoint dibuat, cara rewind, dan di mana fitur ini berhenti agar Anda tidak bergantung padanya untuk hal yang seharusnya dilakukan git.
Sebuah checkpoint adalah snapshot otomatis yang diambil Claude Code sebelum ia menerapkan suntingan. Anda tidak perlu memintanya; sesi merekamnya sambil bekerja, membangun linimasa keadaan yang bisa Anda tuju kembali. Setiap checkpoint menangkap baik berkas dalam keadaan saat itu maupun titik dalam percakapan yang menghasilkannya.
Pemasangan kode dan percakapan itulah yang membuat rewind berguna, bukan sekadar tumpukan undo biasa:
Ada dua cara masuk ke menu rewind. Tekan tombol Escape dua kali secara cepat, atau ketik perintah rewind. Keduanya membuka daftar checkpoint terbaru, dan memilih salah satunya menampilkan pratinjau apa yang akan terjadi jika kembali ke sana sebelum Anda memastikannya.
Saat Anda rewind, Claude Code menanyakan apa yang ingin Anda pulihkan. Anda bisa mengembalikan hanya kode, hanya percakapan, atau keduanya sekaligus, yang memungkinkan Anda menyimpan diskusi yang berguna sambil membuang suntingan yang dihasilkannya, atau sebaliknya.
Rewind adalah jaring pengaman yang membuat prompt berani jadi terjangkau. Karena suntingan buruk hanya sejauh satu ketukan tombol dari dibatalkan, Anda bisa membiarkan agen mencoba perubahan ambisius, mengamati hasilnya, dan me-rewind seketika jika meleset, alih-alih terlalu merinci setiap pengaman di awal.
Rewind bersinar setiap kali jalur termurah ke depan adalah meninggalkan potongan kerja terakhir alih-alih memperbaikinya. Beberapa situasi yang berulang cocok dengan bentuk itu.
Checkpointing melacak perubahan yang dibuat Claude Code melalui tool penyuntingnya sendiri. Ia bukan sistem kontrol versi serbaguna, dan ia tidak melihat semua yang terjadi di working tree Anda. Perlakukan ia sebagai undo cepat yang terbatas pada sesi, bukan sebagai sumber kebenaran Anda.
Perbedaan itu paling penting di sekitar perubahan yang tidak ditangkap fitur ini. Berkas yang ditulis ulang oleh perintah shell yang dijalankan agen, suntingan yang Anda buat manual di editor lain, dan apa pun di luar workspace yang dilacak bisa berada di luar sebuah checkpoint, sehingga rewind mungkin tidak memulihkannya seperti yang Anda harapkan.
Checkpointing bukan pengganti git. Checkpoint terikat pada sesi Anda dan bisa kedaluwarsa atau hilang saat sesi berakhir, serta tidak mencakup suntingan manual atau berkas yang diubah oleh perintah bash. Teruslah melakukan commit ke git untuk apa pun yang benar-benar ingin Anda simpan.
Rewind paling kuat ketika ia berdampingan dengan kebiasaan yang sudah menjaga kerja agen tetap terkendali, bukan ketika ia menggantikannya.
Checkpointing menurunkan biaya membiarkan agen mencoba berbagai hal, karena setiap perubahan yang dibuatnya hanya sejauh satu ketukan tombol dari dibatalkan. Pelajari rewind Escape ganda, putuskan dengan sengaja apakah akan memulihkan kode, percakapan, atau keduanya, dan teruslah commit ke git untuk keadaan yang penting. Digunakan bersama, keduanya membuat Anda bergerak cepat tanpa takut kehilangan kerja.