본문 바로가기

NVM2

Claude Code exit code 3 오류, Node 업그레이드로 해결 Claude Code 오류 해결 Claude Code를 실행했는데 아무 반응 없이 exit code 3만 뜨고 꺼지는 경우가 있어요. 이 오류는 Claude Code가 요구하는 최소 Node.js 버전을 충족하지 못할 때 발생해요. 정상적인 실행이라면 Claude Code 인터페이스가 바로 뜨는데, 이 오류가 나면 터미널에 숫자 하나만 찍히고 아무 일도 일어나지 않아요. 처음 보면 뭐가 잘못된 건지 감이 안 잡혀서 당황스러울 수 있어요. 📌 3줄 요약 · exit code 3은 Node.js 에러가 아니라 Claude Code가 자체 정의한 종료 코드예요. · 원인은 대부분 Node.js 18 버전 사용이고, 20 이상(권장 22 LTS)으로 올리면 해결돼요. · 업그레이드 후에는 .. 2026. 8. 13.
WSL에서 Claude Code 실행 안 될 때 해결법 트러블슈팅 WSL에서 Claude Code 설치가 안 된다면, Node.js 버전·npm 권한·네트워크·WSL 설정 네 가지를 순서대로 점검해보세요. 대부분 10분 안에 해결됩니다. 📌 3줄 요약 WSL에서 Claude Code 설치 실패는 Node.js 미설치/구버전, npm 권한, 네트워크 차단, WSL 설정 네 가지 원인이 대부분입니다. nvm으로 Node.js 18 이상을 설치하고, npm 글로벌 경로를 사용자 디렉토리로 변경하면 권한 문제까지 한 번에 해결됩니다. WSL 2 + 리눅스 홈 디렉토리 조합이 가장 안정적인 실행 환경입니다. 📑 목차 1. WSL 환경에서 Claude Code가 안 되는 이유 2. Node.js 버전과.. 2026. 8. 10.