Claude Code 완벽 설치 가이드 - 초보자를 위한 Step by Step/ 자동화 세팅하기 위해 개인 작은 스터디 파트 2

커서+클로드 코드 화면
터미널: wsl
명령어: Claude

🚀 Claude Code 완벽 설치 가이드 - 초보자를 위한 Step by Step

📌 Claude Code란?

Claude Code는 터미널에서 Claude AI와 대화하며 코딩을 할 수 있는 도구입니다. 마치 개발자 친구가 옆에서 도와주는 것처럼 실시간으로 코드를 작성하고 수정해줍니다.

아래는 클로드를 통해서 쓴 내용입니다

🎯 시작하기 전에 필요한 것들

1. Windows 시스템 요구사항

Windows 10 이상 (64비트)
최소 8GB RAM 권장
인터넷 연결 필수

2. 필요한 계정

Anthropic 계정 (Claude API 키 발급용)
GitHub 계정 (선택사항, 코드 백업용)

📦 Step 1: 기본 환경 설치하기

1-1. Python 설치하기

Python 다운로드
- 🔗 https://www.python.org/downloads/ 접속
- "Download Python 3.12.x" 클릭 (최신 버전)
- ⚠️ 중요: 설치시 "Add Python to PATH" 체크박스 반드시 체크!

설치 확인하기

# PowerShell 열기: Win + X → Windows PowerShell
python --version

결과: Python 3.12.x 출력되면 성공!

1-2. Node.js 설치하기 (npm 포함)

Node.js 다운로드
- 🔗 https://nodejs.org/ko 접속
- LTS 버전 다운로드 (왼쪽 녹색 버튼)
- 기본 설정으로 설치 진행
설치 확인하기
```
node --version
npm --version
```
각각 버전 번호가 나오면 성공!

1-3. Git 설치하기

Git 다운로드
- 🔗 https://git-scm.com/download/win 접속
- 64-bit Git for Windows Setup 다운로드
- 기본 설정으로 설치 (Next 계속 클릭)
설치 확인하기
```
git --version
```

🐧 Step 2: WSL2 설치하기 (선택사항이지만 권장)

WSL(Windows Subsystem for Linux)은 Windows에서 Linux 명령어를 사용할 수 있게 해줍니다.

2-1. WSL2 설치

PowerShell을 관리자 권한으로 실행
- Win + X → Windows PowerShell (관리자)
WSL 설치 명령어 실행
```
wsl --install
```
- 자동으로 Ubuntu가 설치됩니다
- 설치 완료 후 재부팅 필요
재부팅 후 Ubuntu 초기 설정
- 시작 메뉴에서 "Ubuntu" 실행
- 사용자 이름과 비밀번호 설정 (잊지 마세요!)

2-2. WSL에서 Python 설치 (선택사항)

# Ubuntu 터미널에서 실행
sudo apt update
sudo apt install python3 python3-pip

🔑 Step 3: Claude API 키 발급받기

3-1. Anthropic Console 가입

Console 접속
- 🔗 https://console.anthropic.com 접속
- "Sign up" 클릭하여 회원가입
이메일 인증
- 가입 이메일로 온 인증 링크 클릭

3-2. API 키 생성

Console 로그인 후
- 좌측 메뉴 "API Keys" 클릭
- "Create Key" 버튼 클릭
- 키 이름 입력 (예: "my-claude-code")
API 키 저장
- ⚠️ 중요: 생성된 키는 한 번만 보여집니다!
- 메모장에 복사해서 안전하게 보관
- 형식: sk-ant-api03-xxxxx...

💻 Step 4: Claude Code 설치하기

4-1. 설치 방법 1: npm을 통한 설치 (권장)

# PowerShell에서 실행
npm install -g @anthropic/claude-code

4-2. 설치 방법 2: 직접 다운로드

# PowerShell에서 실행
curl -fsSL https://installer.claude.ai | sh

4-3. 설치 확인

claude --version

⚠️ 오류가 나는 경우:

claude 명령을 찾을 수 없다고 나오면 PowerShell을 재시작
그래도 안 되면 시스템 재부팅

🔧 Step 5: Claude Code 설정하기

5-1. API 키 설정

방법 1: 환경 변수로 설정 (권장)

# PowerShell에서 실행
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "your-api-key-here", "User")

