Claude Code 설치 및 설정 가이드

🎯 단계 1: 계정 생성 및 구독

1.1 Anthropic 계정 생성

1. claude.ai 방문
   • 브라우저에서 https://claude.ai 접속
   • "Sign Up" 또는 "Create Account" 클릭
2. 계정 정보 입력
3. 이메일 주소: your-email@example.com 비밀번호: 강력한 비밀번호 설정 이름: 본인 이름
4. 이메일 인증
   • 이메일로 전송된 인증 링크 클릭
   • 계정 활성화 완료

1.2 Pro/Max 플랜 구독

1. 플랜 선택
   • Dashboard에서 "Upgrade" 또는 "Subscribe" 버튼 클릭
   • Pro 플랜 ($20/월): 개인 개발자, 소규모 프로젝트
   • Max 플랜 ($100/월): 프로덕션 환경, 대규모 프로젝트
2. 결제 정보 입력
3. 결제 방법: 신용카드/체크카드 청구 주기: 월간/연간 (연간 결제 시 할인)
4. 구독 확인
   • 구독 완료 후 Claude Code 접근 권한 활성화
   • API 키 생성 권한 획득

---

🔧 단계 2: CLI 설치

2.1 시스템 요구사항 확인

• 지원 운영체제: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+)
• Node.js: 버전 18 이상 (권장: 20 LTS)
• Git: 최신 버전
• 터미널/Command Prompt: 기본 명령어 사용 가능

2.2 Node.js 설치 (필요한 경우)

Windows:

# Node.js 공식 사이트에서 다운로드
# https://nodejs.org/en/download/
# 또는 Chocolatey 사용
choco install nodejs

macOS:

# Homebrew 사용
brew install node

# 또는 공식 설치 파일 다운로드
# https://nodejs.org/en/download/

Linux (Ubuntu):

# Node.js 20.x 설치
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# 설치 확인
node --version
npm --version

2.3 Claude Code CLI 설치

방법 1: npm 글로벌 설치 (권장)

# Claude Code 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

방법 2: GitHub 릴리스에서 바이너리 다운로드

# 최신 릴리스 다운로드 (Linux/macOS)
curl -fsSL https://claude.ai/install.sh | sh

# Windows의 경우 GitHub Releases 페이지에서 .exe 파일 다운로드
# https://github.com/anthropics/claude-code/releases

2.4 설치 검증

# 의사진단 명령어로 설치 상태 확인
claude doctor

# 예상 출력:
# ✅ Claude Code installed correctly
# ✅ Node.js version compatible
# ✅ Git available
# ⚠️ Authentication required

---

🔑 단계 3: 인증 설정

3.1 API 키 생성

1. Anthropic Console 접속
   • https://console.anthropic.com 방문
   • Claude.ai 계정으로 로그인
2. API 키 생성
3. 1. "API Keys" 섹션으로 이동 2. "Create Key" 버튼 클릭 3. 키 이름 입력: "Claude Code - [프로젝트명]" 4. 권한 설정: "Full Access" 또는 필요한 권한만 선택 5. 생성된 키 안전하게 복사 (다시 볼 수 없음!)

3.2 CLI 인증 설정

# 인증 시작
claude auth

# OAuth 프로세스 진행
# 1. 브라우저가 자동으로 열림
# 2. Claude.ai에 로그인
# 3. Claude Code 접근 권한 승인
# 4. 터미널로 돌아가서 완료 메시지 확인

# 인증 상태 확인
claude auth status

3.3 환경 변수 설정 (선택사항)

# .bashrc, .zshrc, 또는 .bash_profile에 추가
export ANTHROPIC_API_KEY="your-api-key-here"

# Windows PowerShell의 경우
$env:ANTHROPIC_API_KEY = "your-api-key-here"

---

💻 단계 4: IDE 연동

4.1 VS Code 확장 프로그램 설치

방법 1: VS Code Marketplace

1. VS Code 열기
2. 확장 프로그램 탭 (Ctrl+Shift+X)
3. "Claude Code" 검색
4. Anthropic 공식 확장 프로그램 설치
   • 확장 프로그램 이름: "Claude Code for VSCode"
   • 개발자: Anthropic

방법 2: 명령 팔레트

1. Ctrl+Shift+P (Cmd+Shift+P on Mac)
2. "Extensions: Install Extensions" 입력
3. "Claude Code" 검색 및 설치

방법 3: 터미널에서 설치

# VS Code 확장 프로그램 CLI로 설치
code --install-extension anthropic.claude-code

4.2 JetBrains IDE 플러그인 설치

