본문 바로가기

Skills vs CLAUDE.md vs MCP — 언제 무엇을 써야 할까

Claude를 확장하는 세 가지 방법인 Skills, CLAUDE.md, MCP의 역할과 경계를 정리하고, 상황별로 무엇을 선택해야 하는지 알려드립니다.

Skills(에이전트 스킬), CLAUDE.md, MCP는 모두 "Claude를 내 상황에 맞게 확장한다"는 목적을 공유하지만, 서로 다른 문제를 풉니다. 이 글에서는 각각의 역할을 무엇이 담당하는지, 언제 어느 것을 골라야 하는지, 그리고 셋을 함께 쓸 때 어떤 조합이 자연스러운지를 정리합니다. Skill 자체가 무엇인지 처음 접하신다면 이 사이트의 스킬 입문 글을, CLAUDE.md나 MCP를 처음 접하신다면 각각의 입문 글을 먼저 보시면 이 글의 비교가 더 잘 이해됩니다.

🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
🟢 현행 모델 라인업 일치 · Claude Opus 5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.

Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당

🟢 현행 모델 라인업 일치 · Claude Opus 5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.
0, 출력 $50)으로 이용합니다. 일회성
🟢 현행 모델 라인업 일치 · Claude Opus 5 / Claude Sonnet 5 / Claude Haiku 4.5 (상위 티어: Claude Fable 5.1). 이 안내는 새 모델이 출시될 때만 바뀝니다.
00 크레딧은 Fable 5 전환 당시에만 지급됐고 5.1에는 없습니다. 일부 코딩·디버깅 요청은 보안 분류기에 의해 Opus 모델로 대체 응답될 수 있습니다(두 모델 공통). 자세한 내용은 Fable 5.1 가이드Fable 5 재개 안내를 참조하세요.

언제 무엇이 로드되는가 CLAUDE.md 대화 시작부터 끝까지 항상 로드 Skills 이름·설명만 먼저 관련 작업일 때만 전체 내용 로드 MCP 외부 도구·데이터 연결이 필요할 때만 호출 대화 시작

Skills란 무엇인가

Skills(에이전트 스킬)는 Claude가 특정 작업을 만났을 때 자동으로 불러와 쓰는, 지침·메타데이터·부가 자료(스크립트, 템플릿 등)를 묶은 모듈입니다. 공식 문서는 이를 신입 직원에게 건네는 온보딩 안내문에 비유합니다 — 새로 들어온 사람에게 업무 방식을 정리해 주듯, Skill은 Claude에게 특정 분야의 작업 방식을 정리해 전달합니다.

Skill은 한 번의 대화에서만 쓰는 프롬프트(대화창에 직접 입력하는 일회성 지시)와 다릅니다. 프롬프트는 매번 다시 입력해야 하지만, Skill은 조건에 맞을 때 자동으로 불려와 같은 지침을 반복해서 입력할 필요가 없습니다. 공식 문서가 꼽는 이점은 세 가지입니다. 첫째, Claude를 특정 분야에 특화시킵니다. 둘째, 반복 입력을 줄입니다. 셋째, 여러 Skill을 조합해 복잡한 다단계 작업을 처리할 수 있습니다.

Skill에는 두 종류가 있습니다. Anthropic이 미리 만들어 제공하는 사전 구축 Skill(PowerPoint·Excel·Word·PDF 같은 문서 작업용)과, 사용자가 직접 만드는 커스텀 Skill입니다. 커스텀 Skill은 Claude Code에서 만들거나 API로 업로드하거나 claude.ai 설정에서 추가하는 등 Claude의 여러 제품에서 공통으로 쓸 수 있습니다.

Skill이 가벼운 이유는 프로그레시브 디스클로저(progressive disclosure — 필요할 때 단계적으로 불러오는 방식) 구조 때문입니다. Skill 파일 맨 위에는 이름(name)과 설명(description)을 담은 메타데이터 블록이 있는데, 이 부분만 항상 시스템 프롬프트에 로드됩니다. Skill의 본문 지침이나 첨부 자료는 실제로 해당 작업이 필요할 때만 불러옵니다. 이 구조 덕분에 여러 개의 Skill을 설치해 둬도 평소 대화의 맥락(컨텍스트)을 크게 소모하지 않는다는 것이 공식 설명입니다.

주의할 점: 이 description 필드가 Claude가 "지금 이 Skill을 써야 하는지"를 판단하는 유일한 근거입니다. 공식 문서는 description이 Skill이 무엇을 하는지와 언제 써야 하는지를 모두 담아야 한다고 명시합니다. 설명이 모호하면 필요한 순간에 Skill이 자동으로 선택되지 않을 수 있습니다.

CLAUDE.md란 무엇인가

CLAUDE.md는 프로젝트 전체에 항상 적용되는 맥락과 규칙을 적어두는 안내 파일입니다. Skill이 특정 작업을 만났을 때만 선택적으로 불려오는 것과 달리, CLAUDE.md는 대화가 시작될 때 함께 읽혀 별도의 트리거 없이 항상 적용됩니다.

보통 프로젝트 개요, 디렉토리 구조, 코딩 컨벤션, 커밋·배포 원칙처럼 "이 프로젝트에서 작업할 때는 항상 이렇게 해 달라"는 성격의 내용을 담습니다. Skill처럼 특정 작업 유형에 대한 전문 절차를 담기보다는, 프로젝트 전반에 걸쳐 일관되게 지켜야 할 배경 지식과 원칙을 담는 쪽에 가깝습니다. 자세한 작성법은 이 사이트의 CLAUDE.md 입문 글을 참고하세요.

