Claude Code Skills, Hooks, Subagents, MCP 언제 뭘 써야 할까

Claude Code Skills, Hooks, Subagents, MCP 언제 뭘 써야 할까

이 글에서 사용하는 주요 용어 정의

용어	정의
Skill	SKILL.md + 보조 스크립트로 구성된, 특정 작업 지식을 담은 폴더 단위 지침
Hook	특정 이벤트 시점에 자동 실행되는 셸 명령(규칙 강제용)
Subagent	독립된 컨텍스트·권한을 가지고 병렬로 작업을 처리하는 하위 에이전트
MCP(Model Context Protocol)	에이전트가 외부 도구·데이터에 JSON-RPC로 접근하게 해주는 프로토콜

---

도입

Claude Code를 쓰다 보면 "이건 스킬로 만들어야 하나, 서브에이전트로 시켜야 하나" 헷갈리는 순간이 옵니다. 네 가지 개념(Skills, Hooks, Subagents, MCP)이 서로 겹쳐 보이지만, 실제로는 에이전트가 무엇을 보고 무엇을 할 수 있는지를 각각 다른 층위에서 바꿔주는 도구입니다. 오늘은 이 네 가지를 언제 골라 써야 하는지 기준을 정리해보겠습니다.

---

네 가지 개념, 뭐가 다른가

[메모리]  기본 지식 · 항상 로드됨
   │
[Skills]  필요할 때만 불러오는 "지식" 묶음 (SKILL.md)
   │
[Hooks]   이벤트 시점마다 "규칙"을 코드로 강제
   │
[Subagents] 독립 컨텍스트로 "작업"을 병렬 위임
   │
[MCP]     외부 도구·데이터에 실제로 "행동"하는 통로

핵심은 Skills는 지식(knowledge), MCP는 행동(action)이라는 구분입니다. Skills는 Claude가 읽고 참고하는 마크다운 지침이고, MCP 서버는 실제로 호출되어 무언가를 수행하는 프로세스입니다.

---

핵심 내용

언제 무엇을 쓸까

상황	선택
반복되는 프롬프트 템플릿이 필요할 때	슬래시 커맨드
도메인 지식이나 보조 파일이 필요한 실제 작업	Skill
특정 규칙을 무조건 강제해야 할 때	Hook
독립적으로 병렬 처리 가능한 작업(리서치, 리뷰 등)	Subagent
외부 서비스(DB, API, 사내 시스템)에 실제로 접근해야 할 때	MCP

Subagent 예시 — 병렬 리서치 위임

# 메인 에이전트가 서브에이전트에게 독립 작업을 위임하는 흐름 예시
"보안 취약점 스캔은 security-reviewer 서브에이전트에게 맡기고,
 나는 계속 기능 구현을 진행해줘"

각 서브에이전트는 자기만의 컨텍스트 창, 프롬프트, 도구 권한을 가지므로 메인 에이전트의 컨텍스트를 소모하지 않고 큰 작업을 쪼갤 수 있습니다.

MCP 연결 예시

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

MCP 서버를 등록하면 Claude Code가 GitHub 이슈 조회, PR 생성 같은 실제 행동을 API 호출로 수행할 수 있게 됩니다.

네 가지를 함께 쓰는 예시 조합

• Skill: "PR 리뷰 체크리스트" 지식을 담아둔다
• Subagent: 리뷰 작업 자체를 별도 에이전트에게 위임한다
• MCP: GitHub API로 실제 PR 코멘트를 남긴다
• Hook: 리뷰 완료 후 자동으로 Slack 알림 스크립트를 실행한다

---

마무리

네 가지는 경쟁 관계가 아니라 층위가 다른 도구입니다. "지식이 필요하면 Skill, 규칙을 강제하려면 Hook, 작업을 나누려면 Subagent, 실제 행동이 필요하면 MCP"라는 기준만 기억해두면 헷갈릴 일이 크게 줄어듭니다.

---

참고 자료

• Developers Digest - Claude Code Agent Teams, Subagents, and MCP: 2026 Playbook
• Totalum Blog - Claude Code Skills in 2026