공식 문서 · 빌드 심화 09

플러그인 — 기능 확장 패키지

스킬·에이전트·훅·MCP를 묶어 팀과 공유·배포.

성격 확장·배포핵심 plugin.json설치 /plugin install
확장기능 패키지

스킬·에이전트·훅·MCP를 하나로 묶기

플러그인은 스킬·에이전트·훅·MCP 서버를 plugin.json 하나로 묶어 공유·배포할 수 있는 단위다. 마켓플레이스에서 남이 만든 플러그인을 설치할 수도 있다.

한 문장으로혼자 쓰면 .claude/ 폴더로 충분하고, 팀과 표준화해 공유하려면 플러그인으로 묶는다.

마켓플레이스에서 설치 (가장 쉬움)

1
마켓플레이스 추가
/plugin marketplace add …
2
설치
/plugin install …
3
사용
/plugin-name:skill 호출
/plugin marketplace add anthropics/claude-code
/plugin install code-review@claude-code
/plugin list

직접 만들기

claude plugin init 으로 뼈대를 만들고, 아래 구조로 스킬·에이전트·훅을 채운다.

플러그인 디렉토리 구조
my-plugin/ ├─ .claude-plugin/plugin.json ← 메타데이터(핵심) ├─ skills/hello/SKILL.md ← 스킬 ├─ agents/code-reviewer.md ← 커스텀 에이전트 ├─ hooks/hooks.json ← 자동화 훅 └─ .mcp.json ← MCP 서버
claude --plugin-dir ./my-plugin
초보자 주의플러그인 스킬은 이름 충돌을 막으려 네임스페이스를 쓴다 — /my-plugin:hello. 마켓플레이스 플러그인은 임의 코드를 실행할 수 있으니 신뢰할 수 있는 것만 설치한다. 편집 후에는 /reload-plugins.
더 깊이스킬 자체를 자세히 배우려면 위 메뉴 공식 문서 → Skills (또는 심화 → 스킬).
출처: code.claude.com/docs/en/{plugins, discover-plugins}
클로드코드 시작하기공식 문서 · 09 플러그인