윈도우 PC에 Claude Code (CLI) 완벽 설치 가이드

Claude Code로 개발을 시작하려고 한다면 무엇부터 해야 할까요?

몇 가지 프로그램을 먼저 설치해야 Claude Code를 제대로 사용할 수 있습니다.

처음에는 "Node.js가 뭔데?", "Git은 꼭 필요한가?", "VS Code는 왜 설치해야 하지?" 같은 궁금증이 생길 수 있습니다.

이런 궁금증을 하나씩 알아가면서 세팅해나가면 좋겠지만 바이브코딩을 시작하고 알아도 늦지 않습니다.

개발하려면 꼭 설치해야 하는 것

많은 사람들이 Git부터 설치해야 하는 줄 아는데 사실 가장 중요한 건 Node.js입니다.

Claude Code는 Node.js 기반으로 동작하기 때문에 Node.js가 없으면 설치 자체가 되지 않습니다.

필수 설치 목록은 다음과 같습니다.

• Chrome
• Node.js
• VS Code
• Claude Code

Git은 없어도 개발은 가능합니다.

다만 프로젝트 백업이나 버전 관리를 위해 나중에 설치하는 것을 추천합니다.

---

1. 윈도우 업데이트 먼저 진행하기

새 컴퓨터를 구매했다면 가장 먼저 윈도우 업데이트를 진행합니다.

설정 → Windows 업데이트 → 업데이트 확인

업데이트를 모두 설치한 뒤 재부팅합니다.

이 과정을 먼저 해야 이후 프로그램 설치 시 오류가 발생할 가능성이 줄어듭니다.

---

2. Chrome 설치하기

개발 관련 문서는 대부분 Chrome 기준으로 설명됩니다.

또한 웹 개발을 하게 되면 개발자 도구(F12)를 자주 사용하게 됩니다.

Chrome을 설치하고 로그인까지 완료합니다.

---

3. Node.js 설치하기

이제 가장 중요한 Node.js를 설치합니다.

Node.js 다운로드

Node.js 공식 홈페이지에 접속합니다.

https://nodejs.org/ko/download

• LTS (권장 버전)
• Current (최신 버전)

처음 설치하는 경우에는 LTS 버전을 선택하여 다운로드 하는 것을 추천합니다.

 

설치 확인하기

Node.js는 자바스크립트를 실행할 수 있게 해주는 프로그램입니다.

Claude Code도 Node.js가 있어야 실행할 수 있습니다.

설치가 완료되면 명령 프롬프트(CMD)를 열고 아래 명령어를 입력합니다.

node -v

버전이 표시되면 정상 설치된 것입니다.

다음으로 npm도 확인합니다.

npm -v

버전이 표시되면 준비 완료입니다.

확인되지 않는다면 정상적으로 설치되지 않은 것입니다.

---

4. VS Code 설치하기

코드를 작성할 에디터를 설치합니다.

현재 가장 많이 사용하는 에디터는 VS Code입니다.

https://code.visualstudio.com/

Visual Studio Code - The open source AI code editor | Your home for multi-agent development

다운로드 후 설치하면 됩니다.

---

5. VS Code터미널 열기

Claude Code는 터미널 환경에서 사용합니다.

VS Code를 실행한 후

터미널 → 새 터미널

을 선택합니다.

화면 아래쪽에 검은색 터미널 창이 나타나면 정상입니다.

---

6. Claude Code 설치하기

 

터미널에서 아래 명령어를 실행합니다.

npm install -g @anthropic-ai/claude-code

설치가 완료되면 버전을 확인합니다.

claude --version

버전이 출력되면 정상 설치입니다.

---

7. Claude 로그인하기 & 실행하기

터미널에서 다음 명령어를 입력합니다.

claude

브라우저가 열리면서 로그인을 진행하게 됩니다.

로그인이 완료되면 Claude Code를 사용할 수 있습니다.

---

8. Claude Code 실행하기

프로젝트 폴더에서 실행합니다.

claude

이제 Claude와 대화하면서 개발할 수 있습니다.

토큰을 다써서 코딩을 하지 않네요..

 

예를 들어

React 로그인 페이지 만들어줘

또는

Next.js 블로그 프로젝트 생성해줘

같은 요청을 할 수 있습니다.

Claude가 파일을 생성하거나 수정하면서 개발을 도와줍니다.

 

---

Git은 꼭 설치해야 할까?

많은 초보자들이 궁금해하는 부분입니다.

결론은 설치하지 않아도 됩니다.

Node.js만 있으면 Claude Code 설치와 실행은 가능합니다.

다만 프로젝트가 커지면 Git이 있으면 훨씬 편합니다.

예를 들어 Claude가 실수로 코드를 망가뜨렸을 때 Git이 있으면 이전 상태로 쉽게 되돌릴 수 있습니다.

그래서 처음에는 Node.js만 설치하고 시작해도 괜찮지만, 개발을 계속할 생각이라면 Git도 함께 설치하는 것을 추천합니다.

---

마무리

정리하면 다음 순서대로 진행하면 됩니다.

1. 윈도우 업데이트
2. Chrome 설치
3. Node.js 설치
4. VS Code 설치
5. VS Code 터미널 열기
6. Claude Code 설치
7. 로그인
8. 개발 시작

이 정도만 완료하면 새 컴퓨터에서도 바로 AI와 함께 개발을 시작할 수 있습니다.