Claude Code 공식 플러그인 시스템 완전 정리

Anthropic이 `claude-code` 레포에 공식 플러그인 디렉토리를 추가했다. `/slash` 명령어, 전문화된 에이전트, 훅(Hook), MCP 서버를 묶어서 팀 단위로 공유할 수 있는 플러그인 시스템이다. 직접 써보면서 유용한 것들을 정리한다.

GitHub: [anthropics/claude-code](https://github.com/anthropics/claude-code) → `plugins/` 폴더

---

## Claude Code 설치

```bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# macOS (Homebrew)
brew install --cask claude-code

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

# Windows (WinGet)
winget install Anthropic.ClaudeCode
```

설치 후 프로젝트 폴더에서 `claude`를 실행하면 시작된다.

> npm 설치(`npm install -g @anthropic-ai/claude-code`)는 deprecated. 위 방법 중 하나를 사용할 것.

---

## 공식 플러그인 목록

현재 레포에 포함된 공식 플러그인들이다.

### `code-review` — PR 자동 코드 리뷰

```bash
/code-review
```

5개 Sonnet 에이전트가 병렬로 돌면서 PR을 검토한다.

- `CLAUDE.md` 준수 여부
- 버그 탐지
- 과거 커밋 맥락 분석
- PR 히스토리 검토
- 코드 코멘트

신뢰도 기반 점수 필터링으로 False Positive를 줄인다. 실제로 중요한 이슈만 올라온다.

---

### `commit-commands` — Git 워크플로우 자동화

```bash
/commit           # 현재 staged 변경사항 커밋
/commit-push-pr   # 커밋 + push + PR 생성 한 번에
/clean_gone       # 원격에서 삭제된 로컬 브랜치 정리
```

커밋 메시지를 Claude가 변경 내용 분석해서 자동 작성해준다. 귀찮은 반복 작업을 줄여준다.

---

### `security-guidance` — 보안 경고 훅

파일을 편집할 때 자동으로 보안 패턴을 감지해서 경고를 띄워준다.

모니터링하는 패턴:
- Command Injection
- XSS
- `eval()` 사용
- 위험한 innerHTML
- `pickle` 역직렬화
- `os.system()` 호출 등 9가지

`PreToolUse` 훅으로 작동한다. 코드 편집 전에 경고가 먼저 뜨는 방식.

---

### `feature-dev` — 기능 개발 워크플로우

```bash
/feature-dev
```

7단계 구조화 워크플로우로 진행된다.

1. 요구사항 분석 (`code-explorer` 에이전트)
2. 아키텍처 설계 (`code-architect` 에이전트)
3. 구현
4. 테스트
5. 리뷰 (`code-reviewer` 에이전트)
6. 문서화
7. 완료 확인

대형 기능 추가할 때 방향을 잃지 않게 도와준다.

---

### `pr-review-toolkit` — PR 리뷰 전문 에이전트 세트

```bash
/pr-review-toolkit:review-pr              # 전체 리뷰
/pr-review-toolkit:review-pr comments    # 코멘트만
/pr-review-toolkit:review-pr tests       # 테스트만
/pr-review-toolkit:review-pr errors      # 에러 처리만
/pr-review-toolkit:review-pr simplify    # 코드 단순화
```

전문 에이전트 6종이 각각 특화된 영역을 담당한다:
- `comment-analyzer`: 코드 코멘트 품질
- `pr-test-analyzer`: 테스트 커버리지
- `silent-failure-hunter`: 조용한 실패 패턴
- `type-design-analyzer`: 타입 설계
- `code-reviewer`: 일반 코드 품질
- `code-simplifier`: 복잡도 감소 제안

---

### `hookify` — 커스텀 훅 생성기

```bash
/hookify              # 원하지 않는 동작 방지 훅 생성
/hookify:list         # 등록된 훅 목록
/hookify:configure    # 훅 설정
```

Claude Code가 특정 동작을 하지 못하게 막는 커스텀 훅을 만들어준다. `conversation-analyzer` 에이전트가 대화 패턴을 분석해서 문제되는 행동을 식별한다.

---

### `plugin-dev` — 플러그인 개발 키트

직접 플러그인을 만들 때 사용한다.

```bash
/plugin-dev:create-plugin   # 8단계 가이드 워크플로우로 플러그인 생성
```

에이전트 3종 포함:
- `agent-creator`: 에이전트 설계
- `plugin-validator`: 플러그인 구조 검증
- `skill-reviewer`: 스킬 품질 검토

---

## 플러그인 구조

```
plugin-name/
├── .claude-plugin/
│   └── plugin.json     # 플러그인 메타데이터
├── commands/           # /slash 명령어
├── agents/             # 전문 에이전트
├── skills/             # 스킬 정의
├── hooks/              # 이벤트 핸들러
├── .mcp.json           # 외부 도구 설정 (선택)
└── README.md
```

---

## 플러그인 설치

```bash
# 프로젝트에서 claude 실행 후
/plugin install <marketplace-url>

# 또는 .claude/settings.json에 직접 설정
```

---

## 써보고 느낀 점

**바로 쓸 만한 것**: `commit-commands`의 `/commit-push-pr`은 실제로 시간 절약이 된다. 커밋 메시지 고민하는 시간이 줄어든다.

**팀 단위로 유용한 것**: `code-review`와 `pr-review-toolkit`은 개인보다 팀에서 진가를 발휘한다. PR 리뷰 기준을 통일할 수 있다.

**재미있는 것**: `hookify`는 Claude가 특정 패턴의 코드를 생성하지 못하게 막는 훅을 Claude 자신이 만들어주는 구조다. 메타적으로 흥미롭다.

**링크**: [공식 플러그인 문서](https://docs.claude.com/en/docs/claude-code/plugins) | [GitHub 플러그인 폴더](https://github.com/anthropics/claude-code/tree/main/plugins)

Claude Code 공식 플러그인 시스템 완전 정리

// COMMENTS

ON THIS PAGE