5.6 Claude Code 핵심 용어 정리
Claude Code를 효과적으로 사용하려면 주요 개념과 용어를 이해해야 합니다. 개발자가 아니어도 알아두면 소통이 훨씬 수월해집니다.
Claude Code 구조 한눈에 보기
graph TD
A[사용자] -->|자연어 지시| B[Claude Code CLI]
B --> C{어떤 작업?}
C -->|파일 읽기/쓰기| D[Read / Write / Edit 도구]
C -->|명령 실행| E[Bash 도구]
C -->|코드 검색| F[Grep / Glob 도구]
C -->|복잡한 작업| G[Sub-Agent 위임]
C -->|확장 기능| H[MCP 서버]
C -->|자동화| I[Hooks]
B --> J[CLAUDE.md\n프로젝트 설정]
B --> K[Skills\n슬래시 명령어]
style A fill:#4a9eff,color:#fff
style B fill:#ff9800,color:#fff
style G fill:#9c27b0,color:#fff
style H fill:#4caf50,color:#fff
핵심 용어 — 기본 개념
| 용어 | 의미 | 비유 |
|---|---|---|
| CLI (Command Line Interface) | 텍스트 기반 명령어 인터페이스. Claude Code는 터미널에서 실행됩니다 | 카카오톡 채팅방처럼 텍스트로 대화하는 창 |
| CLAUDE.md | 프로젝트 루트에 두는 설정 파일. Claude Code가 프로젝트를 이해하는 "매뉴얼" | 신입사원에게 주는 팀 온보딩 문서 |
| 컨텍스트 (Context) | Claude가 현재 대화에서 기억하고 있는 전체 정보 | 회의 중 지금까지 나온 모든 대화 내용 |
| Tool (도구) | Claude가 파일 읽기, 코드 실행 등 실제 작업을 수행하는 기능 | 비서가 사용하는 업무 도구 (엑셀, 이메일 등) |
| Permission (권한) | Claude가 파일 수정, 명령 실행 등을 할 때 사용자 승인을 받는 체계 | 결재 시스템 — 중요한 건 승인 후 진행 |
핵심 용어 — 고급 기능
| 용어 | 의미 | 알아야 하는 이유 |
|---|---|---|
| Skill (스킬) | /commit, /review 같은 슬래시 명령어. 복잡한 작업을 한 줄로 실행하는 매크로 |
반복 작업을 자동화하여 생산성 향상. 커스텀 스킬도 만들 수 있음 |
| Sub-Agent (서브에이전트) | 복잡한 작업을 처리하기 위해 Claude가 "분신"을 만들어 병렬로 작업을 분배하는 기능 | 팀장이 팀원에게 업무를 분배하는 것과 동일. 큰 작업을 빠르게 처리 |
| Hooks (훅) | 특정 이벤트(파일 저장, 도구 실행 등) 발생 시 자동으로 실행되는 스크립트 | 자동화 트리거 — "코드 수정 시 자동 포맷팅" 같은 규칙 설정 |
| Tool Use (Function Calling) | AI가 텍스트 생성 외에 외부 도구를 직접 호출하는 기능. MCP 서버의 도구들을 실제로 실행하는 메커니즘 | AI가 "말"에서 "행동"으로 진화하는 기반 기술. 에이전트 AI의 필수 요소 |
| MCP (Model Context Protocol) | Claude가 외부 도구(DB, API, 브라우저 등)에 접근할 수 있게 하는 표준 프로토콜. USB 규격처럼 하나의 표준으로 다양한 도구 연결 | AI가 사내 시스템과 연동되는 핵심 기술. 어떤 MCP 서버를 붙이느냐에 따라 AI 능력이 달라짐 |
| MCP 서버 | MCP 규격에 맞춰 특정 기능을 제공하는 플러그인. 예: Gmail 서버(메일 읽기/쓰기), DB 서버(데이터 조회), 브라우저 서버(웹 탐색) | 필요한 기능에 맞는 MCP 서버를 선택·조합하는 것이 AI 제품 기획의 핵심 판단 포인트 |
| Plan Mode (계획 모드) | 코드를 바로 작성하지 않고, 먼저 계획을 세우고 사용자 승인 후 실행하는 모드 | PM의 기획 → 리뷰 → 실행 프로세스와 동일 |
Sub-Agent 동작 방식
graph TD
A["사용자: '5개 페이지를\n모두 만들어줘'"] --> B[Claude Code\nMain Agent]
B --> C["Sub-Agent 1\nindex.html 생성"]
B --> D["Sub-Agent 2\nmodule2.html 생성"]
B --> E["Sub-Agent 3\nmodule3.html 생성"]
B --> F["Sub-Agent 4\nmodule4.html 생성"]
C --> G[결과 취합]
D --> G
E --> G
F --> G
G --> H["완료 보고\n'4개 파일 생성 완료'"]
style A fill:#4a9eff,color:#fff
style B fill:#ff9800,color:#fff
style G fill:#4caf50,color:#fff
Hooks 활용 예시
graph LR
subgraph 이벤트["트리거 이벤트"]
E1["파일 저장"]
E2["도구 실행 전"]
E3["세션 시작"]
end
subgraph 훅["자동 실행 (Hooks)"]
H1["코드 포맷팅"]
H2["보안 검사"]
H3["프로젝트 설정 로드"]
end
E1 --> H1
E2 --> H2
E3 --> H3
// .claude/settings.json — Hooks 설정 예시
{
"hooks": {
"PostToolUse": [{
"matcher": "Write|Edit",
"command": "echo '파일이 수정되었습니다'"
}],
"SessionStart": [{
"command": "echo '세션을 시작합니다'"
}]
}
}
PM 포인트: Hooks는 품질 관리 자동화에 유용합니다. 예를 들어 "코드 수정 시 자동으로 린트 검사" 같은 규칙을 설정하면, AI가 만든 코드의 품질을 자동으로 관리할 수 있습니다.
5.7 유용한 Claude Code 스킬 & 활용법
Claude Code의 슬래시 명령어(Skill)를 활용하면 복잡한 작업을 한 줄로 처리할 수 있습니다. PM이 실무에서 바로 쓸 수 있는 핵심 스킬을 소개합니다.
필수 내장 스킬
| 스킬 | 기능 | PM 활용 시나리오 |
|---|---|---|
/help |
도움말 표시 | 모르는 기능이 있을 때 바로 확인 |
/clear |
대화 초기화 | 새로운 작업 시작 시 컨텍스트 리셋 |
/compact |
대화 내용 압축 | 긴 작업 중 컨텍스트가 부족할 때 |
/cost |
현재 세션 비용 확인 | API 사용량 모니터링 |
생산성 향상 스킬
| 스킬 | 기능 | 사용 예시 |
|---|---|---|
/commit |
Git 커밋 메시지 자동 생성 + 커밋 | 코드 변경 후 "이 변경사항을 커밋해줘" 대신 한 줄로 처리 |
/review |
PR(Pull Request) 코드 리뷰 | 다른 팀원의 코드를 AI가 먼저 검토 |
/simplify |
코드 간소화 및 품질 개선 | 복잡해진 코드를 깔끔하게 정리 |
PDCA 스킬 — 체계적 개발 사이클 관리
PDCA(Plan-Do-Check-Act) 스킬은 설계부터 검증까지 전체 개발 사이클을 한 줄 명령으로 관리하는 강력한 워크플로우 자동화 도구입니다.
| 스킬 | PDCA 단계 | 기능 | 실무 활용 시나리오 |
|---|---|---|---|
/pdca plan {기능명} |
Plan (계획) | 기능 목록, 우선순위, 구현 전략이 담긴 계획 문서 자동 생성 | 새 기능 기획 시 PRD 초안을 빠르게 작성 |
/pdca design {기능명} |
Plan (설계) | 데이터 구조, 화면 구성, API 설계가 담긴 설계 문서 생성 | 개발팀에 전달할 상세 설계서 자동 작성 |
/pdca do {기능명} |
Do (실행) | 설계 문서를 기반으로 실제 코드 구현 시작 | 설계서대로 프로토타입을 자동 생성 |
/pdca analyze {기능명} |
Check (검증) | 설계-구현 일치율(Gap) 자동 분석, Match Rate 계산 | 구현 결과가 설계서대로인지 자동 검증 |
/pdca iterate {기능명} |
Act (개선) | Gap이 90% 미만이면 자동 수정 → 재분석 반복 (최대 5회) | 품질 미달 시 자동 수정 루프 실행 |
/pdca report {기능명} |
보고 | 전체 PDCA 사이클 결과를 종합 보고서로 생성 | 프로젝트 완료 보고서 자동 작성 |
/pdca status |
상태 확인 | 현재 PDCA 진행 상황과 Match Rate 표시 | 프로젝트 진행률을 한눈에 확인 |
graph LR
A["/pdca plan\n계획 수립"] --> B["/pdca design\n상세 설계"]
B --> C["/pdca do\n구현"]
C --> D["/pdca analyze\nGap 분석"]
D --> E{"Match Rate\n≥ 90%?"}
E -->|"No"| F["/pdca iterate\n자동 개선"]
F --> D
E -->|"Yes"| G["/pdca report\n완료 보고서"]
style A fill:#4a9eff,color:#fff
style C fill:#ff9800,color:#fff
style D fill:#9c27b0,color:#fff
style F fill:#f44336,color:#fff
style G fill:#4caf50,color:#fff
PM 포인트: PDCA 스킬의 핵심 가치는 "설계와 구현의 괴리를 자동으로 잡아내는 것"입니다. PM이 기획한 내용이 실제로 다 구현되었는지, 수동으로 대조할 필요 없이
/pdca analyze 한 줄이면 됩니다. Match Rate가 90% 미만이면 /pdca iterate로 자동 수정까지 가능합니다.
PM 업무별 활용 시나리오
graph TD
A[PM 업무] --> B["📝 문서 작성"]
A --> C["🎨 프로토타입"]
A --> D["📊 데이터 분석"]
A --> E["🔍 코드 이해"]
B --> B1["'PRD 초안을 마크다운으로\n작성해줘'"]
C --> C1["'로그인 페이지를\nHTML로 만들어줘'"]
D --> D1["'이 CSV 파일을\n분석해서 차트 만들어줘'"]
E --> E1["'이 코드가 어떤 기능을\n하는지 설명해줘'"]
style A fill:#4a9eff,color:#fff
style B fill:#ff9800,color:#fff
style C fill:#9c27b0,color:#fff
style D fill:#4caf50,color:#fff
style E fill:#f44336,color:#fff
CLAUDE.md 작성 가이드
프로젝트 루트에 CLAUDE.md 파일을 만들면, Claude Code가 프로젝트를 더 잘 이해합니다.
# CLAUDE.md 예시
## 프로젝트 개요
- 이 프로젝트는 PM 교육용 정적 웹사이트입니다
- HTML + CSS + JS만 사용합니다 (프레임워크 없음)
## 코딩 컨벤션
- 한국어 주석 사용
- CSS는 BEM 네이밍 대신 단순 클래스명 사용
- JavaScript는 ES6+ 문법 사용
## 중요 규칙
- 외부 라이브러리는 CDN으로만 사용 (npm 없음)
- 모든 페이지는 반응형 (모바일 대응 필수)
- 다크모드를 반드시 지원할 것효과적인 바이브 코딩 워크플로우
graph TD
A["1️⃣ CLAUDE.md 작성\n프로젝트 규칙 설정"] --> B["2️⃣ 큰 그림 요청\n'교육 사이트 전체 구조 만들어줘'"]
B --> C["3️⃣ 섹션별 구현\n'모듈1 콘텐츠를 작성해줘'"]
C --> D["4️⃣ 브라우저 확인\n직접 열어서 검증"]
D --> E{"만족?"}
E -->|No| F["5️⃣ 구체적 피드백\n'헤더 색상을 #4A90D9로'"]
F --> D
E -->|Yes| G["6️⃣ /commit\n변경사항 저장"]
G --> H["다음 섹션으로"]
H --> C
style A fill:#4a9eff,color:#fff
style D fill:#ff9800,color:#fff
style G fill:#4caf50,color:#fff
자주 쓰는 프롬프트 패턴
| 상황 | 프롬프트 예시 |
|---|---|
| 새 파일 만들기 | "회원가입 페이지를 module6.html로 만들어줘. 기존 모듈과 같은 스타일로" |
| 디자인 수정 | "사이드바 배경색을 좀 더 진한 남색(#0a1628)으로 바꿔줘" |
| 버그 수정 | "모바일에서 메뉴 버튼을 눌러도 사이드바가 안 열려. 수정해줘" |
| 기능 추가 | "각 모듈 페이지에 학습 진행률 표시 바를 상단에 추가해줘" |
| 코드 이해 | "main.js의 IntersectionObserver 부분이 무슨 역할인지 쉽게 설명해줘" |
| 일괄 수정 | "모든 페이지의 footer 텍스트를 '© 2026 우리팀'으로 바꿔줘" |
실습 과제
Claude Code를 실행하고 다음을 직접 해보세요:
- 프로젝트 폴더에
CLAUDE.md파일 만들기 /help로 사용 가능한 명령어 확인- "간단한 할일 목록 웹페이지를 만들어줘"로 첫 바이브 코딩 체험
- 결과를 보고 3번 이상 피드백으로 개선하기
/cost로 사용량 확인
핵심 요약: 바이브 코딩의 본질은 "완벽한 프롬프트"가 아니라 "빠른 반복"입니다. 대충 시작하고, 결과를 보고, 구체적으로 수정 요청하세요. 3~5회 반복이면 대부분 원하는 결과를 얻을 수 있습니다.
5.8 커뮤니티 스킬 & 확장 생태계
Claude Code는 내장 스킬 외에도 GitHub과 커뮤니티에서 만든 수천 개의 스킬을 설치해 사용할 수 있습니다. 마치 스마트폰의 앱스토어처럼, 필요한 기능을 골라 AI의 능력을 확장하는 방식입니다.
스킬 생태계 구조
graph TD
A[Claude Code 스킬 생태계] --> B["🏢 공식 스킬\nAnthropic 제공"]
A --> C["🌐 커뮤니티 스킬\nGitHub 오픈소스"]
A --> D["🛒 스킬 마켓플레이스\n큐레이션된 목록"]
B --> B1["/commit /review\n/simplify 등"]
C --> C1["GStack\noh-my-claudecode\nSuperpowers"]
D --> D1["awesome-claude-skills\nclaude-skills\nSkillsMP"]
style A fill:#4a9eff,color:#fff
style B fill:#4caf50,color:#fff
style C fill:#ff9800,color:#fff
style D fill:#9c27b0,color:#fff
스킬 vs MCP 서버 — 뭐가 다를까?
둘 다 Claude Code의 기능을 확장하지만, 역할이 다릅니다.
graph TD
A[Claude Code 확장 방법] --> B["🔧 스킬 (Skill)"]
A --> C["🔌 MCP 서버"]
B --> B1["슬래시 명령어로 실행\n예: /commit /review /qa"]
B --> B2["작업 워크플로우 자동화\n'이렇게 일해라' 매크로"]
B --> B3["CLAUDE.md에 추가하거나\n/plugin install로 설치"]
C --> C1["외부 도구를 AI에 연결\n예: Gmail, DB, Slack"]
C --> C2["AI의 접근 가능한\n도구/데이터 확장"]
C --> C3["settings.json에\nMCP 서버로 등록"]
style A fill:#4a9eff,color:#fff
style B fill:#ff9800,color:#fff
style C fill:#9c27b0,color:#fff
| 구분 | 스킬 (Skill) | MCP 서버 |
|---|---|---|
| 비유 | 업무 매뉴얼 / SOP | USB로 연결한 외부 장치 |
| 역할 | "어떻게 일할지" 절차 정의 | "무엇에 접근할지" 능력 확장 |
| 예시 | /commit, /review, /qa | Gmail 서버, DB 서버, 브라우저 서버 |
| 설치 | CLAUDE.md 또는 /plugin install | settings.json에 서버 등록 |
인기 GitHub 스킬 프레임워크 — TOP 3
1. GStack — Garry Tan(Y Combinator CEO)의 Claude Code 스킬팩
23개 이상의 전문 스킬을 역할별(CEO, 디자이너, 엔지니어, QA 등)로 구성한 오픈소스 프레임워크입니다. 소프트웨어 개발의 전체 라이프사이클을 커버합니다.
| 스킬 | 역할 | 기능 |
|---|---|---|
/plan-ceo-review |
CEO/창업자 | 10-star 제품 관점에서 계획을 재검토. 전제를 도전하고 스코프 확장 제안 |
/design-consultation |
디자이너 | 디자인 시스템 제안(타이포그래피, 색상, 레이아웃) + 프리뷰 페이지 생성 |
/ship |
릴리스 매니저 | 테스트 → 리뷰 → 버전 업 → 커밋 → PR 생성 자동화 |
/qa |
QA 엔지니어 | 웹사이트 체계적 테스트 + 버그 발견 시 자동 수정 후 재검증 |
/investigate |
디버거 | 4단계 체계적 디버깅: 조사 → 분석 → 가설 → 수정 |
2. oh-my-claudecode (OMC) — 멀티 에이전트 오케스트레이션 플랫폼
19개 전문 에이전트와 36개 이상의 스킬을 제공합니다. 여러 AI 에이전트가 팀처럼 협업하여 복잡한 작업을 병렬 처리합니다.
| 스킬 | 기능 | 특징 |
|---|---|---|
/autopilot |
아이디어에서 작동하는 코드까지 자율 실행 | 사람 개입 최소화, 전체 워크플로우 자동화 |
/team |
N개 에이전트가 공유 태스크 리스트로 협업 | 팀 프로젝트처럼 역할 분담하여 병렬 작업 |
/deep-interview |
소크라테스식 질문으로 요구사항 구체화 | 모호한 요청을 명확한 스펙으로 변환 |
/ultrawork |
고처리량 병렬 실행 엔진 | 대규모 작업을 동시에 처리하여 속도 극대화 |
3. Superpowers (obra) — 에이전트형 스킬 프레임워크
20개 이상의 실전 검증된 스킬을 제공합니다. 특별한 프롬프트 없이도 상황에 맞는 스킬이 자동으로 활성화됩니다.
| 스킬 | 기능 | 특징 |
|---|---|---|
/brainstorm |
아이디어 브레인스토밍 구조화 | 발산 → 수렴 과정을 체계적으로 진행 |
/write-plan |
구현 계획 수립 | 아이디어를 실행 가능한 단계로 분해 |
/execute-plan |
계획에 따른 자동 구현 | TDD 패턴 내장, 단계별 검증 |
분야별 추천 커뮤니티 스킬
| 분야 | 스킬 | 기능 | PM 활용 포인트 |
|---|---|---|---|
| UI/디자인 | Frontend-Design (공식) | AI 특유의 밋밋한 디자인을 벗어나 개성있는 UI 생성 가이드 | 프로토타입 품질을 크게 높임. 277K+ 설치 |
| 브라우저 자동화 | Playwright / Browse | 웹 브라우저를 자동 조작하여 테스트·데이터 수집 | QA 테스트 자동화, 경쟁사 사이트 분석 |
| 외부 연동 | Composio | 850+ SaaS 도구(Slack, Notion, Google Workspace 등) 연결 | AI가 실제 업무 도구와 직접 상호작용 |
| 보안 | Trail of Bits Security | 코드 취약점 자동 스캔 (CodeQL/Semgrep 활용) | 보안 리뷰 자동화, 출시 전 취약점 점검 |
| 다이어그램 | Excalidraw Generator | 아키텍처 다이어그램을 코드로 자동 생성 | 회의·문서용 시각자료를 빠르게 생성 |
| 데이터 분석 | Valyu | SEC 공시, PubMed, 금융 데이터 등 전문 데이터 소스 접근 | 시장조사, 경쟁 분석에 신뢰할 수 있는 데이터 활용 |
스킬 찾기 — 주요 마켓플레이스 & 디렉토리
| 사이트 | 특징 | 규모 |
|---|---|---|
| awesome-claude-skills GitHub |
커뮤니티 큐레이션 목록. 카테고리별로 정리된 검증된 스킬 모음 | 100+ 스킬 |
| claude-skills GitHub (alirezarezvani) |
9개 도메인(개발, 제품, 마케팅, 컴플라이언스, 재무 등) 233+ 스킬. 11개 AI 플랫폼 호환 | 233+ 스킬 |
| SkillsMP skillsmp.com |
직업별·인기순 필터링 가능한 대규모 스킬 검색 엔진 | 700,000+ 스킬 |
| Anthropic 공식 플러그인 GitHub |
Anthropic이 직접 관리하는 공식 플러그인. 품질과 호환성 보증 | 엄선된 공식 스킬 |
스킬 설치 및 사용법
# 1. GitHub 스킬 프레임워크 설치 (예: GStack)
npm install -g gstack
# 2. 공식 플러그인 설치
/plugin install frontend-design
# 3. 커뮤니티 스킬 추가 (CLAUDE.md에 규칙 추가 방식)
# 프로젝트의 CLAUDE.md 파일에 스킬 내용을 복사하여 사용
# 4. MCP 서버 방식 설치 (settings.json에 추가)
# Claude Code 설정에서 MCP 서버로 등록하여 사용
graph LR
A["스킬이 필요해!"] --> B{"어디서 찾지?"}
B --> C["GitHub에서\n검색"]
B --> D["마켓플레이스에서\n탐색"]
B --> E["공식 플러그인\n확인"]
C --> F["CLAUDE.md에\n규칙 추가"]
D --> F
E --> G["/plugin install\n명령어 실행"]
F --> H["Claude Code에서\n즉시 사용!"]
G --> H
style A fill:#f44336,color:#fff
style H fill:#4caf50,color:#fff
실습 과제
커뮤니티 스킬 생태계를 직접 탐색해보세요:
- GitHub에서
awesome-claude-skills를 검색하여 어떤 스킬이 있는지 둘러보기 - 관심있는 스킬 1개를 선택하여 CLAUDE.md에 규칙으로 추가해보기
- "이 프로젝트에 유용한 Claude Code 스킬을 추천해줘"라고 Claude에게 물어보기
실무자를 위한 핵심 포인트: 스킬 생태계는 빠르게 성장하고 있습니다. 모든 스킬을 알 필요는 없지만, "내 업무에 맞는 스킬을 찾아 설치할 수 있다"는 것 자체가 AI 도구 활용 역량의 핵심입니다. 앱스토어에서 앱을 고르듯, 필요할 때 찾아 쓰면 됩니다.
📎 Claude Code 한국어 가이드: Claude Code의 설치, 설정, 실전 활용법을 한글로 체계적으로 정리한 가이드입니다. 처음 시작하는 분부터 고급 활용까지 참고하세요. → cc101.axwith.com/ko