# 또는 임시로 현재 세션에만 설정
$env:ANTHROPIC_API_KEY = "your-api-key-here"

방법 2: 설정 파일 생성

홈 디렉토리에 .claude 폴더 생성
```
mkdir $HOME\.claude
```
config.json 파일 생성
```
notepad $HOME\.claude\config.json
```
다음 내용 입력 후 저장
```
{
  "api_key": "your-api-key-here"
}
```

🎉 Step 6: Claude Code 실행하기

6-1. 첫 실행

# 아무 폴더에서나 실행 가능
claude

# 특정 프로젝트 폴더에서 실행
cd "C:\Users\사용자명\Documents\내프로젝트"
claude

6-2. 첫 대화 시작하기

Claude: 안녕하세요! 무엇을 도와드릴까요?

You: Python으로 간단한 계산기를 만들어줘

📝 Step 7: 실제 사용 예제

7-1. YouTube 맛집 모니터링 프로젝트 시작하기

프로젝트 폴더 생성

mkdir "C:\Users\사용자명\Documents\YouTube_Monitor"
cd "C:\Users\사용자명\Documents\YouTube_Monitor"

Claude Code 실행
```
claude
```

프로젝트 요청하기

You: 한국 유튜브에서 맛집 관련 채널 정보를 자동으로 수집하는 시스템을 만들어주세요.
- 검색 키워드: 서울 맛집, 맛집 추천
- 수집 정보: 채널명, 영상링크, 구독자수
- 저장: Google Sheets
- 매일 아침 9시에 자동 실행

7-2. 필요한 패키지 설치

Claude가 requirements.txt 파일을 만들어주면:

# requirements.txt 설치
pip install -r requirements.txt

주로 설치되는 패키지들:

google-api-python-client: YouTube API
gspread: Google Sheets 연동
oauth2client: Google 인증
schedule: 스케줄링
requests: HTTP 요청

🔄 Step 8: Cursor와 함께 사용하기

8-1. Cursor 설치

Cursor 다운로드
- 🔗 https://cursor.sh 접속
- Windows 버전 다운로드 및 설치

8-2. Claude Code와 Cursor 연동 워크플로우

Claude Code로 초기 코드 생성

# 터미널에서
claude
> 맛집 모니터링 시스템의 기본 구조를 만들어줘

Cursor에서 코드 열기

# Claude Code로 파일 생성 후
cursor .  # 현재 폴더를 Cursor로 열기

Cursor에서 세부 수정
- Cursor의 AI 기능으로 코드 개선
- Claude Code의 결과물을 Cursor에서 리팩토링

8-3. 효과적인 협업 방법

Claude Code (터미널) → 전체 구조 설계, 파일 생성
     ↓
Cursor (IDE) → 세부 코드 수정, 디버깅
     ↓
Claude Code → 문제 해결, 새 기능 추가

🚨 자주 발생하는 문제와 해결법

문제 1: "claude 명령을 찾을 수 없습니다"

해결책:

# npm 전역 경로 확인
npm config get prefix

# 해당 경로를 시스템 PATH에 추가
# 시스템 속성 → 환경 변수 → PATH 편집

문제 2: API 키 인증 오류

해결책:

# API 키 다시 설정
$env:ANTHROPIC_API_KEY = "sk-ant-api03-정확한키입력"

# 키 확인
echo $env:ANTHROPIC_API_KEY

문제 3: Python 패키지 설치 오류

해결책:

# pip 업그레이드
python -m pip install --upgrade pip

# 가상환경 사용 (권장)
python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -r requirements.txt

💡 초보자를 위한 꿀팁

1. 명령어 기억하기

작업

명령어

Claude Code 시작

claude

현재 위치 확인

pwd

폴더 이동

cd 폴더명

파일 목록 보기

dir 또는 ls

Python 실행

python 파일명.py

2. 유용한 Claude Code 명령어

# 파일 생성 요청
You: main.py 파일을 만들어서 기본 구조를 작성해줘

# 오류 해결 요청
You: 이 오류를 해결해줘: [오류 메시지 복사]

# 코드 설명 요청
You: 이 코드가 뭘 하는지 설명해줘

3. 프로젝트 백업하기

# Git으로 백업
git init
git add .
git commit -m "첫 커밋"

🎯 다음 단계

