Claude Code 5분 설치하기 (2026 초보자 가이드)

Claude Code가 1년 안에 월 검색량 0에서 100만까지 갔어요. “다들 얘기하길래” 직접 써보고 싶어서 여기 왔다면, 이 글이 당신의 5분 설치 가이드예요.

시작 전 3가지:

1. Claude Pro 구독 ($20/월) 또는 그 이상 필요. 무료 티어에 Claude Code 없어요.
2. Claude Code는 터미널에서 돌아요. 컴퓨터의 텍스트 기반 명령창이요.
3. 네이티브 인스톨러가 2026년 초에 npm을 공식 방법으로 대체했어요. 몇 달 전 튜토리얼은 아마 npm 방식 보여줄 거예요. 아직 작동하지만 비권장.

가봅시다.

시스템 요구사항

설치 전에 지원되는 OS인지 확인:

Windows 11이면 괜찮아요. macOS Monterey (12) 이하면 먼저 업그레이드.

옵션 1: macOS 또는 Linux (30초 설치)

터미널 열고, 이거 붙여넣고 엔터:

curl -fsSL https://claude.ai/install.sh | bash

이게 전체 설치예요. 네이티브 인스톨러가 바이너리 다운로드, ~/.local/bin에 넣고, 자동 업데이트 설정. Node.js 불필요, 의존성 없음, 패키지 매니저 드라마 없음.

작동 확인:

claude --version
claude doctor

claude doctor가 진단 실행 — 인증 상태, PATH, 설정, MCP 서버. 설치 후 항상 실행해서 문제 일찍 잡기.

프로젝트로 점프:

cd /경로/프로젝트
claude

이제 Claude Code 안이에요.

옵션 2: Windows + WSL (권장)

WSL (Windows Subsystem for Linux)은 Windows 안에서 Linux 돌리는 거. Claude Code는 네이티브 Windows 경로보다 WSL로 더 잘 돌아요. 설치는 Linux랑 같음.

1단계: PowerShell을 관리자로 열고 실행:

wsl --install

재부팅 요청하면 재부팅. 재시작 후 시작 메뉴에서 Ubuntu 터미널 열기.

2단계: Ubuntu/WSL 터미널 안에서 Claude Code 설치:

curl -fsSL https://claude.ai/install.sh | bash

3단계: 확인하고 시작:

claude --version
claude doctor
cd /mnt/c/Users/당신의_사용자명/경로/프로젝트
claude

/mnt/c/ 경로가 WSL이 Windows 드라이브에 접근하는 방식. C: 드라이브는 /mnt/c/에, D:는 /mnt/d/에 있음.

옵션 3: Windows 네이티브 (PowerShell)

WSL 피하고 싶다면 Windows에 직접 설치 가능. 이 경로는 Claude Code가 내부적으로 Git Bash를 쓰기 때문에 Git for Windows 필요.

1단계: 먼저 Git for Windows 설치. 기본 설정으로 OK.

2단계: PowerShell 열고 (관리자 아님) 실행:

irm https://claude.ai/install.ps1 | iex

3단계: 확인:

claude --version
claude doctor

claude doctor가 Git Bash를 못 찾는다고 하면, ~/.claude/settings.json에 추가:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

옵션 4: 레거시 NPM 방식 (아직 작동)

이미 Node.js 18+ 설치되어 있고 npm 선호하면:

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

Anthropic은 이 경로 비권장하지만 하위 호환성 위해 작동 유지. 피하는 이유 3가지:

1. 자동 업데이트 없음. 새 버전 나오면 수동으로 npm update.
2. Node.js 18+ 필요. 네이티브 인스톨러는 의존성 제로.
3. 잘 깨짐. npm 글로벌 설치는 권한 문제 자주 있음.

이미 npm으로 설치했으면 네이티브로 마이그레이션:

# 네이티브 바이너리 설치
curl -fsSL https://claude.ai/install.sh | bash

# 기존 npm 버전 제거
npm uninstall -g @anthropic-ai/claude-code

인증 (로그인 의식)

처음 claude 실행하면 브라우저가 OAuth 로그인 열어요. 사용하는 Anthropic 계정으로 로그인:

