AI 해결 노트 · 2026-09-17 · 실측 2026-09-17

Claude Code 윈도우 네이티브 설치, 제대로 깔렸는지 5분 만에 확인하기 — claude doctor·PATH·versions 폴더 실측

한 줄로

Claude Code 윈도우 네이티브 설치본은 버전, 실행 파일 위치, claude doctor, PATH, versions 폴더 순으로 점검하면 됩니다. 저희 PC에서는 실행 경로가 한 곳뿐이었고, doctor가 No installation issues found.를 출력했습니다.

이 글은 새로 까는 법보다 이미 깐 것을 점검하는 순서를 다룹니다. 설치 명령은 공식 문서에서 옮겼고 저희가 이번에 다시 실행하지는 않았습니다.

이런 분께

claude가 가끔 옛 버전으로 뜨거나, "업데이트하세요" 알림이 계속 나오거나, 인터넷 강좌대로 npm이나 winget으로 깔았다가 네이티브로 옮긴 분. 지금 어느 claude가 실행되는지 모르는 분.

실측 환경

공식 설치 명령 (실행하지 않음)

출처: code.claude.com/docs/en/setup (2026-09-17 확인). 이번 점검에서는 재설치하지 않았으므로 아래 명령은 문서 인용입니다.

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

문서는 둘을 헷갈렸을 때 나오는 오류도 적어 둡니다. PowerShell에서 CMD용을 치면 The token '&&' is not a valid statement separator, CMD에서 PowerShell용을 치면 'irm' is not recognized as an internal or external command가 나옵니다. 관리자 권한은 필요 없다고 되어 있습니다("You do not need to run as Administrator.").

점검 1 — 버전과 실행 파일 위치

$ claude --version
2.1.274 (Claude Code)

$ where.exe claude
C:\Users\User\.local\bin\claude.exe

PowerShell의 Get-Command claude -All도 Application claude.exe C:\Users\User\.local\bin\claude.exe 한 줄만 돌려줬습니다. 경로가 여러 개 나오면 각 경로의 실행 파일과 설치 출처를 확인하세요. 공식 문제 해결 문서(code.claude.com/docs/en/troubleshoot-install, 2026-09-17 확인)는 "If you find multiple installations, keep only one."이라고 하고, 권장 위치로 %USERPROFILE%\.local\bin\claude.exe를 듭니다.

npm 전역에 따로 깔린 것이 없는지도 봤습니다.

