npm 설치, 로컬 vs 전역 vs npx 완전 정복, 초보자도 이해하는 쉬운 가이드

npm을 배우다 보면 가장 먼저 헷갈리는 세 가지가 있습니다

개발을 처음 시작하면 가장 빨리 만나는 도구 중 하나가 바로 npm입니다. 그런데 막상 써보려고 하면 여기서 바로 막힙니다. 로컬 설치가 뭐지, 전역 설치는 또 뭐지, npx는 왜 따로 있지. 이름은 많이 보이는데 감이 잘 안 잡히는 경우가 많습니다.

이건 사실 초보자만의 문제가 아닙니다. 처음 개념을 잘못 잡아두면 나중에 프로젝트가 꼬일 때 왜 그런지도 모른 채 헤매게 됩니다. 그래서 오늘은 이 세 가지를 정말 쉽게, 그리고 실무에서 바로 구분할 수 있게 정리해보겠습니다.

핵심만 먼저 보면 이렇습니다. 프로젝트 안에서 쓰는 것은 로컬 설치, 컴퓨터 전체에서 자주 쓰는 도구는 전역 설치, 한 번만 가볍게 실행할 때는 npx. 이 기준만 잡혀도 npm이 훨씬 쉬워집니다.

---

npm이란 무엇인가요?

npm은 Node.js에서 사용하는 패키지 관리자입니다. 쉽게 말하면, 필요한 기능이나 도구를 설치해서 쓸 수 있게 해주는 시스템입니다.

예를 들어 이런 것들을 npm으로 설치합니다.

• 날짜 계산 라이브러리
• 서버 실행 도구
• React 같은 프레임워크
• 개발 편의용 CLI 도구

즉, npm은 단순 설치 버튼이 아니라 개발 환경을 구성하는 기본 도구라고 보면 됩니다.

💡 이신우 소장의 한마디: npm을 이해하면 개발이 쉬워지는 이유는, 코드를 잘 쓰는 문제보다 먼저 어떤 도구를 어디에 설치해야 하는지를 알게 되기 때문입니다.

---

1. 로컬 설치는 프로젝트 안에서만 쓰는 방식입니다

명령어

npm install lodash

무슨 뜻인가요?

로컬 설치는 현재 프로젝트 폴더 안에만 패키지를 설치하는 방식입니다. 보통 설치가 끝나면 node_modules 폴더가 생기고, 그 안에 라이브러리가 들어갑니다.

특징

• 해당 프로젝트에서만 사용 가능
• 팀원과 같은 환경 유지 가능
• package.json에 기록됨

비유로 이해하면

카페 안에서만 쓰는 머그컵과 비슷합니다. 밖에 들고 나갈 수는 없지만, 그 카페 안에서는 가장 안정적입니다.

언제 쓰나요?

프로젝트에서 실제로 사용하는 라이브러리는 대부분 로컬 설치를 합니다.

• React
• Express
• lodash
• axios

즉, 프로젝트 코드에 직접 들어가는 것은 로컬 설치가 기본이라고 보면 됩니다.

---

2. 전역 설치는 컴퓨터 어디서든 쓰는 방식입니다

명령어

npm install -g http-server

무슨 뜻인가요?

전역 설치는 내 컴퓨터 전체에서 사용할 수 있도록 설치하는 방식입니다. 특정 프로젝트 안이 아니라, 어디서든 명령어처럼 실행할 수 있게 됩니다.

특징

• 모든 프로젝트에서 사용 가능
• 명령어 형태로 실행 가능
• 시스템 전체 환경에 영향을 줌

비유로 이해하면

집에서 쓰는 개인 텀블러와 비슷합니다. 카페든 회사든 어디든 들고 다니면서 쓸 수 있습니다.

언제 쓰나요?

주로 CLI 도구나 자주 반복해서 쓰는 개발 도구를 설치할 때 씁니다.

• http-server
• nodemon
• 예전 create-react-app 방식

즉, 프로젝트 코드가 아니라 개발할 때 쓰는 도구는 전역 설치를 고려할 수 있습니다.

📢 이신우 소장의 AI 강의 안내

미래이음연구소에서 바이브코딩 입문 / 생성형AI 업무효율화 / GEO 마케팅 강의를 운영합니다.

🌐 lab.duonedu.net  |  📞 010-3343-4000 (강의 문의)

---

3. npx는 설치 없이 한 번 실행하는 방식입니다

명령어

npx create-react-app myapp

무슨 뜻인가요?

