muaco Tech Note

Claude Codecode.claude.com

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

Claude Code가 파일을 잘못 고쳤을 때 /rewind 메뉴로 이전 상태로 되돌리는 법과, 체크포인트가 지켜 주지 못하는 경우를 알려 드려요.

안녕하세요, muaco입니다.

이 글로 할 수 있는 일

Claude Code는 요청마다 저장 지점을 자동으로 남기므로, 잘못된 수정도 메뉴 하나로 되돌릴 수 있습니다. 이 저장 지점의 이름은 체크포인트. AI에게 맡긴 파일 수정이 엉뚱하게 끝난 날에도 손으로 하나하나 되돌릴 필요가 없습니다.

이 글을 따라 하면 되돌리기 메뉴를 직접 열게 됩니다. 파일만 되돌릴지, 대화까지 되돌릴지 고르는 법도 다룹니다.

체크포인트가 지켜 주지 못하는 경우도 함께 짚어 보겠습니다. 이 부분을 모르고 믿었다가는 크게 당하기 쉽습니다.

미리 갖춰야 할 준비

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

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

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

게임은 보통 어디서 저장될까요? 대개 문 앞이나 모닥불 앞입니다. Claude Code에서는 여러분이 새 요청을 보내는 순간이 바로 그 자리.

요청을 보내면 Claude가 일을 시작하기 직전의 파일 상태가 찍힙니다. 덕분에 "세 번째 요청 전으로 돌아가자"처럼 요청 단위로 되돌릴 수 있습니다.

몇 가지 숫자도 알아 두면 좋습니다. 한 세션(Claude Code를 켜서 이어 가는 대화 한 묶음)에서 파일 사본은 가장 최근 체크포인트 100개까지 보관됩니다.

세션을 닫았다가 다시 이어 열면 어떨까요? 체크포인트는 대화와 함께 저장되므로 이때도 /rewind를 쓸 수 있습니다.

다만 세션이 마지막으로 사본을 남긴 뒤 기본 약 30일이 지나면 정리 작업이 사본을 지웁니다. 더 오래 두고 싶다면 설정의 cleanupPeriodDays 값을 늘려 보세요. 문서에 안내된 방법입니다.

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

1. 일부러 망쳐 보기

따라 하기
  1. 터미널에서 연습 폴더로 들어가 Claude Code를 켜세요. 입력칸이 보이면 준비 완료.
  2. "메모.txt의 모든 줄을 영어로 바꿔 줘"라고 요청하세요. 이 요청을 보내는 순간, 바뀌기 전 상태가 저장됩니다.
  3. Claude가 작업을 마치면 메모 파일을 열어 보세요. 문장이 영어로 바뀌어 있다면 망가뜨리기에 성공했습니다.

2. 되돌리기 메뉴 열기

따라 하기
  1. 입력칸을 비운 채로 Esc를 두 번 누르세요. 입력칸에 /rewind를 치고 엔터를 눌러도 같은 메뉴가 열립니다.
  2. 이번 세션에서 보낸 요청 목록이 화면에 뜨나요? 그렇다면 제대로 열렸습니다.
  3. 방향키로 "메모.txt의 모든 줄을 영어로 바꿔 줘"를 고르세요. 이 요청을 보내기 직전으로 돌아가겠다는 뜻입니다.

여기서 다들 한 번은 멈칫합니다. 입력칸에 글자가 남아 있으면 Esc 두 번이 메뉴를 여는 대신 그 글자를 지우기 때문입니다.

지워진 글은 어디로 갔을까요? 입력 기록에 그대로 남아 있습니다. 메뉴 일을 마친 뒤 Up 키로 다시 불러와 보세요.

3. 되돌리는 방식 고르기

시점을 고르면 이제 할 일을 묻는 선택지 차례. 서랍 정리에 빗대면 이해가 쉽습니다. 서랍 속 물건만 옛날로 돌릴지, 정리하며 나눈 대화만 돌릴지, 둘 다 돌릴지 고르는 자리입니다.

선택지파일대화이런 경우에 고르세요
Restore code and conversation되돌림되돌림처음부터 다시 시키고 싶을 때
Restore conversation그대로되돌림파일은 마음에 드는데 대화 흐름만 다시 잡고 싶을 때
Restore code되돌림그대로대화에서 오간 설명은 남기고 파일만 원래대로 돌리고 싶을 때
따라 하기
  1. 이번 연습에서는 Restore code를 고르세요. 잘못 골랐을 때는 Never mind가 답입니다. 아무것도 바꾸지 않고 목록으로 돌아갑니다.
  2. 메모 파일을 다시 열어 보세요. 처음 적은 한국어 세 줄이 돌아와 있으면 성공입니다.
  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#체크포인트#되돌리기#rewind#안전장치#AI 코딩 도구#Git

같은 분류의 글