Claude Code는 작업하는 동안 Claude의 파일 편집 내용을 자동으로 추적하여, 무언가 잘못되었을 때 변경 사항을 빠르게 취소하고 이전 상태로 되돌릴 수 있게 해줍니다.

​
체크포인트 작동 방식

Claude와 작업할 때, 체크포인팅은 각 편집 전에 코드의 상태를 자동으로 캡처합니다. 이 안전망을 통해 언제든지 이전 코드 상태로 돌아갈 수 있다는 것을 알고 야심찬 대규모 작업을 추진할 수 있습니다.

​
자동 추적

Claude Code는 파일 편집 도구로 만든 모든 변경 사항을 추적합니다:
  • 모든 사용자 프롬프트가 새로운 체크포인트를 생성합니다
  • 체크포인트는 세션 간에 지속되므로 재개된 대화에서 액세스할 수 있습니다
  • 30일 후 세션과 함께 자동으로 정리됩니다 (구성 가능)

​
변경 사항 되돌리기

Esc를 두 번 누르거나 (Esc + Esc) /rewind 명령을 사용하여 되돌리기 메뉴를 엽니다. 다음을 복원하도록 선택할 수 있습니다:
  • 대화만: 코드 변경 사항은 유지하면서 사용자 메시지로 되돌리기
  • 코드만: 대화는 유지하면서 파일 변경 사항 되돌리기
  • 코드와 대화 모두: 세션의 이전 시점으로 둘 다 복원

​
일반적인 사용 사례

체크포인트는 다음과 같은 경우에 특히 유용합니다:
  • 대안 탐색: 시작점을 잃지 않고 다양한 구현 접근 방식을 시도
  • 실수로부터 복구: 버그를 도입하거나 기능을 손상시킨 변경 사항을 빠르게 취소
  • 기능 반복: 작동하는 상태로 되돌릴 수 있다는 것을 알고 변형을 실험

​
제한 사항

​
Bash 명령 변경 사항은 추적되지 않음

체크포인팅은 bash 명령으로 수정된 파일을 추적하지 않습니다. 예를 들어, Claude Code가 다음을 실행하는 경우: 
rm file.txt
mv old.txt new.txt
cp source.txt dest.txt
이러한 파일 수정은 되돌리기를 통해 취소할 수 없습니다. Claude의 파일 편집 도구를 통해 만든 직접적인 파일 편집만 추적됩니다.

​
외부 변경 사항은 추적되지 않음

체크포인팅은 현재 세션 내에서 편집된 파일만 추적합니다. Claude Code 외부에서 파일에 수동으로 만든 변경 사항과 다른 동시 세션의 편집은 현재 세션과 동일한 파일을 수정하는 경우가 아니면 일반적으로 캡처되지 않습니다.

​
버전 제어의 대체재가 아님

체크포인트는 빠른 세션 수준 복구를 위해 설계되었습니다. 영구적인 버전 기록과 협업을 위해서는:
  • 커밋, 브랜치, 장기 기록을 위해 버전 제어(예: Git)를 계속 사용하세요
  • 체크포인트는 적절한 버전 제어를 보완하지만 대체하지는 않습니다
  • 체크포인트는 “로컬 실행 취소”로, Git은 “영구 기록”으로 생각하세요

​
참고 항목