Plugins
Skills, 에이전트, Hooks, MCP를 하나로 묶어서 팀과 공유하세요.
플러그인이란?
플러그인은 Skills, 에이전트, Hooks, MCP 서버를 하나의 패키지로 묶어서 프로젝트와 팀 간에 공유할 수 있는 확장 시스템이에요. 마켓플레이스를 통해 배포하거나, 로컬에서 직접 개발할 수 있어요.
팀 공유
한 번 만들면 팀 전체가 같은 워크플로우를 사용할 수 있어요.
올인원 패키지
Skills + 에이전트 + Hooks + MCP를 하나로 묶어요.
마켓플레이스
공식 마켓플레이스에서 설치하거나 직접 배포할 수 있어요.
버전 관리
시맨틱 버저닝으로 안정적인 업데이트를 제공해요.
플러그인 vs 독립 설정
| 방식 | Skill 이름 | 적합한 상황 |
|---|---|---|
| 독립 설정 (.claude/) | /hello | 개인 워크플로우, 실험, 단일 프로젝트 |
| 플러그인 | /my-plugin:hello | 팀 공유, 여러 프로젝트, 마켓플레이스 배포 |
.claude/에서 먼저 실험하고, 준비되면 플러그인으로 변환하세요!플러그인 만들기
1단계: 디렉토리 & 매니페스트 생성
mkdir my-plugin
mkdir my-plugin/.claude-plugin.claude-plugin/plugin.json 파일을 만드세요.
{
"name": "my-plugin",
"description": "팀 코드 리뷰 플러그인",
"version": "1.0.0",
"author": { "name": "Your Name" }
}2단계: Skill 추가
mkdir -p my-plugin/skills/code-reviewskills/code-review/SKILL.md를 작성하세요.
---
description: 코드 품질과 보안을 리뷰합니다
---
코드를 분석하고 품질, 보안, 모범 사례에 대한
피드백을 제공하세요.3단계: 로컬 테스트
claude --plugin-dir ./my-plugin여러 플러그인을 동시에 로드할 수도 있어요.
claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two플러그인 구조
| 디렉토리 | 용도 |
|---|---|
.claude-plugin/ | plugin.json 매니페스트 |
skills/ | SKILL.md 파일 (에이전트 스킬) |
commands/ | 마크다운 명령 파일 |
agents/ | 커스텀 에이전트 정의 |
hooks/ | hooks.json 이벤트 핸들러 |
.mcp.json | MCP 서버 설정 |
.lsp.json | LSP 서버 설정 |
settings.json | 기본 설정값 |
commands/, agents/ 등은 플러그인 루트에 두세요. .claude-plugin/ 안에 넣지 마세요!설치 & 공유
다른 사람이 만든 플러그인은 /plugins install 명령으로 설치할 수 있어요.
마켓플레이스 제출:
- Claude.ai: claude.ai/settings/plugins/submit
- Console: platform.claude.com/plugins/submit
기존 설정 → 플러그인 변환
| 독립 설정 (.claude/) | 플러그인 |
|---|---|
| 하나의 프로젝트에서만 사용 | 마켓플레이스로 공유 가능 |
.claude/commands/ | plugin-name/commands/ |
settings.json에 Hooks | hooks/hooks.json |
| 수동 복사해서 공유 | /plugins install로 설치 |