IntelliJ IDEA / PyCharm / WebStorm 등:

1. IDE 열기
2. Settings/Preferences (Ctrl+Alt+S)
3. Plugins 섹션
4. Marketplace 탭
5. "Claude Code" 검색
6. Install 클릭 후 IDE 재시작

4.3 IDE 연동 확인

# VS Code에서 Claude Code 실행
# Ctrl+Esc (Windows/Linux) 또는 Cmd+Esc (Mac)

# 또는 명령 팔레트에서
# "Claude Code: Start Chat"

---

🚀 단계 5: 프로젝트 연결 및 초기 설정

5.1 기존 프로젝트에 Claude Code 연결

1. 프로젝트 디렉토리로 이동

cd /path/to/your/project

2. Claude Code 초기화

# 프로젝트 초기화
claude /init

# 또는 상호작용식 초기화
claude "이 프로젝트를 Claude Code와 연결하고 최적화해줘"

3. 프로젝트 구조 분석

# 프로젝트 구조 이해
claude "이 프로젝트의 구조와 주요 구성요소를 분석해줘"

# 설정 파일 생성
claude "개발 환경에 맞는 .claude 설정 파일을 만들어줘"

5.2 Claude Code 설정 파일 생성

.claude/config.json 예시:

{
  "project": {
    "name": "My Awesome Project",
    "description": "Next.js 기반 웹 애플리케이션",
    "type": "web-application"
  },
  "include_patterns": [
    "src/**/*.js",
    "src/**/*.ts",
    "src/**/*.jsx",
    "src/**/*.tsx",
    "*.json",
    "*.md",
    "*.yml"
  ],
  "exclude_patterns": [
    "node_modules/**",
    "dist/**",
    "build/**",
    ".git/**",
    "*.log"
  ],
  "context": {
    "tech_stack": ["React", "Next.js", "TypeScript", "Tailwind CSS"],
    "coding_style": "airbnb",
    "test_framework": "Jest"
  }
}

5.3 프로젝트 컨텍스트 설정

README.md 업데이트:

claude "프로젝트 README.md를 개발자 온보딩에 최적화해서 업데이트해줘"

코드 스타일 가이드 설정:

claude "ESLint, Prettier 설정을 우리 팀 코딩 컨벤션에 맞게 구성해줘"

---

✅ 단계 6: 설치 완료 및 테스트

6.1 기본 동작 테스트

# 간단한 질문으로 연결 테스트
claude "Hello, Claude Code!"

# 프로젝트 분석 테스트
claude "이 프로젝트에서 개선할 수 있는 부분을 찾아줘"

# 코드 생성 테스트
claude "간단한 유틸리티 함수를 하나 만들어줘"

6.2 IDE 통합 테스트

• VS Code: Ctrl+Esc로 Claude Code 패널 열기
• JetBrains: 터미널에서 claude 명령어 실행
• 파일 참조: @filename.js 형식으로 특정 파일 언급

6.3 고급 기능 테스트

# 슬래시 명령어 테스트
/help                    # 사용 가능한 명령어 목록
/review                  # 코드 리뷰
/optimize               # 성능 최적화 제안
/test                   # 테스트 코드 생성

# 컨텍스트 참조 테스트
claude "@src/components/ 이 컴포넌트들을 분석해줘"

---

🔧 문제 해결 및 팁

일반적인 문제들:

1. 인증 실패

# 인증 재설정
claude auth logout
claude auth

# API 키 직접 설정
export ANTHROPIC_API_KEY="your-key"

2. 권한 오류 (Linux/macOS)

# npm 권한 수정
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# 또는 npx 사용
npx @anthropic-ai/claude-code

3. 방화벽/프록시 문제

# 프록시 설정
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy https://proxy.company.com:8080

성능 최적화 팁:

1. 제외 패턴 설정: 불필요한 파일들을 .claudeignore에 추가
2. 컨텍스트 최적화: 관련 파일만 참조하여 토큰 사용량 절약
3. 명확한 지시: 구체적이고 명확한 요청으로 더 나은 결과 얻기

---

🎉 축하합니다!

Claude Code 설치와 설정이 완료되었습니다! 이제 다음과 같은 혜택을 누리실 수 있습니다:

• ⚡ 3-10배 빠른 개발 속도
• 🔍 전체 코드베이스 인식
• 🤖 자동 코드 생성 및 리팩토링
• 📚 실시간 문서화
• 🐛 지능적 버그 감지 및 수정

첫 번째 프로젝트에서 claude "Hello World 앱을 만들어줘"로 시작해보세요!