[공식문서읽기] Claude Code Plugins 완벽 가이드 - 확장 기능으로 개발 생산성 극대화하기

Claude Code Plugins는 Claude Code의 기능을 확장하는

강력한 시스템입니다. 커스텀 슬래시 명령어, 전문화된 에이전트, 훅(Hooks), MCP 서버를 통해 개발 워크플로우를 자동화하고 팀 전체에서 일관된 도구를 공유할 수 있습니다. 2026년 현재 Anthropic에서 공식 관리하는 플러그인 마켓플레이스가 활성화되어 있으며, 누구나 자신만의 플러그인을 개발하고 배포할 수 있습니다.

플러그인 시스템 구조

Claude Code 플러그인은 표준화된 디렉토리 구조를 따릅니다. 각 구성 요소는 선택사항이므로 필요한 기능만 구현하면 됩니다.

plugin-name/
├── .claude-plugin/
│   └── plugin.json          # 플러그인 메타데이터 (필수)
├── commands/                # 슬래시 명령어
├── agents/                  # 전문화된 에이전트
├── skills/                  # 에이전트 스킬
├── hooks/                   # 이벤트 핸들러
├── .mcp.json               # 외부 도구 연동 설정
└── README.md               # 문서

핵심 구성 요소

Commands (슬래시 명령어): 사용자가 / 입력 후 실행하는 명령어입니다. /code-review, /deploy 같은 형태로 특정 작업을 트리거합니다.

Agents (전문화된 에이전트): 특정 작업에 최적화된 AI 에이전트입니다. 코드 분석, 아키텍처 설계, 보안 검토 등 전문 영역별로 구성됩니다.

Skills (스킬): 도메인 지식을 주입하는 마크다운 파일입니다. Claude가 자동으로 로드하거나 사용자가 직접 호출할 수 있습니다.

Hooks (훅): 특정 이벤트 발생 시 자동 실행되는 핸들러입니다. SessionStart, PreToolUse, Stop 등의 이벤트를 감지합니다.

MCP Integration: Model Context Protocol을 통해 외부 도구 및 서비스와 연동합니다.

 

---

공식 플러그인 마켓플레이스

Anthropic에서 관리하는 공식 플러그인 저장소에서 검증된 플러그인을 설치할 수 있습니다.

주요 공식 플러그인

플러그인	명령어	기능
Code Review	/code-review	5개의 병렬 Sonnet 에이전트로 PR 자동 리뷰
Feature Dev	/feature-dev	7단계 가이드 기능 개발 워크플로우
Agent SDK	/new-sdk-app	Agent SDK 프로젝트 인터랙티브 설정
Plugin Dev	/plugin-dev:create-plugin	8단계 플러그인 개발 가이드
PR Review Toolkit	/pr-review-toolkit:review-pr	6개 전문 에이전트 PR 분석

외부 파트너 플러그인

커뮤니티와 파트너사에서 제공하는 플러그인도 사용할 수 있습니다.

• Firecrawl: 웹 스크래핑 및 크롤링, LLM 친화적 마크다운 변환
• Semgrep: 실시간 보안 취약점 탐지
• Sonatype Guide: 소프트웨어 공급망 보안 및 의존성 분석

 

---

 

플러그인 설치 방법

VS Code에서 설치

VS Code 확장 프로그램에서 플러그인 관리 UI를 제공합니다.

프롬프트 창에서 /plugins 입력 → Manage plugins 인터페이스 열기

CLI에서 설치

/plugin install {plugin-name}@claude-plugin-directory

또는 Claude Code 내에서 /plugin > Discover로 검색하여 설치할 수 있습니다.

 

 

나만의 플러그인 만들기

1단계: 플러그인 구조 생성

mkdir -p my-plugin/.claude-plugin
mkdir -p my-plugin/commands
mkdir -p my-plugin/skills

2단계: 메타데이터 작성

.claude-plugin/plugin.json 파일을 생성합니다.

{
  "name": "my-awesome-plugin",
  "version": "1.0.0",
  "description": "나만의 멋진 플러그인"
}

