자료실
가이드웹앱 만들기

클로드 코드 되돌리기 — 체크포인트와 /rewind 사용법

고른 이유AI에게 코드를 맡길 때 가장 큰 걱정은 "망가지면 되돌릴 줄 모른다"는 거예요. 되돌리는 법 하나만 알아도 훨씬 과감하게 시켜 볼 수 있어서 골랐어요.

한 줄로 말하면

Claude Code는 파일을 고치기 직전마다 그 상태를 자동으로 저장해 둬요. 결과가 마음에 안 들면 Esc 두 번이나 /rewind로 원하는 시점까지 되돌릴 수 있어요.

이런 분께

  • Claude Code로 웹페이지나 작은 도구를 만들어 보는 분
  • AI가 멀쩡하던 파일을 망칠까 봐 큰 수정을 망설이는 분
  • 버전 관리 도구(Git)는 아직 써 본 적 없는 분

체크포인트는 무엇인가요

체크포인트는 Claude가 파일을 고치기 전에 자동으로 찍어 두는 저장 지점이에요. 따로 "저장해"라고 말하지 않아도 생겨요. 그래서 여러 번 고친 뒤에도 "세 번째 수정 전으로 돌아가고 싶어"가 가능해요.

되돌릴 때는 범위를 고를 수 있어요.

  • 코드만 파일은 그 시점으로, 지금까지 나눈 대화는 그대로
  • 대화만 대화 흐름만 그 시점으로, 파일은 지금 상태 그대로
  • 둘 다 파일과 대화를 함께 그 시점으로

코드만 되돌리면 "방금 방식은 취소하고, 이번엔 다르게 해 줘"처럼 대화를 이어 갈 수 있어서 가장 자주 쓰게 돼요.

되돌리는 방법

입력창에서 Esc 키를 빠르게 두 번 누르거나 /rewind를 입력하면 되돌릴 시점 목록이 떠요. 시점을 고른 뒤 범위(코드만·대화만·둘 다)를 선택하면 끝이에요. 되돌린 뒤에는 파일이 실제로 바뀌었는지 눈으로 한 번 확인하세요.

되돌려지지 않는 것

체크포인트는 만능 백업이 아니에요. 다음 변경은 되돌려지지 않을 수 있어요.

  • 내가 편집기에서 직접 고친 내용
  • 터미널 명령으로 일어난 변화(파일 삭제·이동, 설치, 데이터베이스 변경)
  • 외부로 이미 보낸 것(배포, 메일 발송, 결제 등)

그래서 완성본이나 중요한 작업은 Git이나 별도 복사본으로 따로 지켜 두는 게 안전해요. 체크포인트는 "작업 중 실행 취소"로 생각하면 맞아요.

✅ 체크리스트

중요한 파일이 아니라 연습용 폴…

체크리스트 전체는 회원에게 열려 있어요

확인 중…
📋 그대로 쓰는 프롬프트

지금까지 이 대화에서 바꾼 파일들…

프롬프트 전체 보기와 복사는 회원에게 열려 있어요

확인 중…

참고할 점

  • 되돌린 뒤 새 작업을 시작하면, 되돌리기 전의 이후 기록은 다시 고르기 어려울 수 있어요. 버려도 되는 상태인지 한 번 더 생각하고 되돌리세요.
  • 기능 이름과 화면은 Claude Code 업데이트에 따라 바뀔 수 있어요. 막히면 공식 문서의 Checkpointing 항목을 확인하세요.

저작권·출처 문의 newrun.cs@gmail.com

자료를 넘어 나만의 도구를 직접 만들고 싶다면 —

교육 프로그램 보기 →

함께 보면 좋은 자료

자료실 전체 →