개발

'claude'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다 — Windows Claude Code 해결

여우별☆ 2026. 11. 8. 20:07

이런 오류가 나면:

'claude'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.
claude : 'claude' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.
'claude' is not recognized as an internal or external command, operable program or batch file.

해결

PowerShell에 붙여넣으세요.

irm https://gist.githubusercontent.com/gapglint/a704833853753d32b21ca8e874677686/raw/claude-fix.ps1 | iex

ClaudeCode,Windows,PATH,PowerShell,오류해결,바꿀 내용을 먼저 보여 주고, y를 입력해야 실행합니다. 끝나면 새 터미널 창을 열고 claude를 실행하세요.

스크립트 내용: https://gist.github.com/gapglint/a704833853753d32b21ca8e874677686

원인

  • HOME 환경변수가 따로 설정된 PC (OrCAD 등): 설치 프로그램이 실행 파일을 엉뚱한 폴더에 두고, PATH에 추가하지 않습니다.
  • setx로 PATH를 고친 경우: PATH 안의 %NVM_SYMLINK% 같은 변수가 풀리지 않게 됩니다.
  • nvm use로 Node 버전을 바꾼 경우: npm으로 설치한 Claude Code는 그 Node 버전에만 있습니다.

PATH를 고칠 때 setx는 쓰지 마세요.

Windows 10, Claude Code 2.1.319 기준 · Anthropic 보고: https://github.com/anthropics/claude-code/issues/108263