증상 → npm 전역 설치에서 EACCES가 나면 먼저 현재 Node.js와 npm의 경로를 확인하고, 경로가 맞지 않으면 설치를 중단하세요.
빠른 해결 → npm 공식 안내에 따라 우선 Node 버전 관리자를 검토하고, 필요한 경우에만 전역 설치 위치를 사용자 폴더로 바꾸세요. sudo로 밀어붙이거나 시스템 폴더 권한을 먼저 바꾸면 안 됩니다.
이 안내는 Node.js 24를 설치한 뒤 처음 전역 명령을 설치하려는 학생에게 적합합니다. 학교 맥이나 원격 맥에서 관리자 권한 없이 공부하는 초보자도 안전하게 멈출 지점을 확인할 수 있습니다. 프로젝트는 실행되지만 가끔 공용 명령이 필요한 자바스크립트 학습자에게도 도움이 됩니다.
SECTION 01먼저 구분하세요: 프로젝트 설치인가, 전역 설치인가요?
프로젝트 의존성은 현재 프로젝트가 사용하는 도구입니다. 프로젝트 폴더 안에서 npm install을 실행하면 보통 해당 프로젝트에 필요한 패키지를 설치합니다. 반면 npm install -g 패키지이름처럼 -g를 붙이는 전역 설치는 여러 프로젝트에서 호출할 수 있는 “공용 도구”를 설치하려는 동작입니다. npm은 전역 설치와 로컬 설치의 차이를 구분해 안내합니다.
프로젝트 폴더에서 npm install만 실패한다면 어떻게 해야 하나요?
그 오류가 곧바로 전역 폴더 권한 문제라는 뜻은 아닙니다. 먼저 프로젝트 폴더에서 실행했는지, 오류 메시지가 특정 패키지나 프로젝트 경로를 가리키는지 확인하세요. 과제 프로젝트에 필요한 패키지를 설치하는 상황이라면 전역 설치 권한을 바꾸기보다 프로젝트 의존성 오류를 따로 살펴야 합니다.
macOS npm 전역 설치에서 EACCES가 뜨더라도 원인은 한 가지가 아닙니다. 예전 설치의 파일이 남아 있거나, 터미널이 서로 다른 Node.js와 npm을 호출하거나, npm이 쓰려는 폴더에 쓰기 권한이 없을 수 있습니다. npm의 EACCES 해결 안내도 권한 문제를 해결하기 전에 설치 방식을 살펴보도록 안내합니다.
SECTION 02첫 번째 확인: Node.js와 npm은 같은 설치 경로에서 실행되나요?
터미널을 열고 아래 명령을 한 줄씩 실행하세요.
which node
which npm
node -v
npm -v
npm config get prefix
npm root -g
which는 터미널이 실제로 실행할 파일의 위치를 보여줍니다. node -v와 npm -v는 각각 실행 중인 Node.js와 npm의 버전을 확인합니다. npm config get prefix는 npm 전역 설치의 기준 경로를, npm root -g는 전역 패키지가 놓이는 경로를 확인하는 데 씁니다. 전역 폴더와 설정값의 의미는 npm 폴더 안내와 npm 설정 문서에서 확인할 수 있습니다.
출력된 경로를 메모하고, node와 npm이 어떤 설치 방식에서 왔는지 비교하세요. 예전 설치 잔여물과 새 설치 경로가 섞여 있거나, 예상하지 못한 시스템 위치를 가리킨다면 여기서 멈추는 편이 안전합니다. 경로를 모른 채 파일을 지우거나 시스템 폴더 권한을 바꾸면 원인을 더 찾기 어려워질 수 있습니다.
학교에서 지정한 Node.js 버전이 있다면 먼저 강의 안내와 현재 버전을 대조하세요. 설치 방식을 바꿔도 수업에서 요구하는 버전이 달라지면 과제 실행 결과가 달라질 수 있습니다.
SECTION 03권한 오류라면 어떤 해결 경로를 선택해야 하나요?
Node.js 공식 배포 상태 안내에서는 Node.js 24를 LTS, Node.js 26을 Current로 표시합니다. 버전 상태는 변할 수 있으므로 현재 상태는 Node.js 공식 릴리스 목록에서 다시 확인하세요. Node.js 24 파일을 확인해야 한다면 공식 다운로드 보관소를 이용할 수 있습니다. 다만 이 페이지가 특정 설치 방식이나 권한 문제의 해결을 보장하는 것은 아닙니다.
아래 결정 목록에서 해당하는 항목을 확인하세요. 조건에 맞는 경로 하나를 선택하고, 경로가 불분명하면 변경을 멈추는 것이 기준입니다.
- [ ] Node.js와 npm의 출처가 서로 다르거나 여러 수업에서 버전을 바꿔 써야 합니다. Node 버전 관리자를 우선 검토하세요. 여러 강의용 도구 묶음을 관리하는 방식입니다. npm 공식 안내도 전역 설치 권한 문제의 해결 방향으로 버전 관리자 사용을 제시합니다.
- [ ] 현재 설치 방식을 유지해야 하고, 학교 정책상 설정 파일을 바꿀 수 있습니다. npm 전역 설치 위치를 사용자 폴더로 바꾸는 방법을 검토하세요. npm 문서는 사용자 폴더를 사용하는 방향과
prefix설정을 설명하지만, 모든 맥의 셸 설정에 똑같이 적용된다고 보장하지는 않습니다. - [ ] 학교에서 관리하는 맥이고 설정 권한이 없거나, 설치 경로를 설명할 수 없습니다. 변경하지 말고 관리자에게 문의하세요. 권한 제한을 우회하는 절차를 시도하지 마세요.
- [ ] 해당 명령을 한 번만 써야 하며, 패키지가 별도의 실행 방법을 제공합니다. 전역 설치가 꼭 필요한지 먼저 확인하세요. 프로젝트별 사용법이 있으면 프로젝트 안에서 해결하는 편이 변경 범위가 작습니다.
Node 버전 관리자는 설치된 Node.js와 npm의 출처를 일관되게 관리하려는 학습자에게 유리합니다. 반대로 이미 수업에서 정한 설치 방식이 있고, 그 환경을 유지해야 한다면 새 관리 방식으로 바꾸기 전에 강의 담당자에게 확인해야 합니다. 설치 명령은 맥의 기존 설정과 셸에 따라 달라질 수 있으므로, 확인 없이 복사해 실행하지 마세요.
사용자 폴더 방식은 시스템 폴더를 건드리지 않는 장점이 있지만, 전역 명령이 들어 있는 경로를 셸의 PATH에 추가해야 할 수 있습니다. PATH는 터미널이 명령어를 찾을 때 차례로 살펴보는 “경로 목록”입니다. 설정을 바꾸기 전에 현재 셸이 zsh인지 확인하고, npm의 현재 안내를 참고하세요. 방법이 분명하지 않거나 학교 기기 정책을 모르면 진행을 멈추세요.
사용자 폴더로 바꾸는 방법과 Node 버전 관리자 중 무엇을 택하든, 수업에서 지정한 버전과 학교의 기기 정책을 먼저 확인하세요. 경로를 확인할 수 없으면 권한 설정을 더 바꾸지 마세요.
SECTION 04수정 후에는 어떻게 확인하나요?
설정을 바꿨다면 터미널을 새로 열고 경로 확인 명령을 다시 실행하세요. 그다음 오류가 난 전역 설치를 다시 시도하고, 설치가 끝나면 해당 프로그램의 도움말이나 버전 명령으로 호출되는지 확인합니다. 패키지마다 확인 명령이 다르므로 임의의 명령을 정답처럼 가정하지 말고 패키지 설명을 확인하세요.
- 권한 거부가 그대로 반복되면: 같은 설치 명령을
sudo로 재실행하지 마세요.npm config get prefix와 오류에 표시된 경로를 비교하고, 서로 다르거나 원인을 설명할 수 없다면 더 변경하지 마세요. - 설치는 끝났지만 명령을 찾지 못하면: 사용자 폴더 설정과
PATH가 맞는지 살펴보세요.PATH를 고친 뒤에도 터미널이 이전 경로를 사용한다면 셸을 다시 시작한 후 확인합니다. - 프로젝트 의존성 설치만 실패하면: 전역 권한 해결을 계속하지 말고, 프로젝트 폴더와 오류 메시지에 나온 파일 경로를 기준으로 원인을 다시 분류하세요.
VS Code 터미널에서만 명령을 찾지 못한다면, 시스템 터미널과 VS Code가 서로 다른 셸 설정을 읽는지 확인해야 합니다. VS Code 터미널 프로필 안내를 참고해 실제 터미널 프로필을 비교하세요.
npm 권한을 고친 뒤 수업 프로젝트가 영향을 받지 않았는지 어떻게 확인하나요?
프로젝트 폴더에서 다시 의존성을 설치하고, 과제 안내에 있는 실행 명령을 확인하세요. 전역 설치 경로를 조정한 것만으로 프로젝트가 정상이라고 단정할 수는 없습니다. 수업에서 지정한 Node.js 버전, 프로젝트가 사용하는 명령, 실행 결과를 각각 확인하면 됩니다.
SECTION 05현재 컴퓨터로 해결하기 어렵다면
학교 맥은 관리자가 설치와 설정을 제한할 수 있고, 개인 컴퓨터는 수업용 도구를 별도로 구성해야 하며, 설치 경로가 섞이면 다른 프로젝트까지 영향을 줄 수 있습니다. 반대로 원격 맥은 macOS 환경에서 과제를 확인하는 대안이지만, 네트워크 연결이 필요하고 실물 맥의 로컬 사용과 같지 않으며, 장기간 계속 쓸 계획이라면 구매나 다른 환경과 비용을 비교해야 합니다.
문제가 npm 권한에만 있고 현재 맥을 계속 쓸 수 있다면 위의 경로 점검을 먼저 끝내세요. 과제에 필요한 macOS 환경 자체를 사용할 수 없는 경우에는 MACNOX의 이용 요금과 선택지를 비교해 볼 수 있습니다. 실제로 맥에서 수업을 진행해야 하고 임시 환경이 적합하다면 한국 이용 안내에서 원격 접속 방식을 확인하세요. 렌탈은 잠깐 필요한 학습 환경을 마련하는 선택지이지, 장기적으로 매일 안정적인 고부하 작업을 하거나 물리 장치가 필요한 경우의 정답은 아닙니다.