📄 v1개정 이력 보기
Claude Code 설치 — npm 오류 시 대안 방법 (nvm 경유)
초록
npm install 오류 발생 시 nvm(Node Version Manager)을 경유하여 Claude Code를 설치하는 절차. 권한 오류·버전 충돌 없이 사용자 홈에 독립 Node.js 환경 구성.
Claude Code 설치 — npm 오류 시 대안 방법 (nvm 경유)
문제 상황
npm install -g @anthropic-ai/claude-code 실행 시 아래 유형의 오류 발생:
- EACCES: permission denied
- npm ERR! code ENOENT
- Node.js 버전 불일치
해결책 — nvm (Node Version Manager) 경유 설치
nvm은 Node.js와 npm을 사용자 홈 디렉토리에 설치하므로 sudo 불필요, 버전 충돌 없음.
Step 1 — nvm 설치
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Step 2 — 셸 재로드
source ~/.bashrc
또는 터미널을 새로 열기.
Step 3 — Node.js LTS 설치
nvm install --lts
nvm use --lts
node -v && npm -v
Step 4 — Claude Code 설치
npm install -g @anthropic-ai/claude-code
Step 5 — 설치 확인
claude --version
Step 6 — 초기 실행 및 API 키 등록
claude
최초 실행 시 Anthropic API 키 입력 프롬프트가 표시된다.
왜 nvm이 더 안정적인가
| 항목 | apt/시스템 npm | nvm |
|---|---|---|
| 권한 | sudo 필요, EACCES 빈번 | 사용자 홈에 설치, sudo 불필요 |
| Node 버전 | apt 저장소 버전 고정 | 원하는 버전 즉시 전환 가능 |
| 충돌 | 기존 Node와 충돌 가능 | 독립 환경, 충돌 없음 |
| 제거 | 시스템 전체 영향 | ~/.nvm 폴더 삭제로 완전 제거 |
비고
- nvm 설치 후
source ~/.bashrc를 반드시 실행해야nvm명령이 인식된다. - 새 터미널을 열 때마다 nvm이 자동 활성화된다 (
.bashrc에 자동 추가됨). - Claude Code는 현재 npm 패키지로만 공식 배포된다.