클로드 코드 되돌리기, 어디까지 돌아올까

망친 작업을 Claude Code의 되감기(/rewind)로 되돌리면, 그 대화에서 편집 도구로 고친 파일만 고른 프롬프트 직전으로 돌아온다. 셸 명령으로만 바뀐 파일, 대부분의 서브에이전트 편집, Claude Code 밖에서 고친 다른 파일, 심볼릭·하드 링크로 된 경로는 그대로 남는다. Gemini CLI는 되돌리는 범위부터 달라서, 켜 두면 편집 도구 호출을 승인할 때 프로젝트 파일 전체를 저장했다가 통째로 돌린다. Codex CLI에는 파일을 되돌리는 명령이 없다. 어느 도구든 되돌리지 못하고 남은 변경은 남겨 둔 git 기록에서 되돌린다.

로봇이 태엽 손잡이를 거꾸로 돌리자 블록 몇 개만 작업대 위 제자리로 날아 돌아가고, 작업대 끝의 블록 두 개는 흐트러진 채 남는다. 블록은 파일이고, 되감기는 그 가운데 일부만 제자리로 돌려놓는다.

되감기를 마쳤는데 설정 파일 하나가 바뀐 그대로다. 긴 작업 끝에 테스트가 깨져 한 시간 전 프롬프트로 되감았지만, 에이전트가 셸 명령으로 고친 그 파일은 되감기가 저장해 둔 대상이 아니었다. 다른 파일들은 한 시간 전 모습으로 돌아와 있어서, 이 파일 하나만 남은 것이 더 헷갈린다. 남은 파일을 하나씩 찾아 고치기 전에, 되감기가 어디까지 맡는지부터 알아야 한다. 클로드 코드 되돌리기, 어디까지 돌아올까?

2026-11-09에 확인한 Claude Code 문서(그날 최신 버전 2.1.319)로 보면, 답은 파일마다 갈린다. 되감기로 돌아오느냐는 그 파일을 그 대화에서 Claude의 편집 도구가 바꿨느냐에 달렸다. 그렇지 않은 파일은 git 기록에서 되돌리거나 직접 고쳐야 한다.

Claude Code 되감기는 무엇을 저장해 두나

체크포인트는 도구가 작업 도중 그 시점의 파일 사본, 곧 스냅샷을 저장해 두는 지점이다. 무엇을 언제 저장하는지는 도구마다 다르다. Claude Code는 턴을 시작하는 프롬프트를 보낼 때마다 체크포인트를 하나씩 만들고, Claude가 일하는 도중에 끼워 보낸 메시지로는 만들지 않는다. 이때 추적하는 것은 Claude Code가 자기 파일 편집 도구로 바꾼 내용이다.

저장한 스냅샷을 무한정 두지는 않는다. 한 세션 안에서는 최근 체크포인트 100개의 스냅샷을 남긴다. 체크포인트는 대화와 함께 저장돼, 세션을 이어 받은 뒤에도 되감을 수 있다. 다만 기본값으로는 세션이 마지막으로 스냅샷을 저장한 뒤 약 30일이 지나면 그 스냅샷을 지우고, 더 오래 두려면 설정 cleanupPeriodDays 를 바꾼다. 스냅샷이 지워진 체크포인트로 되감으면 No files were restored(복원된 파일 없음)로 실패할 수 있다.

되감기 메뉴는 /rewind 로 열거나, 입력 칸이 비었을 때 Esc 를 두 번 눌러 연다.

입력 칸에 글자가 있으면 Esc 두 번은 메뉴를 여는 대신 입력 칸을 비운다. 지운 글은 입력 기록에 남아서, 되감기 메뉴를 마친 뒤 위쪽 화살표로 되살릴 수 있다. 메뉴에는 그 세션에서 보낸 프롬프트가 나열되고, 지점을 정한 다음 할 일을 고른다. 그 가운데 되돌리기는 셋이다.

  • 코드와 대화를 함께 그 지점으로 되돌리는 「Restore code and conversation」
  • 대화만 그 메시지로 되돌리고 코드는 지금 그대로 두는 「Restore conversation」
  • 코드만 되돌리고 대화는 그대로 두는 「Restore code」

