실습 환경 준비 (VSCode, Node.js, Git)

이 장에서는 클로드 코드를 설치하기 전에 필요한 기반 도구를 설치합니다. 실습에서 가장 큰 허들이니 차근차근 따라오시길 바랍니다.

클로드 코드 자체를 설치하기 전에 VSCode, Node.js가 필요하고, Windows라면 Git을 가장 먼저 설치해야 합니다.

환경 설정이 어려우신 분은 11장의 "클로드 코드 웹 버전"을 참고하세요. 설치 없이 브라우저에서 간단한 작업을 체험할 수 있습니다. 다만 기능이 제한적이므로, 가능하면 이 장을 따라 터미널 버전을 설치하시길 권장합니다.

1. 설치 순서

설치 순서는 OS에 따라 조금 다릅니다.

Windows: Git → VSCode → Node.js → Claude Code 순서. 윈도우에서는 클로드 코드가 내부적으로 Git을 사용하기 때문에, Git이 없으면 설치 직후 에러가 발생합니다. 처음부터 Git을 깔고 시작하면 이 에러를 피할 수 있습니다.

Mac: VSCode → Node.js → Claude Code 순서. Mac에는 Git이 기본 내장되어 있어 따로 설치하지 않아도 됩니다.

2. Windows 사용자: Git 먼저 설치

Mac 사용자는 이 3장을 건너뛰고 4장(VSCode)부터 진행하세요.

Windows에서 Git이 없으면 클로드 코드 실행 시 Git을 설치하라는 에러를 만나게 됩니다. 처음부터 설치해두는 편이 가장 깔끔합니다.

Git 미설치 에러

2.1 설치 방법

https://git-scm.com/ 에서 Git 설치 파일을 받습니다.
받은 파일을 더블클릭하여 설치합니다. 옵션을 묻는 화면이 여러 번 나오는데 기본 설정 그대로 두고 "다음" 버튼만 눌러서 설치하면 됩니다.
설치가 끝나면 다음 단계인 VSCode로 넘어갑니다.

3. Visual Studio Code

마이크로소프트에서 만든 코드 편집기로, 가장 인기 있는 도구 중 하나입니다. 클로드 코드는 터미널에서도 쓸 수 있지만, VSCode 안의 터미널에서 실행하면 코드 변경 사항을 바로 눈으로 확인하면서 작업할 수 있어 편리합니다. 또한 VSCode용 클로드 코드 확장(extension)을 설치하면 더 편하게 사용할 수 있습니다(11장 참고).

3.1 설치 방법

https://code.visualstudio.com/ 에 접속합니다.
가운데 버튼을 누르면 OS에 맞는 설치 파일이 자동으로 다운로드됩니다.
다운로드한 파일을 실행해 동의합니다, 다음을 눌러가며 설치합니다. 설치가 익숙하지 않다면 "바탕화면에 바로가기 추가" 옵션을 켜두는 것을 권합니다.

4. Node.js

Node.js는 컴퓨터에서 JavaScript 코드를 실행할 수 있게 해주는 프로그램입니다. 클로드 코드는 Node.js 위에서 동작하기 때문에 반드시 설치해야 합니다.

자주 묻는 질문

Q: 저는 JavaScript로 코딩할 게 아닌데 왜 Node.js가 필요한가요?
A: 여러분이 JavaScript를 쓰는 게 아니라, 여러분이 사용할 도구(클로드 코드)가
   Node.js 위에서 동작하기 때문입니다. 클로드 코드를 실행하기 위한 환경이라고
   생각하시면 됩니다.

4.1 설치 방법

https://nodejs.org/ko/download 로 이동합니다. OS에 맞는 버전을 추천해주니 그대로 받으면 됩니다.
다운로드한 파일을 더블클릭해 동의합니다, 다음을 누르며 설치합니다.
제대로 설치되었는지 확인합니다. 터미널을 열어 확인합니다.

터미널은 '컴퓨터와 글자로 대화하는 창'입니다. 마우스로 아이콘을 클릭하는 대신, 키보드로 글자를 입력해서 컴퓨터에 명령을 내리는 방법입니다.
- Windows
  
  Windows에서는 PowerShell과 명령 프롬프트의 실행 권한이 다릅니다. 우선 명령 프롬프트(cmd) 를 사용해주세요.
  1. 시작 버튼 → cmd 검색 → 명령 프롬프트 실행
  2. 검은 화면에 node --version 을 입력하고 엔터를 누릅니다. 숫자가 나오면 설치된 것입니다(버전이 책과 달라도 괜찮습니다). 숫자가 안 나오면 터미널을 닫았다 다시 열어보세요.
  3. 터미널을 끄지 말고 다음 장으로 넘어가세요.
- Mac
  1. 런치패드에서 "터미널"을 검색해 실행합니다.
  2. node --version 을 입력하고 엔터를 누릅니다. 숫자가 나오면 설치된 것입니다.
  3. 터미널을 끄지 말고 다음 장으로 넘어가세요.

다음 장에서 드디어 클로드 코드를 설치합니다.