[Claude Code] 플러그인(Plugin) (11, 실습 마무리)

실습 목표 : 스킬, 서브에이전트, 훅, mcp서버 등을 하나로 묶어 공유하는 방법을 익혀보자.

 

Step 1. 플러그인이란?

실습 프로젝트인 shop-api에는 다음과 같은 것들이 쌓여있다.

.claude/skills/tdd/SKILL.md
.claude/agents/code-reviewer.md
.claude/hooks/run-tests.sh
.claude/settings.json
.mcp.json

다른 프로젝트에서 쓰려면 하나씩 복사해야 하고, 팀에 나눠주려면 "이 파일들을 이 위치에 두세요"라고 설명해야 한다.
플러그인은 스킬, 서브에이전트, 훅, json 설정 파일, mcp서버 등을 한 덩어리로 묶어 설치·배포할 수 있게 만든 것이다.

 

플러그인 구조는 다음과 같다. 이미 만든 폴더 이름들이 그대로 들어간다.

my-plugin/
├── .claude-plugin/
│   └── plugin.json      ← 이름, 버전, 설명
├── skills/
├── agents/
├── hooks/
└── .mcp.json

 

플러그인이 값어치를 하는 시점은 같은 설정을 여러 프로젝트나 여러 사람에게 반복해서 적용할 때이므로 지금 당장 만들 필요는 없다.

 

Step 2. 플러그인 설치해보기

설치는 마켓플레이스를 통해 이루어진다. 
마켓플레이스는 플러그인 목록을 담은 저장소이고, /plugin 명령으로 추가하고 설치한다.

/plugin marketplace add <저장소 주소>
/plugin install <플러그인 이름>@<마켓플레이스 이름>

 

실제로 플러그인 하나를 설치해보자.

 

먼저 터미널에서 claude-code-cli를 실행하고 다음 명령어를 실행한다.

/plugin marketplace add anthropics/claude-plugins-community

 

 

정상적으로 클로드 커뮤니티 마켓플레이스가 설치되면 다음과 같은 문장이 출력된다.

 

이제 레딧 등에서 화제가 되었던 eli5라는 플러그인을 설치해보자.

(eli5 플러그인은 "Explain Like I'm 5"의 약자로, "다섯 살 아이에게 설명하듯 아주 쉽게 설명해 달라"는 뜻으로 복잡하고 어려운 개념을 쉽게 설명하도록 하는 플러그인으로 개발자 커뮤니티에서 화제가 됐었다.)

 

/plugin install eli5@claude-community

실행하면

 

플러그인이 적용되는 범위를 설정할 수 있다.

항목	범위
user scope	내 모든 프로젝트
project scope	이 프로젝트, 팀 공유
local scope	이 프로젝트, 나만

 

범위를 설정하고 설치를 했을 때

위와 같이 출력되면 정상적으로 설치가 된 것이다.

 

 

핵심정리

1. 플러그인은 스킬·서브에이전트·훅·MCP를 한 덩어리로 묶은 것이다.
지금까지의 실습에서 만든 것들이 그대로 구성 요소가 된다.

2. 같은 설정을 여러 프로젝트나 여러 사람에게 반복해서 적용할 때 플러그인이 값어치를 한다.
프로젝트 하나에서 쓸 거라면 .claude/ 폴더가 더 낫다.

 

 

실습을 마무리하며,

실제 프로젝트에서 같은 지시를 두 번 타이핑했다면, 그때가 무언가를 만들 때이다.

• 규칙이면 → CLAUDE.md
• 절차면 → 스킬
• 반복되는 역할이면 → 서브에이전트
• 예외 없이 지켜야 하면 → 훅