코드를 되돌리는 두 항목은 고른 지점 뒤에 추적된 파일 변경이 있을 때만 나온다. 대화를 되돌린 뒤 다음 프롬프트를 보내기 전에 Claude Code를 끝내면, 되감은 메시지가 다시 돌아올 수 있다. 이때도 되돌린 파일은 되감기가 둔 그대로 남는다.

그래서 되감기는 「실수하기 전」으로 무조건 돌아가는 일이 아니라, 추적한 파일을 고른 프롬프트 직전 상태로 맞추는 일이다. Claude Code 변경 기록(CHANGELOG)의 문구로 보면, 되감기는 추적한 경로의 파일을 「되살리거나 지운다(restore or delete)」. 지우는 대상을 그 지점 뒤에 생긴 파일로 보는 것은 변경 기록에서 읽은 추론이다. 결국 무엇이 돌아오는지는 그 파일을 무엇이 바꿨느냐에 달려 있다.

되감아도 그대로 남는 파일은 어떤 것일까

되감은 뒤에도 남는 변경은 크게 네 가지다. 첫째는 셸 명령만 바꾼 파일이다. 문서는 이런 파일이 추적되지 않아 그대로 남고, 되돌리려면 git 같은 버전 관리를 쓰라고 적는다. 단 Claude가 이 대화에서 편집 도구로 이미 고친 파일이라면, 그 뒤에 셸 명령이 바꾼 것도 되감기가 되돌린다. 처음 장면의 설정 파일이 남은 것도 셸 명령으로만 바뀐 파일이었기 때문이다.

둘째는 서브에이전트의 편집이다. 서브에이전트도 Claude의 파일 편집 도구로 고치지만, 그 편집은 대개 세션의 체크포인트에 잡히지 않는다. 이때 되감기는 이 대화에서 Claude가 이미 고친 파일만 되돌리고, 서브에이전트가 다른 파일에 한 편집은 남긴다.

서브에이전트에게 일을 맡기는 문제는 이 블로그의 일을 나눠 주면 빨라질 줄 알았다에서도 다뤘다. 거기서는 일을 나눠 맡길 때의 판정 비용을 봤다. 여기서는 서브에이전트에게 맡긴 편집이 되감기 밖에 남는 점을 본다.

셋째는 Claude Code 밖에서 생긴 변경이다. 내가 직접 고친 파일과 동시에 돌던 다른 세션의 편집은 보통 체크포인트에 잡히지 않는다. 현재 세션과 같은 파일을 고친 경우가 예외다. 뒤집어 말하면 같은 파일이면 잡히므로, 그 파일을 되돌릴 때 내가 고친 내용도 함께 되돌아갈 수 있다. 되감기 전에 내 수정을 남겨 두는 방법은 아래 확인 순서 2단계에서 다룬다.

넷째는 심볼릭 링크나 하드 링크로 된 경로다. 추적된 경로라도 링크면 되감기가 건너뛰고, 「Restored the code, but skipped N files」(코드는 되돌렸지만 파일 N개를 건너뛰었다) 경고를 띄운다. 건너뛴 파일은 지금 내용 그대로 남는다. 문서가 드는 예는 dotfile 관리자가 프로젝트에 심볼릭 링크로 넣어 둔 설정 파일과, pnpm이 하드 링크로 놓은 파일이다. 이런 파일을 되돌리려면 Claude에게 그 편집을 거꾸로 해 달라고 하거나 직접 고친다.

