Claude Code를 처음 써 보려는 사람에게 가장 큰 벽은 도구 자체가 아니다. “터미널에서 시작한다”는 한 줄 때문에 마음이 멈춘다. Cursor나 GitHub Copilot처럼 익숙한 IDE 화면이 아니라 검은 터미널 창에서 출발해야 한다는 사실이 막막함을 만든다. 그런데 막상 깔아 보면 5분이면 끝난다. 이 글은 “어디서부터 시작해야 하지”라는 첫 막막함을 해소하기 위한 한국어 단계별 가이드다.
Claude Code가 정확히 뭔가
Claude Code는 Anthropic이 만든 AI 코딩 에이전트다. 터미널에 자연어로 지시를 입력하면 코드를 작성하고, 버그를 수정하고, Git 커밋까지 알아서 처리한다. 2026년 기준으로 VS Code, JetBrains, 데스크톱 앱, 웹(claude.ai/code)에서도 같은 흐름으로 쓸 수 있다. 즉 “터미널 전용”이라는 인상은 정확하지 않다. 입구가 터미널일 뿐, 본인이 편한 환경을 골라 쓰면 된다.
가격 면에서 결정적인 사실 하나. Claude Code는 Claude Pro($20/월) 이상 구독자라면 추가 비용 없이 그대로 쓸 수 있다. Cursor Pro와 같은 가격이지만 작동 방식이 다르다. Cursor가 코드 완성 중심이라면 Claude Code는 에이전트 방식으로 작업 단위를 통째로 처리한다.
설치 전 준비
- Claude Pro·Max·Teams·Enterprise 구독 (또는 Anthropic Console API 계정)
- 터미널 환경 — Mac은 기본 터미널 또는 iTerm2, Windows는 PowerShell 또는 Git Bash
- Windows 사용자라면 Git for Windows 사전 설치
운영체제별 설치
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell
irm https://claude.ai/install.ps1 | iexmacOS Homebrew
brew install --cask claude-codeHomebrew와 WinGet으로 설치하면 자동 업데이트가 안 된다는 점 한 가지만 기억해 두자. 주기적으로 brew upgrade claude-code나 winget upgrade Anthropic.ClaudeCode를 실행해 최신 버전을 유지한다.
첫 실행과 로그인
설치가 끝나면 작업할 프로젝트 폴더로 이동해 실행한다.
cd /path/to/your/project
claude처음 실행 시 로그인 화면이 나타난다. 브라우저가 자동으로 열리면 Claude 계정으로 로그인하고 끝. 만약 브라우저가 안 열린다면 c 키를 눌러 URL을 복사해 직접 붙여 넣으면 된다. 이 한 번의 로그인이 끝이다. 이후로는 claude만 입력하면 바로 시작된다.
기본 사용법 — 어렵게 생각하지 말 것
Claude Code는 대화 방식으로 작동한다. “어떻게 명령을 써야 하지”를 고민하지 말고, 하고 싶은 걸 평소 말하는 대로 입력하면 된다. 다음은 자주 쓰는 패턴 다섯 가지다.
- 코드 이해: “이 프로젝트가 뭘 하는 건지 설명해 줘”
- 기능 추가: “로그인 폼에 입력값 유효성 검사 추가해 줘”
- 버그 수정: “빈 폼을 제출해도 통과되는 버그가 있어, 수정해 줘”
- Git 커밋: “변경 사항을 설명적인 메시지로 커밋해 줘”
- 테스트 작성: “이 함수에 대한 단위 테스트 작성해 줘”
중요한 안전장치 하나. 파일을 수정하기 전에 항상 사용자의 승인을 요청한다. 모든 변경이 본인의 OK 후에야 적용되기 때문에 마음 편히 시켜도 된다.
알아두면 유용한 명령어
| 명령어 | 기능 |
|---|---|
claude |
대화형 모드 시작 |
claude "작업 내용" |
일회성 작업 실행 |
claude -c |
직전 대화 이어서 시작 |
/clear |
대화 기록 초기화 |
/help |
사용 가능한 명령 전체 보기 |
/doctor |
설치 상태 자가 진단 |
입문 단계에서 가장 자주 쓰게 되는 건 /clear와 /help 두 개다. 막혔을 때 /doctor를 기억해 두면 troubleshooting이 쉬워진다.
그래서 — 5분이면 충분하다
Claude Code는 단순한 코드 완성 도구가 아니다. 프로젝트 전체 맥락을 파악하고, 파일 사이의 연결을 이해하면서 작업한다. 이게 다른 도구와의 가장 큰 차이다. 기존에 Claude Pro를 구독 중인 사람이라면 추가 비용 없이 지금 당장 시작할 수 있다는 점도 결정 비용을 0에 가깝게 만든다. 설치 5분, 첫 대화 1분이면 충분하다.
지금 할 일
위에 정리된 한 줄 명령어로 Claude Code를 5분 안에 설치한다. 이미 진행 중인 프로젝트 폴더로 들어가 claude를 실행한 다음, 첫 질문은 “이 프로젝트 설명해 줘”로 시작해 보자. AI가 본인 코드베이스를 어떻게 이해했는지 한 화면에 드러난다. 그 다음 단계는 평소 미뤄 두고 있던 작은 버그나 기능 추가를 자연어로 시켜 보는 것. 그 한 사이클을 끝내면 Claude Code의 진짜 매력이 손에 잡힌다.
관련 글
- Claude Code /powerup 명령어 완전 가이드: 4월 신기능 인터랙티브 학습
- Kiro vs Cursor vs Claude Code: 2026 AI 코딩툴 3파전 비교
- Claude 작업 공간을 시작하지 못했습니다: 원인과 해결법 총정리