본문 바로가기

AI Insights & Innovations

최신 인공지능 기술과 트렌드를 탐색하는 전문 블로그

AI/AI AGENT

Ubuntu에서 Node.js® v24.3.0 및 Claude Code 설치 메뉴얼

by dma-ai 2025. 6. 30.
728x90
 

Ubuntu에서 Node.js® v24.3.0 및 Claude Code 설치 메뉴얼

Ubuntu 환경에서 **Node.js 최신 버전(v24.3.0)**과 Claude Code를 설치하는 과정을 단계별로 안내합니다.
nvm(Node Version Manager)을 사용해 Node.js를 설치하고, npm으로 Claude Code를 설치하는 가장 안전하고 권장되는 방법을 소개합니다.

1. Node.js®란?

**Node.js®**는 서버와 데스크탑 환경 모두에서 JavaScript를 실행할 수 있는 런타임입니다.
최신 버전(v24.3.0)은 공식 웹사이트 또는 nvm을 통해 설치할 수 있습니다.

2. Node.js® 설치 방법

2-1. nvm(Node Version Manager) 설치

nvm은 여러 Node.js 버전을 쉽게 설치·관리할 수 있는 도구입니다.

  • 설치가 끝나면, 터미널을 재시작하거나 아래 명령어를 실행하세요.
 
bash
source ~/.bashrc

2-2. Node.js 최신 버전(v24.3.0) 설치

 
bash
nvm install 24
  • 위 명령어는 Node.js 24.x 최신 버전을 설치합니다.

2-3. 설치 확인

 
bash
node -v # "v24.3.0"이 출력되어야 합니다. nvm current # "v24.3.0"이 출력되어야 합니다. npm -v # 11.4.2(이상)가 출력되어야 합니다.

"nvm"은 플랫폼 간 Node.js 버전 관리자입니다. 문제가 발생하면 nvm 공식 웹사이트를 참고하세요123.

3. Node.js® 공식 바이너리 직접 다운로드 (선택 사항)

  • x64 아키텍처용 미리 빌드된 Node.js® 바이너리는 [Node.js 공식 다운로드 페이지]에서 받을 수 있습니다.
  • Standalone Binary(.xz), 소스 빌드, 서명된 SHASUMS 검증 등 고급 옵션도 제공됩니다2.

4. Claude Code 설치 및 실행

4-1. 시스템 요구사항

  • Ubuntu 20.04 이상
  • Node.js 18 이상
  • 4GB RAM 이상
  • 인터넷 연결

4-2. Claude Code 글로벌 설치

sudo를 사용하지 않고 아래 명령어로 설치하세요.

 
bash
npm install -g @anthropic-ai/claude-code
  • sudo를 사용하면 권한 문제나 보안 위험이 발생할 수 있으니 주의하세요456.

4-3. 프로젝트 디렉토리로 이동

 
bash
cd your-project-directory
  • 실제 작업할 프로젝트 폴더로 이동하세요.

4-4. Claude Code 실행 및 인증

 
bash
claude
  • 첫 실행 시 인증 안내가 나옵니다.
  • Anthropic Console(결제 계정 필요) 또는 Claude App(Pro/Max 플랜)으로 OAuth 인증을 완료하세요456.

5. 문제 해결 및 참고사항

  • Node.js가 인식되지 않을 때:
    which node와 which npm으로 경로를 확인하세요. nvm 설치가 제대로 적용되지 않았다면 터미널을 재시작하거나 source ~/.bashrc를 실행하세요.
  • npm 권한 오류:
    nvm 환경에서는 sudo 없이 글로벌 패키지 설치가 가능합니다.
  • 공식 문서:
    추가적인 문제 해결은 Claude Code 및 Node.js 공식 문서를 참고하세요.

6. 기타 설치 방법

  • Node.js 공식 바이너리 직접 다운로드, 소스 빌드, 서명된 SHASUMS 검증, nightly 빌드 등 고급 설치 방법도 제공합니다2.
  • 여러 Node.js 버전이 필요하다면 nvm이 가장 편리합니다3.
 
  1. https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh
  2. https://nodejs.org/en/download/current
  3. https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-22-04
  4. https://docs.anthropic.com/en/docs/claude-code/setup
  5. https://www.claudecode.io/installation
  6. https://claudelog.com/installation/
  7. https://stackoverflow.com/questions/72979232/doesnt-install-npm-when-i-install-a-new-node-version-using-nvm
  8. https://hostman.com/tutorials/how-to-install-node-js-and-npm-on-ubuntu-24-04/
  9. https://www.youtube.com/watch?v=GfpzxQMfEJA
  10. https://www.liquidweb.com/blog/how-to-install-node-js-via-nvm-on-ubuntu-18-04/
  11. https://devchaeyoung.tistory.com/entry/ubuntu-22044-%EC%97%90%EC%84%9C-node-npm-%EB%B2%84%EC%A0%84-20-10%EB%B2%84%EC%A0%84%EC%9C%BC%EB%A1%9C-%EC%97%85%EA%B7%B8%EB%A0%88%EC%9D%B4%EB%93%9C%ED%95%98%EA%B8%B0
  12. https://underconstructionpage.com/how-to-install-claude-code-on-ubuntu-linux-a-developers-guide/
  13. https://claude.ai/public/artifacts/1bc2e924-6d3c-47b4-b9c8-f22ece6b2168
  14. https://www.cherryservers.com/blog/install-npm-ubuntu
  15. https://github.com/nvm-sh/nvm/issues/2990
  16. https://www.youtube.com/watch?v=YCz46I5mnuw
  17. https://itecsonline.com/post/how-to-install-claude-code-on-ubuntu-linux-complete-guide-2025
  18. https://docs.anthropic.com/en/docs/claude-code/overview
  19. https://phpfashion.com/en/how-to-install-claude-code-beginners-guide
  20. https://www.pythonblogs.com/how-to-install-claude-code-on-ubuntu-linux-a-developers-guide/
  21. https://www.datacamp.com/tutorial/claude-opus-4-claude-code
728x90