Claude Code가 느려지는 이유: 스킬, 서브에이전트, MCP, 플러그인 선택법

2026년에 ‘Claude Code에 이것저것 집어넣기’가 가장 큰 골칫거리가 된 이유는?#

공식 문서조차 “어떤 경우에 무엇을 선택해야 하는가?”에 대한 포괄적인 답을 바로 제시하지 못했습니다.

이 글에서 설명하는 한 달간의 경험에는 실제 프로젝트에서 사용한 네 가지 방식이 모두 포함됩니다. 복잡한 작업 하나를 위한 서브에이전트 묶음, 반복 절차를 위한 소수의 스킬, 실시간 데이터를 위한 MCP 서버 몇 개, 그리고 대략 스무 개가 넘는 플러그인 중 몇 개를 고른 구성입니다. 이 가이드는 그 사례를 선택 매트릭스와 바로 쓸 수 있는 의사결정 트리, Anthropic의 인용문, Claude를 제대로 쓸 수 없게 만드는 일곱 가지 안티패턴으로 정리합니다.

스킬은 서브에이전트, MCP, 플러그인과 어떻게 다른가요? 한눈에 보는 표#

선택 매트릭스:

기업가를 위한 쉬운 비유를 들어보겠습니다. 직원 10명인 회사의 CEO라고 상상해 보세요.

• CLAUDE.md — 회사 정관입니다. 늘 벽에 붙어 있고 모두가 읽으며 누구도 이의를 제기하지 않습니다.
• Skill — 사내 절차입니다. “리뷰를 진행하는 방법”, “릴리스 노트를 작성하는 방법”, “결제를 받는 방법” 같은 것입니다.
• Subagent — 별도 사무실과 제한된 권한 목록을 가진 전문가입니다. 모든 권한을 주면 직원이 아니라 두 번째 CEO가 생깁니다.
• MCP server — CRM, 은행, 창고 같은 회사 시스템입니다. 지식이 아니라 연결입니다.
• Plugin — 상점에서 구입하는 기성 솔루션입니다. 절차, 전문가, 통합 기능을 한 상자에 담은 패키지입니다.

이들이 경쟁 관계인 네 가지 도구가 아니라 한 시스템의 네 계층이라는 점을 이해하면 “어느 것이 더 나은가?”라는 질문은 사라집니다. 남는 질문은 “각 요소를 어디에 둘 것인가?”입니다.

Claude Code의 스킬이란 무엇이며 언제 설치해야 할까요?#

Anthropic의 공식 정의:

스킬은 세 단계로 구성됩니다.

1. 메타데이터. 세션 시작 시 항상 불러옵니다. frontmatter에 있는 이름과 설명입니다. 스킬 하나는 시작 시 약 100토큰을 사용합니다.
2. 지침. Claude가 트리거 요청을 발견했을 때만 불러옵니다. 최대 5,000토큰이며, SKILL.md의 본문이 여기에 해당합니다.
3. 리소스. 지침에서 명시적으로 요청할 때만 불러옵니다. 번들 파일, scripts/의 스크립트, references/의 참고 자료가 포함됩니다. 스크립트는 bash를 통해 실행되며, 코드 자체는 컨텍스트에 들어가지 않습니다.

Anthropic은 이 원칙을 점진적 공개라고 부릅니다.

같은 글에는 이보다 더 잘 설명할 수 없는 비유도 나옵니다.

스킬을 사용할 때:

• 계속 반복하는 표준 절차가 있을 때. PR 리뷰, 릴리스 노트 작성, 스타일 가이드에 따른 코드 리뷰 등이 해당합니다.
• CLAUDE.md의 한 섹션이 단순한 사실 설명에서 절차로 바뀌어 다른 모든 작업을 방해하기 시작할 때.
• 여러 프로젝트에서 같은 지침을 일관되게 따르게 하고 싶을 때.

실용적인 공식은 이렇습니다. 무언가를 두어 번 넘게 한다면 시스템에 맡기세요. 처음에는 직접 프롬프트를 쓰세요. 두 번째부터는 스킬로 만들 후보입니다.

스킬을 사용하지 말아야 할 때:

• 작업에 실시간 데이터(데이터베이스, API, 검색, 현재 주식시장 데이터)가 필요하다면 스킬이 아니라 MCP가 필요합니다. “현재 가격을 가져오는” 스킬은 환각을 일으킵니다.
• 작업에 격리된 컨텍스트가 필요하다면 서브에이전트를 사용하세요.
• 강제 검사가 필요하다면(“.env가 포함된 커밋 차단”) 스킬에만 의존하지 말고 해당 커밋 경로를 검사하는 hook을 사용하세요. 실제 적용 범위를 검토하고 시험하세요. hook이 파일을 읽거나 복사하거나 게시하는 모든 경로를 제한하지는 않습니다.

