Claude Code 플러그인 마켓플레이스는 Skills·Slash Commands·Hooks·MCP 서버를 한 번에 묶어 설치·업데이트할 수 있게 해주는 배포 체계입니다. 2025년 10월 공개된 기능으로, 공식 문서 기준 개인·팀·조직 단위 확장을 Git 저장소나 로컬 경로에서 관리할 수 있습니다. 결론부터 말하면, 반복되는 개발 환경 세팅을 자동화하기에는 충분하지만 사내 보안이 엄격한 환경에서는 신뢰할 수 있는 저장소만 선별해 등록하는 편이 안전합니다.
개념 정리
Claude Code 플러그인 마켓플레이스란 무엇인가요?
공식 문서 기준, 플러그인은 Skills·Commands·Hooks·MCP 서버·서브에이전트를 하나의 디렉터리 구조로 묶은 확장 패키지입니다. 마켓플레이스는 이런 플러그인 여러 개를 나열해두는 카탈로그이며, GitHub 저장소나 로컬 경로로 배포됩니다.
Anthropic 공식 문서(docs.claude.com/en/docs/claude-code/plugins)에 따르면 플러그인 시스템은 2025년 10월 퍼블릭 베타로 공개되었습니다. 즉 API·구조는 변경될 수 있으므로 프로덕션 배포 스크립트에 강하게 결합시키는 건 신중해야 합니다.
마켓플레이스 자체는 별도 요금이 없고 Claude Code 사용 요금(Pro·Max·API)에 포함됩니다. 다만 플러그인이 호출하는 외부 MCP 서버·API 는 각자의 요금·한도를 따릅니다.
설치 방법
마켓플레이스는 어떻게 등록하고 설치하나요?
등록은 Claude Code 세션에서 /plugin marketplace add <owner/repo> 명령으로 진행합니다. 공식 문서 기준 GitHub 저장소, Git URL, 로컬 디렉터리 경로 세 가지 소스를 지원합니다.
등록 후 /plugin 명령으로 대화형 브라우저를 열거나, /plugin install <plugin-name>@<marketplace> 로 직접 설치할 수 있습니다. 설치된 플러그인은 다음 세션부터 자동 활성화됩니다.
| 명령 | 용도 |
|---|---|
/plugin marketplace add <source> |
마켓플레이스 등록 |
/plugin marketplace list |
등록된 마켓플레이스 확인 |
/plugin install <name>@<market> |
플러그인 설치 |
/plugin |
대화형 관리 UI |
/plugin marketplace remove <name> |
마켓플레이스 제거 |
팀 단위 배포는 저장소 루트의 .claude/settings.json 에 enabledPlugins 를 명시해두면, 팀원이 클론했을 때 동일한 확장 세트가 적용되도록 유도할 수 있습니다.
구성 요소
Skills·Hooks·MCP 는 어떻게 다르고 어떻게 함께 담기나요?
세 가지는 역할이 뚜렷이 다릅니다. Skills 는 모델이 상황을 판단해 불러오는 마크다운 지침 묶음, Hooks 는 특정 이벤트(PreToolUse, PostToolUse 등)에 실행되는 결정론적 셸 명령, MCP 는 외부 도구·데이터에 접근하는 서버 프로토콜입니다.
플러그인 저장소는 공식 문서 기준 다음과 같은 구조를 갖습니다.
plugin.json— 이름·버전·설명 메타데이터skills/— Skills 정의(SKILL.md+ 리소스)commands/— Slash 명령 마크다운hooks/hooks.json— 이벤트별 훅 정의.mcp.json— MCP 서버 접속 정보agents/— 서브에이전트 정의
이 구조 덕분에 하나의 플러그인을 설치하면 관련된 Skills·Hooks·MCP 가 함께 활성화됩니다. 예를 들어 데이터베이스 관리용 플러그인이라면 SQL 스킬, 위험 쿼리 차단 훅, DB MCP 서버 접속 설정을 한 번에 배포할 수 있습니다.
한계와 주의점
언제 쓰지 말아야 하나요?
결론부터 말하면, 감사가 필요한 사내 환경이나 신뢰 검증이 어려운 서드파티 플러그인은 신중히 다뤄야 합니다.
첫째, Hooks 는 사용자 셸 권한으로 임의 명령을 실행합니다. Anthropic 공식 문서도 “플러그인을 설치하기 전 소스를 검토하라”고 명시합니다. 특히 파일 시스템·네트워크를 건드리는 훅은 리스크가 큽니다.
둘째, MCP 서버 설정이 자동 등록된다는 점은 편리하지만, 반대로 말하면 어떤 외부 엔드포인트에 연결되는지 사용자가 놓칠 수 있습니다. .mcp.json 을 열어 URL·인증 방식을 확인하는 게 안전합니다.
셋째, 베타 단계라 API 변경 가능성이 있습니다. 릴리스 노트 기준 명령 이름·설정 스키마는 정식 GA 전까지 조정될 수 있으므로, CI 파이프라인에 강하게 결합시키기보다는 개발자 로컬 환경 표준화 용도가 안전합니다.
반대로 팀 온보딩 세팅, 반복적인 코드 리뷰 워크플로우, 사내 도구 통합처럼 표준화 이득이 큰 영역에는 효과적입니다.
자주 묻는 질문
Q. 플러그인 마켓플레이스는 유료인가요?
A. 별도 요금 없이 Claude Code 요금제에 포함됩니다.
Q. Skills 와 플러그인은 어떻게 다른가요?
A. Skills 는 지침 묶음, 플러그인은 Skills·훅·MCP 를 담는 상위 컨테이너입니다.
Q. 사설 GitHub 저장소도 마켓플레이스로 쓸 수 있나요?
A. 공식 문서 기준 인증된 Git URL 이면 사설 저장소도 지원합니다.
Q. 설치한 플러그인을 잠시 끌 수 있나요?
A. `/plugin` 대화형 UI에서 개별 플러그인을 비활성화할 수 있습니다.
Q. MCP 서버는 따로 설정해야 하나요?
A. 플러그인 `.mcp.json` 에 포함되어 있으면 별도 설정이 필요 없습니다.
정리하면 Claude Code 플러그인 마켓플레이스는 Skills·Hooks·MCP 를 한 묶음으로 배포·설치할 수 있게 해주는 확장 체계이며, 팀 표준화·반복 세팅 자동화에 특히 유리합니다. 다만 베타 단계이고 훅이 임의 명령을 실행할 수 있다는 특성상, 신뢰할 수 있는 저장소만 등록하고 .mcp.json 과 훅 스크립트를 설치 전에 확인하는 습관이 필요합니다. 공식 근거로 확인한 핵심과 한계만 정리했습니다.
답글 남기기