이 페이지에서

Node.js 설치

Node.js와 npm을 설치합니다. Claude Code, Codex CLI, Pi, DeepSeek Harness 등 명령줄 도구를 쓰려면 먼저 설치해야 합니다.

Claude Code, Codex CLI, Pi, DeepSeek Harness는 npm으로 설치하며 OpenCode도 npm으로 설치할 수 있으므로, 먼저 Node.js를 설치하세요. 아래 단계는 Mac 기준이며 Windows는 따로 설명합니다. LTS 22.19 이상이 이미 있다면 이 페이지는 건너뛰세요.

1. Node.js 다운로드

Node.js 다운로드 페이지를 열고 LTS, 22.19 이상을 선택합니다.
Mac에서는 Apple 메뉴 → About This Mac을 클릭해 칩을 확인합니다: M 시리즈는 ARM64, Intel은 x64입니다. 다운로드 페이지에서 Or get a prebuilt Node.js를 찾아 macOS를 선택하고 **macOS Installer (.pkg)**를 클릭하세요. Source Code는 선택하지 마세요.

Node.js 다운로드 페이지

① macOS를 선택합니다. ② 칩에 맞게 ARM64 또는 x64를 선택합니다. ③ macOS Installer (.pkg)를 클릭합니다.

2. Node.js 설치

Finder → Downloads에서 .pkg를 더블클릭하고 Continue → Install을 클릭한 다음 Close를 클릭합니다.

Windows: 다운로드 페이지에서 Windows와 아키텍처를 선택하고 .msi를 내려받은 뒤 설치 마법사의 안내를 따르세요.

3. 설치 확인

Mac에서는 ⌘ Space를 눌러 Terminal을 검색해 엽니다(설치 전에 열어 둔 터미널이 있다면 닫았다가 다시 여세요). Windows에서는 새 PowerShell을 엽니다. 각 줄을 실행하세요:

터미널

node --version
npm --version

Node.js와 npm 모두 버전 번호가 표시되어야 합니다.

Windows PowerShell에서는 이후 튜토리얼의 npm / npx 명령을 npm.cmd / npx.cmd로 적으세요. 실행 정책은 변경할 필요가 없습니다.

그다음 설정하려는 도구의 가이드로 돌아가세요. 예: Codex CLI, Pi, DeepSeek Harness.