미리 알아둘 제한 사항:

• 스킬 이름: 최대 64자이며, 소문자, 숫자, 하이픈만 사용할 수 있습니다. anthropic과 claude는 예약어입니다.
• 설명: 최대 1,024자입니다. description과 when_to_use를 합친 값은 목록에서 1,536자로 잘립니다.
• SKILL.md 본문: 500줄 이하를 권장합니다. 초과하는 내용은 references/와 scripts/로 옮기세요.
• 자동 컨텍스트 압축(auto-compaction) 중에는 활성 스킬마다 처음 5,000토큰이 다시 첨부됩니다. 전체 스킬의 총 예산은 25,000토큰입니다.

서브에이전트란 무엇이며 중첩 단계가 5개인 이유는 무엇인가요?#

공식 문서에서:

Claude Code에는 이미 알고 있든 모르든 사용하고 있는 내장 서브에이전트가 세 가지 있습니다.

2026년 6월 10일, Anthropic은 Claude Code v2.1.172를 출시하면서 서브에이전트가 처음 도입된 이후 유지되던 제한을 없앴습니다. 이제 자식 에이전트도 최대 5단계 깊이까지 자체 서브에이전트를 실행할 수 있습니다.

숫자 5는 안전을 위한 상한이지 최적화 목표가 아닙니다.

YAML 오케스트레이터 템플릿을 포함한 기능 상세 분석은 중첩 서브에이전트 가이드에 있습니다.

서브에이전트를 사용할 때:

• 코드나 로그를 탐색한 뒤 짧은 결론만 있으면 될 때.
• 동시에 나란히 실행할 수 있는 병렬 작업.
• 전문 분야별 위임: 백엔드 / 프런트엔드 / 테스트 / 리뷰가 각각 하나의 기능을 맡는 경우.
• 비용 절감: Sonnet이나 Opus 대신 Haiku 서브에이전트를 사용하면 비용을 5–7배 줄일 수 있습니다.

서브에이전트를 사용하지 말아야 할 때:

• 한 번뿐인 사소한 작업이나 간단한 도구 호출. 서브에이전트는 시작 비용이 듭니다.
• 작업끼리 상태를 공유해야 할 때. 서브에이전트는 서로의 컨텍스트를 볼 수 없으므로 관련 작업은 메인 스레드에 두어야 합니다.

주요 안티패턴은 다음과 같습니다.

서브에이전트에 Opus와 모든 도구를 주면 그저 또 하나의 메인 세션이 됩니다. 도구 목록이 메인 에이전트와 같다면 서브에이전트의 권한이 제대로 제한되지 않은 것입니다.

다시 말해, 부모와 같은 권한을 가진 서브에이전트는 두 번째 CEO일 뿐입니다. 쓸모없고 비용만 많이 듭니다.

MCP 서버란 무엇이며 언제 Claude Code에 연결해야 할까요?#

공식 정의:

MCP로 실제 할 수 있는 일은 다음과 같습니다.

• Claude를 Google Calendar와 Notion에 연결해 개인 비서를 만듭니다.
• Figma에 연결해 디자인을 바탕으로 바로 쓸 수 있는 웹 프로젝트를 Claude가 생성하게 합니다.
• 기업용 챗봇을 여러 데이터베이스에 동시에 연결합니다.
• Blender와 3D 프린터에 연결해 모델을 만들고 즉시 출력합니다.

사람들이 가장 먼저 설치하는 잘 알려진 MCP 서버:

연결 방법과 설치 명령은 MCP 카탈로그에 모아 두었습니다.

MCP를 사용할 때:

• 외부 데이터나 작업을 연결해야 할 때: “데이터베이스에서 행을 가져와”, “Jira 티켓을 읽어”, “Slack에 게시해” 같은 경우.
• 여러 프로젝트나 에이전트가 같은 서비스를 사용한다면 서버 하나를 중앙에서 유지하는 편이 쉽습니다.

MCP를 사용하지 말아야 할 때:

• 정적인 지식이나 절차에는 MCP가 아니라 스킬을 사용하세요. “코드 리뷰를 하는 방법에 관한 지침”은 스킬입니다. “GitHub의 최신 PR을 읽고 리뷰해”에는 MCP가 필요합니다.
• 한 번만 쓸 CLI 명령에는 서버를 설정하는 것보다 Bash를 사용하는 편이 쉽습니다.
• “올바른 아키텍처를 위해” MCP를 만들고 싶을 때는 실제 작업이 아니라 미관상의 선택입니다.

2026년에 “Claude Code가 멍청하게 행동한다”는 불만을 일으키는 가장 큰 원인 중 하나가 바로 MCP의 주요 함정입니다.

이런 MCP를 한꺼번에 모두 설치하면 LLM의 컨텍스트 창을 질식시키게 됩니다. 사용 가능한 모든 도구가 컨텍스트에 로드되기 때문입니다.

실용적인 경험칙은 다음과 같습니다. 특정 작업에 초점을 둔 활성 MCP 서버를 2–3개 이하로 유지하세요. 여러 서버를 사용한 이 글의 사례에서는 시작이 느려지고 오류가 더 자주 발생했습니다.

MCP 도구 검색은 Claude Code v2.1.x에서 추가되었습니다. 도구가 더는 무조건 컨텍스트에 로드되지 않고, 색인된 뒤 필요할 때 가져옵니다. 덕분에 “한 프로젝트에 MCP를 많이 두는” 비용은 줄어들지만 완전히 없어지지는 않습니다.

플러그인은 스킬과 어떻게 다르며 경계가 흐려진 이유는 무엇인가요?#

공식 설명:

2026년 6월 설치 수 기준 상위 플러그인:

전체 선택 분석은 101개 중 상위 10개 플러그인 가이드에서 확인할 수 있습니다.

플러그인을 사용할 때:

• 디자인이나 리뷰처럼 워크플로의 상당 부분을 처리하는 커뮤니티 패키지가 준비되어 있을 때.
• “스킬 + 서브에이전트 + MCP + hook” 구성을 직접 조합하고 싶지 않다면 이미 만들어진 패키지를 사용할 수 있습니다.
• 기업 내 배포: 관리자가 팀 마켓플레이스를 만들면 개발자가 하나의 접두 경로에서 설치할 수 있습니다.

플러그인을 사용하지 말아야 할 때:

• 스킬 하나로 해결할 수 있는데 패키지에 MCP가 다섯 개 더 “혹시 몰라서” 따라오는 경우. 컨텍스트만 어지럽힙니다.
• 감사를 거치지 않은 비공개 소스 플러그인. 사용자 권한으로 실행되므로 설치 전에 내용을 확인하세요.
• 이미 같은 주제의 플러그인을 사용 중인 경우. 컨텍스트에 중복으로 들어가면 문제가 두 배가 됩니다.

설치 전에 Claude Code v2.1.143+는 플러그인이 각 메시지에 추가할 토큰을 추정한 Context cost를 표시합니다. v2.1.145+부터는 패키지의 명령, 에이전트, 스킬, hook, MCP, LSP 전체 목록을 보여 주는 Will install 필드도 표시합니다. 설치를 클릭하기 전에 가장 먼저 열어 볼 화면입니다.

2026년에 효과적인 선택 매트릭스는 무엇인가요?#

우선순위에 따른 여섯 가지 질문:

1. 반복적인 절차, 스타일, 체크리스트인가요? 그렇다면 스킬입니다.
2. 외부 데이터나 작업(데이터베이스, API, Slack, GitHub, Figma)이 필요한가요? 그렇다면 MCP 서버입니다.
3. 메인 컨텍스트를 어지럽히지 않도록 별도의 컨텍스트를 원하나요? 그렇다면 서브에이전트입니다.
4. 정해진 이벤트의 검사나 자동 단계가 필요한가요? 그렇다면 적용 범위를 시험한 hook입니다. 더 넓은 접근 경계에는 권한이나 환경 격리를 사용하세요.
5. 1–4를 한 번의 클릭으로 묶은 기성 패키지를 원하나요? 그렇다면 마켓플레이스의 플러그인입니다.
6. 데이터, 컨텍스트, 스타일이 모두 필요한 복잡한 작업인가요? 그렇다면 조합을 사용하세요. Haiku 서브에이전트 + 미리 불러온 스킬 + 범위를 좁힌 MCP 하나입니다.

조합 공식:

규칙을 위한 스킬을 미리 불러온 Haiku 서브에이전트와 실시간 데이터용으로 범위를 좁힌 MCP 서버를 함께 쓰면 실제로 효과를 보는 패턴입니다.

