목적별 가이드

하려는 일 가이드
Node.js를 처음 준비하기 이 글의 설치·실행 확인
기존 버전의 보안·업데이트 확인 Node.js 취약점·업데이트
준비한 환경에서 AI CLI 시작하기 제미나이 CLI
Qwen의 코딩 도구 사용하기 Qwen Code
패키지·잠금 파일과 workspace 선택 확인 pnpm 가이드
Bun의 Bun 실행 파일과 셸 경로를 확인해 작은 코드를 시작하기 Bun 가이드
Deno의 짧은 코드를 실행하며 Deno 권한 범위를 확인하기 Deno 가이드

Node.js·npm·npx 구분

이름 하는 일
Node.js JavaScript 파일과 명령을 실행하는 런타임
npm 프로젝트에 필요한 패키지를 설치·관리하는 도구
npx·npm exec 패키지가 제공하는 명령을 실행하는 경로
VS Code 코드 파일을 읽고 편집하는 프로그램

공식 Node 설치 프로그램은 Node와 npm을 함께 준비하는 경로입니다. npm을 별도로 업데이트하는 일과 Node 실행 파일을 바꾸는 일은 구분하세요. npx도 명령에 따라 패키지를 내려받고 실행할 수 있으므로, 모르는 명령을 그대로 붙여 넣지 않습니다.

LTS와 설치할 버전 선택

Node.js 공식 다운로드에서 현재 LTS 표시를 확인합니다. Node 26은 2026년 10월 28일 LTS로 전환했습니다.

먼저 다음 두 조건을 맞추세요.

  1. 사용하려는 CLI·프로젝트가 요구하는 Node 버전
  2. Node 공식 지원 기간과 현재 수정 릴리스

최소 요구 조건이 Node 20 이상이라고 해도 Node 20을 새로 설치하라는 뜻은 아닙니다. 최소 버전 조건과 보안 지원 기간은 별개입니다. 지원 중인 다른 LTS를 쓰는 프로젝트라면 무조건 최신 주 버전으로 바꾸기보다 해당 프로젝트의 안내를 따릅니다.

기존 프로젝트의 버전 고정 파일이나 설치 문서가 있다면 먼저 읽으세요. 처음 준비하는 환경과 이미 여러 프로젝트를 운영하는 환경의 선택이 같을 필요는 없습니다.

Windows 공식 파일 고르기

Windows의 설정 → 시스템 → 정보 → 시스템 종류에서 CPU와 운영체제를 확인합니다.

확인한 환경 공식 다운로드에서 볼 항목
일반 Intel·AMD 64비트 PC Windows x64
ARM 기반 Windows PC Windows ARM64
macOS·Linux 해당 운영체제와 CPU에 맞는 별도 항목

Node 26의 공식 지원 표는 Windows x64·ARM64에서 Windows 10 이상을 안내합니다. 다른 주 버전의 지원 조건을 그대로 옮기지 마세요. 이 글의 설치 순서는 Windows 기준입니다.

처음 설치한다면 공식 페이지의 Installer·설치 프로그램(.msi) 경로를 확인하고 안내에 따라 진행합니다. 압축된 독립 바이너리는 파일을 푸는 것만으로 모든 터미널의 실행 경로가 설정되는 방식은 아닙니다.

여러 Node 버전을 오가야 한다면 버전 관리자도 선택지입니다. npm 공식 문서는 버전 관리자를 권장하고, 사용할 수 없다면 공식 설치 프로그램을 안내합니다. 기존 버전 관리자와 새 설치 프로그램을 겹쳐 사용하기 전에는 현재 경로부터 확인하세요.

새 터미널에서 버전과 경로 확인

설치를 마쳤다면 열려 있던 PowerShell을 닫고 새 창에서 확인합니다.

node -v
npm -v
node -p "process.execPath"

첫 두 줄은 각각 Node와 npm의 버전을, 마지막 줄은 실제 실행한 Node 파일의 경로를 표시합니다. Node와 npm의 버전 번호가 같을 필요는 없습니다.

같은 이름의 명령이 여러 곳에 있는지 확인하려면 다음을 씁니다.

Get-Command node -All | Select-Object Source
where.exe node

설치 화면에서 본 버전과 실행 결과가 다르면 다른 폴더의 Node가 먼저 선택됐을 수 있습니다. 편집기의 내장 터미널도 다시 열어 확인하세요.

짧은 JavaScript 실행하기

새 연습 폴더에 다음 내용을 hello-node.js로 저장합니다.

const task = { name: "첫 실행", count: 2 };
console.log(task.name + ": " + (task.count + 1));

파일이 있는 폴더에서 실행합니다.

node .\hello-node.js

출력이 첫 실행: 3이면 이 파일의 JavaScript가 실행된 것입니다. npm 패키지 설치나 AI 계정 인증까지 끝났다는 의미는 아닙니다. 다음에는 사용할 도구의 공식 설치 절차로 넘어가세요.

명령이 인식되지 않을 때

증상 먼저 확인할 부분
node를 찾을 수 없음 설치 완료 여부·새 터미널·실행 경로
다른 Node 버전이 표시됨 중복 설치·버전 관리자·우선 경로
node는 되지만 npm에서 스크립트 정책 오류 npm.cmd 실행 가능 여부와 오류 문구
CLI가 지원 버전 오류를 표시함 해당 CLI의 현재 최소 버전·프로젝트 지정 버전

PowerShell에서 npm.ps1 실행 정책 오류가 난다면 npm.cmd -v로 실행 파일 경로의 npm도 확인할 수 있습니다. 원인 확인 없이 PC 전체의 실행 정책을 바꾸기보다, 오류에 등장한 파일과 실제 명령 경로부터 확인하세요.

이미 설치한 Node를 교체해야 한다면 업데이트 글에서 설치 방식과 지원 버전을 먼저 구분합니다.

참고자료

공식 자료 확인일은 2026년 11월 1일입니다. 자체 JavaScript와 명령 예제는 별도 로컬 환경에서 확인했으며, Windows 설치 마법사·시스템 PATH 변경을 실행한 검수는 아닙니다.