• Claude Pro/Max 개인 구독 — claude.ai 로그인
• Claude Team 또는 Enterprise — 워크스페이스 로그인
• Claude Console — 조직이 초대했으면

브라우저 자동으로 안 열리면, 터미널에서 c 눌러 로그인 URL 복사, 브라우저에 붙여넣고 로그인 완료, 요청 시 터미널에 코드 다시 붙여넣기.

나중에 계정 전환:

/logout

(셸 아니라 Claude Code 안에서 실행)

첫 명령어들

claude가 인터랙티브 세션에 들어가게 하면, 이거 시도:

/help          # 모든 사용 가능 명령어 표시
/status        # 인증, 구독, 요청 제한 확인
/config        # 현재 설정 보기
/logout        # 로그아웃

셸에서 (인터랙티브 세션 밖):

claude doctor    # 진단 리포트
claude --version # 설치된 버전 표시
claude mcp list  # 구성된 MCP 서버 목록

진짜 첫 작업

이미 있는 프로젝트 열기. 뭐든 — Next.js 앱, Python 스크립트, 설정 레포. Claude Code 시작:

cd /경로/프로젝트
claude

그 다음 한국어로 실제 작업 타이핑. 이런 거:

“README 읽고, 이 프로젝트가 어떻게 구성되어 있는지 알려줘.”

또는:

“이메일 주소 검증하는 새 함수 추가해. 코드베이스에서 가장 잘 맞는 곳에 넣어.”

또는:

“모든 TODO 주석 찾아서 파일 경로랑 같이 나열해.”

Claude가 파일 보고, 생각하고, 변경 제안. 각 파일 편집 전에 승인 요청. 당신이 통제권 유지.

흔한 설치 문제 (와 해결)

“command not found: claude”

인스톨러가 바이너리를 ~/.local/bin에 넣었는데 셸이 그 디렉토리 몰라요. PATH에 추가:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

zsh (Catalina 이후 macOS 기본)에 있으면 .bashrc를 .zshrc로 교체.

“The token ‘&&’ is not a valid statement separator”

PowerShell에 CMD 스타일 명령어 붙여넣음. CMD로 전환하거나 PowerShell 버전 사용:

irm https://claude.ai/install.ps1 | iex

npm install 중 “Permission denied”

sudo npm install -g 시도해서 권한 깨짐. npm에 sudo 쓰지 마세요. 대신:

• 네이티브 인스톨러 사용 (sudo 불필요): curl -fsSL https://claude.ai/install.sh | bash
• nvm (Node Version Manager)로 홈 디렉토리에 Node 설치

WSL이 인터넷에 안 닿음

curl https://claude.ai로 테스트. 실패하면, Windows 방화벽이나 VPN이 WSL 차단. 대부분 VPN에 “로컬 트래픽 제외” 옵션 있어요 — 활성화.

Node.js 버전 너무 오래됨 (npm만)

Claude Code npm 설치는 Node 18 이상 필요. node -v로 확인. v16 이하면 nvm 경유 업그레이드:

nvm install 20
nvm use 20

또는 npm 완전 건너뛰고 네이티브 인스톨러 사용.

설치 직후 요청 제한

Pro 플랜인데 1시간 안에 한도 침? 2026년 3월 31일 Anthropic이 공식 인정한 실제 이슈예요. Claude Code 버전 확인:

claude --version

v2.1.100 이상이면 토큰 사용량을 10-20배 부풀리는 버그 보고됨. 커뮤니티 보고 해결법: 공식 패치 나올 때까지 v2.1.34로 다운그레이드.

MCP로 Claude Code 확장

기본이 돌면, 진짜 힘은 MCP (Model Context Protocol) 경유 다른 도구와 연결. MCP가 Claude Code를 “코딩 어시스턴트"에서 “당신 데이터베이스, API, 팀 도구에 직접 접근 가능한 코딩 어시스턴트"로 바꿔요.

현재 MCP 서버 목록:

claude mcp list

새로 추가 (예시 — 데이터베이스 연결):

claude mcp add my-db --command "docker run --rm my-db-mcp:latest"

각 프로젝트에 고유한 .claude/.mcp.json 파일 있을 수 있어요. 그 프로젝트가 쓰는 MCP 서버 목록. 공유 코드베이스는 이 파일 커밋해서 팀 전원이 같은 도구 설정 받아요.

