Skip to main content
Node.js는 Claude Code와 JavaScript 기반 도구 실행에 필요합니다.

사전 준비

  • Ubuntu 24.04
  • sudo 권한

설치 과정

1

필수 패키지 설치

sudo apt update
sudo apt install -y curl ca-certificates gnupg
2

NodeSource 저장소 등록

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
3

Node.js 설치

sudo apt install -y nodejs

설치 확인하기

node --version
npm --version

문제 해결

  • npm 미인식: 터미널을 재시작한 뒤 다시 확인합니다.
  • 네이티브 빌드 오류: 아래 명령어로 빌드 도구를 추가 설치합니다.
sudo apt install -y build-essential

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: uv + Python

다음 설치 단계를 이어서 진행합니다.