Claude 실무

Claude Code 스킬과 MCP, 쓰임새 비교하기

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

GROWBEAT Editorial
첫 공개
최근 수정
10분
대표 이미지 — Claude Code 로고

Claude Code를 업무에 쓰기 시작한 마케터나 1인 사업자라면 스킬, 서브에이전트, MCP, 훅, 플러그인이라는 이름을 들어 봤을 겁니다. 그런데 무엇이 다른지 몰라 같은 지시문을 매번 붙여 넣고 있지는 않나요?

이 글은 2026년 10월 22일에 확인한 Anthropic 공식 문서로 다섯 가지 확장 방식과 기본 규칙 파일 CLAUDE.md를 비교하고 최소 예시와 도입 순서를 정리합니다.

Claude Code 확장 기능은 무엇이 있고 어떻게 다른가요?

Claude Code 공식 문서(2026년 10월 22일 확인)에 따르면 CLAUDE.md는 상시 규칙, 스킬은 필요할 때 쓰는 절차, MCP(AI가 외부 도구·데이터에 접속하는 표준 연결 방식)는 외부 연결, 서브에이전트는 격리된 작업, 훅은 자동 실행을 맡습니다. 플러그인은 이를 묶어 공유하는 포장 단위입니다.

방식무엇을언제어디에 저장예시
CLAUDE.md매 세션 읽는 기본 규칙같은 규칙을 두 번 틀릴 때./CLAUDE.mdnpm 대신 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에서는 명령 한 줄로 추가합니다.

bash
claude 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 설정을 묶은 설치 꾸러미로, 혼자 한 프로젝트에서 쓸 때는 필요 없고 같은 설정을 다른 프로젝트나 팀원에게 옮길 때 씁니다.

text
my-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일에 확인했습니다.

참고 자료

태그
#클로드 코드#Claude Code 스킬#MCP 서버#서브에이전트#클로드 코드 훅
무료 맞춤 보고서 받기