링크 때문에 건너뛴 경로가 무엇인지 보려면, 되돌리기 전에 /debug 로 디버그 기록을 켠다. 그러면 디버그 로그(~/.claude/debug/<session-id>.txt)에 건너뛴 경로가 하나씩 적힌다.

프로젝트 바깥으로 이미 나간 것도 그대로다. 되감기가 돌려놓는 것은 파일이라서, 원격 저장소에 이미 푸시한 커밋은 되감기 대상이 아니다. 지금까지 본 경우를 파일을 바꾼 주체별로 모으면 그림 1과 같다.

Claude Code 되감기로 돌아오는 것은 편집 도구로 고친 파일, 그 파일을 뒤이어 셸이 바꾼 내용, context: fork 스킬을 앞에서 돌렸을 때의 편집이다. 그 밖의 서브에이전트 편집은 이미 고친 파일만 돌아오고, 셸 명령만 바꾼 파일과 다른 세션·직접 고친 파일(같은 파일이 아니면), 링크 경로는 그대로 남는다.
그림 1. 같은 「바뀐 파일」이라도 무엇이 바꿨느냐에 따라 돌아옴·일부만·그대로로 나뉜다. 다른 세션·직접 고친 파일은 같은 파일이면 함께 되돌아갈 수 있다(Claude Code 체크포인트 문서, 2026-11-09 확인).

그림 1에서 돌아오는 줄을 모아 보면, 모두 이 대화에서 편집 도구가 한 번은 손댄 파일이다. 되감기가 고른 프롬프트 직전 상태로 맞추는 것은 편집 도구가 손대 추적한 파일까지다. 그 밖에서 바뀐 파일은 되감기로는 돌아오지 않으니, git에 남은 기록에서 되돌리거나 직접 고친다.

Gemini CLI와 Codex CLI에서는 무엇이 돌아오나

나머지 두 도구에서는 되돌리기가 맡는 단위부터 달라진다. Gemini CLI는 v0.67.0 문서·소스를 기준으로 2026-11-09에 확인했다. 체크포인트보다 먼저 볼 것은 이용 조건이다. 2026-05-19 공지는 2026-06-18부터 일부 이용자의 Gemini CLI 요청 처리를 멈춘다고 알렸다.

대상은 Google AI Pro·Ultra 이용자와, Gemini Code Assist for individuals로 무료로 쓰던 이용자다. 이들에게는 Antigravity CLI로 옮기라고 안내했다. 유료 Gemini API 키나 Gemini Code Assist Standard·Enterprise 라이선스로는 그대로 쓴다. Antigravity CLI의 되돌리기는 공식 문서를 찾지 못해 이 글에서 다루지 않는다.

Gemini CLI의 체크포인트는 따로 켜야 한다. 문서는 이 기능이 기본으로 꺼져 있고 settings.json 에서 켠다고 적는다. 넣을 키는 general.checkpointing.enabled 하나다.

{
  "general": {
    "checkpointing": {
      "enabled": true
    }
  }
}

문서는 켜 두면 파일을 바꾸는 편집 도구 호출을 승인할 때 체크포인트를 만든다고 적는다. 예로 든 도구는 write_file·replace 다. 스냅샷은 내 프로젝트의 git 저장소와 따로, Gemini CLI가 홈 폴더에 두는 git 저장소에 들어간다. 경로는 ~/.gemini/history/<project_hash> 다. 문서는 이 스냅샷이 그 순간의 프로젝트 파일 전체(무시 목록 밖 — 소스 기준)를 담고, 내 저장소는 건드리지 않는다고 적는다. 체크포인트에는 대화 기록과, 막 실행하려던 도구 호출도 함께 담긴다.

켜 둘 조건이 하나 더 있다. v0.67.0 소스로 보면, 체크포인트를 켰는데 git이 없으면 초기화 단계에서 오류를 낸다. 문구는 「Please install Git or disable checkpointing to continue」다. 계속하려면 Git을 설치하거나 체크포인트를 끄라는 말이다.

