Node.js 설치

Claude Code는 Node.js라는 프로그램 위에서 실행됩니다. Node.js는 자바스크립트(JavaScript)라는 프로그래밍 언어를 실행하는 환경인데, 지금 이 개념을 깊이 이해할 필요는 전혀 없습니다. 여러분이 자동차를 운전할 때 엔진 구조를 몰라도 되는 것처럼요. 노무사 업무에 빗대면 이렇습니다. 엑셀에서 VBA 매크로를 돌리려면 엑셀 프로그램이 있어야 하잖아요? 마찬가지로 Claude Code를 실행하려면 Node.js가 설치되어 있어야 합니다. 또 다른 비유: 한글(HWP) 파일을 열려면 한글 프로그램이 설치되어 있어야 하듯이요. 그것뿐입니다. Node.js는 무료이고, 설치도 간단합니다. 한 번만 설치하면 됩니다. 설치하고 나면 Node.js를 직접 다룰 일은 거의 없습니다. Claude Code가 알아서 사용하니까요.

Mac에서는 두 가지 방법이 있습니다. 방법 1: 공식 웹사이트에서 다운로드 (추천) nodejs.org에 접속합니다. 화면에 LTS(장기 지원 버전)라고 표시된 초록색 버튼을 클릭하면 설치 파일(.pkg)이 다운로드됩니다. 다운로드된 파일을 더블클릭하고, '계속' 버튼을 계속 누르면 설치가 완료됩니다. 일반 프로그램 설치와 동일합니다. 방법 2: 터미널에서 Homebrew로 설치 이미 Homebrew가 설치되어 있는 분은 터미널에서 명령어 한 줄로 설치할 수 있습니다.

# 방법 2: Homebrew로 설치 (Homebrew가 이미 있는 분만)
brew install node

# Homebrew가 없는 분은 방법 1(웹사이트 다운로드)을 추천합니다.

Windows에서는 공식 웹사이트에서 다운로드하는 방법이 가장 쉽습니다. nodejs.org에 접속합니다. LTS 버전의 Windows Installer(.msi)를 다운로드합니다. 다운로드된 파일을 더블클릭합니다. 설치 마법사가 나타나면 'Next'를 계속 클릭합니다. 중간에 'Automatically install the necessary tools' 체크박스가 나오면 체크해 주세요. 'Install'을 클릭하고 완료될 때까지 기다립니다. 설치가 완료되면 반드시 터미널(PowerShell)을 껐다가 다시 열어야 합니다. 설치 전에 열었던 터미널에서는 Node.js를 인식하지 못할 수 있기 때문입니다.

Node.js가 정상적으로 설치되었는지 확인해 봅시다. 터미널을 열고(설치 후 새로 열어야 합니다) 아래 명령어를 입력합니다. node 버전과 npm 버전이 숫자로 출력되면 설치가 성공한 것입니다. 버전 숫자는 다를 수 있으며, 그것은 정상입니다. 중요한 것은 에러 메시지 없이 숫자가 출력되는 것입니다. 만약 'node: command not found'라는 에러가 나온다면, 터미널을 껐다가 다시 열어보세요. 그래도 안 된다면 Node.js 설치를 다시 시도해 보세요.

# Node.js 버전 확인
node --version
# 출력 예시: v20.11.0

# npm 버전 확인 (npm은 Node.js와 함께 설치됩니다)
npm --version
# 출력 예시: 10.2.4

# 두 명령어 모두 버전 번호가 나오면 성공입니다!