간단한 프로젝트부터 시작
- To-do 리스트 앱
- 날씨 정보 수집기
- 간단한 웹 스크래퍼
점진적으로 복잡도 높이기
- API 연동 프로젝트
- 자동화 시스템
- 웹 애플리케이션
커뮤니티 참여
- GitHub에 코드 공유
- 스터디 그룹 참여
- 블로그 작성

📚 추가 학습 자료

공식 문서: https://docs.anthropic.com/claude-code
Python 기초: https://wikidocs.net/book/1
Git 기초: https://backlog.com/git-tutorial/kr/

🤝 도움 받기

문제가 생기면:

Claude Code에게 직접 물어보기
스터디 그룹에 질문하기
공식 문서 확인하기

기억하세요: 모든 전문가도 처음엔 초보자였습니다. 천천히, 꾸준히 하면 됩니다! 🌟

------

아래는 클로드 코드를 통해서 쓴 내용이고요!

# Claude Code 설치 및 사용 가이드 📘

## 목차

1. [Claude Code란?](#claude-code란)

2. [설치 전 준비사항](#설치-전-준비사항)

3. [Windows 환경에서의 설치](#windows-환경에서의-설치)

4. [Cursor IDE와 연동하기](#cursor-ide와-연동하기)

5. [기본 사용법](#기본-사용법)

6. [문제 해결](#문제-해결)

7. [유용한 팁](#유용한-팁)

---

## Claude Code란?

Claude Code는 Anthropic에서 개발한 터미널 기반 AI 코딩 도구입니다. 자연어로 코드를 작성하고, 버그를 수정하며, 코드베이스를 탐색할 수 있습니다.

### 주요 기능

- 자연어로 코드 작성 및 수정

- 자동 파일 읽기 및 편집

- Git 작업 자동화

- 코드 디버깅 및 최적화

- 프로젝트 구조 분석

---

## 설치 전 준비사항

### 1. 시스템 요구사항

- 운영체제: Windows 10/11 (WSL 필요)

- Node.js: 18.0.0 이상

- 메모리: 최소 4GB RAM 권장

- 디스크 공간: 최소 1GB 여유 공간

### 2. 계정 준비

- Anthropic 계정 생성 ([console.anthropic.com](https://console.anthropic.com))

- 계정에 최소 $30 크레딧 추가 (신용카드 또는 체크카드 필요)

---

## Windows 환경에서의 설치

### 단계 1: WSL 설치

1. PowerShell을 관리자로 실행 (Windows Terminal 사용 권장)

2. 다음 명령어 실행:

```powershell

wsl --install

```

3. 컴퓨터 재부팅 (필수)

### 단계 2: Ubuntu 설정

1. 재부팅 후 Ubuntu 터미널이 자동으로 열림

2. 사용자명과 비밀번호 설정 (Windows 계정과 달라도 됨)

3. 설정 완료 후 다음 명령어로 업데이트:

```bash

sudo apt update

sudo apt upgrade -y

```

### 단계 3: Node.js 설치

1. Node Version Manager (nvm) 설치:

```bash

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

source ~/.bashrc

```

2. Node.js 설치:

```bash

nvm install 18

nvm use 18

```

3. 설치 확인:

```bash

node --version

npm --version

```

### 단계 4: npm 전역 디렉터리 설정

```bash

mkdir -p ~/.npm-global

npm config set prefix ~/.npm-global

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

source ~/.bashrc

```

### 단계 5: Claude Code 설치

⚠️ 중요: sudo를 사용하지 마세요!

```bash

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

```

권한 오류가 발생하면:

```bash

npm install -g @anthropic-ai/claude-code --force --no-os-check

```

### 단계 6: 설치 확인

```bash

claude --version

```

버전 정보가 표시되면 설치 완료!

---

## Cursor IDE와 연동하기

### 단계 1: Cursor 명령어 활성화

1. Cursor IDE 열기

2. Cmd+Shift+P (Mac) 또는 Ctrl+Shift+P (Windows) 누르기

3. "Shell Command: Install 'cursor' command in PATH" 검색 후 실행

### 단계 2: Claude Code Extension 설치

WSL 터미널에서 다음 명령어 실행:

Linux/Mac:

```bash

cursor --install-extension ~/.claude/local/node_modules/@anthropic-ai/claude-code/vendor/claude-code.vsix

```

Windows:

```bash

cursor --install-extension %USERPROFILE%\.claude\local\node_modules\@anthropic-ai\claude-code\vendor\claude-code.vsix

```

### 단계 3: Cursor 재시작

Extension이 적용되도록 Cursor를 완전히 종료하고 다시 시작합니다.

### 단계 4: 연동 확인

1. Cursor에서 프로젝트 열기

2. 터미널에서 claude 명령어 실행

3. 또는 Cmd+Esc (Mac) / Ctrl+Esc (Windows) 단축키 사용

---

## 기본 사용법

### 1. Claude Code 시작

```bash

# 프로젝트 디렉터리로 이동

cd /mnt/c/Users/YourName/Documents/your-project

# Claude Code 실행

claude

```

### 2. 첫 번째 명령어들

```

# 프로젝트 분석

"이 프로젝트가 무엇을 하는지 설명해줘"

# 코드 작성

"Python으로 계산기 함수를 만들어줘"

# 버그 수정

"이 코드에서 오류를 찾아서 수정해줘"

# 파일 생성

"README.md 파일을 작성해줘"

```

### 3. 유용한 명령어

- /help: 도움말 보기

- /exit: Claude Code 종료

- /config: 설정 변경

- Ctrl+C: 현재 작업 중단

- Esc: Claude Code 중지

---

## 문제 해결

### 자주 발생하는 문제들

#### 1. "claude: command not found" 오류

해결방법:

- WSL 터미널에서 실행하고 있는지 확인

- Node.js와 npm이 정상 설치되었는지 확인

- PATH 설정이 올바른지 확인

#### 2. 권한 오류

해결방법:

- sudo 없이 설치했는지 확인

- npm 전역 디렉터리 설정 확인

- npm config get prefix 실행하여 설정 확인

#### 3. Cursor 연동 안됨

해결방법:

- Extension 수동 설치 명령어 다시 실행

- Cursor 완전 재시작

- 프로젝트 루트 디렉터리에서 실행 확인

#### 4. 느린 성능

해결방법:

- WSL 2 사용 확인: wsl --set-default-version 2

- Linux 파일시스템에서 작업 (`/home/username/`)

- Windows 파일시스템 대신 WSL 내부 파일시스템 사용

---

## 유용한 팁

### 1. 효율적인 사용법

명령어 팁:

- 구체적인 요청하기: "로그인 기능 추가"보다는 "JWT 토큰을 사용한 로그인 API 엔드포인트 추가"

- 단계별로 요청하기: 복잡한 작업을 작은 단위로 나누어 요청

- 코드 설명 요청하기: "이 함수가 무엇을 하는지 설명해줘"

파일 작업:

- 파일 드래그 앤 드롭: Shift를 누른 채로 드래그

- 이미지 붙여넣기: Ctrl+V 사용 (Cmd+V가 아님)

- 여러 파일 동시 편집 가능

### 2. Cursor IDE 활용

단축키:

- Cmd+Esc / Ctrl+Esc: 빠른 Claude Code 실행

- Cmd+Option+K / Alt+Ctrl+K: 파일 참조 삽입

- Esc: Claude Code 중지 (Ctrl+C 아님)

설정 최적화:

```bash

# 권한 확인 건너뛰기 (개발 시 편리)

claude --dangerously-skip-permissions

# 자동 diff 뷰어 설정

claude

/config

# diff tool을 "auto"로 설정

```

### 3. 비용 절약 팁

- 명확하고 구체적인 요청으로 재작업 최소화

- 작은 기능부터 시작하여 점진적으로 확장

- 코드 리뷰 전에 Claude Code로 최적화

---

## 마무리

이 가이드를 따라하면 Claude Code를 성공적으로 설치하고 Cursor IDE와 연동하여 사용할 수 있습니다.

기억할 점:

- WSL 환경에서만 실행 가능

- 프로젝트 루트에서 실행하기

- 구체적이고 명확한 요청하기

- 단계별로 작업 진행하기

추가 도움이 필요하면:

- 공식 문서: [https://docs.anthropic.com/claude-code](https://docs.anthropic.com/claude-code)

- 커뮤니티: [Claude Code GitHub Issues](https://github.com/anthropics/claude-code/issues)

Claude Code 완벽 설치 가이드 - 초보자를 위한 Step by Step/ 자동화 세팅하기 위해 개인 작은 스터디 파트 2 - 클로드코딩 환경 설정 (윈도우)

커서+클로드 코드 화면터미널: wsl명령어: Claude