/restore 를 인자 없이 치면 체크포인트 목록이 나오고, 목록에 나온 이름을 붙여 치면 그 체크포인트로 복원한다. 문서는 복원이 프로젝트의 모든 파일을 스냅샷 시점으로 되돌리고, 대화 기록을 되살리고, 원래 도구 호출을 다시 제안한다고 적는다. 그래서 스냅샷 뒤에 사람이 직접 고친 파일과 셸이 바꾼 파일까지 그 시점으로 돌아간다. 셸 명령 앞에서는 따로 체크포인트를 만들지 않는다(소스 기준). 소스를 보면 복원은 그 스냅샷 뒤에 새로 생긴 파일도 지운다.

처음부터 무시 목록(.gitignore)에 걸린 파일은 스냅샷에 들지 않는다 — 소스에서 읽은 범위다. 다만 소스로 보면 저장과 복원은 git의 무시 규칙과 추적 상태를 따른다. 스냅샷을 담는 저장소가 이미 추적한 파일은 나중에 무시 목록에 넣어도 복원될 수 있다(git의 일반 동작에서 읽은 추론). 무시 목록에 넣었다고 복원에서 빠진다고 믿으면 안 된다.

Claude Code가 내 수정까지 되돌리는 것은 같은 파일일 때뿐이지만, Gemini CLI는 켜 두면 프로젝트 전체가 그 시점으로 돌아간다. 복원 전에 남길 변경은 프로젝트 폴더 밖에 따로 둔다.

