Claude Code 스킬과 MCP, 쓰임새 비교하기
Claude Code에서 업무 절차를 저장하는 스킬, 도구를 연결하는 MCP, 일을 나눠 맡는 보조 AI를 비교합니다. 기능별 역할과 사용 예를 정리했습니다.

Claude Code를 업무에 쓰기 시작한 마케터나 1인 사업자라면 스킬, 서브에이전트, MCP, 훅, 플러그인이라는 이름을 들어 봤을 겁니다. 그런데 무엇이 다른지 몰라 같은 지시문을 매번 붙여 넣고 있지는 않나요?
이 글은 2026년 10월 22일에 확인한 Anthropic 공식 문서로 다섯 가지 확장 방식과 기본 규칙 파일 CLAUDE.md를 비교하고 최소 예시와 도입 순서를 정리합니다.
Claude Code 확장 기능은 무엇이 있고 어떻게 다른가요?
Claude Code 공식 문서(2026년 10월 22일 확인)에 따르면 CLAUDE.md는 상시 규칙, 스킬은 필요할 때 쓰는 절차, MCP(AI가 외부 도구·데이터에 접속하는 표준 연결 방식)는 외부 연결, 서브에이전트는 격리된 작업, 훅은 자동 실행을 맡습니다. 플러그인은 이를 묶어 공유하는 포장 단위입니다.
| 방식 | 무엇을 | 언제 | 어디에 저장 | 예시 |
|---|---|---|---|---|
| CLAUDE.md | 매 세션 읽는 기본 규칙 | 같은 규칙을 두 번 틀릴 때 | ./CLAUDE.md | npm 대신 pnpm 사용 |
| 스킬 | 필요할 때 불러오는 절차 | 같은 절차를 세 번째 붙여 넣을 때 | .claude/skills/이름/SKILL.md | /weekly-report |
| 서브에이전트 | 따로 일하고 요약만 보고 | 다시 안 볼 출력이 대화를 채울 때 | .claude/agents/이름.md | 문서 수십 개 요약 |
| MCP 서버 | 외부 서비스 연결 | 못 보는 데이터를 계속 복사해 올 때 | ~/.claude.json(기본) · .mcp.json(팀 공유 시) | 노션 페이지 읽기 |
| 훅 | 정해진 순간 자동 실행 | 요청 없이도 매번 일어나야 할 때 | .claude/settings.json | 입력 대기 알림 |
| 플러그인 | 위 기능의 설치 꾸러미 | 다른 프로젝트에도 같은 설정이 필요할 때 | .claude-plugin/ 폴더 | /my-plugin:hello |

