Claude Code 확장 도구 선택의 최적화: Lightest-First 계층 설계 전략

Skill, MCP, Plugin, or just a CLI: how I pick a Claude Code extension, lightest first

Rapls2026년 6월 8일10분intermediate

AI 요약

Context

Claude Code의 Skill, MCP, Plugin 간 기능적 모호함으로 인한 잘못된 도구 선택 및 오버헤드 발생. 정적인 절차(Procedure) 기술 도구로 실시간 외부 데이터(Live Data)를 호출하려 시도하는 아키텍처 계층 간 오해로 인한 실행 실패 경험.

Technical Solution

도구 간 독립적 선택이 아닌 Plugin > Skill > MCP/CLI 순의 Nested 계층 구조 정의
Skill을 단순 절차 및 지식 저장소로 제한하여 컨텍스트 윈도우 소모 최소화 및 온디맨드 로딩 구현
외부 데이터 연동 시 'CLI 가능 여부'를 1차 판별하여 불필요한 MCP 서버 구축 비용 제거
빈번한 호출 및 심층적 시스템 조작이 필요한 경우에만 MCP(Model Context Protocol)를 통해 외부 서버 연결
다수의 Skill, MCP 설정, 훅(Hook)을 하나로 묶어 배포하는 컨테이너로서의 Plugin 설계
.claude/skills/ 내 Git 기반 관리(Skill)와 머신 기반 설정(MCP)을 분리하여 환경별 보안성 확보

실천 포인트

1. 단순 작업 절차나 지식 전달이 목적인가? $\rightarrow$ Skill 적용

2. 외부 데이터가 필요한가? $\rightarrow$ 기존 CLI 존재 여부 확인 $\rightarrow$ (존재 시) Skill에서 CLI 호출 / (미존재 또는 고빈도 사용 시) MCP 구축

3. 위 구성 요소들을 패키징하여 타 환경에 배포해야 하는가? $\rightarrow$ Plugin 설계

4. `CLAUDE.md`에 모든 절차를 넣지 않고 개별 Skill로 분리하여 토큰 소모를 최적화했는가?

태그

#MCP #AI Agent Architecture #Claude-Code #System Design #Context Optimization

원문 읽기