[클로드 코드 완독 챌린지] - 1주차 : 클로드 코드 설치하기

클로드 코드(Claude Code)란

클로드 코드는 엔트로픽에서 만든 에이전트형 인공지능 도구로, 사용자의 터미널 환경에서 직접 작동한다는 특징이 있습니다. 사용자 터미널에 접근할 수 있다는 것은 각종 인증 정보를 얻을 수 있다는 것이며, 이러한 특징 외에도 사용자 고유의 개발 환경과 도구를 함께 이용할 수 있다.

따라서 웹에서 이용할 수 있는 ChatGPT 와는 다르게 물어보고 대답하는 과정을 연결하여 코드 편집, 오류 수정, 명령 실행, 커밋 생성, 테스트 실행 등의 전체 개발 워크플로를 완전히 자동화 할 수 있다.

---

클로드 코드 요금제

클로드 코드는 유료 서비스이기 때문에 요금제를 선택해서 구매해야 한다.

1. 클로드 구독 플랜 요금제
2. API 사용량 기반 요금제

API 사용량 기반 요금제는 폭넓은 모델을 자유롭게 쓸 수 있고, 쓰는 만큼 낸다는 장점이 있으나 총 금액을 예측하기 어렵고 초반에는 절약하며 쓰는 법을 알기 어렵기 때문에 구독 플랜 요금제를 선택하겠다.

구독 플랜 요금제로는 Pro 와 Max 가 있는데 Pro로 충분하기 때문에 Pro 로 구독할 것이다.

백만 토큰(MTok)

토큰은 인공지능에 사용자가 입력한 내용과 출력된 내용을 이해하고 만드는 기본 단위이다. 따라서 토큰 사용량은 매우 중요하며, 비용 및 효율과 관련하여 이 책의 전체를 관통하는 주제이기도 하다.

---

윈도우에 클로드 코드 설치

윈도우에 직접 클로드 코드를 설치해서 진행할 수도 있지만, 디렉터리 구조도 다르고 하기 때문에 WSL2(Window Subsystem for Linux) 를 구성하겠다.

1. WSL2 를 구성하기 위해, 윈도우 파워셸을 관리자 권한으로 실행
2. WSL2 설정을 위해 Linux용 Windows 하위 시스템과 Virtual Machine Platform 기능을 활성화
   • dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   • dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
3. 해당 작업 완료 후 → 제어판 → 프로그램 → 프로그램 및 기능 → Windows 기능 켜기/끄기 → Linux 용 Windows 하위 시스템 과 Virtual Machine Platfom 활성화 확인
4. 윈도우 시스템 다시 시작
   • Restart-Computer
5. WSL2 를 설치 및 업데이트, 기본 설정 값 설정
   • wsl —update
   • wsl —set-default-version 2
6. 설치 가능한 가상 머신 확인 후 , 우분투 24.04 설치
   • wsl —list —online
   • wsl —install Ubuntu-24.04
   • 설치 후 환경변수 모두 claude 로 설정
7. 윈도우 검색에서 Ubuntu 검색 후 실행
8. Node.js 내려받기 화면에 접속 후 Linux, nvm 선택하고 클립보드에 복사 클릭
9. 복사한 내용을 우분투 터미널에서 마우스 오른쪽 버튼을 클릭해 붙여넣어 Node.js 설치
   • 마지막에 npm -v 로 실행되는 부분이 에어 없이 정상적으로 출력되는지 확인
10. Node.js 패키지 관리자를 이용해서 클로드 코드를 설치
    • npm install -g @anthropic-ai/claude-code
11. 클로드 코드 정상 확인
    • claude -v

---

클로드 코드 실행

클로드 코드를 실행하면 현재 디렉터리에 접근해도 되는지 확인하고, 그곳을 작업 공간으로 삼는다. 일반적으로 작업을 위한 디렉터리를 만들게 되는데, 1주차에서는 디렉터리를 따로 만들지 않고, 클로드 코드를위해 준비된 깃허브 저장소를 내려받은 후에 해당 저장소에서 작업을 진행

1. 클로드 코드를 위한 깃허브 저장소를 내려받고, 해당 저장소의 week1 디렉터리로 이동
   • git clone https://github.com/sysnet4admin/_Book_Claude-Code.git
   • cd _Book_Claude-Code/week1
   • claude
2. 테마 설정
3. 로그인 방법 선택하라고 적혀 있지만, 요금제 진행 선택
   1. Claude account with subscription 선택 후 계정 연동
4. 구독 및 계정 연동 후 로그인 성공 메시지가 터미널에 나옴 Enter 눌러 진행
5. 계정에 등록된 구독 정보를 모두 확인 했다면 설정 진행
   • 클로드 코드는 실수할 수 있고, 보안적으로 의심되는 코드는 실행하지 말라 → Enter
   • 클로드 코드가 실행될 터미널 설정 → Yes
   • 현재 폴더를 신뢰할 수 있는지 → Yes
6. 모든 기본 설정 끝
7. / docter 명령어로 클로드 코드 점검