🤔 클로드코드가 뭔가요?
클로드코드는 Anthropic에서 만든 AI 코딩 도우미(바이브 코딩)입니다. 쉽게 말해서, 여러분이 "이런 프로그램 만들어줘"라고 말하면 AI가 대신 코드를 짜주는 도구예요. 터미널(검은 화면)에서 명령어를 입력하면 클로드가 알아서 코딩을 해줍니다!
📋 준비물
Windows 10 이상의 컴퓨터
인터넷 연결
클로드 요금제 pro이상 구독하기
🚀 설치 과정
1단계: Python 설치하기
https://www.python.org/downloads/
1. 웹브라우저 열기
2. "python.org" 검색하거나 주소창에 입력
3. 노란색 "Download Python" 버튼 클릭
4. 다운로드된 파일 실행
5. ⚠️ 중요: "Add Python to PATH" 체크박스 꼭 체크!
6. "Install Now" 클릭
2단계: Git for Windows 다운로드 및 설치
https://git-scm.com/downloads/win
3단계: Node.js 설치
https://nodejs.org/ko/download/current
4단계: Claude Code 설치
https://docs.anthropic.com/en/docs/claude-code/overview
https://github.com/anthropics/claude-code
4-1단계: 설치하기
방법 1: CMD(명령 프롬프트) 사용하기
CMD 열기:
1. Windows 키 + R 동시에 누르기
2. "cmd" 입력 후 엔터
3. 검은 화면이 나타남
위 스샷의 시작버튼 옆에 ' cmd ' 또는 ' 명령 프롬프트 ' 입력 해도 됩니다.
이런 화면이 나타나면 됩니다.
설치 명령어:
pip install claude-code
npm install -g @anthropic-ai/claude-code
💡 팁: 마우스 우클릭하면 붙여넣기가 됩니다!
위에 두 줄중 하나만 하시는 거예요~ 이유는 밑에서 설명합니다
방법 2: PowerShell 사용하기 (더 최신 방법!)
PowerShell 열기:
방법 A) 시작 버튼 우클릭
1. 시작 버튼(윈도우 로고)에 마우스 우클릭
2. "Windows PowerShell" 또는 "터미널" 클릭
방법 B) 검색으로 열기
1. Windows 키 누르기
2. "PowerShell" 입력
3. "Windows PowerShell" 클릭
" 위 화면과 같은 화면이 나타나면 됩니다."
설치 명령어:
pip install claude-code
npm install -g @anthropic-ai/claude-code
🎯 PATH 추가
1. PATH 추가 전 vs 후 비교
❌ PATH 추가 전:
# Git이 설치된 폴더까지 전체 경로를 입력해야 함
C:\Program Files\Git\bin\git.exe --version
# 매번 이렇게 긴 경로를 쳐야 함 😫
C:\Program Files\Git\bin\git.exe clone https://github.com/example/repo.git
✅ PATH 추가 후:
# 어디서든 간단하게!
git --version
# 짧고 편하게 사용 가능 😊
git clone https://github.com/example/repo.git
🎨 실생활 비유로 이해하기
PATH 추가 = 단축 다이얼 등록
1. 단축 다이얼 없을 때:
- 피자집 전화: 02-1234-5678 전체 입력
2. 단축 다이얼 등록 후:
- 피자집 전화: 1번만 누르면 끝!
Git PATH도 똑같은 원리입니다! 🍕
🔧 PATH 추가하는 방법
방법 1: Git 설치 시 자동 추가 (추천)
1. Git 설치 프로그램 실행
2. "Adjusting your PATH environment" 단계에서
3. ✅ "Git from the command line and also from 3rd-party software" 선택
4. 설치 완료!
방법 2: 수동으로 추가하기
1. Windows 키 + X → "시스템" 클릭
2. "고급 시스템 설정" 클릭
3. "환경 변수" 버튼 클릭
4. "Path" 선택 → "편집" 클릭
5. "새로 만들기" → Git 설치 경로 추가
예: C:\Program Files\Git\bin
6. 모든 창에서 "확인" 클릭
🚨 PATH 추가 안 했을 때 발생하는 문제들
1. 명령어를 찾을 수 없음
'git'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.
2. 개발 도구에서 Git 인식 실패
- VS Code: "Git을 찾을 수 없습니다"
- IntelliJ: "Git executable not found"
- SourceTree: "Git 설치를 감지할 수 없습니다"
3. npm/pip 패키지 설치 실패
# Git 저장소에서 패키지 설치 시 오류
npm ERR! Error: spawn git ENOENT
💡 팁 : PATH 확인하는 방법
현재 PATH 목록 보기:
# CMD/PowerShell에서
echo %PATH%
# 또는 보기 좋게 정리해서
echo %PATH:;=&echo.%
Git이 PATH에 있는지 확인:
where git
⚠️ PowerShell 오류 발생 시:
만약 "이 시스템에서 스크립트를 실행할 수 없습니다" 오류가 나면:
# 1. 먼저 이 명령어 실행 (관리자 권한 필요)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
# 2. Y 입력 후 엔터
# 3. 다시 설치 명령어 실행
pip install claude-code
🤔 CMD vs PowerShell 뭘 써야 할까요?
구분
CMD
PowerShell
장점
• 더 단순함
• 오류가 적음
• 전통적인 방법
• 더 강력함
• 복사/붙여넣기 편함
• 최신 Windows 기본값
단점
• 기능이 제한적
• 구식 인터페이스
• 처음엔 복잡해 보임
• 권한 설정 필요할 수도
추천
🔰 완전 초보자
💪 조금이라도 컴퓨터 써본 분
📌 초보자를 위한 꿀팁!
복사 & 붙여넣기 방법:
CMD: 마우스 우클릭
PowerShell: Ctrl+V 또는 마우스 우클릭
5단계: 클로드코드 실행하기
claude-code
입력 후 엔터! API 키를 입력하라고 나오면 복사한 키 붙여넣기
cd your-awesome-project # 예 : cd /path/to/your/project
claude
***********************************참고*************************
📊 npm vs pip 설치 방법 비교
🔍 근본적인 차이점 분석
1. 설치 도구의 차이
• npm (Node Package Manager)
- JavaScript/Node.js 패키지 관리자
- Node.js 설치 시 함께 설치됨
- 주로 웹 개발자들이 사용
• pip (Python Package Installer)
- Python 패키지 관리자
- Python 설치 시 함께 설치됨
- 데이터 분석, AI/ML 개발자들이 주로 사용
2. 명령어 상세 분석
npm 버전:
npm install -g @anthropic-ai/claude-code
npm install
: 패키지 설치 명령-g
: Global(전역) 설치 (시스템 어디서나 사용 가능)@anthropic-ai/claude-code
: 공식 패키지명 (스코프 포함)
pip 버전:
pip install claude-code
pip install
: 패키지 설치 명령claude-code
: 패키지명 (더 간단한 이름)
📋 상세 비교표
구분
npm 버전
pip 버전
필요한 사전 설치
Node.js (16.0 이상)
Python (3.8 이상)
설치 용량
약 150-200MB
약 50-100MB
설치 속도
보통 (의존성 많음)
빠름 (의존성 적음)
업데이트 방법
npm update -g @anthropic-ai/claude-code
pip install --upgrade claude-code
삭제 방법
npm uninstall -g @anthropic-ai/claude-code
pip uninstall claude-code
실행 방법
claude-code
또는 claude
claude-code
공식 지원
✅ Anthropic 공식
❓ 커뮤니티 버전일 가능성
🎯 어떤 걸 선택해야 할까요?
npm 설치를 추천하는 경우:
✅ Anthropic 공식 버전을 원할 때
✅ 이미 Node.js가 설치되어 있을 때
✅ 웹 개발 환경에 익숙할 때
✅ VS Code 등 개발 도구와 연동이 중요할 때
pip 설치를 추천하는 경우:
✅ Python이 이미 설치되어 있을 때
✅ 더 가벼운 설치를 원할 때
✅ 데이터 분석 작업을 함께 할 때
✅ 설치 과정이 더 간단한 걸 원할 때
⚠️ 중요한 주의사항
1. 두 버전은 서로 다른 패키지일 수 있음
2. 기능과 명령어가 약간 다를 수 있음
3. 공식 문서 확인 필수!
🔧 실제 설치 과정 비교
npm으로 설치하기:
# 1. Node.js 설치 확인
node --version
# 2. npm 버전 확인
npm --version
# 3. Claude Code 설치
npm install -g @anthropic-ai/claude-code
# 4. 설치 확인
claude-code --version
pip으로 설치하기:
# 1. Python 설치 확인
python --version
# 2. pip 버전 확인
pip --version
# 3. Claude Code 설치
pip install claude-code
# 4. 설치 확인
claude-code --version
💡 프로의 팁!
설치 전 확인사항:
# npm 버전 확인 (패키지 정보 보기)
npm view @anthropic-ai/claude-code
# pip 버전 확인 (패키지 정보 보기)
pip show claude-code
🚨 트러블슈팅
npm 설치 실패 시:
# 캐시 정리
npm cache clean --force
# 관리자 권한으로 재시도
# Windows: 관리자 권한 PowerShell에서 실행
# Mac/Linux: sudo npm install -g @anthropic-ai/claude-code
pip 설치 실패 시:
# pip 업그레이드
python -m pip install --upgrade pip
# 특정 버전 설치
pip install claude-code==1.0.0
📊 최종 추천
사용자 유형
추천 방법
이유
🔰 완전 초보자
pip
더 간단하고 빠름
🌐 웹 개발자
npm
익숙한 환경
📊 데이터 분석가
pip
Python 생태계 활용
🎯 공식 버전 선호
npm
Anthropic 공식 지원