체크포인팅
코드 변경을 자동으로 추적하고, 언제든 이전 상태로 되돌리세요.
체크포인팅이란?
Claude Code가 파일을 수정할 때마다 자동으로 체크포인트를 생성해요. 작업이 잘못된 방향으로 갔을 때 빠르게 이전 상태로 되돌릴 수 있어요. 대규모 리팩토링도 안심하고 시도하세요!
자동 추적
매 프롬프트마다 자동으로 체크포인트를 생성해요.
쉬운 되돌리기
Esc 두 번으로 원하는 시점으로 되돌아가요.
대화 요약
특정 시점부터 대화를 요약해서 컨텍스트를 절약해요.
사용법
Esc를 두 번 누르거나 /rewind 명령을 입력하세요.
/rewind스크롤 가능한 프롬프트 목록이 표시돼요. 원하는 시점을 선택한 후 액션을 고르세요.
| 액션 | 설명 |
|---|---|
| Restore code and conversation | 코드와 대화 모두 해당 시점으로 되돌리기 |
| Restore conversation | 대화만 되돌리기 (현재 코드 유지) |
| Restore code | 코드만 되돌리기 (대화 유지) |
| Summarize from here | 해당 시점 이후의 대화를 요약으로 압축 |
되돌리기 vs 요약
| 기능 | Restore | Summarize |
|---|---|---|
| 코드 변경 | 코드를 이전 상태로 되돌림 | 코드 변경 없음 |
| 대화 내용 | 선택한 시점 이후 삭제 | 요약으로 압축 |
| 컨텍스트 | 줄어듦 | 줄어듦 (더 효율적) |
| 원본 보존 | - | 세션 기록에 보존됨 |
Summarize는
/compact와 비슷하지만, 특정 시점부터만 압축해요. 앞부분은 그대로 유지!활용 사례
대안 탐색: 여러 구현 방식을 시도하면서 시작점으로 언제든 복귀
실수 복구: 버그가 생긴 변경사항을 빠르게 되돌리기
컨텍스트 절약: 긴 디버깅 세션을 중간부터 요약해서 공간 확보
제한사항
- bash 명령으로 변경된 파일은 추적되지 않아요 (rm, mv, cp 등)
- Claude Code 외부에서 수정한 파일은 추적되지 않아요
- 체크포인트는 30일 후 자동 삭제돼요 (설정 변경 가능)
- 세션 간에 체크포인트가 유지되지만, Git을 대체하지는 않아요
체크포인트는 "로컬 Undo"이고, Git은 "영구 히스토리"예요. 둘 다 사용하세요!