그리고 의존성 방향에 관한 핵심 규칙입니다.

서브에이전트는 MCP 서버를 사용할 수 있습니다. MCP 서버는 서브에이전트를 사용할 수 없습니다.

즉, MCP는 항상 에이전트가 아니라 데이터와 작업을 담당합니다. 작업을 위임하려면 MCP가 서브에이전트를 호출하는 것이 아니라 서브에이전트가 MCP를 호출해야 합니다.

구체적인 사례로, 디지털 에이전시의 편집 엔진은 SEO 기사 하나를 60분 만에 작성합니다. 내부에는 서브에이전트 25개와 검토 단계 14개가 있습니다. 각 에이전트는 자체 컨텍스트와 권한, 편집 규칙용 스킬을 가지고 순차적으로 작업합니다. 한 서브에이전트는 바로 쓸 수 있는 태그와 이전 기사가 들어 있는 데이터베이스가 있는 MCP 서버에 연결합니다. 메인 오케스트레이터 에이전트는 Opus에서 실행되고, 자식 에이전트는 Haiku에서 실행되어 예산을 합리적인 수준으로 유지합니다.

이것은 “기사 공장”이 아니라 속도보다 품질의 깊이가 중요할 때 네 가지 방식을 하나의 시스템으로 결합하는 방법의 사례입니다.

지금 Claude Code에서 없애야 할 7가지 실수는 무엇인가요?#

1. 유행한다는 이유로 상위 10개 플러그인을 모두 설치했습니다. 각각 메시지마다 토큰을 추가합니다. /plugin list를 열고 각 항목의 Context cost를 확인하세요. 2주 동안 사용하지 않은 플러그인은 제거하세요.

2. 다른 사람의 .mcp.json에서 MCP 서버 15개를 복사했습니다. 다른 사람의 스택은 그 사람의 프로젝트와 작업에 맞춰 구성되어 있습니다. 현재 프로젝트에서 활성 MCP는 2–3개 이하로 유지하세요. 나머지는 다른 프로젝트용 별도 설정으로 옮기거나 지금 삭제하세요.

3. 스킬과 MCP 플러그인이 같은 일을 합니다. 스킬은 “코드 리뷰를 해”라고 지시하고, pr-review-toolkit 플러그인은 자체 리뷰 절차를 실행합니다. 둘이 우선순위를 놓고 경쟁하기 시작합니다. 증상은 “Claude, 왜 계속 왔다 갔다 해?”라는 반응입니다. 해결책은 단일 정보 출처를 유지하는 것입니다. 여기서 설명한 구성에서는 지침을 직접 제어하기 위해 스킬을 선택했습니다.

4. hook이 필요한 상황에서 규칙을 강제하려고 스킬을 사용합니다. 스킬은 제안이지 보장이 아닙니다. “.env가 포함된 커밋 차단”에는 해당 커밋 경로를 검사하는 pre-commit hook을 쓸 수 있습니다. 스테이징된 내용과 우회 경로를 따로 시험하세요. 모든 읽기나 다른 게시 경로를 막지는 않습니다. 스킬만으로는 이 경계를 강제할 수 없습니다.

5. 서브에이전트가 부모와 같은 권한을 가집니다. Opus와 모든 도구를 주었더니 메인 세션이 하나 더 생겼습니다. 공식 문서의 시스템 프롬프트는 서브에이전트에 제한된 도구 목록과 자체 제약이 있는 작업을 주라고 권합니다. 그렇지 않으면 비용만 많이 드는 복제본일 뿐입니다.

6. 플러그인을 설치하기 전에 Will install을 확인하지 않았습니다. Claude Code v2.1.145+에서 이 필드가 패키지의 전체 구성을 보여 줍니다. “작은 기능 하나”만 있는 줄 알았던 플러그인에 MCP 서버 3개, 서브에이전트 2개, hook 5개가 들어 있는 경우가 많습니다. 이 모두가 컨텍스트에 들어옵니다.

7. 오래된 .claude/commands/가 새 스킬과 중복됩니다. Anthropic 문서에는 이렇게 나와 있습니다.

오래된 commands/ 폴더도 여전히 작동하지만 이제 표준은 스킬입니다. 이 사례에서는 두 폴더를 모두 사용하고 있었는데, commands/를 제거하고 번들 파일과 트리거가 포함된 스킬만 남겼습니다.

Claude Code가 “복잡해졌다”는 신호:

