Cmd. /rewind
대화와 코드를 이전 체크포인트로 되돌리거나 특정 메시지부터 요약하는 명령
핵심 요약
- checkpoint로 code·대화 복원·요약 (
/undo) - 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
checkpoint로 code·대화 복원·요약 (/undo)
/rewind사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | /checkpoint, /undo |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/rewind# 되감기 메뉴 열기 (별칭 동일)
/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 | 이전 세션 재개 | 작업 연속성 목적 |
실행 결과와 유지 범위
선택한 체크포인트로 대화·코드를 복원하거나 대화 일부를 요약합니다. 모든 외부 부작용을 되돌리는 기능은 아닙니다.
공식 문서(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일 후 정리되며, 이 기간은 설정으로 조정할 수 있습니다.
주의사항
- Bash 명령으로 생긴 변경은 추적되지 않습니다.
rm,mv,cp등으로 만든 파일 변경은 되감기로 되돌릴 수 없습니다. 체크포인트는 Claude의 파일 편집 도구로 직접 편집한 것만 추적합니다. - 외부 변경은 추적되지 않습니다. 현재 세션 밖에서 직접 수정한 파일이나 동시에 돌아가는 다른 세션의 편집은 같은 파일을 건드리지 않는 한 대개 캡처되지 않습니다.
- 버전 관리의 대체재가 아닙니다. 체크포인트는 세션 단위의 빠른 복구용이며, 영구 이력과 협업에는 Git 등을 계속 사용해야 합니다. 체크포인트는 "로컬 undo", Git은 "영구 이력"으로 생각하세요.
- 원본 세션을 그대로 두고 다른 접근을 시도하려면 요약 대신 세션 분기(fork:
claude --continue --fork-session)가 적합합니다. - 되돌리기 전 필요한 산출물은
/export등으로 백업해 두면 안전합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록