🔌 Claude Code /plugin 완벽 가이드 — 클코 플러그인 추천! (++BKIT)

안녕하세요! 트윅히 입니다.!

 

오늘은 클로드 코드 플러그인에 대해서 다뤄볼게요

저도 너무 쉽게 설치 할 수 있어서 좋았어요!

진짜 저한테도 도움이 됐던 거라 여러분들에게도 분명 도움이 될거라 생각합니다.

 

Claude Code의 확장성을 극대화하는 플러그인 시스템, 제대로 파헤쳐 봅니다.

---

📋 목차

1. 플러그인이 뭔가요?
2. 플러그인의 구성 요소
3. 플러그인 설치 방법
4. 주목할 만한 공식 플러그인들
5. MCP 서버 플러그인 추천
6. 🌟 커뮤니티 추천: bkit (Vibecoding Kit)
7. Kotlin/Spring Boot 프로젝트에 활용하기
8. 플러그인을 직접 만들 수도 있어요
9. 마치며

---

플러그인이 뭔가요?

Claude Code를 쓰다 보면 자연스럽게 이런 고민이 생깁니다.

"내가 만든 슬래시 커맨드, 팀원한테도 쓰게 해주고 싶은데... MCP 설정도 같이 공유하면 좋겠는데..."

 

그 고민을 해결해 주는 게 바로 /plugin이에요. 🎉

플러그인은 슬래시 커맨드, 에이전트, 훅, MCP 서버를 하나의 패키지로 묶어서 프로젝트나 팀 전체에 공유할 수 있는 확장 단위예요.

2025년 10월 9일에 퍼블릭 베타로 공개됐고, 지금은 모든 Claude Code 사용자가 쓸 수 있습니다.

한마디로 표현하면, "내 개발 환경 세팅을 통째로 패키징해서 한 줄로 설치" 하는 개념이에요.

 

---

플러그인 설치 방법

설치는 정말 간단해요. Claude Code 안에서 /plugin 명령어로 바로 진행할 수 있습니다.

아마 다들 설치 안하셔도 (클코 업데이트는 혹시 모르니 진행해주세요)

claude-plugins-official 가 이미 설치 되어 있을 겁니다.!!

 

외부 마켓 플레이스 설치 방법 (공식 마켓 플레이스 만으로도.. 플러그인 개 많음!!)

# 1. 마켓플레이스 추가
/plugin marketplace add popup-studio-ai/bkit-claude-code

# 2. 플러그인 탐색 (대화형 메뉴)
/plugin

# 3. 바로 설치
/plugin install [이름]

 

마켓플레이스는 GitHub 레포를 그대로 활용해요.

.claude-plugin/marketplace.json 파일만 있으면 누구나 마켓플레이스를 만들 수 있고,

팀 내부 전용 플러그인 저장소를 운영하는 것도 가능합니다.

 

탐색하면서 엔터 누르고 설정 범위를 선택하면 자동으로 설치가 됩니다.

 

어떤 게 설치 됐는 지도 확인 가능

---

주목할 만한 공식 플러그인들

Anthropic 공식 마켓플레이스(anthropics/claude-code)에 있는 플러그인들 중 실제로 유용한 것들을 소개할게요.

🔍 code-review — 병렬 멀티 에이전트 PR 리뷰

PR을 올리기 전에 자동으로 리뷰해주는 플러그인이에요. 단순히 Claude 하나가 보는 게 아니라, 5개의 병렬 Sonnet 에이전트가 각자 다른 관점에서 분석합니다.

• CLAUDE.md 준수 여부
• 버그 탐지
• PR 히스토리 맥락
• 코드 코멘트 품질
• 히스토리컬 컨텍스트

팀 컨벤션을 지키지 않은 코드나, 조용한 실패(silent failure)가 있는 부분도 잡아줘서 실제로 꽤 유용해요.

🚀 feature-dev — 요구사항부터 구현까지 7단계 워크플로우

현재 가장 인기 있는 플러그인입니다 (89,000+ 설치). 새로운 기능 개발 시 이런 흐름으로 진행돼요:

1. 요구사항 수집
2. 코드베이스 탐색
3. 설계
4. 구현
5. 테스트
6. 리뷰
7. 마무리

막연하게 "이 기능 만들어줘" 했을 때 Claude가 무작정 코드부터 짜는 게 아니라, 단계별로 확인하면서 진행한다는 게 포인트예요.

 

