Claude Code가 고쳤다는데 파일이 안 보일 때: 삭제보다 먼저 확인할 6곳

Claude Code가 수정을 마쳤다고 했는데 VS Code에 파일이나 diff가 안 보인다면, 곧바로 같은 작업을 다시 시키지 마세요. 먼저 같은 작업 폴더인지, 실제 파일이 바뀌었는지, 변경 화면만 빠진 것인지 순서대로 구분해야 중복 수정과 덮어쓰기를 피할 수 있습니다.

이 글은 Windows·VS Code·Cursor에서 Claude Code를 처음 쓰는 사람을 위한 초급 진단 가이드입니다. 2026년 10월 8일 기준 공식 문서를 확인했으며, 특정 버전의 버그를 모든 환경에 일반화하지 않습니다.

파일이 안 보일 때는 같은 작업 폴더인지와 실제 변경 여부를 먼저 구분한다.

먼저 세 가지 상태를 구분하세요

상태	보이는 증상	먼저 할 일
실제 수정 실패	파일 시간·내용·git 상태가 모두 그대로	Claude Code 오류와 권한, 작업 경로 확인
수정됐지만 화면에 안 보임	파일 내용이나 git diff는 바뀌었는데 IDE diff가 없음	탐색기·소스 제어·확장 기능 새로고침
다른 복사본을 수정함	비슷한 이름의 프로젝트에서 변경이 발견됨	현재 작업 폴더와 전체 경로 대조

Anthropic은 Claude Code가 현재 프로젝트 폴더에서 여러 파일을 수정하고 명령을 실행한다고 설명합니다. VS Code 확장은 인라인 diff를 제공하지만, 실제 파일 변경과 diff 표시 화면은 같은 것이 아닙니다. GitHub 공개 이슈에는 변경은 적용됐지만 VS Code·Cursor에 diff가 나타나지 않았다는 보고가 있습니다. 이 이슈 하나만으로 현재 모든 버전의 결함이라고 말할 수는 없지만, “diff가 없다 = 파일이 안 바뀌었다”로 단정하면 안 된다는 실제 사례입니다.

1. Claude가 어느 폴더에서 일했는지 확인합니다

가장 흔한 착오는 파일명이 아니라 작업 폴더입니다. 터미널에서 다음 명령으로 현재 위치를 확인하세요.

Get-Location
Get-ChildItem -Force

Claude Code를 시작한 폴더와 VS Code에서 연 폴더가 같은지 전체 경로로 비교합니다. 예를 들어 C:\Users\me\project와 C:\Users\me\OneDrive\project는 이름이 비슷해도 다른 폴더입니다. 저장소를 두 번 복제했다면 project와 project-main도 쉽게 헷갈립니다.

파일 이름을 안다면 PowerShell에서 실제 위치를 찾을 수 있습니다.

Get-ChildItem -Path . -Recurse -File -Filter "파일이름.ext" |
  Select-Object FullName, LastWriteTime, Length

2. 탐색기보다 실제 파일 상태를 먼저 봅니다

VS Code 탐색기가 갱신되지 않았거나 파일 필터가 적용됐을 수 있습니다. 먼저 파일을 직접 다시 열고, 전체 경로·수정 시각·크기를 확인하세요.

Get-Item .\경로\파일이름.ext |
  Select-Object FullName, LastWriteTime, Length

파일을 찾았다면 VS Code에서 Developer: Reload Window를 실행하거나 탐색기를 새로고침합니다. Anthropic의 VS Code 확장 공식 가이드도 확장이 보이지 않거나 화면이 갱신되지 않을 때 창 다시 불러오기를 안내합니다.

수정 실패, 화면 미표시, 다른 복사본 수정은 확인 방법이 서로 다르다.

3. Git 저장소라면 status와 diff로 확인합니다

화면 기억보다 저장소 상태가 더 정확합니다. 프로젝트가 Git 저장소라면 다음 세 줄로 변경 파일과 실제 차이를 확인하세요.

git status --short
git diff --name-only
git diff -- 경로/파일이름.ext

Git의 status 문서는 작업 트리와 인덱스의 상태를 보여 주고, git diff 문서는 커밋되지 않은 실제 차이를 비교하는 기준을 설명합니다.

• git status에 파일이 나오고 git diff에 내용이 보이면 수정은 된 것입니다. IDE diff 표시 문제를 확인하세요.
• 새 파일은 git diff에 바로 안 보일 수 있습니다. git status --short의 ?? 표시를 확인하세요.
• 둘 다 아무것도 없으면 다른 폴더를 보고 있거나, 수정이 저장되지 않았거나, 작업 자체가 실패했을 가능성이 큽니다.

4. VS Code·Cursor의 diff 화면만 빠진 것인지 봅니다

