Claude Code 체크포인트로 되돌리기/rewind 사용법과 안 되는 경우

안녕하세요, muaco입니다.

이 글로 할 수 있는 것

AI에게 파일 수정을 맡겼는데 엉뚱하게 고쳐 놓는 날이 있어요. 이럴 때 Claude Code는 손으로 하나하나 되돌리지 않아도 되게 저장 지점을 알아서 남겨 둬요. 이 저장 지점을 체크포인트라고 불러요. 이 글을 따라 하면 되돌리기 메뉴를 열고, 파일만 되돌릴지 대화까지 되돌릴지 골라 쓸 수 있게 돼요. 체크포인트가 지켜 주지 못하는 경우도 함께 짚어요. 이걸 모르면 믿고 있다가 크게 당해요.

미리 갖춰야 할 준비

• Claude Code가 설치되고 로그인된 상태여야 해요. 설치는 이 글에서 다루지 않아요. 공식 문서를 먼저 보고 오세요.
• 터미널에서 Claude Code를 켜 본 경험이 한 번은 있으면 좋아요. 터미널은 글자로 컴퓨터에 명령을 내리는 검은 창이에요.
• 연습용 폴더와 텍스트 파일 하나를 준비해요. 중요한 업무 파일로 처음 연습하면 마음이 급해져요. 예를 들어 연습 폴더 안에 메모.txt를 만들고 아무 문장이나 세 줄 적어 두세요.

이 글은 2026년 9월 기준 공식 문서를 보고 썼어요. 화면 문구는 버전에 따라 조금 다를 수 있어요.

체크포인트는 언제 저장되나

게임은 보통 문 앞이나 모닥불 앞에서 저장되죠. Claude Code의 저장 지점은 여러분이 새 요청을 보내는 순간이에요. 요청을 보내면 Claude가 일을 시작하기 직전의 파일 상태가 찍혀요. 그래서 "세 번째 요청 전으로 돌아가자"처럼 요청 단위로 되돌릴 수 있어요.

몇 가지 숫자도 알아 두면 좋아요. 한 세션(Claude Code를 켜서 이어 가는 대화 한 묶음)에서 파일 사본은 가장 최근 체크포인트 100개까지 보관돼요. 체크포인트는 대화와 함께 저장되니까, 세션을 닫았다가 다시 이어 열어도 /rewind를 쓸 수 있어요. 다만 세션이 마지막으로 사본을 남긴 뒤 기본 약 30일이 지나면 정리 작업이 사본을 지워요. 더 오래 두고 싶으면 설정의 cleanupPeriodDays 값을 늘리면 된다고 문서에 나와 있어요.

따라 하기: 되돌리기 메뉴 써 보기

1. 일부러 망쳐 보기

2. 되돌리기 메뉴 열기

여기서 다들 한 번 멈칫해요. 입력칸에 글자가 남아 있으면 Esc 두 번이 메뉴를 여는 대신 그 글자를 지워요. 겁먹을 것 없어요. 지워진 글은 입력 기록에 남아서, 메뉴 일을 마친 뒤 Up 키로 다시 불러올 수 있어요.

3. 되돌리는 방식 고르기

시점을 고르면 할 일을 묻는 선택지가 떠요. 서랍 정리에 빗대면 이래요. 서랍 속 물건만 옛날로 돌릴지, 정리하며 나눈 대화만 돌릴지, 둘 다 돌릴지 고르는 자리예요.

목록에 파일 되돌리기 선택지가 안 보일 수도 있어요. 고른 시점 뒤로 추적된 파일 수정이 없으면 두 가지 코드 복원 선택지는 아예 뜨지 않아요. 그때는 Restore conversation, 요약 선택지, Never mind만 나와요.

메뉴에는 Summarize from here와 Summarize up to here도 있어요. 이 둘은 파일을 건드리지 않아요. 긴 대화를 요약으로 눌러 담아 Claude가 기억할 공간을 비워 주는 기능이에요.

체크포인트가 지켜 주지 못하는 경우

체크포인트는 Claude가 파일 편집 도구로 직접 고친 내용만 기억해요. 아래 경우는 되돌리기 메뉴로 복구되지 않아요. 믿고 있다가 가장 많이 놀라는 부분이에요.

• Claude가 터미널 명령으로 바꾼 파일. Claude가 rm file.txt로 파일을 지우거나 mv old.txt new.txt로 이름을 바꾸거나 cp source.txt dest.txt로 복사했다면 되돌릴 수 없어요. 편집 도구가 아니라 명령(Bash)으로 한 일이라서 그래요.
• 여러분이 Claude Code 밖에서 고친 내용. 메모장으로 직접 고쳤거나 다른 Claude Code 창에서 고친 내용은 보통 기록되지 않아요. 지금 세션이 고친 파일과 겹칠 때만 우연히 담겨요.
• 대부분의 서브에이전트가 고친 내용. 서브에이전트는 Claude가 따로 불러 일을 나눠 맡기는 조수예요. 앞에서 바로 도는 일부 경우를 빼면 되돌리기로 복구되지 않아요. 문서는 이럴 때 Git으로 되돌리라고 안내해요.
• Claude가 일하는 도중에 보낸 메시지. 작업이 돌고 있을 때 끼어든 메시지는 새 저장 지점을 만들지 않고 목록에도 안 떠요. 그 작업을 시작한 요청으로 돌아가야 해요.
• 바로가기 링크로 연결된 파일. 심볼릭 링크나 하드 링크(파일 하나를 여러 자리에서 가리키게 해 둔 연결)는 건너뛰어요.

막히기 쉬운 곳

Esc를 두 번 눌렀는데 메뉴가 안 떠요

입력칸에 글자가 남아 있는지 먼저 봐요. 글자가 있으면 두 번 누르기가 입력 지우기로 쓰여요. 한 번 더 두 번 누르거나 /rewind를 직접 쳐요. 터미널 프로그램에 따라 단축키가 다르게 먹을 수 있다고 문서에도 적혀 있어요.

"Restored the code, but skipped N files"가 떠요

대부분 되돌렸지만 몇 개 파일은 건너뛰었다는 경고예요. 링크로 연결된 파일이거나 권한 문제로 파일을 못 고친 경우예요. 건너뛴 파일은 지금 내용 그대로 남아요. 어떤 파일인지 보려면 복원하기 전에 /debug를 켜 두세요. ~/.claude/debug/<session-id>.txt 기록에 건너뛴 경로가 적혀요. 그 파일은 Claude에게 수정 내용을 반대로 되돌려 달라고 하거나 직접 고쳐요.

"No files were restored"가 떠요

파일을 하나도 되돌리지 못했다는 뜻이에요. 오래된 세션이라 약 30일 정리로 사본이 지워졌을 가능성이 먼저 보여요. 그 밖에 폴더 쓰기 권한이 없거나 디스크 공간이 모자랄 때도 나요. 권한과 공간을 확인한 뒤 한 번 더 시도하고, 그래도 안 되면 Git 같은 다른 백업에서 꺼내야 해요.

여기서 더 나아가려면

체크포인트는 세션 안에서 빠르게 무르는 장치예요. 오래 남길 기록이나 여러 사람과 나눌 이력은 문서도 Git으로 관리하라고 해요. 중요한 작업을 맡기기 전에 Git으로 한 번 저장해 두면, 명령으로 지운 파일까지 두 겹으로 지킬 수 있어요.

이상으로 글 마치겠습니다.

출처

• Claude Code Docs: Checkpointing
• Claude Code Docs: Interactive mode
• Claude Code Docs: Errors