3단계: 슬래시 명령어 추가

commands/my-command.md 파일을 생성합니다.

---
name: my-command
description: 내 커스텀 명령어
---

이 명령어가 실행되면 다음을 수행합니다:

1. $ARGUMENTS에서 입력값 확인
2. 작업 실행
3. 결과 반환

4단계: 스킬 추가 (선택사항)

skills/my-skill/SKILL.md 파일을 생성합니다.

---
name: my-skill
description: 코드 작성 시 적용할 규칙
disable-model-invocation: false
---

## 코딩 규칙

- 모든 함수에 타입 어노테이션 추가
- 에러 핸들링 필수
- 테스트 코드 작성

 

Skills vs Commands vs Plugins

Claude Code에서 확장 기능을 만드는 세 가지 방법의 차이점을 이해하는 것이 중요합니다.

특성	Commands	Skills	Plugins
저장 위치	.claude/commands/	.claude/skills/	별도 저장소
호출 방식	사용자 수동 호출	자동 또는 수동	설치 후 사용
공유 범위	프로젝트/개인	프로젝트/개인	마켓플레이스
구성 요소	단일 명령어	명령어 + 지원 파일	전체 시스템

핵심 포인트: 2026년 업데이트로 Commands가 Skills 시스템에 통합되었습니다. 기존 .claude/commands/ 파일은 계속 작동하지만, Skills는 지원 파일, 자동 호출 설정 등 추가 기능을 제공합니다.

 

실전 활용 예제

코드 리뷰 자동화

Code Review 플러그인을 활용한 PR 리뷰 워크플로우입니다.

# PR 코드 리뷰 실행
/code-review

# 5개의 전문 에이전트가 병렬로 분석:
# - 코드 품질
# - 테스트 커버리지
# - 보안 취약점
# - 타입 안전성
# - 에러 핸들링

기능 개발 가이드

Feature Dev 플러그인으로 체계적인 기능 개발을 진행합니다.

/feature-dev "사용자 인증 시스템"

# 7단계 워크플로우:
# 1. 요구사항 분석
# 2. 코드베이스 탐색
# 3. 아키텍처 설계
# 4. 구현
# 5. 테스트
# 6. 코드 리뷰
# 7. 문서화

보안 모니터링

Security Guidance 플러그인은 9가지 보안 패턴을 실시간 모니터링합니다.

• XSS (크로스 사이트 스크립팅)
• Command Injection
• SQL Injection
• Path Traversal
• 하드코딩된 시크릿
• 안전하지 않은 역직렬화
• SSRF
• 인증 우회
• 권한 상승

 

플러그인 개발 모범 사례

문서화

• 모든 명령어와 에이전트에 대한 상세 설명 작성
• 사용 예제 제공
• 설치 및 설정 가이드 포함

에러 핸들링

• 명확한 에러 메시지 제공
• 실패 시 복구 경로 안내
• 로깅으로 디버깅 지원

성능 최적화

• 병렬 처리 가능한 작업 분리
• 불필요한 컨텍스트 로딩 최소화
• 캐싱 활용

 

마무리

Claude Code Plugins는 개발 워크플로우를 혁신적으로 개선할 수 있는 강력한 도구입니다. 공식 마켓플레이스에서 검증된 플러그인을 설치하거나, 팀의 필요에 맞는 커스텀 플러그인을 개발하여 생산성을 극대화해보세요.

시작하기 팁:

1. 먼저 공식 플러그인(Code Review, Feature Dev)을 설치하여 체험해보세요
2. Plugin Dev 플러그인으로 나만의 첫 플러그인을 만들어보세요
3. 팀 내 반복 작업을 자동화하는 플러그인을 고려해보세요

 

참고 자료

• Claude Code Plugins 공식 저장소
• Anthropic 공식 플러그인 디렉토리
• Claude Code Skills 공식 문서
• Claude Code IDE 통합 가이드

이 글은 Claude Code를 활용하여 작성되었습니다.