Node.js 윈도우 설치 방법, 처음 쓰는 사람을 위한 안내

먼저 설치할 프로그램은 없습니다. 이 글부터 바로 시작하면 됩니다.

Node.js는 내 컴퓨터에서 자바스크립트 프로그램을 실행해 주는 엔진입니다. 자바스크립트는 원래 웹 브라우저 안에서만 돌던 언어인데, Node.js를 설치하면 브라우저 밖에서도 그 프로그램을 실행할 수 있습니다.

자동차에 비유하면 이해하기 쉽습니다. 이 수업에서 영상을 만드는 Hyperframes가 자동차라면, Node.js는 그 자동차를 움직이는 엔진입니다. 운전자가 엔진 구조를 몰라도 차를 몰 수 있듯이, 여러분이 자바스크립트를 몰라도 괜찮습니다. 다만 엔진은 꼭 달려 있어야 합니다.

이 수업에서 하는 일

「영상 제작을 위한 AI 활용」 수업은 녹음을 Whisper로 받아 적고, Hyperframes로 장면을 영상으로 만들고, Concat으로 편집하고, kie.ai로 필요한 장면을 생성하는 흐름으로 진행합니다.

Node.js는 이 중 Hyperframes를 실행할 때 필요합니다. Hyperframes는 npx라는 명령으로 실행하는데, npx는 Node.js를 설치할 때 함께 들어옵니다. 수업에서 코드를 직접 쓰지는 않지만, Node.js가 없으면 Hyperframes가 아예 시작되지 않습니다. 수업에서는 Node.js 22 이상을 기준으로 합니다.

윈도우에 설치하기

설치 방법은 두 가지입니다. 하나만 고르면 됩니다.

방법 1. 공식 홈페이지에서 설치 파일 받기

1) https://nodejs.org 에 접속합니다. 2) 다운로드 화면에서 LTS라고 표시된 버전의 Windows 설치 파일(.msi)을 받습니다. 3) 받은 파일을 실행하고, 안내에 따라 다음(Next)을 누릅니다. 설정은 기본값 그대로 두면 됩니다. 4) 중간에 추가 도구를 자동으로 설치할지 묻는 체크 칸이 나오면, 이 수업에서는 체크하지 않고 넘어가도 됩니다. 5) 설치가 끝나면 마침(Finish)을 누릅니다.

LTS는 오랫동안 안정적으로 지원하는 버전이라는 뜻입니다. 2026년 11월 2일 기준 공식 홈페이지의 최신 LTS는 v26입니다. 수업 기준인 22 이상을 만족합니다.

방법 2. winget 명령으로 설치하기

winget은 윈도우에 들어 있는 프로그램 설치 도우미입니다. 시작 버튼을 누르고 PowerShell을 입력해 Windows PowerShell을 연 다음, 아래 명령을 붙여 넣고 Enter를 누릅니다.

winget install OpenJS.NodeJS.LTS

이 명령은 Node.js의 LTS 버전을 찾아 내려받고 설치합니다. 처음 쓰면 이용 약관에 동의할지 묻는데, Y를 입력하고 Enter를 누르면 됩니다.

설치가 끝나면 지금 열려 있는 PowerShell 창을 닫고 새 창을 여세요. 이미 열려 있던 창은 설치 전 상태를 기억하고 있어서 node 명령을 찾지 못합니다. 이 글의 나머지 명령은 모두 새로 연 창에서 입력합니다.

설치 확인 1. node 버전 보기

새 PowerShell 창에서 아래 명령을 입력합니다.

node -v

설치된 Node.js 버전을 보여 줍니다. 아래와 같은 모양으로 v로 시작하는 숫자가 나오면 정상입니다. 숫자는 설치한 시점에 따라 다르며, v22 이상이면 됩니다.

v26.13.0

스크립트 실행 허용하기(윈도우에서 꼭 필요한 단계)

node -v는 잘 되는데, 이어서 npm -v를 입력하면 대부분의 윈도우 PC에서 아래와 같은 빨간 오류가 나옵니다.

