이 게시물은 Claude Code의 Checkpoints 기능과 사용법을 정리한 글입니다.

핵심 기능

• 프롬프트 입력 시점의 파일 상태와 대화 내용을 자동 스냅샷으로 저장
• /rewind 또는 Esc 두 번으로 이전 시점 선택 및 복원 가능

복원 옵션

• Restore code and conversation: 코드와 대화 모두 되돌림
• Restore code: 코드만 되돌림
• Restore conversation: 대화만 되돌림
• Summarize from here: 이후 대화 요약으로 압축, 코드 유지
• Never mind: 취소 선택

주의사항

• 공식 편집 도구(Write, Edit, NotebookEdit)로 한 변경만 추적, Bash나 직접 편집은 추적 불가
• Tasks 상태(~/.claude/tasks/)는 Checkpoints의 추적 범위 밖이라 파일과 상태 불일치 발생 가능
• DB 마이그레이션·대량 파일 이동 등 되돌릴 수 없는 작업 전에는 Git 커밋 권장