🔍 Claude Code — Skills vs 다른 커스터마이징 옵션

🔍 Claude Code — Skills vs 다른 커스터마이징 옵션 비교

📌 이 글의 핵심 요약

• CLAUDE.md는 매 대화에 항상 로드 → 프로젝트 전체 표준에 적합
• Skills는 요청에 따라 로드 → 특정 작업의 전문 지식에 적합
• Subagents는 독립된 실행 컨텍스트 → 위임 작업에 적합
• Hooks는 이벤트 기반(파일 저장, 툴 호출 시 실행) → 자동화 사이드이펙트에 적합
• MCP Servers는 외부 툴·통합 제공 → Skills와는 완전히 다른 범주

1. 5가지 옵션 한눈에 보기

Claude Code는 총 5가지 커스터마이징 방법을 제공합니다. 각각 다른 문제를 해결하도록 설계되어 있으며, 잘못 선택하면 불필요한 복잡성이 생깁니다.

🎯

Skills

요청과 매칭될 때만 로드되는 작업별 전문 지식 파일

📋

CLAUDE.md

모든 대화에 항상 로드되는 프로젝트 전체 설정 파일

🤖

Subagents

독립된 컨텍스트에서 작업을 수행하고 결과를 반환하는 분리된 실행 단위

⚡

Hooks

파일 저장, 툴 호출 등 특정 이벤트 발생 시 자동으로 실행되는 트리거

🔌

MCP Servers

외부 툴과 서비스를 Claude에 연결하는 별도 카테고리. Skills와는 성격이 다른 통합 레이어입니다.

각 옵션은 서로 경쟁 관계가 아니라 보완 관계입니다. 하나에 모든 것을 몰아넣지 말고, 상황에 맞는 옵션을 조합해 사용하세요.

---

2. Skills vs. CLAUDE.md

가장 자주 혼동되는 조합입니다. 핵심 차이는 "항상 적용"이냐 "필요할 때만 적용"이냐입니다.

📋 CLAUDE.md vs 🎯 Skills

CLAUDE.md 이럴 때 사용

• TypeScript strict 모드처럼 항상 적용되어야 하는 설정
• "DB 스키마는 절대 수정하지 말 것" 같은 프로젝트 제약
• 팀 전체가 공유해야 하는 프레임워크 선호도, 코딩 스타일

Skills 이럴 때 사용

• PR 리뷰 체크리스트처럼 특정 작업에만 필요한 지식
• 항상 올라가 있으면 대화를 복잡하게 만드는 상세 절차
• 작업마다 다른 전문 지식이 필요한 경우

💬 코드를 새로 작성하는 동안엔 PR 리뷰 체크리스트가 필요 없습니다. Skills는 리뷰 요청이 들어올 때만 로드됩니다. — CLAUDE.md와 달리 컨텍스트를 낭비하지 않습니다.

구분	CLAUDE.md	Skills
로드 시점	모든 대화 시작 시 항상	요청과 매칭될 때만
컨텍스트 영향	항상 자리 차지	필요할 때만 추가
적합한 내용	프로젝트 전반 표준	작업별 전문 지식

---

3. Skills vs. Subagents

두 옵션 모두 Claude의 능력을 확장하지만, 컨텍스트를 공유하느냐 분리하느냐가 결정적 차이입니다.

🤖 Subagents vs 🎯 Skills

Subagents 이럴 때 사용

• 현재 대화와 분리된 컨텍스트에서 작업을 위임하고 싶을 때
• 메인 대화와 다른 툴 접근 권한이 필요한 경우
• 위임 작업과 메인 컨텍스트 간의 격리가 필요한 경우

Skills 이럴 때 사용

• 현재 대화의 같은 컨텍스트 안에서 지식을 추가할 때
• 대화 전반에 걸쳐 전문 지식이 계속 유효한 경우
• 메인 흐름을 유지하면서 특정 가이드라인을 적용할 때

🔑 Skills는 지식을 현재 대화에 추가하고, Subagents는 작업을 별도 환경에서 독립 실행한 뒤 결과만 반환합니다.

---

4. Skills vs. Hooks

둘 다 자동으로 동작하지만, 무엇이 트리거를 당기느냐가 다릅니다.

🎯

Skills

요청 기반
(내가 무엇을 물어보는가)

⚡

Hooks

이벤트 기반
(파일 저장, 툴 호출 등)

📋

CLAUDE.md

항상 On
(대화 시작 시 자동 로드)

🤖

Subagents

명시적 위임
(Claude가 직접 호출)

⚡ Hooks vs 🎯 Skills

Hooks 이럴 때 사용

• 파일 저장 시 매번 자동으로 린터 실행
• 특정 툴 호출 전 자동 검증
• Claude 행동의 자동화된 사이드이펙트 처리

Skills 이럴 때 사용

• 요청 처리 방식에 영향을 주는 가이드라인
• Claude의 추론 방식을 안내하는 지식
• 무엇을 할지에 대한 전문적 절차

🔑 Hooks는 "언제(When)" 자동 실행되고, Skills는 "무엇을(What)" 물어볼 때 활성화됩니다.

---

5. MCP Servers — 완전히 다른 범주

MCP(Model Context Protocol) Servers는 Skills와 자주 비교되지만, 사실 완전히 다른 레이어입니다. Skills가 Claude에게 "어떻게 할지 알려주는" 지식이라면, MCP는 Claude가 사용할 수 있는 외부 툴과 통합 자체를 제공합니다.

구분	Skills	MCP Servers
역할	작업 수행 방법을 알려주는 지식	외부 툴·API·서비스 연결
예시	PR 리뷰 방법, 커밋 메시지 형식	GitHub API, Slack, DB 연결
관계	Claude의 지식 확장	Claude의 행동 범위 확장

MCP Servers와 Skills는 함께 사용할 수 있습니다. 예를 들어 GitHub MCP로 PR 데이터를 가져오고, code-review Skills로 리뷰 방법을 적용하는 식으로 조합할 수 있습니다.

---

6. 실제 프로젝트에서의 조합 예시

5가지 옵션은 서로를 대체하는 것이 아니라 각자의 역할로 함께 사용됩니다. 전형적인 팀 개발 환경은 다음과 같이 구성할 수 있습니다.

CLAUDE.md

프로젝트 전체 표준 (항상 On) TypeScript strict 모드, 코딩 스타일, "DB 스키마 수정 금지" 등 모든 작업에 적용되어야 하는 규칙

Skills

작업별 전문 지식 (필요할 때만 On) PR 리뷰 체크리스트, 커밋 메시지 형식, 테스트 작성 가이드 등 특정 상황에만 필요한 절차

Hooks

자동화 이벤트 처리 파일 저장 시 자동 린트 실행, 특정 툴 호출 전 입력값 검증

Subagents

격리된 위임 작업 메인 대화와 분리된 컨텍스트에서 독립적으로 처리해야 하는 작업

MCP Servers

외부 툴 & 통합 GitHub, Slack, DB 등 외부 서비스와의 연결 및 데이터 교환

Skills를 사용해야 할 상황: Claude가 특정 주제와 관련될 때 자동으로 적용해야 하는 지식이 있다면 Skills가 정답입니다. 나머지는 각 옵션이 더 잘 처리합니다.

한 줄 선택 기준 ✨

항상 적용 → CLAUDE.md  |  요청 시 자동 적용 → Skills
이벤트 발생 시 자동 실행 → Hooks  |  별도 컨텍스트 위임 → Subagents
외부 서비스 연결 → MCP Servers

하나에 다 넣으려 하지 말고, 각자의 전문성을 조합하세요 🚀