플러그인

스킬, 에이전트, 훅, MCP 서버를 재사용 가능한 플러그인 번들로 패키징 및 배포

플러그인이란?

플러그인은 스킬, 에이전트, 훅, MCP 설정, 세팅을 배포 가능한 단위로 번들링하는 독립적인 패키지입니다. 팀 전체에 공유하거나 커뮤니티 마켓플레이스에 게시하세요.

네임스페이스 스킬

스킬이 충돌을 피하기 위해 /plugin-name:skill-name으로 네임스페이스됩니다

팀 배포

Git 리포, 레지스트리, 또는 공식 마켓플레이스를 통해 플러그인을 공유

이벤트 훅

Claude Code 라이프사이클 이벤트에 응답하는 훅을 번들

MCP & LSP 서버

MCP 서버 설정과 LSP 서버 지원을 포함

플러그인 구조

my-plugin/
├── .claude-plugin/
│   └── plugin.json      # Required: Plugin manifest
├── commands/            # Optional: Slash commands
│   ├── review.md
│   └── deploy.md
├── agents/              # Optional: Custom subagents
│   └── code-reviewer/
│       └── agent.md
├── skills/              # Optional: Agent Skills (NEW)
│   └── my-skill/
│       └── SKILL.md
├── hooks/               # Optional: Event handlers
│   └── hooks.json
├── .mcp.json            # Optional: MCP servers
└── .lsp.json            # Optional: LSP servers (NEW)

1.claude-plugin/plugin.json — 플러그인 매니페스트

이름, 버전, 설명, 작성자, 홈페이지, 리포지토리, 라이선스를 정의

2skills/ — 스킬 파일

플러그인 이름 아래 네임스페이스되는 SKILL.md 파일

3agents/ — 서브에이전트 정의

특화된 서브에이전트를 정의하는 마크다운 파일

4hooks/ — 이벤트 핸들러

Claude Code 이벤트에 응답하는 훅 스크립트

플러그인 만들기

플러그인 매니페스트

이름, 설명, 버전, 작성자, 홈페이지, 리포지토리, 라이선스가 포함된 .claude-plugin/plugin.json 생성

# commands/deploy.md
Run tests, build, and deploy to production.
Ensure all checks pass before deployment.

로컬 테스트

--plugin-dir을 사용하여 개발 중 플러그인을 로드. /reload-plugins로 핫 리로드.

{
  "name": "team-workflows",
  "version": "1.0.0",
  "description": "Team deployment workflows",
  "author": "Your Team"
}

플러그인 배포

프로젝트 레벨

프로젝트와 함께 버전 관리에 체크인

팀 레지스트리

Git 또는 내부 레지스트리를 통해 조직 전체에 공유

공식 마켓플레이스

claude.ai/settings/plugins/submit에서 공식 마켓플레이스에 제출

NEW

플러그인 마켓플레이스 CLI

claude plugins search <query>

Search plugins

claude plugins install <name>

Install plugin

claude plugins list

List installed

claude plugins update

Update all

NEW

LSP 서버 지원

플러그인은 .lsp.json을 통해 Language Server Protocol(LSP) 서버를 번들할 수 있습니다. 고급 언어 기능, 진단, IDE 통합 기능을 제공합니다.

.lsp.json
{
  "servers": {
    "typescript": {
      "command": "typescript-language-server",
      "args": ["--stdio"]
    },
    "python": {
      "command": "pylsp"
    }
  }
}

Auto-completion

Enhanced code suggestions

Diagnostics

Real-time error detection

Go to Definition

Navigate codebase easily

플러그인 활용 사례

팀 워크플로우

  • •표준화된 배포 절차
  • •코드 리뷰 템플릿과 에이전트
  • •문서 생성 파이프라인

도메인 전문가

  • •보안 감사 전문가
  • •데이터베이스 최적화 에이전트
  • •API 문서 생성기

모범 사례

1

철저한 문서화

플러그인이 무엇을 하는지, 어떻게 사용하는지 설명하는 명확한 README 파일을 제공하세요

2

시맨틱 버저닝 사용

호환성 관리를 위해 시맨틱 버저닝(major.minor.patch)을 따르세요

3

--plugin-dir로 테스트

배포 전에 --plugin-dir 플래그를 사용하여 플러그인을 로컬에서 로드하고 테스트하세요

4

보안 우선

플러그인에 시크릿을 포함하지 마세요. 민감한 데이터는 환경 변수를 사용하세요

첫 플러그인을 만들 준비가 되셨나요?

스킬, 에이전트, 훅, MCP 설정을 배포 가능한 플러그인으로 패키징하세요.

시작하기훅스