npm : 이 시스템에서 스크립트를 실행할 수 없으므로 C:\Program Files\nodejs\npm.ps1 파일을 로드할 수 없습니다.
자세한 내용은 about_Execution_Policies(https://go.microsoft.com/fwlink/?LinkID=135170)를 참조하십시오.

설치가 잘못된 것이 아닙니다. node는 실행 파일(node.exe)이라 바로 실행되지만, PowerShell에서 npm과 npx를 입력하면 스크립트 파일(npm.ps1, npx.ps1)이 실행됩니다. 윈도우는 기본 설정에서 PowerShell 스크립트 실행을 막아 두기 때문에 여기서 멈춥니다. 이 설정을 실행 정책이라고 부릅니다.

해결은 명령 한 줄입니다. PowerShell에 아래 명령을 입력합니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

실행 정책을 바꿀지 묻는 안내가 나오면 Y를 입력하고 Enter를 누릅니다. 아무 문구 없이 다음 줄로 넘어가도 정상입니다.

이 설정이 무엇을 바꾸는지도 알아 두세요. RemoteSigned는 내 컴퓨터에 있는 스크립트는 실행하고, 인터넷에서 받은 스크립트는 만든 사람의 서명이 있는 것만 실행하는 설정입니다. 보안을 모두 끄는 설정이 아닙니다. -Scope CurrentUser는 내 계정에만 적용한다는 뜻이라 관리자 권한이 필요 없고, 같은 PC의 다른 사용자에게는 영향을 주지 않습니다.

바뀌었는지 확인합니다.

Get-ExecutionPolicy

RemoteSigned가 나오면 됩니다. 다른 값이 나오거나 명령이 오류로 끝나면 회사 정책으로 막혀 있는 경우입니다. 아래 자주 막히는 곳의 방법을 쓰세요.

설치 확인 2. npm과 npx 버전 보기

이제 아래 두 명령을 한 줄씩 입력합니다.

npm -v
npx --version

Node.js와 함께 설치된 npm과 npx의 버전을 보여 줍니다. 둘 다 아래처럼 숫자 세 개가 점으로 이어져 나오면 정상입니다. 숫자는 예시이므로 실제와 달라도 괜찮습니다.

11.0.0
11.0.0

여기까지 되면 수업 준비는 끝났습니다. npx는 수업에서 Hyperframes를 실행할 때 씁니다.

처음 써 보기

Node.js가 실제로 프로그램을 실행하는지 한 줄짜리 예제로 확인해 봅니다.

node -e "console.log('안녕하세요')"

이 명령은 Node.js에게 따옴표 안의 자바스크립트 한 줄을 실행하라고 시킵니다. 화면에 안녕하세요가 찍히면 엔진이 제대로 돌고 있는 것입니다.

안녕하세요

앞에서 npx --version까지 확인했다면 수업에서 npx hyperframes로 시작하는 명령을 그대로 따라 할 수 있습니다.

자주 막히는 곳

1) node 명령을 찾지 못한다는 오류

node : 'node' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는 프로그램 이름으로 인식되지 않습니다.

설치 전에 열어 둔 PowerShell 창에서 명령을 입력하면 이런 문구가 나옵니다. 창을 모두 닫고 새로 열어 다시 입력하세요. 그래도 같다면 설치가 중간에 실패했을 수 있으니 설치를 한 번 더 진행합니다.

2) 스크립트 실행 허용 명령이 듣지 않는 경우

회사 PC는 관리자가 그룹 정책으로 실행 정책을 정해 두는 경우가 있습니다. 이때는 Set-ExecutionPolicy가 오류로 끝나거나, 실행해도 npm -v에서 같은 오류가 계속 납니다. 아래 명령으로 어디서 정해졌는지 볼 수 있습니다.

Get-ExecutionPolicy -List

