설치 가이드

클로드 코드 설치 가이드

처음 설치하는 분도 막히지 않도록, 운영체제별로 단계별 안내합니다.

1

Claude 구독 확인

OS 공통

Claude Code를 사용하려면 두 가지 방법 중 하나를 선택하세요.

  • Pro 구독 ($20/월) — claude.ai에서 바로 구독, Claude Code 즉시 사용 가능. 초보자에게 추천합니다.
  • API 키 방식 — console.anthropic.com에서 발급. 사용한 만큼만 비용이 발생하지만 설정이 필요합니다.
💡 처음 시작하는 분이라면 Pro 구독을 권장합니다. 별도 설정 없이 claude.ai에서 바로 구독할 수 있습니다.
2

Node.js 설치

  • nodejs.org 접속 → LTS 버전 선택 → .msi 파일 다운로드
  • 다운받은 설치 파일을 실행하고 Next를 눌러 기본 설정으로 설치
  • 설치 완료 후 PowerShell을 열고 아래 명령어로 확인
$ PowerShell 
node --version
npm --version

버전 번호(예: v20.x.x)가 표시되면 설치 완료입니다.

  • nodejs.org 접속 → LTS 버전 선택 → .pkg 파일 다운로드 후 설치
  • Homebrew가 설치되어 있다면 아래 명령어로 바로 설치 가능
$ Terminal 
brew install node

설치 확인

$ Terminal 
node --version
npm --version

버전 번호(예: v20.x.x)가 표시되면 설치 완료입니다.

3

터미널 열기

  • 시작 메뉴 → "PowerShell" 검색 → 클릭하여 실행
  • 또는 키보드 Win + X → Windows PowerShell 클릭
💡 PowerShell 창에 커서가 깜박이면 준비 완료입니다. 명령어를 입력하고 Enter를 눌러 실행합니다.
  • Spotlight 검색 Cmd + Space → "Terminal" 입력 → Enter
  • 또는 응용 프로그램 → 유틸리티 → Terminal
💡 Terminal 창에 사용자이름@컴퓨터이름 ~ % 같은 텍스트가 보이면 준비 완료입니다.
4

Claude Code 설치

OS 공통

터미널(PowerShell 또는 Terminal)을 열고 아래 명령어를 입력하세요.

설치 명령어
$ 터미널 
npm install -g @anthropic-ai/claude-code
설치 확인
$ 터미널 
claude --version

버전 번호가 출력되면 설치 완료입니다.

5

API 키 연결

🔑 API 키 발급 방법 (공통): console.anthropic.com 접속 → API Keys 메뉴 → Create Key → 생성된 키를 복사하세요.

PowerShell에서 입력 (임시 설정)

$ PowerShell 
$env:ANTHROPIC_API_KEY="여기에_키_붙여넣기"
  • 영구 설정 방법: 시작 메뉴 → "환경 변수" 검색 → 시스템 환경 변수 편집 → ANTHROPIC_API_KEY 항목 추가

Terminal에서 입력 (임시 설정)

$ Terminal 
export ANTHROPIC_API_KEY="여기에_키_붙여넣기"

영구 설정 (.zshrc에 추가)

$ Terminal 
echo 'export ANTHROPIC_API_KEY="여기에_키_붙여넣기"' >> ~/.zshrc
source ~/.zshrc

자주 나는 에러

⚠️

에러 해결 모음

▼

Windows 에러

Node.js가 제대로 설치되지 않았거나 PATH에 등록되지 않은 경우입니다.
Node.js를 재설치한 뒤 PowerShell을 완전히 닫고 다시 여세요. 재설치 시 "Add to PATH" 옵션이 체크되어 있는지 확인하세요.
PowerShell을 관리자 권한으로 실행하세요.
시작 메뉴 → PowerShell 검색 → 마우스 우클릭 → "관리자 권한으로 실행" 선택 후 명령어를 다시 입력하세요.
설치 직후에 나타날 수 있는 정상적인 현상입니다.
PowerShell 창을 완전히 닫고 새로 열어서 다시 claude --version을 입력해보세요.

macOS 에러

Node.js 설치가 완료되지 않았습니다.
nodejs.org에서 .pkg 파일을 다시 다운로드해 설치하거나, Homebrew가 있다면 brew install node를 실행하세요. 이후 Terminal을 새로 여세요.
관리자 권한이 필요한 경우입니다. 설치 명령어 앞에 sudo를 붙여 실행하세요.
sudo npm install -g @anthropic-ai/claude-code
Mac 로그인 비밀번호를 입력하라고 나오면 입력하면 됩니다. (입력해도 화면에 표시되지 않습니다)
macOS 개발 도구가 설치되지 않아 발생합니다.
아래 명령어로 Xcode Command Line Tools를 먼저 설치하세요.
xcode-select --install
팝업 창이 열리면 "설치"를 눌러 완료한 뒤 다시 시도하세요.

완료 체크리스트

✅

설치가 잘 됐는지 확인해보세요

코드 에디터 설치

💻 코드 에디터 설치 (선택사항)

Claude Code만으로도 작업 가능하지만, 에디터를 함께 쓰면
파일을 눈으로 보면서 작업할 수 있어 훨씬 편합니다. 셋 중 하나만 골라도 충분합니다.

Claude와 궁합이 가장 좋은 AI 코드 에디터

추천 대상: Claude Code와 함께 쓰고 싶은 분

무료 플랜 있음 Pro $20/월
  1. cursor.com 접속
  2. Download for [OS] 클릭
  3. 설치 후 실행, GitHub 또는 이메일로 로그인
⬇️ Cursor 다운로드

Google의 무료 AI 에이전트 퍼스트 IDE (Claude도 지원)

추천 대상: 무료로 시작하고 싶은 분, 멀티 에이전트에 관심 있는 분

완전 무료 (퍼블릭 프리뷰)

⚠️ 현재 퍼블릭 프리뷰 단계로 기능이 변경될 수 있습니다.

  1. antigravity.google 접속
  2. 운영체제에 맞는 설치 파일 다운로드
  3. 설치 후 Google 계정으로 로그인
⬇️ Antigravity 다운로드

전 세계 개발자가 가장 많이 쓰는 무료 에디터

추천 대상: 이미 VS Code에 익숙한 분, 가장 무난하게 시작하고 싶은 분

완전 무료
  1. code.visualstudio.com 접속
  2. Download 클릭
  3. 설치 후 실행
⬇️ VS Code 다운로드
← LECTURE 0-2로 돌아가기 강의 계속 보기 →