📋 사전 요건
시작하기 전에 Anthropic 계정이 필요하며, 다음 중 하나가 있어야 합니다: Claude Pro/Max/Team/Enterprise 구독 또는 Anthropic Console API 크레딧.
무료 Claude.ai 플랜은 Claude Code를 포함하지 않습니다. Claude Pro ($20/월) 는 대부분의 개발자에게 충분하며, Claude Max ($100~200/월) 는 더 높은 사용량이 필요한 경우에 적합합니다.
🖥️ OS별 지원 환경
Claude Code는 macOS (Intel 및 Apple Silicon), Linux (Ubuntu 22.04+, Debian 12+), Windows 11 (네이티브 또는 WSL2)에서 실행됩니다. Windows에서는 PowerShell을 사용하며, Git Bash는 호환성 문제가 있습니다.
🚀 설치 방법
macOS / Linux — 네이티브 인스톨러 (권장)
네이티브 인스톨러는 Node.js가 필요 없고 백그라운드에서 자동 업데이트되는 가장 빠른 방법입니다.
터미널을 열고 아래 명령어 실행:
curl -fsSL https://claude.ai/install.sh | sh
설치 후 새 터미널 창을 열어 PATH를 적용합니다.
Homebrew로 설치도 가능:
brew install --cask claude-code
단, Homebrew는 자동 업데이트가 되지 않아 brew upgrade claude-code로 수동 업데이트해야 합니다.
Windows — PowerShell (CMD 아님)
iwr https://claude.ai/install.ps1 | iex
설치 후 PowerShell을 닫고 새로 열어 claude 명령어가 인식되는지 확인합니다.
npm으로 설치 (구버전 방식)
npm install -g @anthropic-ai/claude-code
npm 방식은 여전히 작동하지만 공식 권장 방식이 아닙니다. 특정 버전을 고정해야 하거나 npm이 표준인 환경에서만 사용하세요. sudo는 절대 사용하지 마세요.
🔐 인증 (로그인)
인증은 브라우저 기반입니다. 프로젝트 디렉터리에서 claude를 실행하면 기본 브라우저가 claude.ai로 열려 1회 로그인을 진행합니다. 인증 정보는 ~/.claude/에 로컬 저장되어 매 세션마다 로그인할 필요가 없습니다.
▶️ 첫 실행
cd 내_프로젝트_폴더
claude
기본 사용법: 터미널에서 메시지를 입력하고 Enter로 전송합니다. 터미널 내에서는 클릭이 불가하며, 화살표 키로 이동합니다. Claude가 실행 중일 때 Esc로 중단, exit 또는 Ctrl+C로 종료, /help로 사용 가능한 명령어를 확인할 수 있습니다.
🛠️ 유용한 초기 설정
설치 상태 진단:
claude doctor
claude doctor를 실행하면 대부분의 설정 문제를 자동으로 감지하고 수정 방법을 제안합니다.
CLAUDE.md 파일 설정 (프로젝트 루트에 생성):
.claude/settings.json을 통해 훅(hooks)을 설정할 수 있습니다. 예를 들어 파일 편집 후 자동 포매팅, 위험한 명령어 차단, 도구 사용 로깅 등을 설정할 수 있습니다.