MCP란 무엇인가

MCP(Model Context Protocol — 외부 도구·데이터 연결 규약)는 Claude가 사내 시스템, 데이터베이스, 깃허브 같은 외부 자원에 접근할 수 있도록 연결하는 공개된 통신 규약입니다. Skill과 CLAUDE.md가 "무엇을 어떻게 하라"는 지침을 전달하는 것과 달리, MCP는 Claude가 실제로 바깥 세상의 도구를 쓰거나 데이터를 읽고 쓸 수 있게 해주는 연결 통로 역할을 합니다.

즉 Skill이 "지식과 절차"를, CLAUDE.md가 "항상 지켜야 할 맥락"을 제공한다면, MCP는 "새로운 행동 능력"을 제공한다고 볼 수 있습니다. 이슈 트래커에 이슈를 등록하거나, 사내 문서 검색 시스템에서 자료를 찾아오는 것처럼 Claude 혼자서는 할 수 없던 일을 가능하게 만드는 쪽이 MCP의 역할입니다. MCP를 처음 접하신다면 이 사이트의 MCP 입문 글에서 더 자세히 다룹니다.

세 가지 핵심 차이

세 도구의 가장 큰 차이는 "언제 로드되는가"와 "무엇을 제공하는가"입니다. 아래 표로 정리했습니다.

구분SkillsCLAUDE.mdMCP
한 줄 정의필요할 때 자동으로 불러오는 전문 지침 묶음항상 적용되는 프로젝트 맥락·규칙 파일외부 도구·데이터에 연결하는 통신 규약
로드 시점이름·설명은 항상, 본문은 관련 작업일 때만대화 시작부터 항상해당 도구·데이터가 필요할 때
주로 담는 것특정 작업의 지침, 스크립트, 템플릿프로젝트 개요, 컨벤션, 항상 지킬 원칙외부 시스템에 대한 접근·행동 능력
적합한 상황문서 작업 같은 특정 유형의 반복 작업모든 작업에 공통으로 적용할 배경 지식사내 시스템·API 등 외부 자원 접근
제공 형태사전 구축 Skill 또는 커스텀 Skill프로젝트 루트의 안내 파일MCP 서버로 연결

언제 무엇을 쓰나

선택 기준은 "이 내용이 항상 필요한가, 특정 작업에서만 필요한가, 아니면 외부 자원에 접근해야 하는가"로 나눠보면 됩니다. 모든 대화에 항상 적용할 프로젝트 규칙이라면 CLAUDE.md, 특정 작업에서만 필요한 전문 절차나 템플릿이라면 Skill, 외부 시스템의 데이터나 도구에 직접 접근해야 한다면 MCP를 선택합니다.

무엇을 확장하고 싶나요? 모든 대화에 항상 적용할 프로젝트 규칙·맥락 특정 작업에서만 필요한 전문 절차·템플릿 외부 시스템의 데이터·도구 직접 접근 CLAUDE.md Skills MCP

세 가지를 함께 쓰는 예시

세 도구는 배타적이지 않고 함께 쓰도록 설계되어 있습니다. 예를 들어 사내 이슈 트래커와 연동해 버그 리포트 문서를 정리하는 작업을 생각해 볼 수 있습니다. CLAUDE.md에는 "버그 리포트는 항상 재현 절차·기대 결과·실제 결과 순서로 작성한다"처럼 프로젝트 전반의 원칙을 적어 둡니다. 리포트를 특정 문서 형식(예: 표가 포함된 Word 문서)으로 정리하는 세부 절차는 관련 Skill이 필요할 때 자동으로 불려와 처리합니다. 그리고 실제 이슈 트래커에 접근해 항목을 조회하거나 등록하는 행동은 MCP로 연결된 도구가 담당합니다. 이렇게 CLAUDE.md가 원칙을, Skill이 절차를, MCP가 실행 능력을 나눠 맡는 조합이 자연스럽습니다.

자주 묻는 질문

Q. Skill과 CLAUDE.md를 같이 쓰면 서로 충돌하지 않나요?
기본적으로 역할이 다르기 때문에 함께 쓰는 것이 자연스럽습니다. CLAUDE.md는 대화 내내 항상 적용되는 배경 맥락을 담당하고, Skill은 특정 작업을 만났을 때만 추가로 불려와 그 작업의 전문 절차를 담당합니다.

Q. Skill을 여러 개 설치하면 맥락(컨텍스트)이 낭비되지 않나요?
공식 설명에 따르면 크게 낭비되지 않습니다. Skill은 이름과 설명 같은 메타데이터만 항상 로드되고, 본문 지침은 실제로 관련 작업이 필요할 때만 불러오는 프로그레시브 디스클로저 구조이기 때문입니다.

Q. MCP를 연결하면 Skill이 필요 없어지나요?
아니요, 둘은 다른 문제를 해결합니다. MCP는 외부 도구·데이터에 접근할 수 있는 연결 통로를 제공할 뿐이고, 그 도구를 어떤 절차로 활용할지에 대한 전문 지침은 여전히 Skill이 담당할 수 있습니다.

관련 글

이 글이 도움이 됐나요?

이어서 읽어보세요