Codex CLI는 2026-11-09에 확인한 명령 문서 기준(그날 최신 0.167.0)으로 본다. Codex CLI의 undo는 0.128.0(2026-04-30)부터 쓸 수 없다. 이 버전에 실린 변경(PR #19481)이 undo를 쓸 수 없다고 알리기만 하게 바꿨다. PR 본문의 문구는 「make undo a no-op that reports the feature is unavailable」이다. 2026-11-09 명령 문서에도 파일을 되돌리는 명령은 없다. 대화는 남아서, /resume 은 저장한 대화를 원래 기록 그대로 다시 열고 /fork 는 원래 대화를 그대로 두고 새 대화로 가른다.

Claude Code와 같은 키라도 동작은 다르다. 빈 입력 칸에서 Esc 를 두 번 누르면, Codex CLI에서는 직전 메시지를 고쳐 그 지점부터 대화를 갈라 나간다. 문서는 이 동작이 파일을 되돌린다고 적지 않는다. 바뀐 것은 /diff 로 본다 — 스테이징한 변경, 스테이징하지 않은 변경, git이 아직 추적하지 않는 파일까지 보여 준다. 문서는 /quit·/exit 전에 중요한 작업을 저장하거나 커밋하라고 적는다. 비대화형 codex exec 는 기본으로 git 저장소 안인지 검사한다(끄려면 --skip-git-repo-check).

그림 2는 세 도구가 되돌리는 단위를 나란히 놓은 개념도다. 어느 도구든 그 범위 밖의 변경은 남겨 둔 git 기록에서 되돌린다. 표 1은 도구를 고를 때가 아니라, 되돌릴 때 무엇을 확인할지 모은 것이다(2026-11-09 확인).

Claude Code는 편집 도구가 고친 파일을, Gemini CLI는 켜 두면 프로젝트 파일 전체(무시 목록 밖 — 소스 기준)를 그 시점으로 맞추고, Codex CLI에는 파일 되돌리기가 없다. 어느 도구든 그 범위 밖의 변경은 남겨 둔 git 기록에서 되돌린다.
그림 2. 개념도이며 파일 수는 예시다. 회색 칸은 처음부터 무시 목록에 걸린 파일(소스 기준)이고, 이미 추적한 뒤 무시 목록에 넣은 파일은 복원될 수 있다. 점선 칸은 그 시점 뒤에 생겨 되돌릴 때 지워지는 파일이다(Claude Code 쪽은 변경 기록에서 읽은 추론).
확인할 것 Claude Code Gemini CLI Codex CLI
되돌릴 지점이 생기는 때 턴을 시작하는 프롬프트마다 켜 두었을 때, 편집 도구 호출을 승인할 때(문서 표현) 파일 되돌리기 없음 — 0.128.0에서 undo를 쓸 수 없게 했고(쓸 수 없다고 알리기만 한다), 2026-11-09 명령 문서에도 없다
되돌리는 범위 편집 도구가 고친 파일(대화도 함께 고를 수 있다) 프로젝트 파일 전체(무시 목록 밖 — 소스 기준)와 대화·실행하려던 도구 호출 파일은 — · 대화는 /resume·/fork 로 남는다
셸 명령이 바꾼 파일 편집 도구로 이미 고친 파일이면 함께 되돌린다. 아니면 그대로 체크포인트 시점으로 함께 돌아간다. 셸 앞에서 따로 저장하지는 않는다 /diff 로 보고 git으로
내가 직접 고친 파일 같은 파일이 아니면 그대로. 같은 파일이면 함께 되돌아갈 수 있다 함께 되돌아가고, 스냅샷 뒤 새로 만든 파일(무시 목록 밖 — 소스 기준)은 지운다 /diff 로 보고 git으로
기본값·보관 따로 켜지 않아도 자동 · 한 세션 최근 100개 · 기본 약 30일 뒤 정리 꺼져 있다 — settings.json 에서 켜고, git이 있어야 한다 —
확인한 버전 2026-11-09 문서(그날 최신 2.1.319) v0.67.0 문서·소스 2026-11-09 문서(그날 최신 0.167.0)

표의 근거는 앞에서 든 세 도구의 문서와 소스다. 같은 되돌리기 명령이라도 돌아오는 범위는 그 도구가 무엇을 언제 저장하느냐가 정한다. Codex CLI에서는 명령 문서에 파일 되돌리기가 없으니, 작업 전에 남겨 둔 커밋으로 돌아간다.

되감기 전에는 무엇부터 봐야 할까

아래 순서는 이 글이 세 도구의 문서와 git 문서를 대조해 정리한 것이다. 원칙은 하나, 남길 것을 프로젝트 폴더 밖에 먼저 두고 그다음 되돌리는 것이다. 명령은 git 표준 명령만 썼고, 위험한 줄에는 같은 단계 안에 경고를 달았다.

  1. 작업 전 마지막 커밋을 찾고 지금 변경을 본다 — git log --oneline 으로 작업 직전의 커밋과, 그 뒤 에이전트 커밋이 있는지 본다. 아래 코드 블록의 <작업 전 커밋> 자리에 이 커밋을 넣는다. 에이전트 커밋이 없으면 작업 전 마지막 커밋은 지금의 HEAD다. git status 로 바뀐 파일과 새 파일을 보고, 그 파일을 무엇이 바꿨는지 가른다. 무시 목록 파일은 --ignored 를 붙여야 보인다.
  2. 남길 것을 프로젝트 폴더 밖에 둔다 — 「패치」 줄은 작업 전 마지막 커밋과 지금 작업 트리의 차이를 패치(git diff 결과를 담은 파일)로 남긴다. 스테이징해 둔 수정은 그 뒤 작업 트리에서 덮어쓰였으면 패치에 없고 「staged」 줄에만 남는다. 4단계의 restore가 스테이징까지 버리므로 이 줄로 따로 떠 둔다. 새 파일·무시 목록 파일·바이너리 파일은 패치에 내용이 담기지 않으니 폴더 밖으로 복사한다. 폴더 밖이어야 하는 이유는 되돌리기가 프로젝트 안의 파일을 지우기도 해서다. Gemini CLI의 /restore 는 프로젝트 안의 새 파일을 지우고, Claude Code 되감기도 편집 도구가 만든 파일을 지울 수 있다(변경 기록에서 읽은 추론).
  3. 에이전트 커밋이 있어도 되감는다 — Claude Code는 /rewind 메뉴에서 「Restore code」나 「Restore code and conversation」을 고른다. 끼워 보낸 메시지에 「No code restore」(코드 복원 없음)가 붙어 있으면, 그 턴을 시작한 프롬프트를 골라야 턴 전체의 편집이 되돌아간다. Codex CLI는 파일 되돌리기 명령이 없으니 건너뛴다. Gemini CLI는 /restore 로 복원하고, 다시 제안되는 도구 호출은 승인하지 말고 무시하거나 고친다. 되감기는 커밋을 되돌리지 않지만(문서 서술에서 읽은 추론), 스냅샷에는 덮어쓰인 내 수정이 남아 있을 수 있다. 에이전트 커밋이 있으면 되감은 내용을 4·5단계가 지우기 전에 「되감은 뒤」 줄로 떠 둔다.
  4. 남은 파일을 지금의 HEAD에 맞춘다 — git status·git diff HEAD 를 다시 본다. 지금의 HEAD(에이전트 커밋이 있으면 그 커밋) 상태로 돌릴 파일은 「restore」 줄로 되돌린다. 이 줄은 그 파일의 변경을 스테이징 여부와 상관없이 바로 버리므로, 2단계에서 남겨 두었는지 먼저 확인한다. 에이전트 커밋이 없으면 내 수정이 섞인 파일은 버리지 말고 패치를 보며 직접 고친다. 에이전트 커밋이 있으면 바뀐 파일을 모두 이렇게 맞춰 작업 트리를 깨끗하게 만든다. 새로 생긴(추적하지 않는) 파일은 확인한 뒤 직접 지우고, 되감기가 건너뛴 링크 경로는 앞에서 본 대로 고친다.
  5. 에이전트 커밋을 되돌린다 — git show <커밋> 으로 그 커밋에 무엇이 들었는지, 내 수정이 섞였는지 본다. 그다음 git revert <커밋> 으로, 기록을 지우지 않고 그 커밋을 되돌리는 새 커밋을 만든다. git revert 는 작업 트리가 깨끗해야 돌기 때문에 4단계를 먼저 마친다. 커밋이 여럿이면 가장 최근 것부터 하나씩 되돌린다. 충돌로 멈추면 git revert --abort 로 그 전 상태로 돌아간다.
  6. 내 수정을 다시 옮긴다 — 작업 전 마지막 커밋 뒤의 내 수정을 패치와 사본에서 골라 옮긴다. 스테이징해 두었던 수정은 「staged」 줄로 뜬 파일에, 작업 트리에 있던 수정과 그대로 커밋에 들어간 수정은 「패치」 줄로 뜬 파일에 있다. 에이전트가 내 수정을 덮어쓴 뒤 커밋까지 했다면, 그 수정은 git 기록에 없고 「되감은 뒤」 줄로 뜬 파일에만 있을 수 있다. 다만 패치를 통째로 붙이면 에이전트 변경도 함께 돌아온다.
# 되감기 전 — 작업 전 마지막 커밋을 찾고, 남길 것을 프로젝트 폴더 밖에
git status
git status --ignored   # 무시 목록 파일까지
git log --oneline
git diff <작업 전 커밋> > <폴더 밖>/before-rewind.patch   # 패치 — 그 커밋과 지금 작업 트리의 차이
git diff --cached > <폴더 밖>/staged.patch   # staged — 스테이징해 둔 변경
# 새 파일·무시 목록 파일·바이너리 파일은 폴더 밖으로 복사

# (여기서 되감기 · 복원)
git diff <작업 전 커밋> > <폴더 밖>/after-rewind.patch   # 되감은 뒤 — 에이전트 커밋이 있을 때

# 남은 파일을 지금의 HEAD에 맞춘다
git status
git diff HEAD
git restore --source=HEAD --staged --worktree -- <파일>   # 주의: 그 파일의 스테이징한·안 한 변경을 모두 바로 버린다

# 에이전트 커밋이 있으면 — 작업 트리가 깨끗해진 뒤, 가장 최근 커밋부터
git show <커밋>
git revert <커밋>   # 그 커밋을 되돌리는 새 커밋
git revert --abort   # 충돌로 멈추면 — 그 전 상태로
# 내 수정은 패치·사본에서 골라 다시 옮긴다

# 다음 긴 작업 전
git status   # 올라갈 파일 확인
git add -A
git commit -m "<작업 전>"
git switch -c <새-브랜치>
# 또는 워크트리를 따로
git worktree add -b <새-브랜치> <경로>

다음 긴 작업은 시작 전에 커밋하거나, 브랜치나 워크트리를 따로 연다. 그러면 그 커밋이 다음 되감기 때 작업 전 마지막 커밋이 된다. Codex CLI는 /worktree 로 관리되는 git 워크트리에서 대화를 시작하거나 이어 갈 수 있다.

여섯 단계에서 되감기가 맡는 것은 3단계 하나다. 되감기와 git은 둘 중 하나를 고르는 문제가 아니다. 남길 것을 먼저 폴더 밖에 두고, 되감기가 맞춘 뒤 남은 것을 git으로 마저 정리하는 순서다.

되감기의 경계는 버전마다 어떻게 움직였나

여기부터는 더 알고 싶은 독자를 위한 내용이다. Claude Code 변경 기록에서 되감기의 경계와 그 경계를 알리는 동작이 바뀐 다섯 점을 버전 순서대로 모았다. 변경 기록에는 날짜가 없어서 순서만 적는다.

  • 2.1.216 — 추적된 경로에 있는 심볼릭·하드 링크를 통해서는 파일을 되살리거나 지우지 않고, 건너뛴 경로 수를 알리게 됐다. 앞에서 본 링크 경로 경고가 여기서 시작했다.
  • 2.1.260 — 체크포인트 백업 파일이 없어 아무것도 되돌리지 못했는데도 /rewind·--rewind-files 가 성공이라고 알리던 것을 고쳤다.
  • 2.1.309 — 전에는 sed -i 명령을 파일 편집 미리 보기처럼 보여 줬다. 이제는 적힌 그대로 보통 셸 명령으로 돈다. 그래서 다른 셸 편집처럼 되감기로 되돌아오지 않는다. 이미 편집 도구로 고친 파일이면 그 뒤 셸 변경도 되돌린다는 체크포인트 문서의 규칙은 그대로다.
  • 2.1.311 — 직접 고친 것과 셸 편집은 코드 복원의 영향을 받지 않는다(never affected)고 잘못 말하던 /rewind 경고를 고쳤다. 앞에서 본 「같은 파일이면 함께 되돌아갈 수 있다」와 같은 방향이다.
  • 2.1.319 — 디렉터리 심볼릭 링크를 통해 파일을 되살리거나 지울 수 있던 경우를 고쳤다. /branch 이전 체크포인트로 코드를 되돌리면 No files were restored 로 실패하던 것도 고쳤다. 이 글이 확인한 기준 버전이 바로 이 버전이다.
Claude Code 되감기의 경계와 그 알림은 2.1.216(링크 경로 건너뜀)·2.1.260(헛된 성공 알림 고침)·2.1.309(sed -i는 셸 편집)·2.1.311(틀린 경고 문구 고침)·2.1.319(링크·복원 실패 고침)의 다섯 버전에서 차례로 바뀌었다. 2026-11-09 확인 기준인 2.1.319도 그 가운데 하나다.
그림 3. Claude Code 변경 기록(CHANGELOG)의 버전 순서만 나타냈다. 변경 기록에는 날짜가 없다.

그림 3은 다섯 점을 버전 순서대로 한 줄에 놓은 것이다. 되감기가 무엇을 그 시점 상태로 맞추는지는 이 글이 확인한 그날의 버전에서도 고쳐지고 있었다. 다른 버전을 쓴다면 그 버전의 문서와 변경 기록이 기준이다.

Gemini CLI 스냅샷은 어느 호출 앞에서 생길까

v0.67.0 소스로 보면, 체크포인트 설정이 켜져 있을 때 Gemini CLI는 승인을 기다리는 편집 호출을 골라 스냅샷을 저장한다. 고르는 조건은 둘이다. 호출 이름이 편집 도구 목록에 들어 있고, 상태가 승인 대기(AwaitingApproval)여야 한다. 편집 도구 목록에는 셸 도구(run_shell_command)가 없다. 저장할 때는 작업 트리 전체를 따로 두는 저장소에 올린다 — 앞에서 본 「프로젝트 파일 전체」가 여기서 나온다.

저장이 조용히 어긋날 수 있는 자리도 소스에 있다. 프로젝트 루트를 잡지 못하면, 저장 단계는 디버그 메시지만 남기고 건너뛴다. 새 스냅샷을 만들지 못하면 현재 커밋을 쓰려고 시도하고, 그마저 없거나 다른 단계가 실패하면 그 호출의 체크포인트를 건너뛴다. 이런 오류는 디버그 메시지로만 넘어간다. 현재 커밋은 직전 스냅샷(또는 처음의 빈 커밋)이라, 이렇게 만든 항목으로 복원하면 옛 시점으로 돌아갈 수 있다(소스에서 읽은 추론).

편집을 자동으로 승인하는 설정에서 저장이 실제로 어떻게 되는지는 이 글의 확인 범위 밖이다. 그런 설정을 쓴다면 /restore 목록에 체크포인트가 쌓이는지 먼저 확인한다. 쌓이는 것을 봤더라도 복원은 확인 순서 2단계를 마친 다음에 한다.

이 글은 세 도구를 설치하거나 실행하지 않았다. 2026-11-09에 공개 문서·변경 기록·릴리스 노트와 git 공식 문서, v0.67.0 태그로 고정한 Gemini CLI 소스를 서로 대조했다. 명령 예시에는 실행 결과를 싣지 않았다.

되감기는 어디까지 믿어도 되는가

Claude Code 문서는 체크포인트가 세션 안에서 빠르게 복구하도록 만들어졌다고 적는다(「quick, session-level recovery」). 편집 도구가 고친 파일은 고른 프롬프트 직전 상태로 맞춰지고, 세션을 이어 받은 뒤에도 쓸 수 있다. 다만 스냅샷이 정리된 체크포인트로는 되감기가 실패할 수 있다. 길게 이어 간 작업과 세션을 넘는 이력·협업은 커밋과 브랜치로 git이 맡는다.

작업을 너무 오래 이어 가다가 꼬여서 git으로 복구한 적이 있다. git은 파일을 무엇이 바꿨는지 가리지 않는다. 셸 명령·서브에이전트·다른 세션이 바꾼 파일도 커밋해 둔 만큼은 git 기록에 남는다. 그래서 긴 작업 전의 커밋 하나가, 되감기가 덮지 못하는 변경까지 돌아갈 자리를 남긴다.

파일과 git에 정본을 두는 쪽은 이 블로그의 LLM 에이전트 지식 저장소, DB보다 파일이 먼저인 이유에서도 다뤘다. 그 글이 지식 정본을 파일·git에 두어 검증을 얻는 쪽을 봤다면, 이 글은 되감기가 덮지 못하는 변경을 git 기록으로 되돌리는 쪽을 본다. 되감기는 그 도구가 저장해 둔 범위 안에서만 파일을 돌려놓는다.

더 읽기