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)로 경로를 확인하세요.