ai2saveai2save

Node.js 환경 설치 가이드

Claude Code, Codex CLI, Gemini CLI 및 대부분의 API 스크립트는 Node.js에 의존합니다. LTS 버전을 설치하는 것이 좋으며, 메이저 버전은 18 이상을 유지하십시오.

Windows

방법 1: 공식 설치 패키지

nodejs.org에 접속하여 LTS .msi 설치 패키지를 다운로드한 후, "다음"을 클릭하며 설치를 진행하고 PATH에 자동으로 추가하는 옵션을 유지하십시오.

방법 2: Chocolatey

choco install nodejs-lts -y

방법 3: 스쿱

scoop install nodejs-lts

PowerShell를 다시 연 후 검증:

node --version
npm --version

macOS

방법 1: Homebrew(추천)

brew install node
node --version
npm --version

방법 2: 공식 설치 패키지

Nodejs.org에 접속하여 macOS .pkg를 다운로드하고, 설치 후 터미널을 다시 엽니다.

리눅스

방법 1: nvm(권장, sudo 필요 없음, 다중 버전 지원)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc  # zsh 사용자는 source ~/.zshrc
nvm install --lts
nvm use --lts
node --version
npm --version

방법 2: 패키지 관리자

# Debian / Ubuntu
sudo apt update
sudo apt install -y nodejs npm

# Fedora
sudo dnf install -y nodejs npm

CLI를 설치하는 일반적인 방법

npm install -g <package-name>

권한 오류가 발생하면, 우선 nvm 또는 현재 Node 버전이 올바르게 적용되었는지 확인하세요. 시스템 디렉토리를 관리자 권한으로 직접 덮어쓰는 것은 권장하지 않습니다. 설치 후 where node(Windows) 또는 which node(macOS/Linux)로 경로를 확인하세요.