Anthropic 공식 문서상 VS Code 확장은 인라인 diff와 변경 검토 기능을 제공합니다. 하지만 확장 버전, 편집기 상태, 세션 표면에 따라 보이는 방식이 다를 수 있습니다.

1. 왼쪽 소스 제어 패널에서 변경 파일이 잡히는지 확인합니다.
2. 확장 목록에서 Claude Code 버전을 확인하고 편집기를 다시 시작합니다.
3. 같은 저장소를 다른 VS Code 창이나 Cursor 창에서 열어 두지 않았는지 확인합니다.
4. 터미널의 git diff 결과와 편집기 화면을 대조합니다.

공개 이슈에는 Edit·Write가 적용됐지만 “0 diffs”로 보였다는 사례와 Windows에서 파일이 외부에서 바뀐 것으로 감지돼 편집이 반복 실패한 사례가 있습니다. 이때는 무작정 재시도하기보다 오류 문구, Claude Code 버전, 운영체제, 마지막으로 성공한 작업을 기록한 뒤 최신 공식 문서와 이슈 상태를 확인하는 편이 안전합니다.

5. 자동 저장·포매터·동기화 충돌을 분리합니다

파일을 저장하는 순간 포매터, 린터, 자동 저장, 클라우드 동기화 같은 다른 프로세스가 같은 파일을 다시 건드릴 수 있습니다. 편집 도구가 “파일이 예상과 다르게 수정됐다”고 알리면 다음처럼 원인을 줄이세요.

• 중요 파일을 복사해 두고 테스트용 브랜치나 복사본에서 재현합니다.
• 자동 저장과 저장 시 포맷을 잠시 끈 상태에서 한 파일만 수정합니다.
• 같은 파일을 열어 둔 다른 편집기 창을 닫습니다.
• 수정 직후 git diff를 다시 실행해 누가 어떤 내용을 바꿨는지 봅니다.

기존 기능을 깊게 바꾸는 확장 기능을 함께 쓴다면, Claude Code mod의 권한과 업데이트 경로도 함께 점검하세요.

6. 다시 시키기 전에 변경 범위를 고정합니다

파일이 정말 수정되지 않았다고 확인한 뒤에만 재작업을 요청하세요. 다음처럼 경로와 성공 기준을 함께 적으면 다른 복사본을 건드리거나 같은 수정을 중복 적용할 위험을 줄일 수 있습니다.

C:\work\sample-app 폴더만 작업하세요. 수정할 파일은 src\app.js 하나입니다. 수정 전 전체 경로를 보여 주고, 수정 후 git diff -- src/app.js 결과와 실행한 확인 명령을 요약하세요. 파일을 찾지 못하면 새 파일을 만들지 말고 멈추세요.

재시도 전 작업 경로부터 충돌 프로세스까지 순서대로 확인한다.

마지막 확인표

• Claude Code와 VS Code가 같은 전체 경로를 보고 있는가?
• 파일의 수정 시각·크기·내용이 실제로 바뀌었는가?
• git status --short에 수정 또는 새 파일이 표시되는가?
• 터미널 diff와 IDE diff 중 어느 쪽만 비어 있는가?
• 자동 저장·포매터·다른 편집기·동기화가 파일을 다시 바꾸지 않았는가?
• 재시도 전에 복사본이나 브랜치를 만들고 대상 파일을 고정했는가?

핵심은 “안 보인다”를 곧바로 “수정되지 않았다”로 바꾸지 않는 것입니다. 작업 경로 → 실제 파일 → Git 상태 → IDE 표시 → 충돌 프로세스 순서로 확인하면 대부분의 경우 수정 실패와 화면 문제를 구분할 수 있습니다.

---

출처 및 확인일

• Anthropic, 「Claude Code overview」, 게시일 미표기, https://code.claude.com/docs/en/overview, 확인 2026-10-08
• Anthropic, 「Claude Code in VS Code」, 게시일 미표기, https://code.claude.com/docs/en/vs-code, 확인 2026-10-08
• Git, 「git-status Documentation」, 게시일 미표기, https://git-scm.com/docs/git-status, 확인 2026-10-08
• Git, 「git-diff Documentation」, 게시일 미표기, https://git-scm.com/docs/git-diff, 확인 2026-10-08
• Anthropic GitHub, 「File diffs not appearing in VSCode/Cursor when Claude Code makes edits」, 2026-01-04, https://github.com/anthropics/claude-code/issues/16297, 확인 2026-10-08
• Anthropic GitHub, 「File has been unexpectedly modified errors break Edit tool in VSCode extension」, 2025-11-03, https://github.com/anthropics/claude-code/issues/10882, 확인 2026-10-08