plugin.json
플러그인이란?
플러그인은 커스텀 슬래시 명령, 전문 에이전트, 스킬, 훅, MCP 서버 통합으로 Claude Code를 확장하는 패키지입니다. 프로젝트와 팀 간에 공유할 수 있습니다.
● ● ● .claude-plugin/plugin.json
{
"name": "my-plugin",
"description": "A useful plugin for...",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
왜 플러그인을 사용하나요?
📦
올인원 패키지
명령, 에이전트, 스킬, 훅을 단일 설치 패키지로 묶습니다.
🚀
쉬운 배포
마켓플레이스를 통해 공유. 단일 명령으로 설치.
👥
팀 협업
설정에서 팀 플러그인 구성. 모든 멤버에게 자동 설치.
🏷️
네임스페이스 명령
충돌 방지를 위해 플러그인 명령에 접두사 사용. /plugin-name:command
Components
플러그인 구성요소
⌨️
슬래시 명령
마크다운 형식의 커스텀 /명령
🤖
에이전트
특정 작업을 위한 전문 서브에이전트
🎯
스킬
자동 활성화되는 지식 파일
⚡
훅
이벤트 기반 자동화 스크립트
🔌
MCP 서버
외부 도구 통합
Structure
플러그인 구조
● ● ● Plugin Directory
my-plugin/
├── .claude-plugin/
│ └── plugin.json # Plugin metadata & manifest
├── .mcp.json # MCP server configurations
├── commands/ # Slash commands
│ └── hello.md
├── agents/ # Custom agents
│ └── reviewer.md
├── skills/ # Skills (SKILL.md files)
│ └── react/
│ └── SKILL.md
└── hooks.json # Event-driven hooks
Installation
설치 및 설정
Install from marketplace
$ /plugin install my-plugin@marketplace
Add marketplace
$ /plugin marketplace add org/plugins
Local development
$ claude --plugin-dir ./my-plugin
# Create your first plugin
mkdir -p my-plugin/.claude-plugin
touch my-plugin/.claude-plugin/plugin.json
Examples
예제 Plugins
✨
코드 품질 팩
린팅, 포맷팅, 리뷰 명령을 함께 묶음
📚
문서화 스위트
문서 생성을 위한 에이전트와 명령
🧪
테스팅 툴킷
테스트 생성, 커버리지, CI 통합
Community
커뮤니티 & 기여하기
Claude Code 커뮤니티와 플러그인을 빌드하고 공유하세요.