Bài 7.216 phút · 5 thẻ · 8 bài tập · 1 nhiệm vụ

Checkpoint và rewind

Quay lại khi code đã viết mà hướng đi sai: ba cách khôi phục, tóm tắt để gọn ngữ cảnh, những gì rewind không thấy, và vì sao vẫn cần git.

Plan mode ở bài 7.1 giúp bạn chọn hướng trước khi có code. Nhưng có những lúc chỉ khi thấy code mới biết mình chọn sai: tên hàm đọc lên khó chịu, cách chia file làm test rối hơn, một bước refactor đi quá tay. Bài này nói về cách quay lại: checkpoint và lệnh /rewind, những gì chúng hoàn tác được, những gì không, và vì sao git vẫn cần.

Checkpoint là gì

Claude Code tự động lưu trạng thái code trước mỗi prompt bạn gửi. Mỗi prompt bắt đầu một lượt là một checkpoint. Bạn không cần làm gì để có chúng.

Vài con số đáng nhớ:

  • Mỗi phiên giữ snapshot cho 100 checkpoint gần nhất.
  • Checkpoint lưu cùng với hội thoại, nên bạn mở lại phiên hôm qua vẫn rewind được.
  • Snapshot bị dọn sau khoảng 30 ngày kể từ lần lưu cuối. Rewind tới một checkpoint đã bị dọn sẽ báo No files were restored. Muốn giữ lâu hơn thì chỉnh cleanupPeriodDays.

Checkpoint theo dõi những file Claude sửa bằng công cụ sửa file (Edit, Write). Điều này quan trọng, và mục 4 sẽ quay lại.

Mở menu rewind

Hai cách:

  • Gõ /rewind (hoặc tên ngắn hơn, /undo).
  • Nhấn Esc hai lần khi ô nhập đang trống. Nếu ô nhập có chữ, Esc hai lần sẽ xóa chữ thay vì mở menu; chữ đó vẫn nằm trong lịch sử, nhấn Up để lấy lại.

Menu liệt kê các prompt bạn đã gửi trong phiên. Chọn mốc muốn quay về, rồi chọn việc cần làm. Bài 1.3 đã nhắc Esc để dừng Claude giữa chừng: Esc một lần là dừng, Esc hai lần trên ô trống là quay lại.

Ba cách quay lại

Ở mốc đã chọn, menu có các lựa chọn:

Lựa chọn Code Hội thoại Khi nào dùng
Restore code and conversation Về mốc cũ Về mốc cũ Cả hướng đi đều sai, làm lại từ đó
Restore conversation Giữ như hiện tại Về mốc cũ Code ổn, nhưng cuộc trò chuyện đã rối
Restore code Về mốc cũ Giữ như hiện tại Bỏ thay đổi, nhưng giữ những gì Claude đã học được

Hai lựa chọn khôi phục code chỉ hiện khi từ mốc đó có thay đổi file được theo dõi. Sau "Restore conversation", prompt gốc được đưa lại vào ô nhập: bạn sửa nó cho rõ hơn rồi gửi lại, thay vì gõ thêm một lần sửa chồng lên lần cũ.

"Restore code" hay bị bỏ qua nhưng rất hữu ích. Ví dụ Claude đổi tên hàm list thành findAll khắp nơi, bạn không thích. Restore code đưa file về như cũ, còn Claude vẫn nhớ đã thử gì và vì sao bạn không thích, nên lần sau làm đúng hơn.

Menu còn hai lựa chọn tóm tắt: "Summarize from here" và "Summarize up to here". Chúng nén một đoạn hội thoại thành bản tóm tắt để giải phóng ngữ cảnh, không đổi file. Gõ chỉ dẫn ở dòng "add context (optional)" để định hướng bản tóm tắt. Cách này giống /compact nhưng có chọn lọc; bài 7.3 bàn thêm về ngữ cảnh.

Những gì rewind không thấy

Đây là phần quan trọng nhất của bài. Checkpoint không hoàn tác được:

  • File chỉ do lệnh Bash sửa. Ở bài 6.2, Claude đã chèn một dòng bằng printf … >> src/app.js thay vì Edit. Nếu app.js chưa từng được Claude sửa bằng Edit trong phiên, dòng đó không được hoàn tác. (Nếu file đã được sửa bằng Edit trước đó, thay đổi bằng Bash sau đó thì được theo dõi.)
  • Thay đổi của subagent, phần lớn các trường hợp. Debugger chạy trong worktree ở bài 4.3 sửa ở chỗ khác hẳn; subagent chạy nền sửa file mà phiên của bạn không ghi lại.
  • Thay đổi ngoài Claude Code: bạn sửa tay trong editor, một phiên Claude khác sửa cùng repo.
  • File symlink, hard link: bị bỏ qua, kèm thông báo Restored the code, but skipped N files.
  • Tin nhắn gõ khi Claude đang làm có thể ghi "No code restore"; chọn prompt bắt đầu lượt đó thay vào.

Docs nói thẳng: checkpoint để phục hồi nhanh trong phiên, không thay git.

Rewind, branch và git

Ba công cụ, ba việc khác nhau:

  • Rewind: lùi một hai bước trong phiên đang làm. Nhanh, không cần nghĩ trước.
  • /branch tên: chép hội thoại tới lúc đó sang một nhánh mới và chuyển bạn vào; bản gốc nằm nguyên, quay về bằng /resume. Dùng khi muốn thử một hướng khác mà vẫn giữ cuộc trò chuyện cũ. Lưu ý: hai nhánh hội thoại vẫn làm việc trên cùng một thư mục code. Muốn hai bản code thật sự tách nhau thì dùng nhánh git hoặc worktree như bài 4.3.
  • Git: lịch sử lâu dài, chia sẻ với team, và là lưới an toàn cho mọi thứ rewind không thấy.

Thói quen đơn giản kết hợp cả ba: commit trước một thay đổi lớn. Khi đó rewind lo những bước nhỏ trong phiên, còn git diff và git checkout lo mọi thứ còn lại, kể cả những gì Bash hay subagent đã làm.

Thử táo bạo, lùi khi cần

Có checkpoint, bạn có thể thử hướng táo bạo trước, vì lùi lại rất rẻ. Docs khuyên kèm hai thói quen:

  • Theo dõi phút đầu và nhấn Esc ngay khi Claude lệch hướng.
  • Sửa hai lần không được thì dừng. Lần sửa thứ ba chỉ chồng thêm vào một hội thoại đã có hai lần thất bại. Rewind về trước đó (hoặc /clear) rồi viết một prompt tốt hơn, gom những gì bạn vừa học được.

Với todo-api, quy trình refactor một module trông như sau: commit sạch, lập kế hoạch ở plan mode (bài 7.1), duyệt, để Claude làm từng bước, và khi một bước đi sai thì Esc Esc, chọn mốc ngay trước bước đó, "Restore code and conversation", sửa lại prompt rồi gửi. Nhiệm vụ của bài làm đúng như vậy với phần kiểm tra dữ liệu trong route.

Bài sau, 7.3, lo nốt chuyện của những phiên dài: việc chạy nền, quản lý và mở lại phiên, và giữ ngữ cảnh gọn khi làm việc nhiều giờ.

Luyện tập bài 7.2

5 thẻ ghi nhớ, 8 bài tập chấm ngay trên trang, 1 nhiệm vụ làm trên máy.

Bắt đầu luyện tập

Tra cứu liên quan

Gõ để tìm trong tra cứu, mẫu cấu hình và bài học. Không dấu cũng được.