Skill·서브에이전트·훅 — 언제 무엇이 필요한가
세 가지 다 "Claude Code를 확장하는 것"인데 역할이 다릅니다. 절차는 Skill, 조사는 서브에이전트, 강제는 훅. 첫 서비스에서 실제로 쓰는 건 하나뿐입니다.
Claude Code 문서를 보면 Skill, 서브에이전트, 훅, 플러그인, MCP가 줄줄이 나옵니다. 다 알아야 할 것 같지만, 첫 서비스에서 실제로 쓰는 건 Skill 하나입니다. 나머지는 이름과 "언제 필요한지"만 알아 두면 됩니다.
한 장으로
| 무엇 | 언제 켜지나 | 비유 | |
|---|---|---|---|
| CLAUDE.md | 이 폴더의 규칙 | 항상 (대화 시작마다) | 신입 매뉴얼 한 장 |
| Skill | 일 하나의 레시피 | 필요할 때 (자동 또는 /이름) | 업무 인수인계서 |
| 서브에이전트 | 조사를 맡길 별도의 Claude | 시킬 때 | 자료 조사 나간 인턴 |
| 훅 | 특정 순간 무조건 실행되는 명령 | 그 순간마다 | 출입문 자동 잠금 |
| 플러그인 | 위 것들의 묶음 설치 | 설치할 때 | 앱 스토어 |
| MCP | 바깥 도구 연결 규격 | 연결하면 | 새 앱 설치 |
Skill — 절차
"주간보고 써줘", "홍보 글 써줘"처럼 순서와 양식이 정해진 반복 업무를 파일로 만든 것. .claude/skills/이름/SKILL.md에 두면 /이름으로 부르고, 설명이 맞으면 Claude가 알아서 꺼내 씁니다. 내가 부를 때만 켜지게 하려면 파일 맨 위에 disable-model-invocation: true 한 줄.
첫 서비스에서 실제로 만드는 것: 내 업무 Skill 1개(2주차), 마케팅 Skill 1개(4주차). 이게 전부이고, 이걸로 충분합니다.
서브에이전트 — 조사
Claude Code가 필요하면 별도의 Claude를 띄워 조사를 맡깁니다. 파일을 수십 개 읽어야 하는 탐색을 본 대화 밖에서 하니 내 대화창의 기억 공간이 안 찹니다. 결과는 요약만 돌아옵니다.
- 부르는 법: "서브에이전트를 써서 이 폴더 구조를 조사해줘"
- 기본으로 들어 있는 것: Explore(읽기 전용 탐색), Plan(계획), General-purpose(범용)
- 내 것 만들기:
.claude/agents/이름.md에 역할과 쓸 도구를 적음. "보안 점검만 하는 서브에이전트를 만들어줘"라고 시키면 Claude가 씁니다
언제 필요한가: 파일이 수십 개로 늘고 "이거 어디 있지?"를 자주 묻게 될 때. 한 페이지 서비스에서는 거의 안 씁니다. 공식 가이드가 권하는 용도 하나 더 — 만든 걸 다른 Claude에게 검토시키기. "서브에이전트로 이 수정이 기획.md와 맞는지 검토해줘." 만든 사람과 검사하는 사람이 다르면 빈틈이 보입니다.
훅 — 강제
CLAUDE.md의 규칙은 참고입니다. Claude가 잊을 수 있습니다. 훅은 특정 순간에 무조건 실행되는 명령입니다. Claude의 판단과 무관하게 돕니다.
- 파일을 고친 뒤 자동으로 정리 도구 돌리기
- 작업이 끝나면 알림음
- 특정 폴더는 절대 못 고치게 막기
- 올리기(push) 전에 비밀 키 검사
순간의 이름: PreToolUse(도구 쓰기 전), PostToolUse(도구 쓴 뒤), Stop(답변 끝), Notification(승인 대기), SessionStart(대화 시작). .claude/settings.json에 적는데, 직접 쓸 필요는 없습니다. "파일을 고칠 때마다 ○○를 실행하는 훅을 만들어줘"라고 시키면 됩니다. /hooks로 무엇이 걸려 있는지 봅니다.
언제 필요한가: "CLAUDE.md에 적었는데도 자꾸 안 지킨다"가 두 번 넘게 반복될 때. 그 전에는 CLAUDE.md를 줄이는 게 먼저입니다. 훅은 편하지만 잘못 걸면 매번 불필요한 일이 돌아갑니다. 필요가 생길 때 하나씩.
플러그인 — 묶음
Skill·훅·서브에이전트·MCP를 한 묶음으로 나눠 주는 것. /plugin으로 마켓을 열어 설치합니다. 화면 디자인을 도와주는 플러그인처럼 유용한 것이 있습니다. 다만 남이 만든 Skill은 프로그램 설치처럼 다룹니다. 믿을 수 있는 출처만, SKILL.md부터 읽고.
언제 무엇을 — 불편 기준
| 불편 | 먼저 | 그다음 |
|---|---|---|
| 같은 말을 매번 한다 | CLAUDE.md | Skill |
| 규칙을 자꾸 안 지킨다 | CLAUDE.md 줄이기 | 훅 |
| 파일이 많아 대화가 지저분하다 | /clear · 새 대화 | 서브에이전트 |
| 바깥 도구를 쓰고 싶다 | CLI | MCP |
| 남이 만든 걸 쓰고 싶다 | — | 플러그인 (출처 확인) |
정리
절차는 Skill, 조사는 서브에이전트, 강제는 훅. 첫 서비스에서는 CLAUDE.md 한 장과 Skill 두 개면 끝납니다. 나머지는 불편이 생겼을 때 표를 보고 하나씩 더합니다. 도구를 먼저 깔고 쓸 일을 찾지 않습니다.
같이 읽기
- 클로드 요금제 정리 — 무료로 어디까지 되고, Pro는 언제 필요한가무료·Pro·그 위 플랜을 "이 수업 기준"으로 나눴습니다. 결제 타이밍은 정해져 있습니다. 2026년 9월 기준.기초 · 클로드코드
- 클로드 코드란 — 채팅 클로드와 무엇이 다른가말만 하던 Claude에게 손이 생깁니다. 내 컴퓨터 폴더 안에서 파일을 직접 만들고 고치는 Claude. 채팅과 언제 무엇을 쓰는지.클로드코드
- 클로드 코드 설치 — VS Code 확장·데스크톱 앱·터미널, 세 가지 길처음 하는 분에게는 VS Code 확장을 권합니다. 이유와 순서, 윈도우에서 먼저 밟아 본 함정까지. 2026년 9월 공식 문서 기준.클로드코드