Claude Code 완전 가이드 · 3 min read
시작하기
Claude Code란 무엇이고, 왜 사용해야 하며, 어떻게 시작하는지 알아봅니다.
Claude Code란?
Anthropic의 Boris Cherny가 이끄는 팀이 만든 CLI 기반 AI 코딩 에이전트입니다. 터미널에서 직접 실행하며, 파일 읽기/쓰기, 코드 검색, 명령 실행, 웹 검색, 브라우저 자동화까지 자율적으로 수행합니다.
왜 Claude Code인가?
| 특성 | Claude Code | Cursor / Copilot |
|---|---|---|
| 실행 환경 | 터미널 (CLI) | IDE 내장 |
| 자율성 | 파일 편집 + 명령 실행 + 웹 검색 | 코드 제안 위주 |
| 확장성 | Commands, Skills, Agents, Hooks, MCP | 플러그인 제한적 |
| 컨텍스트 | 1M 토큰 (전체 코드베이스) | 제한된 파일 수 |
| 멀티 에이전트 | Agent Teams, 서브에이전트, Worktree | 단일 세션 |
| CI/CD 통합 | GitHub Actions 네이티브 | 제한적 |
설치
npm install -g @anthropic-ai/claude-code
claude이 가이드 사용법
- 학습 — 14개 챕터를 순서대로 읽으며 개념 이해
- 체험 — 레포를 클론해서 예제 직접 실행
- 구축 — Ch13의 Scaffold 가이드로 자기 프로젝트에 적용
핵심 개념 14가지
| 기능 | 위치 | 설명 |
|---|---|---|
| CLAUDE.md | 프로젝트 루트 | 영구 컨텍스트 — 매 세션 자동 로드 |
| Rules | .claude/rules/ | 경로별 조건부 규칙 (glob 패턴) |
| Commands | .claude/commands/ | 슬래시로 호출하는 프롬프트 템플릿 |
| Skills | .claude/skills/ | 재사용 가능한 지식/능력 모듈 (Commands의 상위 호환) |
| Sub-Agents | .claude/agents/ | 독립 컨텍스트의 자율 에이전트 |
| Hooks | .claude/settings.json | 이벤트 반응 결정론적 스크립트 |
| MCP Servers | .mcp.json | 외부 도구/API 연결 프로토콜 |
| Settings | .claude/settings.json | 5단계 계층적 설정 시스템 |
| Auto Memory | ~/.claude/projects/ | Claude가 자동 기록하는 학습 메모리 |
| Plugins | 배포 가능 패키지 | Skills, Agents, Hooks 번들 |
| Agent Teams | 내장 기능 | 복수 세션 병렬 협업 |
| Worktrees | git worktree 기반 | 격리된 병렬 실행 환경 |
| Scheduled Tasks | /loop | 반복 작업 예약 (최대 3일) |
| Checkpointing | 자동 (git 기반) | 파일 편집 추적/되감기 |