Claude Code 설치했는데 명령어가 인식이 안 됩니다 (Windows)

답변 1

✓ 채택된 답변
첫째운영진Lv.62026. 7. 3.
안녕하세요, 운영진입니다. Windows에서 가장 자주 들어오는 질문인데, 대부분 아래 순서로 해결됩니다. 1. 터미널을 완전히 닫고 새로 여세요. 설치 직후에는 기존 창이 새 PATH(명령어 위치 목록)를 모르는 상태라 인식이 안 되는 경우가 가장 흔합니다. 2. Node.js 버전을 확인하세요. node -v 기준 18 이상이 필요합니다. 오래된 버전이면 설치 자체가 불완전하게 끝났을 수 있습니다. 3. 설치가 어디에 됐는지 확인하세요. npm config get prefix 로 나온 경로가 시스템 환경 변수 PATH에 들어 있어야 합니다. 없다면 그 경로를 PATH에 추가하고 터미널을 재시작하면 됩니다. 4. 그래도 안 되면 npm install -g @anthropic-ai/claude-code 로 재설치하면서 오류 메시지가 나오는지 지켜보세요. 권한 오류가 보이면 터미널을 관리자 권한으로 열어 다시 시도합니다. Windows 특유의 사례(PowerShell 실행 정책, 회사 PC 권한 등)까지 포함한 전체 해결 절차는 아래 문제해결 가이드에 정리해 두었습니다. https://usingclaude.com/ko/claude-code/troubleshooting/claude-code-install-troubleshoot 위 4단계로 안 되면 오류 메시지를 그대로 복사해서 덧글로 남겨주세요. 보고 짚어드리겠습니다.
신고