$ npm ls -g --depth=0 @anthropic-ai/claude-code
C:\Users\User\AppData\Roaming\npm
`-- (empty)

이번에 조회한 npm 전역 경로에서는 @anthropic-ai/claude-code가 발견되지 않았습니다. 이때 종료 코드가 1로 나오니 스크립트에서 쓸 때는 주의하세요.

점검 2 — claude doctor

도움말은 "Check the health of your Claude Code installation. Reads settings files in the current directory without a trust prompt."이고, 설치 문서는 "prints read-only installation and settings diagnostics without starting a session"이라고 설명합니다. 따로 만든 임시 작업 폴더에서 실행했고, 약 3초 뒤 종료 코드 0으로 끝났습니다.

Claude Code doctor

Running: native (2.1.274)
Commit: 1efcc1361e64
Platform: win32-x64
Path: C:\Users\User\.local\bin\claude.exe
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: success → 2.1.274 (2026-09-17)
Managed settings (remote): not fetched — requires an Enterprise or Team subscription
Organization policy: not applicable to Pro and Max accounts
...
No installation issues found.

저희는 Running, Path, Config install method, Auto-updates, Last update attempt 다섯 줄을 먼저 봤습니다.

점검 3 — PATH

문서의 Select-String 명령에, 실행 파일이 있는지 보는 Test-Path 한 줄을 붙여 돌렸습니다.

$env:PATH -split ';' | Select-String '\.local\\bin'
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

C:\Users\User\.local\bin
True

이번 where.exe claude와 Get-Command claude -All에서는 .local\bin\claude.exe 한 곳만 검색됐습니다.

셸 경유로 이 스크립트 파일을 만들다가 \\가 \ 하나로 줄어 '\.local\bin'이 저장된 적이 있습니다. 그러면 \b가 정규식 단어 경계로 해석돼 PATH 줄은 안 나오고 True만 찍힙니다. 결과가 비어 있으면 PATH를 고치기 전에 패턴부터 확인하세요.

점검 4 — versions 폴더와 0바이트 파일

이번 윈도우 환경에서는 %USERPROFILE%\.local\share\claude\versions\에 버전별 파일이 있었습니다. 문서의 심볼릭 링크 설명("the native installer manages the launcher at ~/.local/bin/claude as a symlink into ~/.local/share/claude/versions/")은 맥·리눅스에 해당합니다. 저희 폴더는 이랬습니다.

bin\claude.exe와 versions\2.1.274의 SHA-256은 4e4c1746…da117e로 같았습니다. 크기 0인 파일은 없었습니다.

find ~/.local/share/claude/versions -maxdepth 1 -type f -size 0
sha256sum ~/.local/bin/claude.exe ~/.local/share/claude/versions/2.1.274

첫 명령에서 경로가 출력되면 해당 폴더에 크기가 0바이트인 일반 파일이 있다는 뜻입니다.

저희 PC에서 8월에 겪은 일

아래는 이번 9월 17일 점검에서 재현한 내용이 아니고, 당시 명령 기록도 이 글에 싣지 않았습니다. 참고로만 봐 주세요.

저희 PC는 8월 14일까지 winget(Anthropic.ClaudeCode) 설치본을 썼습니다. 그때 winget 저장소의 최신은 2.1.229였고 실제 최신은 2.1.232여서, winget upgrade는 업데이트가 없다고 하는데 Claude Code는 업데이트하라는 알림을 계속 띄웠습니다. 그래서 네이티브 설치로 옮겼습니다.

다음 날에는 "Auto-update failed" 알림이 되풀이됐습니다. 그때는 versions\<버전> 파일이 0바이트로 남아 있었고, claude update는 Updating to X...만 찍고 종료 코드 0으로 끝나면서 아무것도 바꾸지 않았습니다. 릴리스 manifest.json의 크기·체크섬과 맞는 파일을 받아 그 자리에 둔 뒤 claude update를 돌려 해결했습니다.

공식 문서는 "WinGet installations do not auto-update."라고 적고, winget upgrade Anthropic.ClaudeCode로 업데이트하라고 안내합니다. 이번 doctor에는 Auto-updates: enabled로 나옵니다. 이미 네이티브로 쓰고 있다면 winget install이나 npm install -g @anthropic-ai/claude-code를 덧붙여 실행하지 않는 편이 안전합니다. claude 실행 파일이 둘이 되면 어느 쪽이 실행되는지 헷갈리기 쉽습니다.

결과

실패한 것

PATH 확인 스크립트를 처음 두 번은 패턴의 백슬래시가 줄어든 채로 돌렸습니다(위 점검 3). 두 회차 모두 PATH 검색 결과는 없었고 Test-Path의 True만 출력됐습니다. 파일을 다시 써서 세 번째에 정상 출력을 얻었습니다.

확인하지 않은 것

• 설치 명령(install.ps1, install.cmd) 실제 실행. 이번엔 재설치를 하지 않았습니다.
• claude update, claude install 실행. 도움말(Check for updates and install if available)만 봤습니다.
• 세션 안의 /doctor(수리까지 하는 쪽).
• .old.<숫자> 파일을 지워도 되는지, 언제 정리되는지.
• 윈도우에서 bin\claude.exe를 바꿔 끼우는 방식(복사인지 다른 방식인지).
• WSL 설치.

함께 보기

• Claude Code settings.json 위치와 우선순위
• 윈도우에서 Claude Code에 MCP 서버 붙이기