시도해볼 인기 MCP 서버:

• GitHub MCP — Claude Code가 PR 열고, 브랜치 리뷰하고, 이슈 검색
• 데이터베이스 MCP — PostgreSQL, MySQL, MongoDB 직접 쿼리
• Jira/Linear MCP — 이슈 트래커 컨텍스트 가져오기
• Slack/Notion MCP — 팀 도구 연동

OS별 빠른 참고

한국 개발자를 위한 체크리스트

한국 회사에서 업무용으로 쓸 때 확인할 것들:

1. 한국어 프롬프트 잘 돼요. Claude Code는 한국어 자연어 지시에 잘 반응. 한글 주석, 한글 변수명 있는 코드베이스도 문제 없이 이해. OKKY, velog, 개발바닥 뉴스레터 등 국내 개발자 커뮤니티에 사례가 많아요.

2. 기업 사용 체크포인트. 업무 코드를 전송하니까 정보보호팀 확인 필요. Anthropic의 DPA (데이터 처리 계약)는 Team과 Enterprise 플랜에서 제공. Pro와 Max는 개인용 전제니까, 민감한 업무 소스 코드 투입 전에 사내 가이드라인 확인.

3. .claudeignore 활용. .gitignore랑 같은 문법으로 Claude한테 안 보여줄 파일 제외. .env, 비밀키, 민감한 설정은 반드시 넣으세요.

4. Code with Claude 도쿄 2026년 6월 10일. Anthropic 첫 아시아 개발자 컨퍼런스 (샌프란시스코 5/6, 런던 5/19에 이어). 한국 개발자들도 원격 참여 옵션 있을 가능성. 새 기능/새 플랜 발표 예상.

당신한테 뭘 의미하냐

터미널 써본 적 없다면: macOS나 Windows WSL 고수. 터미널은 Claude Code 정체성의 일부예요. 기본 터미널 편안함 없으면 실제로 쓰기 어려움. cd, ls, pwd, git 기본에 30분 투자, 아직 모른다면.

Claude Code 평가 중인 개발자: 5분 만에 설치, 사이드 프로젝트에 겨냥, 실제 작업 줘봐요. Cursor는 더 IDE 같고, Copilot은 더 자동완성 같고, Claude Code는 진짜로 다른 거 — 느껴봐야 이해됨.

팀용으로 설정하는 경우: 공유 레포에 .claude/ 디렉토리 만들고 팀 전체 MCP 설정 포함. 커밋. 새 팀원들은 인스톨러 실행, 인증, 자동으로 팀 도구 설정 상속.

이미 Claude Code 설치했다면: 플러그인과 MCP 생태계가 “Claude Code 사용자"에서 “Claude Code 파워 유저"로 레벨 업하는 곳. FindSkill의 Claude Code Mastery 코스가 Skills, Hooks, MCP 깊게 다뤄요.

결론

Claude Code 설치는 OS에 따라 30초에서 5분. 네이티브 인스톨러 (2026년 4월 기본)는 안정적, 빠름, 의존성 없음.

진짜 학습 곡선은 설치가 아니에요 — 설치 후 Claude Code를 생산적으로 쓰는 법 알아내기. 작은 작업부터 시작, 큰 워크플로로 성장, 실제 필요할 때 MCP 도구 추가. 1일차에 모든 거 설정하려고 하지 마세요.

그리고 구독 예산 잡기. 무료 티어로는 못 가요. Pro $20/월이 진짜 시작점.

다음 단계: FindSkill의 Claude Code Mastery 코스가 첫 설치부터 Skills, Hooks, MCP로 고급 에이전트 패턴까지 전체 워크플로 커버. 이미 설치했다면 Claude Code 요금 가이드로 맞는 구독 티어 고르기.

출처:

• Claude Code 설치 가이드 — NxCode
• Claude Code 초보자 튜토리얼 2026 — NxCode
• 2026 클로드 코드 사용법 — 하이아웃풋클럽
• 고급 설정 — Claude Code Docs (한국어)
• Claude Code 설치 방법 완전 가이드 — LaoZhang AI
• 클로드 코드 가이드 — WikiDocs
• Claude Code 설치/사용법 — rview
• Claude Code GitHub Repository