Checkpointing - Claude Code Docs

Claude Code는 작업하면서 Claude의 파일 편집을 자동으로 추적하므로, 문제가 발생하면 변경 사항을 빠르게 실행 취소하고 이전 상태로 되돌릴 수 있습니다.

Checkpointing의 작동 방식

Claude와 함께 작업할 때, checkpointing은 각 편집 전에 코드의 상태를 자동으로 캡처합니다. 이 안전망을 통해 항상 이전 코드 상태로 돌아갈 수 있다는 것을 알면서 야심 찬 대규모 작업을 수행할 수 있습니다.

Claude Code는 파일 편집 도구로 수행된 모든 변경 사항을 추적합니다:

Esc 두 번(Esc + Esc)을 누르거나 /rewind 명령을 사용하여 rewind 메뉴를 엽니다. 다음을 복구하도록 선택할 수 있습니다:

Checkpoint는 다음과 같은 경우에 특히 유용합니다:

Checkpointing은 bash 명령으로 수정된 파일을 추적하지 않습니다. 예를 들어, Claude Code가 다음을 실행하는 경우:

rm file.txt
mv old.txt new.txt
cp source.txt dest.txt

이러한 파일 수정 사항은 rewind를 통해 실행 취소할 수 없습니다. Claude의 파일 편집 도구를 통해 직접 수행된 파일 편집만 추적됩니다.

Checkpointing은 현재 세션 내에서 편집된 파일만 추적합니다. Claude Code 외부에서 수동으로 수행한 파일 변경 사항과 다른 동시 세션의 편집은 일반적으로 캡처되지 않습니다. 단, 현재 세션과 동일한 파일을 수정하는 경우는 예외입니다.

Checkpoint는 빠른 세션 수준의 복구를 위해 설계되었습니다. 영구적인 버전 기록 및 협업을 위해: