Cmd. /rewind
대화와 코드를 이전 체크포인트로 되돌리거나 특정 메시지부터 요약하는 명령
핵심 요약
/rewind(별칭/checkpoint·/undo)는 코드·대화를 이전 체크포인트로 되돌리거나 선택 메시지를 기준으로 요약하는 메뉴를 엽니다.- 체크포인트는 프롬프트를 보낼 때마다 자동 생성되고 세션을 넘어 유지되며 기본 30일 후 정리됩니다.
- 메뉴에서 코드만·대화만·둘 다 복원하거나, 선택 지점 이후/이전을 요약(Summarize from/up to here)할 수 있습니다.
- 추적되는 변경은 Claude의 파일 편집 도구를 통한 편집뿐이며,
rm·mv등 Bash 명령이나 외부 수정은 되돌릴 수 없습니다. - 버전 관리의 대체재가 아닙니다. 영구 이력·협업에는 Git을 계속 사용하세요.
명령어 원본 선언
/rewind별칭으로 /checkpoint, /undo를 동일하게 사용할 수 있습니다. 추가 인자는 받지 않으며, 실행하면 되감기(rewind) 메뉴가 열립니다.
공식 설명 요약
공식 문서(commands)의 설명은 다음과 같습니다.
Rewind the conversation and/or code to a previous point, or summarize from a selected message. Aliases:
/checkpoint,/undo
정리하면 /rewind는 대화 기록과 코드 변경을 이전 시점으로 되돌리거나, 선택한 메시지를 기준으로 대화를 요약하는 명령입니다. Claude Code는 작업하는 동안 Claude가 파일 편집 도구로 만든 변경을 자동으로 추적해 체크포인트(checkpoint)를 만들어 두고, 이 메뉴에서 안전하게 되돌릴 수 있게 합니다.
체크포인트의 핵심 동작은 다음과 같습니다.
- 자동 추적: 사용자가 프롬프트를 보낼 때마다 새 체크포인트가 생성됩니다. Claude의 파일 편집 도구가 일으킨 모든 변경이 추적됩니다.
- 세션 간 유지: 체크포인트는 세션을 넘어 유지되므로 재개(resume)한 대화에서도 접근할 수 있습니다.
- 자동 정리: 세션과 함께 기본 30일 후 정리되며, 이 기간은 설정으로 조정할 수 있습니다.
최소 지원 버전
- 공식
commands문서의/rewind항목에는 별도의 최소 버전(min-version) 표기가 없습니다. 체크포인팅은 현재 정식 기능으로 문서화되어 있고, 최소 버전을 따로 명시한 부분은 확인되지 않습니다.
사용법
# 되감기 메뉴 열기 (별칭 동일)
/rewind
/checkpoint
/undo/rewind를 입력하거나, 프롬프트 입력창이 비어 있을 때 Esc를 두 번 누르면 되감기 메뉴가 열립니다.
입력창에 텍스트가 있으면
Esc두 번은 메뉴를 여는 대신 입력을 지웁니다. 지워진 텍스트는 입력 기록에 남으므로 메뉴 작업을 마친 뒤Up(위 화살표)으로 다시 불러올 수 있습니다.
메뉴에는 세션 동안 보낸 각 프롬프트가 나열됩니다. 기준 지점을 고른 뒤 동작을 선택합니다.
| 동작 | 의미 |
|---|---|
| Restore code and conversation | 코드와 대화를 모두 해당 지점으로 되돌림 |
| Restore conversation | 현재 코드는 유지한 채 대화만 해당 메시지로 되돌림 |
| Restore code | 대화는 유지한 채 파일 변경만 되돌림 |
| Summarize from here | 선택 메시지와 그 이후를 요약으로 압축(이전 메시지는 그대로) |
| Summarize up to here | 선택 메시지 이전을 요약으로 압축(선택 메시지와 이후는 그대로) |
| Never mind | 변경 없이 메시지 목록으로 복귀 |
대화를 복원하거나 Summarize from here를 선택하면, 선택한 메시지의 원본 프롬프트가 입력창에 복원되어 다시 보내거나 편집할 수 있습니다. Summarize up to here를 선택하면 대화 끝에 머무르고 입력창은 비어 있게 됩니다.
요약(summarize)은 디스크의 파일을 건드리지 않고 대화의 한쪽을 AI 요약으로 압축합니다. /compact와 비슷하지만 전체가 아니라 선택한 메시지를 기준으로 어느 쪽을 압축할지 고를 수 있습니다. 원본 메시지는 세션 트랜스크립트에 남으므로 Claude가 필요할 때 세부 내용을 참조할 수 있고, 요약이 무엇에 집중할지 안내하는 지시를 따로 입력해도 됩니다.
좋은 사용 예
- 잘못된 대규모 자동 수정 롤백 — Restore code로 파일만 되돌리기
- 대안 접근 재시도 전 초기화 — Restore code and conversation으로 시작점 복귀
- 리뷰 결과 기반 재작업 — 특정 메시지를 골라 Restore conversation
- 장황한 디버깅 대화의 컨텍스트 확보 — Summarize from here로 중간 이후 압축
- 초기 설정 대화 압축 — Summarize up to here로 앞부분만 요약하고 최근 작업은 보존
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/rewind | 코드·대화 되돌리기 + 부분 요약 | 체크포인트로 안전하게 복귀 |
/checkpoint | /rewind 별칭 | 체크포인트 관점이 더 직관적일 때 |
/undo | /rewind 별칭 | 단순 되돌리기 어휘를 선호할 때 |
/compact | 전체 대화를 요약 | 부분이 아니라 전체 압축이 필요할 때 |
/resume | 이전 세션 재개 | 작업 연속성 목적 |
활용 사례
- 기능 실험 분기 실패 시 직전 체크포인트로 안전 복귀
- 릴리즈 직전, 의도치 않은 자동 수정만 골라 되돌려 리스크 제거
- 긴 세션에서 컨텍스트 윈도를 확보하기 위해 일부 구간만 선택 요약
주의사항
- Bash 명령으로 생긴 변경은 추적되지 않습니다.
rm,mv,cp등으로 만든 파일 변경은 되감기로 되돌릴 수 없습니다. 체크포인트는 Claude의 파일 편집 도구를 통한 직접 편집만 추적합니다. - 외부 변경은 추적되지 않습니다. 현재 세션 밖에서 직접 수정한 파일이나 동시에 돌아가는 다른 세션의 편집은 같은 파일을 건드리지 않는 한 대개 캡처되지 않습니다.
- 버전 관리의 대체재가 아닙니다. 체크포인트는 세션 단위의 빠른 복구용이며, 영구 이력과 협업에는 Git 등을 계속 사용해야 합니다. 체크포인트는 "로컬 undo", Git은 "영구 이력"으로 생각하세요.
- 원본 세션을 그대로 두고 다른 접근을 시도하려면 요약 대신 세션 분기(fork:
claude --continue --fork-session)가 적합합니다. - 되돌리기 전 필요한 산출물은
/export등으로 백업해 두면 안전합니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Checkpointing: https://code.claude.com/docs/en/checkpointing