Claude Code 확장 방법 완벽 비교
커스텀 커맨드 vs MCP vs 서브에이전트 vs 클로드 스킬
2026년 3월 기준 · 공식 문서 검증 완료
목차
- 4가지 확장 방법 한눈에 보기
- 커스텀 커맨드 (Custom Commands)
- MCP (Model Context Protocol)
- 서브에이전트 (Subagents)
- 클로드 스킬 (Agent Skills)
- 핵심 비교표
- 메모리 효율성 비교
- 스크립트 실행 효율 비교
- 실무에서 어떤 걸 써야 할까?
- 원본 글 팩트체크 & 수정 사항
4가지 확장 방법 한눈에 보기
Claude Code는 2026년 현재 6가지 이상의 확장 메커니즘을 지원하지만, 핵심은 이 4가지입니다. 각각 해결하는 문제가 다릅니다.
| 커스텀 커맨드 | MCP | 서브에이전트 | 클로드 스킬 | |
|---|---|---|---|---|
| 아이콘 | ⌨️ | 🔌 | 🤖 | 📘 |
| 한 줄 요약 | 프롬프트 단축키 | 외부 시스템 연결 | 전문가 AI 위임 | 지능형 업무 매뉴얼 |
| 비유 | 자주 쓰는 문자 템플릿 | USB 허브에 장비 연결 | 전문가 고용해서 일 맡기기 | 전문가에게 업무 매뉴얼 쥐어주기 |
1. 커스텀 커맨드 (Custom Commands)
자주 쓰는 프롬프트를 /명령어로 저장하는 단축키.
마크다운 파일 하나가 곧 슬래시 명령어입니다. 가장 단순하면서도 즉시 효과가 있는 확장 방법입니다.
📌 2026년 현재: 커맨드 = 스킬로 통합
.claude/commands/deploy.md와.claude/skills/deploy/SKILL.md둘 다/deploy로 작동합니다. 기존 커맨드 파일은 그대로 유지됩니다.
파일 위치
.claude/commands/review.md작성 예시
# 코드 리뷰 커맨드
현재 Git diff를 분석하고 코드 리뷰를 수행하세요.
체크할 항목:
- 로직 에러
- 보안 취약점 (인젝션, XSS)
- 프로젝트 컨벤션 위반
- 누락된 테스트사용법
/review # 기본 실행
/fix-issue 1234 # $ARGUMENTS로 인자 전달핵심 포인트
- 파일 하나 = 명령어 하나. 50ms 이내로 로딩
$ARGUMENTS변수로 동적 파라미터 전달 가능- 팀원 전체가 같은
.claude/commands/디렉토리를 공유 가능
2. MCP (Model Context Protocol)
Claude를 외부 세계에 연결하는 표준 프로토콜.
2024년 11월 Anthropic이 공개한 오픈 표준입니다. MCP 서버는 GitHub, Slack, PostgreSQL 같은 외부 서비스를 Claude가 직접 사용할 수 있는 "도구(tool)"로 변환합니다. Claude가 자연어로 대화하면, 필요한 MCP 도구를 자동으로 선택해서 실행합니다.
설정 예시
// .mcp.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"]
}
}
}핵심 포인트
- 2026년 기준 200개 이상의 커뮤니티 MCP 서버 존재
- TypeScript 또는 Python으로 직접 서버 제작 가능
- MCP Tool Search 기능으로 lazy loading 지원 → 컨텍스트 사용량 최대 95% 절감
- 다양한 MCP 지원 플랫폼(Claude.ai, Claude Code, Cursor, VS Code 등)에서 범용적으로 사용 가능
⚠️ 보안 주의: MCP 서버는 파일과 환경변수에 접근할 수 있습니다. 설치 전 반드시 출처를 확인하세요.
3. 서브에이전트 (Subagents)
독립된 컨텍스트 창에서 전문 작업을 수행하는 별도 Claude 인스턴스.
테스트 실행, 문서 읽기, 로그 분석 같은 작업은 대량의 컨텍스트를 소비합니다. 서브에이전트에 위임하면 방대한 출력은 서브에이전트 컨텍스트에 남고, 메인에는 요약만 돌아옵니다.
작업 흐름
메인 Claude → 위임 → [ 🔍 Explore ] → 요약 반환 → 메인 Claude
[ 📋 Plan ]
[ 🛠 범용 ]서브에이전트 정의
<!-- .claude/agents/code-reviewer.md -->
---
name: code-reviewer
description: 코드 변경사항을 리뷰하고 린팅 자동 실행
tools: Read, Grep, Glob
model: sonnet
---
당신은 코드 리뷰 전문가입니다.
변경된 파일을 분석하고 보안, 성능,
가독성 관점에서 피드백하세요.핵심 포인트
- 각 서브에이전트는 독립된 컨텍스트 창에서 작업 (메인 대화 오염 방지)
- 도구 접근 권한을 개별 제한 가능 (최소 권한 원칙)
- 최대 10개 동시 실행 가능 (2026년 기준)
- 빌트인 유형:
Explore(읽기 전용 탐색),Plan(계획 수립),general-purpose(범용) - 서브에이전트끼리는 직접 통신 불가 → 필요하면 Agent Teams 사용
📌 Agent Teams (2026년 2월 출시)
서브에이전트가 "상사에게 보고하는 직원"이라면, Agent Teams는 "서로 소통하는 협업 팀"입니다. 여러 Claude 세션이 메시지를 주고받으며 병렬로 작업합니다. Opus 4.6과 함께 출시되었습니다.
4. 클로드 스킬 (Agent Skills)
지침, 스크립트, 템플릿을 하나의 폴더로 패키지화. Claude가 상황에 맞게 자동으로 참고하는 "업무 매뉴얼".
서브에이전트가 "전문가를 고용하는 것"이라면, 스킬은 "전문가에게 체계적인 업무 매뉴얼을 쥐어주는 것"입니다. 스킬은 무엇을 하라가 아니라 어떻게 하라를 알려줍니다.
스킬 구조
.claude/skills/pdf-processor/
├── SKILL.md # 메인 지침서 (필수)
├── templates/ # Claude가 채울 템플릿
├── examples/ # 기대 출력 예시
├── scripts/ # 실행할 스크립트
└── docs/ # 참고 문서SKILL.md 예시
---
name: pdf-processor
description: PDF에서 텍스트와 표를 추출하고, 폼을 채우고, 문서를 병합. PDF 관련 작업 시 사용.
---# PDF 처리 스킬
## 텍스트 추출
pdfplumber 라이브러리를 사용하세요:
`python scripts/extract.py --input $FILE`
## 폼 채우기
templates/form-template.json 참고...3가지 핵심 특성
① 점진적 로딩 (Progressive Disclosure)
시작 시 이름+설명만 로딩 → 실제 사용 시에만 SKILL.md 읽기 → 필요한 파일만 추가 읽기. 수십~수백 개 스킬을 설치해도 컨텍스트 부담이 거의 없습니다.
② 스크립트 직접 실행
스킬 폴더에 포함된 스크립트를 bash로 직접 실행합니다. 스크립트의 코드는 컨텍스트에 로딩되지 않고, 실행 결과만 토큰을 소비합니다.
③ 크로스 플랫폼 호환
Agent Skills는 오픈 표준으로 공개되어 있으며, 동일한 스킬이 Claude.ai 웹, Claude Code, API에서 수정 없이 작동합니다. Cursor, Gemini CLI 등 다른 AI 도구에서도 SKILL.md 포맷을 지원합니다.
배포 방법 (2026년 기준)
| 대상 | 방법 |
|---|---|
| 개인 | Settings > Capabilities > Skills에서 업로드, 또는 .claude/skills/에 배치 |
| 조직 | 관리자가 워크스페이스 전체에 배포 (자동 업데이트 지원) |
| 플러그인 | claude plugin install 명령으로 마켓플레이스에서 설치 |
핵심 비교표
| 항목 | 커스텀 커맨드 | MCP | 서브에이전트 | 스킬 |
|---|---|---|---|---|
| 한 줄 정의 | 프롬프트 단축키 | 외부 시스템 연결 | 전문가 AI 위임 | 지능형 업무 매뉴얼 |
| 호출 방식 | /명령어 직접 입력 | 자동 (자연어) | 자동 또는 명시적 | 자동 또는 /스킬명 |
| 파일 위치 | .claude/commands/ | .mcp.json | .claude/agents/ | .claude/skills/ |
| 컨텍스트 | 메인 대화 공유 | 메인 대화 공유 | 별도 컨텍스트 | 필요 시에만 로딩 |
| 이식성 | Claude Code만 | MCP 지원 플랫폼 | Claude Code / SDK | 모든 Claude 제품 |
| 외부 도구 접근 | ❌ | ✅ 핵심 기능 | ⚙️ MCP 상속 가능 | ⚙️ 스크립트 통해 |
| 병렬 실행 | ❌ | ❌ | ✅ 최대 10개 | ❌ |
| 난이도 | ⭐ 가장 쉬움 | ⭐⭐⭐ 서버 설정 | ⭐⭐ YAML+프롬프트 | ⭐⭐ 폴더 구조 |
메모리 효율성 비교
전통적 방식 (한 번에 전부 로딩)
[████████] [████████] [████████] [████████] [████████]
도구 A 도구 B 도구 C 도구 D 도구 E
↑ 전부 컨텍스트에 올라감스킬의 점진적 로딩 (필요한 것만)
[▪] [▪] [████████] [▪] [▪]
이름만 이름만 실제 사용! 이름만 이름만
↑ 이것만 컨텍스트에 올라감공식 문서 기반 정보:
- 스킬 설명의 컨텍스트 예산은 컨텍스트 창의 2%로 동적 할당 (폴백 16,000자)
- 스크립트 실행 시 코드 자체는 컨텍스트에 로딩되지 않고 실행 결과만 토큰 소비
- 참조 파일(API 문서, 데이터셋 등)은 실제로 읽히기 전까지 토큰 소비 없음
스크립트 실행 효율 비교
AI가 매번 코드 생성 (전통적 방식)
사용자: "example.com 크롤링해줘"
Claude: [100줄 크롤링 코드 새로 생성] ← 코드 전체가 컨텍스트 소비
[실행 결과] ← 결과도 컨텍스트 소비
→ 비결정적 (매번 약간씩 다른 코드)스킬의 스크립트 직접 실행
사용자: "example.com 크롤링해줘"
Claude: python scripts/crawl.py --url example.com
→ "Success: 100 pages crawled" ← 이것만 컨텍스트 소비
→ 100% 동일한 결과 보장실무 임팩트: 대규모 반복 작업(웹 크롤링, 데이터 변환, 배치 처리)에서 스크립트 실행 방식은 토큰 사용량을 대폭 절감하고, 매번 동일한 결과를 보장합니다.
⚠️ 단, 원본 글의 "100배 절감"이나 "33배 효율" 같은 수치는 공식적으로 검증되지 않은 추정치입니다.
실무에서 어떤 걸 써야 할까?
상황별 선택 가이드
반복 프롬프트가 있다? → 커맨드/스킬
외부 API에 연결해야 한다? → MCP
컨텍스트 보존이 필요하다? → 서브에이전트
팀 전체를 표준화하고 싶다? → 스킬단계적 도입 권장 순서
1️⃣ 스킬 + MCP → 2️⃣ 훅(Hooks) → 3️⃣ 서브에이전트 → 4️⃣ Agent Teams
80% 커버 자동화 컨텍스트 관리 병렬 협업스킬과 MCP만으로도 워크플로의 약 80%를 커버할 수 있습니다. 서브에이전트는 컨텍스트가 무거워질 때, Agent Teams는 병렬 협업이 필요할 때 도입하세요.
원본 글 팩트체크 & 수정 사항
원본 벨로그 글의 내용을 2026년 3월 공식 문서 기준으로 검증한 결과입니다.
🔴 수정 필요
"커스텀 커맨드는 수동, 나머지는 자동"
- 원본: 커스텀 커맨드는 매번 /명령어를 직접 입력해야 한다. MCP/서브에이전트/스킬은 자동으로 작동한다.
- 사실: 2026년 현재 커맨드와 스킬은 통합되었습니다. 커맨드도
description필드를 설정하면 Claude가 자동 호출할 수 있습니다. 반대로 스킬도disable-model-invocation: true를 설정하면 수동 호출만 가능합니다.
"클로드 스킬만 모든 Claude 제품에서 작동"
- 원본: 클로드 스킬은 한 번 만들면 어떤 환경에서도 똑같이 사용할 수 있는 유일한 방법이다.
- 사실: 스킬의 크로스 플랫폼 호환은 사실이지만, MCP도 다양한 플랫폼에서 지원됩니다. "유일한 방법"은 과장입니다. 다만, 스킬은 Agent Skills 오픈 표준으로 공개되어 있어 범용성이 가장 넓은 것은 맞습니다.
🟡 과장 주의
"약 33배 더 효율적" / "100배 토큰 절감"
- 점진적 로딩과 스크립트 실행이 효율적인 것은 공식 문서로 확인됩니다. 하지만 구체적 수치는 Anthropic 공식 문서에 없는 추정치입니다.
- MCP도 MCP Tool Search의 lazy loading으로 컨텍스트 95% 절감이 가능하므로, 스킬만의 고유 장점이라고 보기 어렵습니다.
Hooks와 Plugins 미언급
- 2026년 기준 Claude Code는 최소 6가지 확장 메커니즘을 지원합니다: 스킬, MCP, 서브에이전트, 훅(Hooks), 플러그인(Plugins), Agent Teams.
- 특히 훅은 파일 저장 후 자동 린팅, 커밋 전 테스트 실행 등 자동화에 핵심적이며, 플러그인은 팀 전체의 설정을 하나로 패키징하는 기능입니다.
✅ 정확한 내용
다음 핵심 주장들은 공식 문서로 확인됩니다:
- 스킬의 점진적 로딩 (이름 → SKILL.md → 참조파일 순서)
- 스크립트 실행 시 코드가 아닌 결과만 토큰 소비
- 서브에이전트의 독립 컨텍스트 창
- MCP의 외부 시스템 연결 역할
- Agent Skills가 오픈 표준으로 공개됨
참고 문서
| 문서 | URL |
|---|---|
| Skills 공식 문서 | https://code.claude.com/docs/en/skills |
| Subagents 공식 문서 | https://code.claude.com/docs/en/sub-agents |
| Agent Skills API 문서 | https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview |
| 스킬 작성 모범 사례 | https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices |
| Anthropic Skills 리포 | https://github.com/anthropics/skills |
2026년 3월 26일 작성 · 공식 문서 기반 검증
