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

클로드코드 설치했는데 claude 명령어를 못 찾는다고 뜨네요

익명2026. 7. 30.· 조회 219
npm install -g @anthropic-ai/claude-code로 설치는 성공했다고 나오는데, 새 터미널 열면 claude: command not found 떠요. PATH에 npm 글로벌 경로 추가해야 되는 건 알겠는데 어디다 추가해야 하는지 감이 안 잡히네요. 맥 쓰고 있고 nvm으로 노드 설치했는데 이것도 관련 있을까요? 재부팅도 해봤는데 똑같아요.

답변 1

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

    안녕하세요, 운영진입니다. 결론부터 말씀드리면 npm 전역 설치 디렉터리가 PATH에 안 잡혀 있어서 생기는 문제이고, nvm을 쓰신다면 그게 원인일 가능성이 큽니다. npm install -g로 설치하면 claude 명령어는 npm의 전역 bin 폴더에 생깁니다. nvm으로 노드를 관리하면 이 경로가 노드 버전마다 달라지는데(예: ~/.nvm/versions/node/버전/bin), 새 터미널을 열 때 nvm이 설치 당시와 같은 버전을 로드하지 못하면 그 bin 경로가 PATH에서 빠져서 claude를 못 찾는 증상이 나타날 수 있습니다. 확인해 보시면 좋은 순서입니다. 1. 터미널에서 which -a claude, npm -g ls @anthropic-ai/claude-code를 실행해 실제로 어디에 설치됐는지 확인하세요. 2. echo $PATH로 nvm 노드 버전의 bin 경로가 포함돼 있는지 확인하세요. 3. nvm alias default 설치된버전 명령으로 기본 노드 버전을 지정해 두면, 새 터미널을 열 때마다 같은 버전이 로드돼 PATH 문제가 줄어듭니다. 4. 맥 기본 셸인 zsh이라면 ~/.zshrc에 nvm 초기화 스크립트(export NVM_DIR와 nvm.sh 로드 구문)가 실제로 들어 있는지도 확인하세요. 이 구문이 .bash_profile 등 다른 파일에만 있으면 새 zsh 터미널에서는 nvm 자체가 로드되지 않습니다. 이 방법으로도 안 되면 npm 대신 공식 네이티브 설치 스크립트로 다시 설치하는 방법도 있습니다. PATH 관련 문제가 상대적으로 적은 편입니다. 설치 방식별 차이는 아래 가이드에 자세히 정리해 두었습니다. https://usingclaude.com/ko/claude-code/install/claude-code-install-guide 설치·로그인 오류를 더 폭넓게 다룬 글도 참고하시면 도움이 됩니다. https://usingclaude.com/ko/claude-code/troubleshooting/claude-code-install-troubleshoot