변경 전 상태부터 보존합니다
작업을 시작할 때 저장소·브랜치·HEAD와 수정·미추적 파일을 확인합니다. 이미 있던 변경을 내 작업으로 취급하거나 통째로 지우지 않습니다. 수정 대상과 제외 경로를 정하고, 비밀 파일이 섞이지 않도록 필요한 파일만 기록합니다.
git status --short
git diff --stat
git diff -- path/to/changed-file
위 명령은 상태 확인 예시입니다. 경로와 출력 내용을 검토한 뒤 실제 저장 범위를 정합니다. 커밋은 선택한 추적 파일의 이력이며 외부 데이터베이스·인증 세션·모든 미추적 파일의 백업이 아닙니다.
stash와 revert의 대상도 다릅니다
git stash 기본 동작이 미추적·무시 파일까지 전부 보관한다고 가정하지 않습니다. 옵션별 포함 범위를 먼저 확인하고, 복구 후 내용이 맞는지 확인하기 전 보관본을 제거하지 않습니다. 공유된 작업에서는 다른 작성자의 변경과 충돌할 수 있습니다. Git stash
git revert는 기존 커밋의 효과를 반대로 적용하는 새 커밋을 만드는 방식입니다. 과거 이력을 없애거나 이미 반영된 외부 데이터를 되돌리는 작업이 아닙니다. 미반영 변경을 먼저 보존하고, 되돌린 결과의 검사와 게시를 별도 단계로 다룹니다. Git revert
대화 분기는 Git 브랜치가 아닙니다
저장된 Claude Code 세션은 이어갈 수 있지만, 대화를 다시 열었다고 당시 작업 트리가 복원되지는 않습니다. claude --continue나 --resume을 사용할 때 실제 프로젝트·현재 파일·미완료 작업을 다시 확인합니다. 대화 분기는 다른 접근을 시험하는 기록일 뿐, 대화를 나눴다고 파일 이력까지 나뉘는 것은 아닙니다. CLI의 대화 재개 옵션
같은 경로를 동시에 수정하는 작성자가 있다면 대상 파일을 먼저 조정합니다. 세션 목록에 완료·대기로 표시됐다고 해서 파일이 통합되거나 게시가 확인된 것은 아닙니다. 이 글에서는 다른 세션을 시작하거나 작업을 위임하지 않았습니다.
rewind는 추적된 파일 범위에서만 복구합니다
Claude Code checkpoint는 세션에서 파일 편집 도구가 다룬 파일을 중심으로 추적합니다. 이미 추적된 파일을 나중에 Bash가 바꾼 경우에는 되돌리기에 포함될 수 있지만, Bash만 바꾼 파일까지 항상 추적되는 것은 아닙니다. 하위 에이전트·다른 세션의 모든 변경도 한 번에 복구된다고 가정하지 않습니다.
대화만 복원, 코드 복원, 요약의 효과를 구별하고 실제 선택 대상과 이후 변경을 확인합니다. /clear나 요약은 모든 로컬 기록을 삭제하는 명령이 아닙니다. 공식 문서도 checkpoint를 장기 버전 관리 대신 쓰라고 설명하지 않습니다. checkpoint의 추적 범위와 제한
운영 데이터·외부 서비스·로그인 상태는 각각의 복구 절차가 필요합니다. 복구 전후 파일, 검사 결과와 실제 사이트 상태를 별도로 확인하며, 이 글을 작성하며 되돌리기·삭제·로그아웃을 실행하지 않았습니다.
자료 범위
2026년 10월 29일 공식 문서와 저장된 원고를 대조했습니다. 기능의 제공 조건은 버전·계정·환경에 따라 달라집니다. 본문의 예시와 확인 절차는 실제로 실행하거나 성능을 측정한 결과가 아닙니다.