Claude Code 상세 사용법 56: 체크포인트와 /rewind로 안전하게 되돌리기 | DAKER 커뮤니티

Claude Code 상세 사용법 56: 체크포인트와 /rewind로 안전하게 되돌리기

Claude Code에서 과감한 리팩터링을 맡길 때 가장 중요한 안전장치는 “잘 부탁해”가 아니라 복구 경로입니다. 공식 checkpointing 문서 기준으로 Claude Code는 파일 편집 도구로 만든 변경을 프롬프트 단위로 추적하고, /rewind에서 코드와 대화 상태를 골라 되돌릴 수 있습니다.

Mermaid 흐름으로 보는 복구 선택

아래 Mermaid source처럼 먼저 되돌릴 대상이 코드인지, 대화인지, 컨텍스트인지 분리합니다.

Mermaid source:
flowchart TD
  A[문제가 생김] --> B{무엇을 되돌릴까}
  B --> C[코드만: Restore code]
  B --> D[대화만: Restore conversation]
  B --> E[둘 다: Restore code and conversation]
  B --> F[길어진 대화: Summarize]

기본 사용법

입력창이 비어 있을 때 /rewind를 실행하거나 Esc를 두 번 눌러 rewind menu를 엽니다. 입력창에 텍스트가 남아 있으면 Esc 두 번은 메뉴 대신 입력을 지우므로, 먼저 현재 프롬프트를 저장할지 확인하세요.

/rewind

메뉴에는 세션에서 보낸 프롬프트가 나옵니다. 잘못된 리팩터링이 시작된 지점을 고른 뒤 Restore code, Restore conversation, Restore code and conversation, Summarize from here, Summarize up to here 중 하나를 선택합니다.

코드 복구와 대화 복구를 분리한다

테스트가 깨졌지만 Claude가 원인 분석은 잘하고 있었다면 Restore code만 선택합니다. 반대로 파일은 괜찮은데 대화가 엉뚱한 방향으로 갔다면 Restore conversation이 낫습니다. 둘 다 틀렸으면 둘 다 되돌립니다.

이전 지점으로 코드만 되돌린 뒤, 실패한 접근의 원인을 요약하고 더 작은 패치로 다시 시도해줘.

Summarize 계열은 파일을 되돌리지 않습니다. 대화 일부를 요약해 context window를 확보하는 기능입니다. /compact보다 세밀하게 어느 구간을 압축할지 고를 수 있다는 점이 차이입니다.

추적되지 않는 변경을 조심한다

중요한 제한이 있습니다. checkpoint는 Claude의 파일 편집 도구가 만든 변경을 추적합니다. Bash로 실행한 rm, mv, cp, code generator, migration, package script가 만든 파일 변경은 rewind로 복구되지 않을 수 있습니다.

git diff --stat
git diff

그래서 큰 작업 전후에는 Git diff를 봅니다. 특히 테스트 자동화나 CLI 자동화가 파일을 생성하는 저장소라면 /rewind만 믿지 말고 브랜치, 커밋, 백업을 함께 씁니다.

실무 패턴

첫째, 위험한 작업은 작은 프롬프트로 쪼갭니다. 프롬프트 하나가 checkpoint 하나가 되므로 “인증 모듈 전체를 고쳐줘”보다 “토큰 갱신 경로만 고쳐줘”가 복구하기 쉽습니다.

둘째, 실패한 접근을 지운 뒤 같은 요청을 반복하지 않습니다. 되돌린 다음에는 실패 원인, 변경 범위, 검증 명령을 명시합니다.

방금 접근은 되돌렸다. 이번에는 public API는 건드리지 말고 내부 parser만 수정해.
npm test -- parser 를 통과해야 완료로 보고해.

셋째, 협업 기록은 Git에 남깁니다. checkpoint는 세션 단위 로컬 undo이고, Git은 팀이 공유하는 영구 이력입니다.

실패 모드

가장 흔한 실패는 Bash가 만든 변경까지 /rewind가 되돌릴 것이라고 기대하는 것입니다. 두 번째는 대화만 되돌렸는데 파일 상태도 되돌아갔다고 착각하는 것입니다. 세 번째는 summarize를 restore로 오해하는 것입니다. summarize는 컨텍스트 정리이지 파일 복구가 아닙니다.

시니어 엔지니어의 결론

Claude Code, 클로드 코드, 바이브코딩 워크플로우에서 checkpoint는 “실험해도 되는 여유”를 줍니다. 다만 AI 코딩 복구 전략은 /rewind와 Git을 같이 써야 완성됩니다. 코드 리뷰 전에는 Git diff로 실제 파일 상태를 확인하고, 테스트 자동화 결과를 다시 읽은 뒤에만 복구 완료라고 말하세요.

참고: Anthropic Claude Code checkpointing, commands, llms.txt 문서를 2026-06-13 Asia/Seoul 기준으로 확인했습니다.

Redirecting to Claude Code 상세 사용법 56: 체크포인트와 /rewind로 안전하게 되돌리기 | DAKER 커뮤니티...