[Claude Code 스킬] 체크포인트(되감기) — Esc 두 번으로 AI가 망친 코드를 즉시 되돌리기 | DAKER 커뮤니티
무엇
체크포인트는 Claude Code 2.0에 들어온 내장 ‘시간 되감기’ 기능입니다. 세션이 진행되는 동안 당신이 보낸 프롬프트마다 코드와 대화 상태를 자동으로 스냅샷으로 찍어 둡니다. 게임이 던전에 들어설 때마다 자동 저장을 해 두는 것과 같아서, AI가 코드를 엉뚱하게 헤집어 놓아도 명령 한 번으로 원하는 시점으로 되돌아갈 수 있습니다. 핵심은 git과 완전히 독립이라는 점 — 커밋을 한 번도 하지 않았어도 작동합니다.
언제 쓰나
자율 모드로 큰 리팩터링을 맡겼는데 서너 턴 뒤 “길을 잃었다” 싶을 때
여러 접근을 실험하다 “두 단계 전이 더 나았다”로 돌아가고 싶을 때
Claude의 분석·대화 맥락은 살리되 코드만 깨끗이 되돌리고 싶을 때(또는 그 반대)
git 커밋 사이의 자잘한 실수를 빠르게 취소하고 싶을 때
사용법
입력창이 비어 있을 때 Esc를 두 번 누르거나 /rewind를 입력하면 되감기 메뉴가 열립니다. 세션 동안 보낸 프롬프트 목록에서 돌아갈 지점을 고르고, 복원 방식을 선택합니다.
# 되감기 메뉴 열기
/rewind
# 또는 — 입력창이 비어 있을 때
Esc Esc
# 프롬프트 목록에서 지점 선택 후 동작 고르기
Restore code and conversation 코드 + 대화 되돌리기
Restore conversation 코드 유지, 대화만 되돌리기
Restore code 대화 유지, 코드만 되돌리기
# 체크포인트 보존 기간 설정 (.claude/settings.json)
{ "cleanupPeriodDays": 30 }
팁
Bash 사각지대 주의.
echo > file,sed -i처럼 Bash로 직접 건드린 파일 변경은 체크포인트에 잡히지 않습니다. 추적되는 건 Write·Edit·NotebookEdit 편집 도구를 거친 변경뿐이니, 되돌릴 여지가 있는 중요한 수정은 Claude의 편집 도구에 맡기세요.git의 대체가 아니라 보완. 체크포인트는 세션 안의 임시 안전망(자동 저장)이고, 영구 이력·브랜치·협업은 여전히 git 커밋의 몫입니다. “대화만 복원”은 코드는 그대로 둔 채 잘못 든 대화 맥락만 잘라낼 때 특히 유용합니다.
