Claude Code를 잘 배우는 사람들은 기능을 많이 외우기보다, “지금 내 수준에서 무엇이 가장 큰 체감 효율을 주는가”를 중심으로 순서를 고릅니다. 이 장은 그 순서를 원본 로드맵에 가깝게 되돌린 버전입니다.
🧭 나의 수준 찾기
아래 항목을 솔직하게 체크해 보세요. 정답을 맞히는 시험이 아니라, 어디서 시작해야 시행착오가 적은지 찾는 도구입니다.
- Claude Code를 시작하고 대화를 해본 적이 있다.
- CLAUDE.md 파일을 만들어본 적이 있다.
- 기본 slash command를 3개 이상 써봤다.
- 커스텀 slash command나 skill을 만들어봤다.
- MCP 서버를 설정해본 적이 있다.
- hooks를 ~/.claude/settings.json에 연결해봤다.
- custom subagents를 만들어본 적이 있다.
- print mode(`claude -p`)를 스크립트나 CI/CD에 써봤다.
| 0-2개 | Level 1: Beginner | Milestone 1A에서 시작 | 약 3시간 |
| 3-5개 | Level 2: Intermediate | Milestone 2A에서 시작 | 약 5시간 |
| 6-8개 | Level 3: Advanced | Milestone 3A에서 시작 | 약 5시간 |
팁
잘 모르겠다면 한 단계 낮게 시작하세요. 익숙한 내용을 빠르게 복습하는 편이, 기초를 건너뛰는 것보다 훨씬 낫습니다.
이 로드맵은 의존성, 복잡도, 사용 빈도라는 세 가지 기준을 따라 정렬했습니다. 그래서 가장 먼저 반복 효율이 큰 기능부터 배우고, 그다음 자동화와 통합으로 확장하게 됩니다.
전체 로드맵
| 순서 | 주제 | 난이도 | 시간 | 레벨 | 이유 | 효과 |
|---|---|---|---|---|---|---|
| 1 | Slash Commands | Beginner | 30분 | Level 1 | 빠른 생산성 | 즉시 자동화와 팀 표준화 |
| 2 | Memory | Beginner+ | 45분 | Level 1 | 모든 기능의 바탕 | 문맥 유지와 선호도 저장 |
| 3 | Checkpoints | Intermediate | 45분 | Level 1 | 안전한 탐색 | 복구와 실험 |
| 4 | CLI Basics | Beginner+ | 30분 | Level 1 | 기본 CLI 사용 | interactive / print mode |
| 5 | Skills | Intermediate | 1시간 | Level 2 | 자동화된 전문성 | 재사용 가능한 기능 |
| 6 | Hooks | Intermediate | 1시간 | Level 2 | 워크플로 자동화 | 검증과 품질 게이트 |
| 7 | MCP | Intermediate+ | 1시간 | Level 2 | 실시간 데이터 접근 | API와 외부 연동 |
| 8 | Subagents | Intermediate+ | 1.5시간 | Level 2 | 역할 분리 | 위임과 전문화 |
| 9 | Advanced Features | Advanced | 2~3시간 | Level 3 | 파워 유저 도구 | Planning, Auto Mode, Channels, Voice Dictation, permissions |
| 10 | Plugins | Advanced | 2시간 | Level 3 | 완성된 솔루션 | 온보딩과 배포 |
| 11 | CLI Mastery | Advanced | 1시간 | Level 3 | 명령줄 숙련 | 스크립팅과 CI/CD |
Level 1: Beginner — Getting Started
대상: 체크 0-2개 / 목표: 즉시 생산성, 기본기 이해, Level 2 준비
Milestone 1A: First Commands & Memory
Topics: Slash Commands + Memory / Time: 1-2시간 / Goal: 반복 작업과 문맥 기억을 바로 체험
- custom slash command를 만들어 반복 작업을 줄입니다.
- 프로젝트 memory로 팀 표준을 기억시킵니다.
- 개인 선호도를 저장합니다.
- Claude가 컨텍스트를 자동으로 읽는 흐름을 이해합니다.
Hands-on Exercises
# Exercise 1: 첫 slash command 설치
mkdir -p .claude/commands
cp 01-slash-commands/optimize.md .claude/commands/
# Exercise 2: 프로젝트 memory 만들기
cp 02-memory/project-CLAUDE.md ./CLAUDE.md
# Exercise 3: 직접 실행
# Claude Code에서 /optimize 를 입력합니다.Success Criteria
- /optimize 명령을 실행할 수 있다.
- CLAUDE.md의 기준을 Claude가 기억한다.
- slash command와 memory를 언제 써야 하는지 설명할 수 있다.
다음 단계
- 03. Slash Commands · Memory · Skills를 복습합니다.
- 02. 설치와 첫 세션으로 돌아가 첫 루프를 확인합니다.
- /lesson-quiz slash-commands 또는 /lesson-quiz memory로 체크합니다.
Milestone 1B: Safe Exploration
Topics: Checkpoints + CLI Basics / Goal: 안전한 실험과 핵심 CLI 익히기
# checkpoint 흐름
# Esc+Esc 또는 /rewind로 checkpoint 복귀를 연습합니다.
# interactive vs print mode
claude "explain this project"
claude -p "explain this function"
# file piping
cat error.log | claude -p "explain this error"- checkpoint로 되돌아가는 흐름을 익힙니다.
- interactive와 print mode의 차이를 체험합니다.
- 파일을 piping 해서 분석하는 방법을 익힙니다.
Level 2: Intermediate — Building Workflows
대상: 체크 3-5개 / 목표: 자동화, 통합, 위임
Milestone 2A: Automation (Skills + Hooks)
# skill 설치
cp -r 03-skills/code-review ~/.claude/skills/
# hooks 설치
mkdir -p ~/.claude/hooks
cp 06-hooks/pre-tool-check.sh ~/.claude/hooks/
chmod +x ~/.claude/hooks/pre-tool-check.sh- skill auto-invocation과 hook event trigger의 차이를 이해합니다.
- PreToolUse 같은 hook을 실제로 연결해 봅니다.
- 반복되는 품질 검사를 자동화하는 흐름을 만듭니다.
Milestone 2B: Integration (MCP + Subagents)
# GitHub MCP
export GITHUB_TOKEN="your_github_token"
claude mcp add github -- npx -y @modelcontextprotocol/server-github
# subagents 설치
mkdir -p .claude/agents
cp 04-subagents/*.md .claude/agents/- GitHub나 DB 같은 외부 데이터를 불러오는 방법을 배웁니다.
- 복잡한 작업을 전문 서브에이전트에게 위임합니다.
- MCP, subagents, hooks를 한 워크플로로 묶어 봅니다.
Level 3: Advanced — Power User & Team Lead
대상: 체크 6-8개 / 목표: 팀 툴링, CI/CD, plugin, 고급 기능
Milestone 3A: Advanced Features
# planning mode
/plan Implement user authentication system
# permission modes
claude --permission-mode plan "analyze this codebase"
claude --permission-mode auto "implement the feature"
# extended thinking
# Alt+T / Option+T로 전환합니다.- planning mode와 extended thinking을 사용합니다.
- permission mode를 상황에 맞게 고릅니다.
- auto mode, background tasks, channels, voice dictation 같은 고급 기능을 체험합니다.
Milestone 3B: Team & Distribution (Plugins + CLI Mastery)
# plugin 설치
/plugin install pr-review
# print mode와 JSON 출력
claude -p --output-format json "list all functions"
# session resume
claude -r "feature-auth" "continue implementation"- plugin으로 commands, agents, MCP, hooks를 묶습니다.
- print mode를 CI/CD에 연결합니다.
- JSON output과 batch processing을 활용합니다.
이 책을 한 번 읽은 뒤 다음에 할 일
- 반복하는 작업 2~3개를 골라 slash commands나 memory로 바꿔 봅니다.
- 문제가 넓고 역할이 갈리는 장면에서만 subagents를 써 봅니다.
- 외부 도구가 정말 필요할 때만 MCP나 hooks를 붙여 확장합니다.
Quick start paths
| 15분 | slash command 하나를 복사해 `/optimize`를 실행합니다. |
| 1시간 | slash commands, memory, skill을 한 번씩 붙여봅니다. |
| 주말 | Level 1 → Level 2 → Level 3 순서로 한 번 쭉 돌아봅니다. |
추천 완료 기준
“모든 기능을 다 안다”가 아니라, 어떤 문제에서 어떤 층을 써야 하는지 설명할 수 있으면 첫 학습은 성공입니다.
원본 출발점은 luongnv89/claude-howto이며, 원본의 자가진단·실습·로드맵 구조를 한국어 학습 북에 맞게 최대한 보존했습니다.