Claude Code란? 설치부터 실제 활용까지
Anthropic의 에이전틱 코딩 도구 Claude Code의 개념, 운영체제별 설치 방법, 핵심 기능, 요금제를 공식 문서를 기준으로 정리한다.
Claude Code는 Anthropic이 만든 에이전틱(agentic) 코딩 도구로, 코드를 자동완성해주는 수준을 넘어 코드베이스를 직접 읽고, 파일을 수정하고, 명령을 실행하면서 개발 작업을 끝까지 수행한다. 터미널, VS Code·JetBrains 같은 IDE, 데스크톱 앱, 웹 브라우저 등 여러 환경에서 동일하게 사용할 수 있다.
이 글은 Claude Code가 정확히 무엇을 할 수 있는 도구인지, 운영체제별로 어떻게 설치하는지, 그리고 실무에서 어떻게 활용하는지를 Anthropic 공식 문서를 기준으로 정리한다.
Claude Code는 무엇이 다른가
일반적인 AI 코드 자동완성 도구(예: 자동완성 제안, 인라인 편집)와 달리, Claude Code는 작업을 통째로 위임하는 방식으로 쓰인다. “인증 모듈에 대한 테스트를 작성하고, 실행하고, 실패하면 고쳐줘” 같은 문장 하나로 여러 파일을 넘나들며 계획을 세우고, 코드를 작성하고, 검증까지 마치는 식이다. 이런 방식을 “에이전틱(agentic)“이라고 부르는데, AI가 사람의 매 단계 지시 없이도 스스로 판단해 여러 단계를 이어서 수행한다는 뜻이다.
아래는 이 요청 한 문장이 실제로 처리되는 흐름을 단계별로 정리한 것이다. 사람이 매 단계마다 지시하지 않아도, 계획 수립부터 코드 작성·검증·커밋까지 이어서 진행된다.
설치 방법 (운영체제별)
Claude Code는 여러 방식으로 설치할 수 있다. 아래는 Anthropic 공식 문서에 나온 명령어를 그대로 인용한 것이며, 별도로 실행 검증하지는 않았다.
macOS / Linux / WSL (권장):
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:
irm https://claude.ai/install.ps1 | iexWindows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdHomebrew (macOS/Linux):
brew install --cask claude-codeWinGet (Windows):
winget install Anthropic.ClaudeCodeDebian, Fedora, RHEL, Alpine 계열에서는 apt, dnf, apk 패키지 관리자로도 설치할 수 있다. Native Install(위 curl/irm 방식)은 백그라운드에서 자동 업데이트되지만, Homebrew·WinGet 설치는 각각 brew upgrade, winget upgrade 명령을 직접 실행해야 최신 버전을 유지할 수 있다.
처음 실행하기
설치 후에는 프로젝트 폴더로 이동해 claude 명령만 실행하면 된다.
cd your-project
claude첫 실행 시 로그인 화면이 뜬다. 환경변수 ANTHROPIC_API_KEY가 이미 설정되어 있다면 로그인 대신 API 키 사용 여부를 확인하는 화면이 나온다.
터미널 외에도 VS Code·JetBrains 확장 프로그램, 독립 실행형 데스크톱 앱(로그인 후 유료 구독 필요), 웹 브라우저(claude.ai/code)에서도 동일한 기능을 사용할 수 있다.
주요 기능
공식 문서에서 소개하는 핵심 기능은 다음과 같다.
- 반복 작업 자동화: 테스트 작성, lint 오류 수정, 머지 충돌 해결, 의존성 업데이트, 릴리스 노트 작성 등 귀찮지만 꼭 해야 하는 작업을 위임할 수 있다.
- 기능 구현·버그 수정: 원하는 동작을 문장으로 설명하면 접근 방식을 계획하고, 여러 파일에 걸쳐 코드를 작성하고, 동작을 검증한다.
- Git 연동: 변경사항을 스테이징하고, 커밋 메시지를 작성하고, 브랜치를 만들고, Pull Request까지 직접 연다.
- MCP(Model Context Protocol) 연결: Google Drive의 설계 문서를 읽거나, Jira 티켓을 업데이트하거나, Slack 데이터를 가져오는 등 외부 도구와 연결할 수 있는 개방형 표준이다.
- CLAUDE.md와 Skills, Hooks: 프로젝트 루트에
CLAUDE.md파일을 두면 매 세션 시작 시 코딩 규칙·아키텍처 결정 등을 자동으로 읽어들인다. 반복되는 워크플로는/review-pr같은 Skill로 만들어 팀과 공유할 수 있고, 파일 수정 후 자동 포매팅 같은 작업은 Hook으로 연결할 수 있다. - 병렬 에이전트: 하나의 작업을 여러 하위 작업으로 나눠 동시에 처리하는 Subagent를 실행할 수 있고, 여러 세션을 한 화면에서 관리하는 Background Agent 기능도 있다.
- CLI 파이프라인: 유닉스 철학을 따라 로그를 파이프로 넘기거나, CI에서 실행하거나, 다른 도구와 체이닝할 수 있다. 예:
tail -200 app.log | claude -p "이상 징후 있으면 Slack으로 알려줘" - 예약 작업:
/schedule이나 Routines(클라우드에서 실행, 컴퓨터를 꺼도 동작)를 통해 아침 PR 리뷰, 야간 CI 실패 분석 같은 반복 작업을 자동화할 수 있다. - 어디서나 이어서 작업: Remote Control로 휴대폰에서 세션을 이어가거나, 웹에서 시작한 작업을 터미널로
--teleport해오거나, Slack에서@Claude를 멘션해 버그 리포트를 Pull Request로 받을 수 있다.
요금제
Claude Code는 별도 제품이 아니라 Claude 구독 요금제에 포함된 형태로 제공된다.
| 요금제 | 가격 | Claude Code 포함 여부 |
|---|---|---|
| Free | $0/월 | 명시적으로 포함되지 않음 |
| Pro | 연간 $17/월 또는 월간 $20/월 | 포함 |
| Max (5x / 20x) | $100/월부터 | 포함, 사용량 한도 상향 |
| Team | 연간 좌석당 $20/월 또는 월 $25 | 포함 |
| Enterprise | 좌석당 과금 + 사용량 | 포함 |
API 키를 사용한 사용량 기반 과금(Anthropic Console)으로도 이용할 수 있어, 구독 없이 API 비용만 지불하며 사용하는 것도 가능하다.
한계와 주의할 점
- Claude Code는 코드를 실제로 수정·실행할 수 있는 도구이므로, 중요한 작업 전에는 변경 사항을 검토하는 습관이 필요하다. 공식 문서도 diff를 시각적으로 검토할 수 있는 기능(데스크톱 앱, IDE 확장)을 강조한다.
- Free 요금제에서는 Claude Code를 명시적으로 지원하지 않으므로, 사용하려면 최소 Pro 이상 요금제나 API 키가 필요하다.
- 이 글에 소개한 기능·요금제는 2026년 8월 22일 기준이며, Anthropic이 자주 업데이트하는 영역이므로 실제 사용 전 공식 문서에서 최신 내용을 확인하는 것이 좋다.
- Claude Code는 내부적으로 Claude Sonnet 5·Opus 5 같은 모델을 사용하므로, 어떤 모델을 쓰느냐에 따라 속도와 비용이 달라진다. IDE 기반 도구와의 비교는 Claude Code vs Cursor 글에서 다룬다.
결론
Claude Code는 “코드를 대신 짜주는 자동완성”이 아니라 “작업을 통째로 맡길 수 있는 개발 에이전트”에 가깝다. 터미널 한 줄로 시작할 수 있고, 필요에 따라 IDE·데스크톱·웹·모바일까지 이어서 작업할 수 있는 것이 특징이다. 이미 Claude Pro 이상을 구독하고 있다면 별도 비용 없이 바로 설치해 시도해볼 수 있다.