topic★★★★★난이도

설치 & 첫 실행 — 3분 안에 시작

Node.js 설치부터 첫 claude 명령어 실행까지 단계별 가이드.

#설치#Node.js#npm#첫실행

왜 배우는가

설치에서 막히면 아무것도 시작할 수 없다. 가장 간단한 경로로 빠르게 환경을 구축하고 첫 대화를 나눠보자.

Claude Code는 Node.js 18 이상이 필요하다. 아래 순서대로 따라하면 3분 안에 첫 실행이 가능하다.

터미널 — claude 명령어로 첫 세션이 시작되면 대화형 프롬프트가 열린다

bash

# 1단계: Node.js 설치 확인 (18 이상 필요)
node --version
# v20.x.x 이상이면 OK. 없으면 https://nodejs.org 에서 LTS 설치

# 2단계: Claude Code 설치
npm install -g @anthropic-ai/claude-code

# 3단계: 첫 실행
claude

npm install -g 명령은 패키지를 전역으로 설치한다. 설치 후 어느 디렉토리에서든 claude 명령을 사용할 수 있다.

처음 `claude`를 실행하면 Anthropic 계정 인증 과정이 진행된다. 브라우저가 자동으로 열리고, 로그인하면 터미널에 대화형 프롬프트가 나타난다. 프로젝트 폴더에서 실행하면 Claude Code가 해당 프로젝트의 파일 구조를 자동으로 인식한다.

환경	설치 방법	비고
Windows	Node.js 공식 설치 → npm install -g	PowerShell 또는 Git Bash 사용
macOS	`brew install node` → npm install -g	Homebrew 권장
Linux	`nvm install 20` → npm install -g	nvm으로 버전 관리 권장

팁: 프로젝트 폴더에서 실행하자 — Claude Code는 실행한 디렉토리를 '프로젝트 루트'로 인식한다. 항상 작업할 프로젝트 폴더로 이동한 후 `claude`를 입력하자. 그래야 프로젝트 파일을 올바르게 읽고 수정할 수 있다.