클로드 코드 되돌리기(체크포인트): 잘못된 수정을 안전하게 되감는 법

클로드 코드에 작업을 맡겼는데 엉뚱한 방향으로 파일을 여러 개 고쳐 버렸다면? 예전에는 깃으로 되돌리거나 손으로 고쳐야 했습니다. 지금은 클로드 코드가 작업 중 남기는 체크포인트로 이전 시점으로 되감을 수 있습니다.

📌 되돌리기 기능의 세부 동작과 명령 이름은 버전에 따라 다를 수 있습니다. 공식 문서를 확인하세요.

체크포인트란?

클로드 코드는 사용자가 메시지를 보낼 때마다 그 시점의 상태를 기록해 둡니다. 나중에 "그 메시지를 보내기 전"으로 대화나 코드를 되돌릴 수 있습니다. 게임의 저장 지점과 비슷하다고 생각하면 됩니다.

되돌리는 방법

• 세션에서 Esc를 두 번 누르거나 /rewind를 실행합니다.
• 이전 메시지(시점) 목록이 나오면 돌아갈 시점을 고릅니다.
• 무엇을 되돌릴지 고릅니다.

되돌리기 세 가지 선택

대화만 되돌리는 것도 유용합니다. 잘못된 지시가 대화에 남아 있으면 이후 작업에 계속 영향을 주기 때문입니다.

체크포인트가 못 잡는 변경

체크포인트는 주로 클로드의 파일 편집으로 바뀐 내용을 추적합니다. 다음은 되돌리지 못할 수 있습니다.

• 셸 명령(rm, mv 등)으로 지우거나 옮긴 파일
• 클로드가 아닌 다른 프로그램이 바꾼 파일
• 데이터베이스, 서버 설정처럼 파일 밖에서 일어난 변경

그래서 체크포인트는 실수를 빠르게 되돌리는 보조 장치이지, 백업이 아닙니다.

깃과 함께 쓰는 안전한 습관

1. 큰 작업 전에 커밋: "여기까지는 확실히 괜찮다"는 지점을 깃에 남깁니다.
2. 위험 명령은 확인받기: 삭제·이동 명령은 권한 설정의 ask나 deny로 관리합니다.
3. 큰 변경은 플랜 모드부터: 플랜 모드로 계획을 확인하면 되돌릴 일 자체가 줄어듭니다.
4. 이상하면 바로 멈추기: Esc 한 번으로 작업을 멈추고, 상황을 확인한 뒤 되돌릴지 정합니다.

되돌린 뒤에는

되돌린 시점에서 같은 요청을 그대로 다시 하면 같은 실수가 반복될 수 있습니다. 무엇이 잘못됐는지 알려 주고 다시 요청하세요.

방금 시도에서는 공용 템플릿을 고쳐서 다른 페이지까지 바뀌었어.
이번에는 이 페이지 전용 템플릿만 수정하는 방식으로 해 줘.

써 보며 느낀 점

체크포인트가 생기고 나서 클로드 코드에 조금 더 과감한 시도를 맡길 수 있게 됐습니다. 실패해도 몇 초 만에 되돌릴 수 있으니까요. 다만 셸 명령으로 지운 파일은 되돌리지 못한다는 걸 알고 나서는, 작업 전 깃 커밋을 더 철저히 하게 됐습니다. 체크포인트는 실험을 편하게 해 주고, 깃은 실험을 안전하게 해 줍니다.

한 줄씩 정리

1. Esc 두 번이나 /rewind로 이전 시점의 대화·코드·둘 다를 되돌릴 수 있습니다.
2. 셸 명령이나 외부 변경은 추적되지 않을 수 있으니 체크포인트를 백업으로 믿지 마세요.
3. 큰 작업 전 깃 커밋, 위험 명령 확인, 플랜 모드를 함께 쓰는 것이 안전합니다.

참고 자료

• Claude Code 체크포인트 (공식 문서)
• 클로드 코드 자주 쓰는 슬래시 명령어