한 줄로 말하면
Claude Code는 파일을 고치기 직전마다 그 상태를 자동으로 저장해 둬요. 결과가 마음에 안 들면 Esc 두 번이나 /rewind로 원하는 시점까지 되돌릴 수 있어요.
이런 분께
- Claude Code로 웹페이지나 작은 도구를 만들어 보는 분
- AI가 멀쩡하던 파일을 망칠까 봐 큰 수정을 망설이는 분
- 버전 관리 도구(Git)는 아직 써 본 적 없는 분
체크포인트는 무엇인가요
체크포인트는 Claude가 파일을 고치기 전에 자동으로 찍어 두는 저장 지점이에요. 따로 "저장해"라고 말하지 않아도 생겨요. 그래서 여러 번 고친 뒤에도 "세 번째 수정 전으로 돌아가고 싶어"가 가능해요.
되돌릴 때는 범위를 고를 수 있어요.
- 코드만 파일은 그 시점으로, 지금까지 나눈 대화는 그대로
- 대화만 대화 흐름만 그 시점으로, 파일은 지금 상태 그대로
- 둘 다 파일과 대화를 함께 그 시점으로
코드만 되돌리면 "방금 방식은 취소하고, 이번엔 다르게 해 줘"처럼 대화를 이어 갈 수 있어서 가장 자주 쓰게 돼요.
되돌리는 방법
입력창에서 Esc 키를 빠르게 두 번 누르거나 /rewind를 입력하면 되돌릴 시점 목록이 떠요. 시점을 고른 뒤 범위(코드만·대화만·둘 다)를 선택하면 끝이에요. 되돌린 뒤에는 파일이 실제로 바뀌었는지 눈으로 한 번 확인하세요.
되돌려지지 않는 것
체크포인트는 만능 백업이 아니에요. 다음 변경은 되돌려지지 않을 수 있어요.
- 내가 편집기에서 직접 고친 내용
- 터미널 명령으로 일어난 변화(파일 삭제·이동, 설치, 데이터베이스 변경)
- 외부로 이미 보낸 것(배포, 메일 발송, 결제 등)
그래서 완성본이나 중요한 작업은 Git이나 별도 복사본으로 따로 지켜 두는 게 안전해요. 체크포인트는 "작업 중 실행 취소"로 생각하면 맞아요.
✅ 체크리스트
중요한 파일이 아니라 연습용 폴…
체크리스트 전체는 회원에게 열려 있어요
확인 중…📋 그대로 쓰는 프롬프트
지금까지 이 대화에서 바꾼 파일들…
프롬프트 전체 보기와 복사는 회원에게 열려 있어요
확인 중…참고할 점
- 되돌린 뒤 새 작업을 시작하면, 되돌리기 전의 이후 기록은 다시 고르기 어려울 수 있어요. 버려도 되는 상태인지 한 번 더 생각하고 되돌리세요.
- 기능 이름과 화면은 Claude Code 업데이트에 따라 바뀔 수 있어요. 막히면 공식 문서의 Checkpointing 항목을 확인하세요.


