Claude Code의 /rewind 기능으로 되돌릴 수 없는 파일과 식별 방법

/rewind로 파일을 원상 복구할 수 있었는지 (각 3회)
Claude에게 시킨 작업 사용된 도구 복구 가능 여부
1줄 재작성 Edit 3/3
...

notes.txt의 3번째 줄을 CHANGED로 재작성하세요. 그 외 아무것도 하지 마세요.
notes.txt +1 -1

The code will be restored +1 -1 in notes.txt.
...
‼ Rewinding does not affect files edited manually or via bash.

확인 화면은 `The code will be unchanged.`였고, 선택지는 `Restore conversation`와 요약 2개, 그리고 `Never mind`만 있었습니다. 애초에 `Restore code`가 나타나지 않았습니다.

documentation (checkpointing, 2026-10-15 기준)에도 적혀 있습니다.

Checkpointing does not track files modified by Bash commands.

예시로 `rm file.txt`가 언급되어 있습니다. 이번 Windows에서는 PowerShell이었지만, **쉘(shell)로 삭제한 것은 복구되지 않는다**는 점은 같았습니다.

서브 에이전트에게 재작성하게 한 3번도 메뉴는 `No code changes`였고 `Restore code`가 나타나지 않아 파일은 수정된 상태를 유지했습니다.

Any other subagent: rewinding doesn't restore the edits. Use git to revert them.

| 메뉴 표시 | 의미 |
|---|---|
`notes.txt +1 -1`처럼 파일명이 나옴 | 해당 파일은 복구 가능함 |
`No code changes` | 이 프롬프트로 변경된 파일은 하나도 복구할 수 없음 |

**No code changes여도, 파일이 변하지 않았다고 단정할 수는 없습니다.** 이번 삭제와 서브 에이전트의 6번 모두 실제로 파일이 변경되었습니다.

VS Code 확장 기능 (2.1.296)으로 /rewind

`/rewind`를 입력하니, `/rewind isn't available in this environment.`라고 나왔습니다.

확장 기능에서는 **메시지에 마우스를 올리면 나오는 되돌리기 버튼**을 사용합니다 (도큐먼트 vs-code). 제한에 대해서는 같은 체크포인트 페이지에서 확인하라는 안내를 받았습니다. 확장 기능의 버튼으로는 시도하지 않았습니다.

도큐먼트는 체크포인트를 '세션 내에서 빠르게 복구하기 위한 것'으로 정의하며, 영구적인 버전 기록과 협업을 위해서는 커밋(commit), 브랜치(branch) 등 Git 같은 버전 관리 시스템을 계속 사용하라고 권장하고 있습니다.

Checkpoints are designed for quick, session-level recovery. For permanent version history and collaboration, continue using version control, such as Git, for commits, branches, and long-term history.

**사라질 가능성이 있는 작업을 요청하기 전에, git commit을 해두는 것**이 가장 확실합니다. Git으로 관리하지 않은 파일을 셸에서 삭제한 경우라면,

`/rewind`

로도 Git으로도 복구할 수 없습니다. -
**Windows 10・Claude Code 2.1.300・Sonnet 5.5만, 각 3회**입니다 -
**삭제는 모두 PowerShell에서 진행했습니다.** Git Bash의 `rm`은 이번에 Claude가 선택하지 않았기 때문에 측정하지 않았습니다 (도큐먼트에는 복구되지 않는다고 쓰여 있습니다) - 파일은 몇 줄짜리 텍스트 3개뿐입니다. 큰 파일, 심볼릭 링크(도큐먼트에서는 복구되지 않음)는 시도하지 않았습니다
- 하나의 프롬프트에서 편집과 삭제가 섞인 경우는 시도하지 않았습니다
- 선택한 것은 `3. Restore code` 뿐입니다. `1. Restore code and conversation`은 시도하지 않았습니다 - 체크포인트의 저장 기간(도큐먼트에서는 약 30일)과, 100개까지라는 상한선은 확인하지 않았습니다

- **Claude가 Edit・Write로 수정한 파일**은 새로 만든 파일은 사라진 `/rewind`의 Restore code로 복구되었습니다. **셸에서 삭제한 파일과 서브 에이전트가 수정한 파일은 복구되지 않았습니다**-
**구분하는 방법은,** `/rewind` 메뉴의 프롬프트 아래에 있습니다. `No code changes`라면, 그 프롬프트에서 변경된 것은 되돌릴 수 없습니다. **VS Code 확장 기능에서는,** `/rewind` 대신 메시지의 되돌리기 버튼을 사용하세요.

**사라질 가능성이 있는 작업 전에는,** `git commit`을 하세요.
복구하고 싶다고 생각되면, 먼저 `/rewind`를 열고, **프롬프트 아래에 파일 이름이 나와 있는지** 확인해 보세요.

- Claude Code를 닫아도, 백그라운드에서 실행된 서버가 남아 있는 경우가 있습니다. 구분하는 방법은 화면 하단의 '1 shell' — 화면 표시로 구별되는 다른 예시
- Shift-JIS 파일을 Claude Code에서 한 곳 수정했더니, 일본어가 전부 깨져서 복구할 수 없게 된 경우 — Git으로만 복구했던 예시

JQIT의 엔지니어 95% 이상은 미경험자 채용입니다.

괜찮으시면 코퍼레이트 사이트에도 놀러 오세요.

엔지니어 채용도 진행하고 있습니다. 관심 있으시면 한번 살펴보세요.

▶ 채용 사이트