npx는 전역 설치를 하지 않아도, 패키지를 한 번만 실행할 수 있게 해주는 기능입니다. 설치 후 계속 유지하는 방식이 아니라, 필요할 때 잠깐 불러와 쓰는 느낌에 가깝습니다.

특징

• 설치 없이 실행 가능
• 최신 버전을 쓰기 편함
• 시스템을 깔끔하게 유지하기 좋음

비유로 이해하면

일회용 컵과 비슷합니다. 필요할 때만 쓰고 정리하는 방식입니다.

언제 쓰나요?

• 한 번만 실행할 때
• 설치가 부담스러울 때
• 최신 버전이 필요할 때

즉, 잠깐 쓰고 끝낼 도구라면 npx가 훨씬 편합니다.

---

언제 무엇을 써야 할까?

여기서부터가 가장 중요합니다. 개념보다 실전 기준으로 보면 이렇게 정리할 수 있습니다.

상황	추천 방식
프로젝트에서만 사용하는 라이브러리	로컬 설치
여러 프로젝트에서 반복 사용하는 도구	전역 설치
한 번만 실행하거나 테스트할 때	npx

이 기준만 기억해도 설치 방식 때문에 헤매는 일이 많이 줄어듭니다.

---

초보자가 가장 많이 하는 실수

1. 전역 설치를 너무 많이 하는 것

프로젝트 라이브러리까지 전역으로 설치하면 팀원과 환경이 달라집니다. 그러면 내 컴퓨터에선 되는데요 같은 문제가 생깁니다.

2. 버전 충돌

전역 설치 버전과 로컬 설치 버전이 다르면 이상한 오류가 생길 수 있습니다. 특히 CLI 도구에서 많이 겪습니다.

3. npx를 무조건 만능처럼 쓰는 것

npx는 편하지만 매번 다운로드나 확인 과정이 들어갈 수 있어서 반복 작업에서는 오히려 느릴 수 있습니다.

---

이렇게 기억하면 가장 쉽습니다

• 프로젝트는 로컬
• 도구는 전역
• 테스트는 npx

정말 많이 헷갈린다면 이 한 줄만 외워도 됩니다.

프로젝트는 로컬, 도구는 전역, 테스트는 npx

---

자주 묻는 질문 (Q&A)

Q. React는 로컬 설치인가요, 전역 설치인가요?

A. 보통 프로젝트 안에서 쓰는 라이브러리이므로 로컬 설치가 기본입니다.

Q. nodemon은 왜 전역 설치하는 경우가 많나요?

A. 여러 프로젝트에서 반복적으로 실행하는 개발 도구이기 때문입니다. 하지만 프로젝트별로 로컬 설치해서 쓰는 경우도 있습니다.

Q. npx는 설치를 아예 안 하는 건가요?

A. 사용자는 설치를 신경 쓰지 않고 실행하지만, 내부적으로 필요한 패키지를 불러와 실행하는 방식입니다.

Q. 무조건 전역 설치하면 편한 것 아닌가요?

A. 편할 수는 있지만, 프로젝트 버전 관리와 팀 협업에는 불리할 수 있습니다.

Q. 초보자는 무엇부터 익히면 좋나요?

A. 로컬 설치 개념부터 확실히 이해하는 것이 가장 중요합니다. 그 다음 전역 설치와 npx를 구분하면 됩니다.

---

정리하면, npm 설치 방식은 개발 환경을 정리하는 규칙입니다

npm은 단순한 설치 도구가 아니라 개발 환경을 관리하는 핵심입니다. 무엇을 어디에 설치하느냐에 따라 프로젝트 안정성이 달라지고, 협업 방식이 달라지고, 오류가 생겼을 때 해결 속도도 달라집니다.

그래서 초보자일수록 처음부터 개념을 제대로 잡는 것이 중요합니다. 로컬 설치는 프로젝트 안정성, 전역 설치는 편의성, npx는 가벼운 실행. 이 세 가지를 상황에 맞게 쓰는 감각이 생기면 개발이 훨씬 덜 복잡해집니다.

---

이신우 소장

바이브코딩 전문강사 · 생성형AI 활용 업무효율화 강사 · 미래이음연구소 소장

생성형 AI 기술을 현장에 접목하는 업무형 강의로 기업·기관·학교 대상 AI 교육을 진행하고 있습니다. 누구나 쉽게 AI를 업무에 활용할 수 있도록 돕습니다.

🌐 lab.duonedu.net  |  📞 010-3343-4000