• 모든 메시지가 200줄이 넘는 사용 가능한 도구 목록으로 시작합니다.
• 간단한 작업이 한 달 전보다 오래 걸립니다.
• Claude가 비슷한 스킬이나 플러그인 두 개를 혼동합니다.
• 세션 시작 시 이름 충돌 경고가 나타납니다.
• Claude가 필요한 MCP B 대신 스킬 A처럼 잘못된 도구를 호출합니다.

이 증상 중 두 가지 이상을 알아챘다면 지금 바로 /plugin list와 /skill list를 여세요. 먼저 2주 동안 사용하지 않은 항목을 제거하세요. 그런 다음 항목별 Context cost를 확인하세요. 마지막으로 위의 안티패턴을 해결하세요.

컨텍스트를 다 쓰지 않으려면 스킬과 MCP를 몇 개나 유지할 수 있나요?#

Claude Code에서 직접 확인할 수 있는 항목:

• /skill list — 활성 스킬 전체와 각 스킬의 토큰 크기.
• /plugin list — 플러그인 전체와 Context cost.
• /mcp list — MCP 서버와 도구 개수.

실제 수치로 보는 토큰 예산:

컨텍스트 창은 최대 작업 공간이지 매 작업에서 소비하는 토큰 수가 아닙니다. 같은 결과에 대해 측정한 입력, 캐시 입력, 출력, 반복 턴을 비교하세요. 격리로 부모 컨텍스트를 작게 유지해도 서브에이전트 자체 사용량은 발생합니다.

Anthropic은 기술 블로그에서 스킬 자동 압축 수치를 제시합니다. 활성 스킬마다 처음 5,000토큰을 다시 첨부하며 전체 예산은 25,000토큰입니다. 즉, 무거운 스킬이 5개 넘게 동시에 활성화되면 Claude가 일부 지침을 놓치기 시작합니다.

간단한 실용 규칙:

• 스킬: 현재 프로젝트에서 활성 스킬을 5–7개 이하로 유지하세요. 나머지는 ~/.claude/skills/disabled/에 넣어 두세요. 필요할 때 다시 옮길 수 있습니다.
• MCP: 프로젝트당 2–3개 이하로 유지하세요. 문서용 Context7은 거의 항상 유용하고, 나머지는 작업에 따라 선택하세요.
• 플러그인: 한 번에 하나씩만 설치하고 2주 뒤 사용 여부를 확인하세요. 사용하지 않았다면 제거하세요.

Anthropic의 2026 Agentic Coding Trends Report에 대한 상세 분석과 개발자 80%가 Claude에 작업을 완전히 위임하지 못하는 이유는 별도 가이드에 있습니다. 보고서의 주요 수치는 다음과 같습니다. 사람들은 업무의 60%에 AI를 사용하지만, 작업의 0–20%만 완전히 맡깁니다. 주된 이유는 컨텍스트 과부하와 도구에 대한 통제력 상실입니다.

초보자는 어디서 시작해야 할까요? 최소 작동 설정#

2주간 작업한 뒤의 최소 구성:

1. 프로젝트 규칙을 적은 CLAUDE.md를 루트에 둡니다.
2. Claude Code 이외의 도구에서도 작업할 계획이라면 호환성을 위해 AGENTS.md를 둡니다. 자세한 내용은 “Claude Code, Codex, Cursor에 공통으로 쓸 지침 파일을 만드는 방법”을 참고하세요.
3. 주요 반복 작업을 위한 스킬 1개를 둡니다. 예를 들어 스타일 가이드에 맞춘 code-review로 시작하세요.
4. 최신 문서를 위한 MCP 서버 1개: Context7. 이것이 없으면 Claude는 여전히 존재하지 않는 API를 환각합니다.
5. 첫 달에는 플러그인 0개와 서브에이전트 0개를 사용합니다. 이는 돈을 아끼기 위해서가 아니라 통제력을 유지하기 위해서입니다. 기초를 이해하기 전에는 패키지가 혼란을 줄 수 있습니다.

그다음에는 작업을 따라가세요. 반복 절차가 생기나요? 스킬로 만드세요. 특정 서비스의 실시간 데이터가 필요한가요? MCP를 추가하세요. 큰 작업이 메인 컨텍스트를 채우기 시작하나요? 서브에이전트에 위임하세요.

이것이 세 단계 지도입니다. 먼저 컨텍스트, 그다음 두어 번 넘게 반복하는 일을 시스템에 맡기고, 마지막으로 시스템이 실수하지 않도록 자동 검사를 추가합니다. 앞 단계가 제대로 작동할 때만 다음 단계를 더하세요.