스킬과 슬래시 명령은 어떻게 만들고 언제 쓰나요?
Claude Code 스킬은 .claude/skills/이름/SKILL.md 파일 하나로 만들며, 2026년 10월 공식 문서 기준 사용자 정의 슬래시 명령(.claude/commands/)도 스킬로 통합됐습니다.
markdown--- name: weekly-report description: 주간 성과 보고서를 정리합니다. 주간 보고나 성과 요약을 요청할 때 사용합니다. --- 이번 주 숫자를 표로 정리하고, 지난주와 달라진 점을 세 줄로 씁니다.
/weekly-report로 부르거나 요청이 description과 맞으면 Claude가 불러오며, 개인용은 ~/.claude/skills/에 둡니다.
세션 시작 때는 이름과 설명만 읽고 본문은 쓸 때 불러옵니다. Agent Skills 문서는 이 비용을 스킬당 약 100토큰(AI가 글을 세는 단위)으로 안내합니다. 가끔 쓰는 긴 절차는 CLAUDE.md보다 스킬이 낫습니다.
다만 설명이 모호하거나 겹치면 엉뚱한 스킬을 부르거나 놓칠 수 있습니다. 본문은 500줄 이하가 권장되고, 메시지 발송처럼 되돌리기 어려운 스킬에는 disable-model-invocation: true를 넣어 직접 부를 때만 실행되게 하세요.
같은 지시를 세 번째 붙여 넣을 때 "방금 순서를 weekly-report 스킬로 저장하고 description 맨 앞에 주간 보고를 넣어 줘"라고 요청하세요. skills 폴더를 처음 만들었다면 /reload-skills로 바로 인식시킵니다.
서브에이전트는 언제 쓰고 어떻게 만드나요?
Claude Code 서브에이전트는 자기만의 컨텍스트(AI가 한 번에 보는 작업 공간)에서 일하고 요약만 돌려주는 보조 AI이며, 정의 파일의 필수 항목은 name과 description 2개뿐입니다.
markdown--- name: doc-summarizer description: 문서를 많이 읽는 조사를 맡아 핵심만 보고합니다 tools: Read, Glob, Grep model: sonnet --- 관련 파일을 읽고 결론과 근거 파일명만 다섯 줄로 보고합니다.
.claude/agents/doc-summarizer.md로 저장하며, tools를 빼면 쓸 수 있는 도구를 모두 물려받고 model로 저렴한 모델을 고르면 비용이 줄어듭니다.
서브에이전트도 자기 토큰을 쓰고 메인 대화와 같은 사용 한도에서 차감됩니다. 맥락을 새로 모으는 시간이 들어 주고받기가 잦은 작업은 메인 대화가 낫습니다. 역할 분담은 에이전트 팀 구성 패턴을 참고하세요.
MCP 서버는 언제 연결하나요?
Claude가 못 보는 노션·데이터베이스·슬랙 데이터를 계속 복사해 붙여 넣고 있다면 MCP 서버를 연결할 때입니다. Claude Code에서는 명령 한 줄로 추가합니다.
bashclaude mcp add --transport http notion https://mcp.notion.com/mcp
로그인이 필요한 서버는 세션에서 /mcp로 인증합니다. 기본은 나만 쓰는 local 범위이고, --scope project로 추가하면 .mcp.json에 저장돼 팀과 공유됩니다.
도구 검색이 기본으로 켜져 있어 평소엔 도구 이름만 싣습니다. 다만 공식 문서는 외부 콘텐츠를 읽는 서버가 프롬프트 주입(문서에 숨긴 악성 지시)에 노출될 수 있다며 신뢰하는 서버만 연결하라고 경고합니다.
훅은 CLAUDE.md 규칙과 무엇이 다른가요?
Claude Code 훅은 정해진 순간마다 Claude의 판단 없이 실행되는 명령이고, CLAUDE.md와 스킬은 Claude가 해석하는 지시입니다. 매번 예외 없이 일어나야 하는 일은 훅으로 만듭니다.
아래 공식 예시를 ~/.claude/settings.json에 넣으면 입력 대기 때 맥 알림이 뜹니다(안 뜨면 시스템 설정의 알림에서 Script Editor를 허용하세요). 윈도우·리눅스 명령은 문서에 있고, 등록은 /hooks로 확인합니다.
json{ "hooks": { "Notification": [{ "matcher": "", "hooks": [{ "type": "command", "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'" }] }] } }
훅은 출력을 돌려줄 때만 컨텍스트를 쓰지만 터미널 명령을 알아야 하고, 판단이 필요한 일은 스킬이 낫습니다. 남이 준 설정은 읽어 보고 넣으세요.
공식 문서는 CLAUDE.md나 스킬에 쓴 .env 수정 금지 같은 문장을 보장이 아닌 요청으로 봅니다. 반드시 막을 일은 도구 실행 직전에 검사하는 PreToolUse 훅으로 차단하세요.
플러그인은 언제 필요한가요?
Claude Code 플러그인은 스킬·서브에이전트·훅·MCP 설정을 묶은 설치 꾸러미로, 혼자 한 프로젝트에서 쓸 때는 필요 없고 같은 설정을 다른 프로젝트나 팀원에게 옮길 때 씁니다.
textmy-plugin/ ├── .claude-plugin/plugin.json ├── skills/hello/SKILL.md ├── agents/reviewer.md ├── hooks/hooks.json └── .mcp.json
plugin.json은 필수 항목 {"name": "my-plugin"}만 있어도 되고, .claude-plugin/ 안에는 이 파일만 둡니다. claude --plugin-dir ./my-plugin으로 시험하면 스킬은 /my-plugin:hello로 불립니다. 남의 플러그인은 /plugin의 Discover 탭에서 설치합니다.
켜 둔 플러그인은 쓰지 않는 세션에서도 설명이 매 턴 컨텍스트를 차지하고, 코드는 내 권한으로 실행됩니다. 설치 전에 검토하고 안 쓰면 꺼 두세요.
무엇부터 시작하면 되나요?
공식 문서는 CLAUDE.md 하나로 시작하고, 위 표의 언제 칸에 옮긴 신호가 보일 때 확장을 하나씩 더하라고 권합니다.
같은 요청을 매일 반복한다면 오늘 CLAUDE.md를 200줄 이하로 정리하고(없다면 /init으로 초안 생성) 스킬 하나를 만들어 보세요. 혼자 한 프로젝트만 다룬다면 플러그인은, 터미널 명령이 낯설다면 알림 외의 훅은 미뤄도 됩니다. 설치가 처음이라면 Claude Code 무료 입문 강의부터 보세요.
자주 묻는 질문
.claude/commands에 만든 명령은 이제 못 쓰나요?
계속 쓸 수 있습니다. .claude/commands/deploy.md와 .claude/skills/deploy/SKILL.md는 똑같이 /deploy를 만들고, 이름이 겹치면 스킬이 우선합니다.
MCP와 스킬 중 하나만 고른다면요?
둘은 하는 일이 다릅니다. MCP는 외부 시스템에 접속하는 도구를, 스킬은 그 도구를 잘 쓰는 방법을 주니 외부 데이터가 필요 없다면 스킬만으로 충분합니다.
공식 문서를 한국어로 볼 수 있나요?
볼 수 있습니다. 이 글이 인용한 Claude Code 문서 6개는 주소의 /en/을 /ko/로 바꾼 한국어판을 2026년 10월 22일에 확인했습니다.
참고 자료
- ▸Anthropic, 「Claude Code 확장하기」(2026-10-22) — https://code.claude.com/docs/ko/features-overview
- ▸Anthropic, 「Claude를 skills로 확장하기」(2026-10-22) — https://code.claude.com/docs/ko/skills
- ▸Anthropic, 「사용자 정의 subagent 만들기」(2026-10-22) — https://code.claude.com/docs/ko/sub-agents
- ▸Anthropic, 「MCP를 통해 Claude Code를 도구에 연결하기」(2026-10-22) — https://code.claude.com/docs/ko/mcp
- ▸Anthropic, 「hooks를 사용하여 작업 자동화」(2026-10-22) — https://code.claude.com/docs/ko/hooks-guide
- ▸Anthropic, 「Claude Code 플러그인 만들기」(2026-10-22) — https://code.claude.com/docs/ko/plugins/create
- ▸Anthropic, 「Agent Skills」(2026-10-22) — https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview
함께 읽으면 좋은 글
Claude 실무 글을 먼저, 그다음 최신 글을 보여 드려요

CLAUDE.md 규칙이 무시될 때, 줄이는 기준과 훅 설정
CLAUDE.md 규칙이 자꾸 무시된다면 파일을 줄이는 기준부터 보세요. 반드시 지킬 규칙을 훅으로 옮기고, 훅이 실패할 때 통과되지 않게 설정하세요.

클로드 코드 대화 기록에 남은 비밀번호, 지우기 전 할 일
클로드 코드 대화 기록에 비밀번호나 API 키를 붙여 넣었다면 기록부터 지우지 마세요. 교체, 노출 기간 확인, 기록 정리, 재발 방지 순서로 점검하세요.

깃허브 기여자에 Claude가 뜰 때 끄는 설정과 지우는 순서
깃허브 기여자 목록에 Claude가 보이면 커밋 기록 문제인지 화면 갱신 지연인지부터 나누세요. 앞으로 끄는 설정과 이미 남은 기록 처리 순서를 확인하세요.