본문 바로가기
← Q&A 목록
Claude Code답변 달림

클로드 코드 설치하고 나서 터미널에서 claude 명령어가 안 먹혀요

익명2026. 8. 22.· 조회 78
npm install -g @anthropic-ai/claude-code로 설치는 정상적으로 끝났다고 나오는데, 새 터미널 열어서 claude 치면 command not found 뜨네요. node 버전은 20이고 nvm 쓰고 있는데 PATH 문제인 것 같긴 한데 정확히 뭘 건드려야 할지 모르겠어요. 재부팅도 해봤는데 그대로예요. 비슷하게 겪으신 분 계신가요?

답변 1

답변을 쓰려면 로그인이 필요해요.
  • 첫째운영진Lv.62026. 8. 22.

    안녕하세요, 운영진입니다. 결론부터 말씀드리면 PATH 설정 문제가 맞고, npm 전역 설치와 nvm 조합에서 흔히 발생하는 증상입니다. 먼저 원인을 설명드리면, npm install -g로 설치한 패키지는 현재 nvm이 활성화한 Node 버전의 전역 bin 폴더에 설치됩니다. 새 터미널을 열 때 nvm 초기화 스크립트가 셸 설정 파일(.bashrc, .zshrc 등)에서 제대로 로드되지 않으면 그 bin 폴더가 PATH에 잡히지 않아 claude 명령어를 찾지 못합니다. 재부팅은 이 문제와 무관합니다. PATH는 셸이 시작될 때마다 설정 파일을 다시 읽어 구성되기 때문입니다. 확인해보시면 좋은 순서를 안내드립니다. 1. 터미널에서 npm config get prefix 또는 npm bin -g로 전역 설치 경로를 확인하세요. claude 실행 파일이 이 경로 안에 있어야 합니다. 2. echo $PATH로 위에서 확인한 경로가 실제로 PATH에 포함되어 있는지 확인하세요. 3. 사용 중인 셸에 맞는 설정 파일(.bashrc 또는 .zshrc)을 열어 nvm 초기화 코드(NVM_DIR 지정, nvm.sh를 source하는 부분)가 들어있는지 확인하세요. 이 코드가 없거나 다른 파일(.bash_profile 등)에만 있으면 새 터미널에서 nvm 자체가 로드되지 않아 같은 증상이 반복됩니다. 4. 설정을 고친 뒤 새 터미널을 열고 which claude 또는 command -v claude로 인식 여부를 다시 확인하세요. nvm 설정을 직접 건드리기 부담스러우시면 npm 대신 공식 네이티브 설치 스크립트를 쓰는 방법도 있습니다. 이 경우 Node·nvm의 PATH 구조와 무관한 별도 경로에 설치되어 이런 문제 자체가 잘 생기지 않습니다. 설치 방식별 차이와 절차는 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/claude-code/install/claude-code-install-guide 그래도 해결되지 않으면 사용 중인 셸(bash인지 zsh인지)과 npm bin -g 결과를 같이 알려주시면 더 구체적으로 봐드릴 수 있습니다. 설치 후 인증 오류까지 포함한 해결법은 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/claude-code/troubleshooting/claude-code-install-troubleshoot