Claude Code 플러그인 완전 가이드: 개발부터 활용까지

{
  "name": "my-plugin",
  "description": "플러그인에 대한 간단한 설명",
  "version": "1.0.0",
  "author": {
    "name": "작성자 이름",
    "email": "[email protected]"
  },
  "license": "MIT",
  "claude": {
    "minVersion": "1.0.0"
  }
}

---
description: "명령어에 대한 간단한 설명"
argument-hint: "<required-arg> [optional-arg]"
allowed-tools: [Read, Glob, Grep, Bash]
model: "opus"
---

# 명령어 제목

명령어가 실행될 때 수행할 작업을 설명합니다...

## Arguments

사용자가 제공한 인수: $ARGUMENTS

---
name: specialist
description: "에이전트를 사용할 시기 설명"
model: inherit
color: yellow
tools: ["Read", "Grep", "Bash"]
---

당신은 전문 분야 전문가입니다...

**작업:**
1. 첫 번째 단계
2. 두 번째 단계
...

{
  "description": "훅 플러그인 설명",
  "hooks": {
    "PreToolUse": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/pretooluse.py",
            "timeout": 10
          }
        ]
      }
    ],
    "PostToolUse": [...],
    "UserPromptSubmit": [...],
    "Stop": [...]
  }
}

{
  "my-server": {
    "type": "http",
    "url": "https://api.example.com/mcp"
  },
  "local-server": {
    "type": "command",
    "command": "node",
    "args": ["server.js"]
  }
}

/plugin marketplace add your-org/claude-plugins

# 특정 플러그인 설치
/plugin install formatter@your-org

# 플러그인 활성화
/plugin enable plugin-name@marketplace-name

# 플러그인 비활성화 (제거하지 않음)
/plugin disable plugin-name@marketplace-name

# 플러그인 완전 제거
/plugin uninstall plugin-name@marketplace-name

mkdir -p hello-plugin/.claude-plugin
cd hello-plugin

{
  "name": "hello-plugin",
  "version": "1.0.0",
  "description": "간단한 인사말 명령을 제공합니다",
  "author": "your-name"
}

---
description: "친결한 인사말을 출력합니다"
---

안녕하세요! Claude Code 플러그인 개발에 온 것을 환영합니다!

/plugin marketplace add ./
/plugin install hello-plugin
/hello

---
description: "코드를 리뷰하고 개선 사항을 제안합니다"
parameters:
  - name: code
    description: "리뷰할 코드"
    required: true
---

# 코드 리뷰

제공된 코드를 분석하고 다음 측면에서 리뷰합니다:

1. **버그 및 잠니ial 오류**
2. **성능 최적화 기회**
3. **코드 스타일 일치성**
4. **보안 문제**

...

{
  "marketplaces": [
    "your-org/shared-plugins"
  ],
  "plugins": {
    "shared-formatter": {
      "source": "marketplace",
      "marketplace": "your-org/shared-plugins",
      "enabled": true
    }
  }
}

{
  "name": "project-formatter",
  "hooks": {
    "pre-commit": "format-code"
  }
}

---
description: "API 엔드포인트에서 문서를 생성합니다"
---

엔드포인트를 분석하고 OpenAPI 스펵명을 생성합니다...

{
  "hooks": {
    "after-success": "deploy-to-production"
  }
}

// 나쁜: 엔드포인트마다 분리된 도구
{
  "name": "list_users",
  "description": "사용자 목록을 가져옵니다"
}
{
  "name": "create_event",
  "description": "이벤트를 생성합니다"
}

// 좋은: 하나의 도구로 다단계 오퍼레이션 처리
{
  "name": "schedule_event",
  "description": "사용자를 탐색하고 이벤트를 예약합니다",
  "parameters": {
    "user_query": "사용자 탐색 쿼리",
    "event_details": "이벤트 세부 정보"
  }
}

{
  "asana_search": { "description": "Asana에서 탐색" },
  "asana_create": { "description": "Asana에 생성" },
  "jira_search": { "description": "Jira에서 탐색" },
  "jira_create": { "description": "Jira에 생성" }
}

// 나쁜
{
  "result": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "active"
  }
}

// 좋은
{
  "result": {
    "name": "프로젝트 알파",
    "status": "진행 중",
    "assignee": "김개발"
  }
}

{
  "name": "get_repository_info",
  "parameters": {
    "format": {
      "type": "string",
      "enum": ["concise", "detailed"],
      "description": "응답 형식"
    }
  }
}

{
  "hooks": {
    "pre-commit": {
      "enabled": false,
      "command": "security-scan"
    }
  }
}

{
  "mcpServers": {
    "database": {
      "enabled": false,
      "requireApproval": true,
      "description": "프로덕션 데이터베이스 접속"
    }
  }
}