---

MCP 서버 플러그인 추천

📚 Context7 — 최신 공식 문서를 세션에 직접 주입

LLM의 고질적인 문제 중 하나가 학습 데이터 기반의 환각(hallucination)이죠. Context7은 현재 사용 중인 라이브러리의 버전별 최신 공식 문서를 세션에 직접 주입해줘서, "이건 deprecated됐는데요?" 같은 당황스러운 상황을 방지해줘요.

Spring Boot나 Kotlin 작업할 때 API가 버전마다 살짝씩 다른 경우가 많은데, 이게 정말 유용하더라고요.

🐙 GitHub MCP — 공식 GitHub 연동

repo 관리, PR 생성/리뷰, 이슈 트래킹, CI/CD 워크플로우 확인까지 Claude Code 안에서 바로 처리할 수 있어요.

---

🌟 외부 마켓 플레이스 플러그인 추천: bkit (Vibecoding Kit)

공식 플러그인 말고도 커뮤니티에서 만든 플러그인 중에 퀄리티가 정말 높은 게 있어요. 그 중에서도 bkit은 한 번쯤 꼭 써봐야 할 것 같아서 따로 소개합니다.

공식 사이트: bkit.ai · GitHub: popup-studio-ai/bkit-claude-code

bkit이 뭔가요?

bkit(Vibecoding Kit)은 Claude Code를 위한 프로덕션 수준 플러그인으로,

PDCA(Plan-Do-Check-Act) 방법론과 9단계 개발 파이프라인을 통해 AI와 함께 체계적으로 소프트웨어를 개발할 수 있게 해줍니다.

"AI한테 코드 짜달라고 시키는 도구"가 아니라,

"AI와 함께 개발 프로세스 자체를 설계하는 프레임워크" 에 가깝다는 표현이 딱 맞는 것 같아요.

 

PDCA가 생소하신 분들을 위해 간단히 설명하면:

단계	역할
Plan	요구사항 분석 → 계획 문서 자동 생성
Do	설계 → 구현
Check	갭 분석, 리팩토링, 코드 리뷰
Act	완료 리포트, 회고, 반복 개선

 

이 사이클을 Claude Code 안에서 명령어 한두 개로 돌릴 수 있게 만들어놨어요.

9단계 개발 파이프라인

bkit의 핵심은 **9개의 개발 단계(Phase)**를 순서대로 밟아가는 파이프라인이에요. 각 단계 안에서 PDCA 미니 사이클이 돌아가는 구조입니다.

Phase 1: Schema/Terminology  ──→ 데이터 구조 & 도메인 용어 정의
Phase 2: Coding Convention   ──→ 코딩 컨벤션 확립
Phase 3: Mockup Development  ──→ HTML/CSS/JS + JSON으로 기능 검증
Phase 4: API Design/Impl     ──→ 백엔드 API 구현 + Zero Script QA
Phase 5: Design System       ──→ 컴포넌트 시스템 구축
Phase 6: UI Implementation   ──→ 실제 UI 구현 + API 연동
Phase 7: SEO/Security        ──→ 검색 최적화 & 보안 강화
Phase 8: Review              ──→ 아키텍처/컨벤션 품질 검증
Phase 9: Deployment          ──→ 프로덕션 배포

 

 

각 Phase 안에서는 이런 미니 사이클이 돌아요:

 

Phase N
├── Plan   → 무엇을 할지 계획
├── Design → 상세 설계
├── Do     → 구현
├── Check  → 품질 검증
└── Act    → 확인 후 다음 단계로

 

처음 보면 "이걸 다 해야 해...?" 싶을 수 있는데, 각 Phase는 선택적으로 건너뛸 수 있고, 프로젝트 규모에 따라 필요한 단계만 쓰는 방식이라 실제로는 꽤 유연해요.

프로젝트 규모별 3가지 레벨

bkit은 프로젝트 성격에 맞게 세 가지 레벨로 초기화할 수 있어요.

레벨언제 쓰나요?특징

Starter	정적 사이트, 포트폴리오, 랜딩 페이지	백엔드 없음 (Phase 4 스킵)
Dynamic	로그인/DB가 있는 풀스택 앱	BaaS로 백엔드 처리
Enterprise	마이크로서비스, K8s, Terraform	직접 백엔드 구현