MachinePolicy나 UserPolicy 줄에 Undefined가 아닌 값이 있으면 회사 정책이 우선 적용되는 상태입니다. 개인이 바꿀 수 없으니 아래 방법 중 하나로 진행합니다.

방법 1. 명령 뒤에 .cmd 붙이기. npm 대신 npm.cmd, npx 대신 npx.cmd라고 입력하면 스크립트 파일을 거치지 않아 정책과 상관없이 실행됩니다.

npm.cmd -v
npx.cmd --version

방법 2. PowerShell 대신 명령 프롬프트 쓰기. 시작 버튼에서 cmd를 검색해 명령 프롬프트를 열면 이 문제가 처음부터 생기지 않습니다. 이 시리즈의 npm, npx 명령은 명령 프롬프트에서도 그대로 동작합니다.

방법 3. 지금 창에서만 잠시 허용하기. 아래 명령은 지금 열린 PowerShell 창에서만 스크립트 실행을 허용하고, 창을 닫으면 원래대로 돌아갑니다. 회사 정책에 따라 이것도 막혀 있을 수 있습니다.

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

어느 방법도 안 되면 사내 IT 담당자에게 PowerShell 실행 정책 때문에 npm을 쓸 수 없다고 알려 주세요.

3) 버전이 22보다 낮게 나오는 경우

예전에 설치한 Node.js가 남아 있는 경우입니다. 위의 설치 방법으로 LTS를 다시 설치한 뒤 새 창에서 node -v를 확인합니다.

4) 회사 PC에서 설치가 안 되는 경우

설치 파일 실행 시 관리자 권한을 요구하거나, 사내망에서 내려받기가 막히는 경우가 있습니다. 회사 PC라면 수업 전에 설치 권한과 nodejs.org 접속 가능 여부를 교육 담당자에게 확인해 주세요. npx가 패키지를 내려받다가 멈추는 것도 사내 프록시 때문인 경우가 많습니다.

용어 풀이

자바스크립트: 웹 페이지를 움직이게 하려고 만든 프로그래밍 언어입니다. 지금은 웹 밖에서도 널리 씁니다. 런타임: 프로그램을 실제로 실행해 주는 환경입니다. Node.js가 자바스크립트의 런타임입니다. npm: Node.js용 프로그램을 내려받고 관리하는 도구입니다. Node.js와 함께 설치됩니다. npx: 프로그램을 따로 설치하지 않고 바로 내려받아 실행하는 명령입니다. 수업에서 Hyperframes를 실행할 때 씁니다. LTS: Long Term Support의 줄임말로, 오래 지원하는 안정 버전을 뜻합니다. 처음 설치한다면 LTS를 고르면 됩니다. PowerShell: 윈도우에서 글자로 명령을 입력하는 창입니다. 이 시리즈의 모든 명령은 여기에 입력합니다. 실행 정책: PowerShell이 스크립트 파일(.ps1)을 실행해도 되는지 정해 둔 보안 설정입니다. 윈도우 PC는 기본적으로 막혀 있어서 npm을 쓰려면 한 번 허용해야 합니다.

맥에서는

맥은 https://nodejs.org 에서 LTS 버전의 macOS 설치 파일(.pkg)을 받아 실행하면 됩니다. 설치 후에는 터미널 앱을 새로 열고 윈도우와 똑같이 node -v, npm -v로 확인합니다. PowerShell 실행 정책 문제는 맥에서는 생기지 않습니다.

다음 글

다음 글에서는 Hyperframes가 장면을 MP4로 만들 때, Whisper가 음성을 읽을 때 뒤에서 일하는 FFmpeg를 설치합니다. FFmpeg 윈도우 설치 방법과 처음 쓰는 명령 3가지

시리즈 전체 목록: https://www.letscoding.kr/blog/category/tools

공식 문서: https://nodejs.org/en/download https://nodejs.org/en/about/previous-releases https://learn.microsoft.com/ko-kr/powershell/module/microsoft.powershell.core/about/about_execution_policies 확인일: 2026-11-02