기타
Claude Code Checkpoints로 잘못된 작업 되돌리기
두줄요약
Claude Code의 Checkpoints와 /rewind로 코드와 대화를 시점별로 되돌리는 방법을 설명했습니다. Tasks 상태와 Bash 변경은 추적되지 않으므로 Git 커밋이 필요하다고 정리했습니다.
문제 상황
- Claude Code에서 복잡한 리팩토링 중 잘못된 방향으로 작업이 누적되는 상황
- 여러 파일 수정 뒤에 문제를 발견하면 에디터 Undo나 git reset만으로 즉시 복원하기 어려운 점
원인 분석
- 프롬프트 입력 시점마다 작업 맥락이 길어지며 초기 지시가 희미해지는 구조
- 공식 편집 도구 변경만 추적되고 Bash 수정, 직접 편집, Tasks 상태는 추적 범위 밖인 점
해결 방법
- Checkpoints로 프롬프트마다 파일 상태와 대화 내용을 자동 스냅샷 저장
- /rewind 또는 Esc 두 번으로 코드·대화 복원 범위를 선택해 되돌리기
- Restore code, Restore conversation, Summarize from here로 상황별 복원·압축 수행
주의할 점
- Bash 명령, rm·mv·cp·sed -i 같은 변경은 rewind 대상이 아닌 점
- Tasks 상태는 별도 저장소에 남아 파일과 대화 복원 결과와 불일치할 수 있는 점
- 위험한 작업 전에는 Git 커밋으로 별도 복구 지점 확보 필요