Spring Boot 백엔드 프로젝트라면 Enterprise 레벨이 딱 맞겠죠?

어떤 게 들어있나요?

bkit에는 31개의 에이전트와 36개의 스킬이 포함되어 있으며, 워크플로우(17개) / 캐퍼빌리티(18개) / 하이브리드(1개)로 분류되어 있습니다. 꽤 규모가 있죠?

핵심 명령어들을 보면 이런 식이에요:

# Claude Code + bkit 학습부터 시작
/bkit:learn-claude-code

# 프로젝트 규모에 맞게 초기화 (starter / dynamic / enterprise)
/bkit:init-starter
/bkit:init-dynamic
/bkit:init-enterprise

# PDCA 워크플로우 실행
/pdca plan     # 기획 및 설계 문서 생성
/pdca do       # 구현
/pdca analyze  # 분석 및 갭 탐지
/pdca report   # 완료 리포트

Skills도 슬래시 커맨드처럼 직접 부르는 게 아니라, 맥락을 보고 Claude가 자동으로 적용하는 방식이라 쓰다 보면 "어? 이것도 해줬네" 하는 순간이 꽤 많이 생겨요.

 

 

설치 방법

# 1. bkit 마켓플레이스 추가
/plugin marketplace add popup-studio-ai/bkit-claude-code

# 2. bkit 설치
/plugin install bkit

# 처음 시작하는 분들은 가벼운 스타터 버전도 있어요
/plugin install bkit-starter

커스터마이징이 진짜 잘 돼요

bkit의 중요한 특징은 "원본 플러그인은 유지하되, 필요한 부분만 내 프로젝트에 덮어써 쓰는" 방식의 커스터마이징입니다.

Claude Code는 설정과 구성 요소를 불러올 때 프로젝트의 .claude/ 폴더 → 사용자 전역 ~/.claude/ → 플러그인 설치 경로 순으로 우선순위를 두기 때문에, 플러그인 파일 중 일부를 프로젝트 내 .claude/로 복사해 수정하면 그 파일만 커스텀 버전으로 작동하고 나머지는 플러그인 기본값을 그대로 사용합니다.

 

플러그인이 업데이트돼도 내가 수정한 파일은 건드리지 않으니까, 팀 맞춤 설정을 유지하면서 업스트림 개선사항을 계속 받아올 수 있어요. 설계가 꽤 영리한 편입니다.

bkit을 추천하는 이유

솔직히 말하면, 처음엔 "이렇게 많은 에이전트랑 스킬이 필요할까?" 싶었어요.

그런데 실제로 써보니까 "AI에게 시키는 개발"이 아니라 "AI와 함께하는 개발" 의 차이가 느껴지는 플러그인이더라고요.

특히 새 기능을 기획 단계부터 잡아야 할 때, bkit의 PDCA 흐름이 Claude의 사고 과정을 구조화해줘서 결과물 퀄리티가 확실히 달라집니다.

💡 참고로 bkit은 Apache 2.0 라이선스로 공개돼 있어서, 조직 내부용 플러그인 베이스로 활용하거나 커스터마이징해서 사용하는 것도 자유롭게 가능해요.

 

 

---

🔥 플러그인을 직접 만들 수도 있어요

GitHub 레포 하나만 있으면 누구나 플러그인을 만들고 마켓플레이스를 운영할 수 있어요.

커뮤니티에서도 활발하게 공유되고 있고, DevOps 자동화, 문서 생성, 테스트 스위트 등 다양한 플러그인들이 이미 올라와 있습니다.

-> 만드는 방법이 궁금하시면 댓글 달아주세요!!

---

마치며

처음에 Claude Code를 "그냥 AI 코딩 어시스턴트" 정도로 생각했는데,

플러그인 시스템을 보고 나니 에이전트 오케스트레이션 프레임워크에 더 가깝다는 느낌이 들었어요.

 

특히 팀에서 협업할 때, 각자 다른 환경 세팅으로 인한 "제 로컬에선 됐는데요?" 문제를 플러그인으로 많이 줄일 수 있을 것 같습니다.

방향성 자체는 굉장히 좋아 보여요.

한번 /plugin marketplace add anthropics/claude-code로 시작해보세요! 🚀

 

 

항상 여러분의 댓글은.. 도움이 됩니다. ❤️