[Local LLM 구축하기 09] Node.js·npm 설치와 실행 경로 확인

Local LLM 구축하기 · 09/30 · 개발 환경

전체 연재와 학습 순서 · 실습 코드 ZIP

Node.js는 JavaScript를 브라우저 밖에서 실행하고, npm은 필요한 패키지를 설치하는 데 사용합니다. 뒤에서 다룰 OpenClaw도 Node로 동작해요. 여기서는 설치를 마친 뒤 실제로 어느 버전과 경로가 사용되는지 확인합니다.

Windows PowerShell을 준비합니다. 이전에 Node를 설치한 적이 있다면 버전과 실행 경로부터 기록해 둡니다.

Node LTS와 요구 버전

nodejs.org에서 지원 중인 LTS 설치 파일을 받습니다. 2026년 10월 18일 확인 기준으로 Node 24 계열은 LTS입니다. 같은 날 확인한 OpenClaw 문서는 Node 24.16 이상 또는 26.1 이상을 요구하고 Node 26을 권장합니다. 연재에서는 Node 24의 최신 패치로 시작하며, 실제 설치일에도 OpenClaw의 요구 조건을 다시 확인합니다.

LTS 여부와 프로그램의 최소 요구 버전은 따로 봐야 합니다. 예전 강좌에 적힌 “Node 18 이상”을 그대로 적용하면 설치 후 실행 단계에서 막힐 수 있어요. Windows x64·ARM64 설치 파일도 PC에 맞게 고릅니다.

Node·npm 경로 확인

node --version
npm.cmd --version
npx.cmd --version
Get-Command node, npm.cmd, npx.cmd
where.exe node

Windows 설치 파일에는 보통 npm이 함께 들어 있습니다. npm.ps1이 실행 정책에 막히면 npm.cmd로 실행해 볼 수 있습니다. 시스템 전체의 정책을 바꾸기 전에 이 차이를 확인하세요. where.exe node에 여러 경로가 나오면 PATH에서 앞선 설치가 실행됩니다. 새 버전을 설치했는데도 버전이 그대로라면 그 순서를 살펴봅니다.

package.json과 API 요청

New-Item -ItemType Directory -Force "$env:USERPROFILE\node-llm-lab"
Set-Location "$env:USERPROFILE\node-llm-lab"
npm.cmd init -y
node -e "fetch('http://127.0.0.1:11434/api/version').then(r=>r.json()).then(console.log).catch(e=>{console.error(e);process.exitCode=1})"

위 예제는 Node의 내장 fetch로 Ollama 버전을 요청합니다. Node가 설치돼도 Ollama 서버가 꺼져 있으면 요청은 실패합니다. 두 단계를 나눠 확인할 수 있는 간단한 예예요. 프로젝트의 설정은 package.json에, 선택된 의존성 버전은 package-lock.json에 기록됩니다.

프로젝트 설치·전역 설치·npx

프로젝트 안에서 npm install을 실행하면 의존성이 node_modules에 설치됩니다. 전역 설치는 명령줄 프로그램을 사용자 환경에서 찾기 쉽게 하고, npx는 패키지의 실행 파일을 찾아 실행합니다. npx도 필요한 코드를 내려받아 실행할 수 있으므로 출처를 확인한 뒤 사용합니다.

npm.cmd view openclaw version engines로 설치 전에 공개 버전과 요구 조건을 조회할 수 있습니다. 이 명령 자체는 OpenClaw를 설치하거나 실행하지 않습니다. 실제 설치는 22편에서 진행합니다. 이름이 비슷한 패키지와 혼동하지 않도록 공식 문서가 연결하는 패키지를 확인합니다.

npm.cmd view openclaw version engines

Windows와 WSL에 각각 설치한 Node는 별도 환경입니다. 네이티브 모듈이 포함된 node_modules를 두 환경 사이에서 그대로 공유하면 문제가 생길 수 있어요. 프로젝트를 어느 쪽 터미널에서 실행할지 먼저 정합니다.

참고 자료

• Node.js 릴리스 일정
• npm 설치 안내
• OpenClaw 요구 런타임

문서·모델 태그 확인 기준: 2026년 10월 18일. 기본 실습 환경: Windows 11 x64.

---