Claude Code플러그인SkillMCPLSPSuperpowersECCGSDBMAD에이전트 워크플로튜토리얼
Claude Code 플러그인·스킬 생태계 가이드 2026 — 뭘 깔아야 하고, 뭘 같이 깔면 안 되는가
Claude Code 확장 생태계는 이제 '프롬프트 모음'이 아니라 Skill·Plugin·Hook·MCP·LSP가 얽힌 하나의 플랫폼입니다. 2026년 8월 기준으로 가장 많이 쓰이는 워크플로 프레임워크(Superpowers, ECC, GSD, BMAD, OMC, Ruflo), Anthropic 공식 플러그인, MCP·LSP 도구를 역할별로 정리하고, 초보자가 10분 만에 따라 할 수 있는 첫 설치 순서와 상황별 추천 구성, 절대 함께 설치하면 안 되는 조합, 설치 전 보안 체크리스트까지 담았습니다.
Claude Code를 쓰기 시작하면 한 달 안에 반드시 이런 장면을 만납니다. 유튜브나 X에서 "이 플러그인 하나로 생산성 10배"라는 글을 보고 설치하고, 다음 주에 또 다른 걸 설치하고, 어느 날부터 Claude가 질문 하나에 서브에이전트 다섯 개를 띄우며 토큰을 태우는데 왜 그러는지 본인도 모르는 상태가 됩니다. 설치한 프레임워크 세 개가 각자 "계획부터 세워라"고 Hook으로 끼어들고 있기 때문입니다.
이 글은 그 반대로 갑니다. 2026년 8월 22일 기준으로 실제로 많이 쓰이는 것들을 역할별로 딱 하나씩 고르는 방법, 초보자가 10분 만에 따라 할 수 있는 첫 설치 순서, 그리고 절대 함께 깔면 안 되는 조합을 정리했습니다. 별 개수는 조회 당시 표시값이고 계속 바뀝니다. 인지도 지표일 뿐 품질이나 안전성 보증이 아닙니다.
먼저 결론 — 처음이라면 이 구성
전부 읽을 시간이 없다면 이것만 기억하면 됩니다.
✕
하지 말아야 할 것
유명한 프레임워크(Superpowers, ECC, GSD, BMAD…)를 전부 설치하기. 전부 "계획·테스트·리뷰"를 건드리므로 Hook이 중복 실행되고 컨텍스트가 오염됩니다.
→
대신 이렇게
공식 진단 플러그인 1개 + 워크플로 프레임워크 1개 + 언어별 LSP + 꼭 필요한 MCP 2~4개 + 코드 리뷰 도구 1개. 각 도구의 역할이 겹치지 않게.
✓
구체적인 첫 세트
claude-code-setup → Superpowers → typescript-lsp(또는 pyright-lsp) → Context7 → Playwright → pr-review-toolkit. 여기에 GitHub·Sentry·Vercel 등 실제 쓰는 서비스 MCP만 추가.
1. 용어부터 — Skill, Plugin, Hook, MCP, LSP는 뭐가 다른가
Claude Code 확장 기능은 이름이 비슷해 보여도 언제 컨텍스트에 올라가느냐가 전혀 다릅니다. 이걸 모르면 "왜 아무것도 안 했는데 컨텍스트가 꽉 차지?"라는 상황을 겪게 됩니다.
구성 요소
역할
컨텍스트 비용
적합한 용도
CLAUDE.md
프로젝트의 상시 규칙
항상 로드
코드 스타일, 빌드 명령, 금지사항
Skill
필요할 때 불러오는 전문 절차
설명만 상시, 본문은 호출 시
배포 절차, 리뷰 체크리스트, 장애 대응
Plugin
Skill·Agent·Hook·MCP·LSP를 묶은 배포 단위
구성에 따라 다름
확장 패키지 설치·업데이트
Subagent
별도 컨텍스트에서 특정 작업 수행
메인 컨텍스트와 격리
조사, 리뷰, 테스트, 보안 분석
Hook
특정 이벤트에 자동 실행
출력이 없으면 거의 0
위험 명령 차단, 포맷 검사, 로그
MCP
외부 서비스·데이터·도구 연결
도구 이름·스키마만큼 상시 비용
GitHub, DB, 브라우저, 문서
LSP
코드 심볼·정의·참조 탐색
매우 낮음
정확한 코드 탐색
핵심만 다시 풀면 이렇습니다.
CLAUDE.md는 매 턴 읽히므로 짧아야 합니다. Anthropic도 약 200줄 이하를 권합니다. 10~20개의 핵심 규칙만 넣고 긴 절차는 Skill로 빼세요.
Skill은 SKILL.md 파일 하나가 중심입니다. 설명(description)만 항상 올라가 있다가, 관련 작업이 오면 본문 전체를 읽습니다. 예전의 slash command도 지금은 이 체계로 통합되는 방향입니다.
Hook은 "판단"이 아니라 "반드시 실행되어야 하는 규칙"에 씁니다. "main에 직접 push 금지" 같은 것. Claude가 잊을 수 있는 건 Hook으로, Claude가 판단해야 하는 건 Skill로.
MCP는 편하지만 연결한 서버의 도구 목록이 통째로 컨텍스트에 올라갑니다. 안 쓰는 MCP는 꺼두는 것이 곧 성능입니다.
LSP는 가장 저평가된 항목입니다. 연결하면 Claude가 grep으로 이름을 추측하는 대신 "정의로 이동, 참조 찾기, 타입 확인"을 정확히 합니다. 비용도 가장 낮습니다.
무엇을 어디에 넣어야 하나
항상 지켜야 할 10~20개 규칙
→
CLAUDE.md
긴 개발 절차·배포 체크리스트
→
Skill
독립적으로 수행할 역할(조사·리뷰)
→
Subagent
위험 명령 차단·자동 검사
→
Hook
GitHub·브라우저·DB 접근
→
MCP
정의 이동·참조 검색·심볼 탐색
→
LSP
2. 10분 따라하기 — 첫 설치 순서
Claude Code 안에서 그대로 입력하면 됩니다. 순서에 이유가 있으니 바꾸지 마세요.
1단계
설치 전 백업. 전역 설정을 건드리는 도구가 있으니 터미널에서 cp -R ~/.claude ~/.claude.backup 하고, 프로젝트는 git commit으로 깨끗한 상태를 만듭니다.
2단계
공식 진단 플러그인./plugin install claude-code-setup@claude-plugins-official — 저장소를 읽기 전용으로 분석해서 "이 프로젝트에는 어떤 Hook·Skill·MCP가 맞다"를 추천합니다. 무작정 깔기 전에 이것부터.
3단계
워크플로 프레임워크 딱 하나. 기본값은 /plugin install superpowers@claude-plugins-official. 아래 3절에서 다른 선택지를 비교합니다.
4단계
언어별 LSP./plugin install typescript-lsp@claude-plugins-official 또는 pyright-lsp. 쓰는 언어만.
5단계
최신 문서 + 브라우저./plugin install context7@claude-plugins-official, /plugin install playwright@claude-plugins-official. 웹 개발이면 사실상 필수.
다른 프레임워크와 결정적으로 다른 점은, 프로젝트 상태를 Markdown 산출물로 보존하고 각 실행 단계마다 새로운 컨텍스트의 Agent를 쓴다는 것입니다. 긴 세션에서 Claude가 앞선 요구사항을 잊는 문제(Context Rot)를 정면으로 다룹니다.
좋은 점: 수일~수개월 프로젝트, 세션을 끊었다 이어가는 작업에 강합니다. 기존 프로젝트 온보딩(/gsd-onboard)도 있습니다.
불편한 점: 계획·상태 파일이 많이 생깁니다. 짧은 작업에는 과합니다.
hljs language-bash
npx @opengsd/gsd-core@latest
3-5. BMAD Method — 제품 기획과 아키텍처
코딩 플러그인이 아니라 AI 기반 Agile 제품 개발 방법론입니다. 아이디어를 PRD, 사용자 스토리, 아키텍처, 구현 계획, 테스트 전략으로 구체화하고, 기획자·아키텍트·개발자·QA 역할을 나눕니다.
좋은 점: 코드 전에 요구사항을 깊이 정리합니다. 이해관계자가 많은 공공·기업 구축 사업에 맞습니다.
불편한 점: 작은 프로젝트엔 지나치게 무겁습니다. Node.js 20.12 이상, 일부 기능은 Python과 uv가 필요합니다.
hljs language-bash
npx bmad-method install
3-6. Oh My ClaudeCode(OMC) — 실행 중심 다중 Agent
/autopilot으로 작업을 자동 분해하고, 팀 기반 병렬 처리·단계별 파이프라인·HUD·사용자 Skill 추출을 제공합니다. Codex·Gemini를 tmux worker로 붙이는 기능도 있습니다.
좋은 점: 설정 없이 다중 Agent 경험을 바로 시작할 수 있고, 진행 상태를 HUD로 봅니다.
불편한 점: 단순 작업에도 여러 Agent가 뜹니다. 비용 예측이 어렵습니다. tmux에 익숙해야 전부 활용합니다.
3-7. Ruflo — 가장 야심 찬 Swarm 시스템
대규모 Agent Swarm, 공유 메모리, 학습, Agent Federation을 얹는 메타 하네스. 전체 설치 시 .claude/, .claude-flow/, CLAUDE.md, Hook, MCP, daemon, 약 98개 Agent, 60개 이상 명령, 30개 이상 Skill이 프로젝트에 추가·변경됩니다.
"일단 깔아보는 도구"가 아니라, 명확한 다중 Agent 연구 목표가 있을 때 별도 저장소에서 평가할 시스템입니다. 일반 웹 개발에는 과합니다.
3-8. SuperClaude — 검증된 구형 프레임워크
네이티브 Plugin 체계 전부터 쓰이던 대형 설정 프레임워크. 약 30개 명령, 20개 Agent, 7개 동작 모드, 8개 MCP 통합을 ~/.claude에 전역 설치합니다. 커뮤니티와 문서는 탄탄하지만 최신 Plugin 관리 방식과는 결이 다릅니다. 신규 사용자라면 Superpowers·ECC·GSD를 먼저 보는 편이 낫습니다.
어떤 걸 고를까 — 한 줄 판단
Claude Code 처음 / 팀 방법론 없음
→
Superpowers
Superpowers가 너무 엄격함
→
Addy Agent Skills
수개월짜리 프로젝트, 세션 끊김 잦음
→
GSD Core
PRD·아키텍처 문서가 필요한 구축 사업
→
BMAD
팀 전체 표준 환경, 여러 언어
→
ECC
병렬 Agent 실행을 적극 활용
→
Oh My ClaudeCode
4. Anthropic 공식 플러그인 — 안심하고 조합할 수 있는 것들
claude-plugins-official Marketplace에 올라 있는 것들입니다. 워크플로 프레임워크와 달리 역할이 좁아서 하나 고른 프레임워크 위에 얹어도 충돌이 적습니다.
플러그인
하는 일
언제 설치
claude-code-setup
저장소를 읽기 전용 분석 → 맞는 Hook·Skill·MCP·Subagent·CLAUDE.md 개선점 추천
가장 먼저
claude-md-management
/revise-claude-md로 CLAUDE.md의 중복·모호함·비대화 정리, 작업 중 배운 지식 반영
프로젝트가 오래될수록
feature-dev
기능 개발을 7단계(요구 파악→조사→질문→설계→구현→리뷰→검증)로
Superpowers 없이 가볍게 절차만 원할 때
frontend-design
획일적인 "AI 스타일" UI를 줄이고 개성 있는 인터페이스 유도
프론트엔드 작업이 많을 때
code-review
4개 Agent 병렬 리뷰 + 발견 사항 신뢰도 점수
둘 중 하나
pr-review-toolkit
일반 리뷰·테스트 품질·주석 정확성·조용히 무시된 오류·타입 설계·단순화 전문 Agent
둘 중 하나 (더 세밀)
hookify
Markdown 규칙을 Hook으로 변환, 재시작 없이 적용
테스트 저장소에서 먼저 검증
plugin-dev
사내 Plugin 제작 도구
팀 공통 규칙 배포할 때
skill-creator
Skill 초안·트리거 개선·테스트 케이스·호출 정확도 평가
Skill을 직접 만들 때
ralph-loop
완료 조건을 만족할 때까지 반복 실행 (실험적)
격리된 테스트 프로젝트에서만
몇 가지 보충합니다.
feature-dev는 Superpowers의 축소판입니다. 공식 문서도 "단순 버그 수정이나 한 줄 변경에는 맞지 않는다"고 말합니다. Superpowers를 깔았다면 따로 필요 없습니다.
code-review vs pr-review-toolkit은 역할이 겹칩니다. 처음엔 하나만. 더 세밀한 쪽(테스트 품질, 조용히 무시된 에러, 타입 설계까지 따로 보는)이 pr-review-toolkit입니다.
hookify는 이런 규칙을 그냥 Markdown으로 씁니다.
hljs language-markdown
- main 브랜치에 직접 push하지 않는다.
- rm -rf 명령을 차단한다.
- 마이그레이션 파일 변경 시 경고한다.
- package-lock.json을 직접 수정하지 않는다.
편리하지만 최근 저장소에 Hook dispatch와 Agent 권한 처리 관련 이슈가 올라와 있습니다. 중요한 저장소에 바로 적용하기보다 테스트 저장소에서 먼저 검증하세요.
skill-creator는 긴 프롬프트를 SKILL.md에 붙여넣는 대신, "언제 이 Skill이 호출되어야 하는가"와 "성공 조건"을 함께 설계하게 해줍니다. 이게 Skill 품질의 절반입니다.
팀 고유의 배포 절차, 인프라 구조, 문서 양식, 보안 규칙이 들어가기 때문입니다. 범용 Skill은 이걸 모릅니다.
9. 함께 설치하면 안 되는 조합
처음에는 아래 그룹에서 정확히 하나만 고릅니다.
Superpowers
GSD Core
BMAD
ECC
Oh My ClaudeCode
Ruflo
SuperClaude
이 도구들은 정도 차이는 있어도 전부 같은 영역을 건드립니다 — 계획 수립, Subagent 실행, 테스트, 코드 리뷰, 메모리, 상태 파일, Hook, 명령, CLAUDE.md, 그리고 "작업이 끝났는지 판단하는 기준".
Claude Code에서는 여러 Plugin의 Hook이 합쳐지고, 조건을 만족하면 모두 실행됩니다. 두 프레임워크가 각자 "구현 전에 계획하라"는 Hook을 걸어두면 Claude는 두 번 계획하고, 두 가지 완료 기준 사이에서 혼란스러워합니다. Skill 설명과 MCP 도구가 늘수록 컨텍스트 노이즈도 늘어납니다. 기능이 많다고 결과가 좋아지지 않습니다.
안전하게 조합할 수 있는 것
워크플로 프레임워크 하나 위에 아래는 비교적 안전합니다.
언어별 LSP
Context7
Playwright
GitHub, Sentry, Vercel·Cloudflare·Supabase
frontend-design
코드 리뷰 도구 하나
보안 도구 하나
ccusage
10. 설치 전 보안 체크리스트
Claude Code Plugin은 단순한 프롬프트가 아닙니다. 로컬 셸 명령, HTTP 요청, MCP 서버, Hook, 외부 API를 실행할 수 있고, Hook은 lifecycle 이벤트에 셸·HTTP·LLM 호출을 연결할 수 있습니다. 설치 전 다음을 확인하세요.
1
Plugin manifest 읽기..claude-plugin/plugin.json에서 어떤 Skill·Agent·Hook·MCP를 등록하는지 확인.
2
Hook 실행 파일 검색.find . -path 'hooks' -type f 그리고 grep -R "curl\|wget\|rm \|sudo\|eval\|python\|node" . — 네트워크 호출과 삭제 명령이 있는지.
3
MCP 설정 확인..mcp.json, .claude/settings.json, .claude/settings.local.json의 외부 주소와 실행 명령.
4
Agent 권한 확인. Bash·Write·Edit·WebFetch·MCP·전체 파일시스템 접근 중 무엇을 갖는지.
5
환경 변수 자동 읽기 확인.ANTHROPIC_API_KEY, OPENAI_API_KEY, GITHUB_TOKEN, AWS_ACCESS_KEY_ID, DATABASE_URL을 건드리는지.
6
설치 전후 diff. 설치 전 커밋 → 설치 → git status, git diff. 전역 설정을 바꾸는 도구면 cp -R ~/.claude ~/.claude.backup.
7
안 쓰는 MCP 비활성화. 도구 수가 많을수록 잘못된 도구 선택과 컨텍스트 비용이 늘어납니다.
8
팀 환경이면 Marketplace 제한.strictKnownMarketplaces 정책으로 허용한 Marketplace만 쓰게 합니다.
마무리 — 우선순위 한 장
순위
역할
선택
1
가장 먼저
claude-code-setup
2
워크플로 기본값
Superpowers
3
가벼운 대안
Addy Agent Skills
4
장기 프로젝트
GSD Core
5
제품 기획·아키텍처
BMAD
6
대형 종합 패키지
ECC
7
실용적인 다중 Agent
Oh My ClaudeCode
8
실험적 Swarm
Ruflo
9
코드 정확도
언어별 LSP
10
웹 개발
Context7 + Playwright
11
품질 관리
PR Review Toolkit
12
사내 자산화
plugin-dev + skill-creator
지금 실제 개발 환경에 적용한다면 Superpowers + TypeScript/Python LSP + Context7 + Playwright + PR Review Toolkit + GitHub/Sentry로 시작하는 것이 가장 좋습니다. 그 뒤 장기 프로젝트의 컨텍스트 관리가 부족하다고 느끼면 GSD로 전환하고, 팀 전체 표준화가 필요해졌을 때 ECC를 별도 저장소에서 테스트하는 순서가 안전합니다.
마지막으로 하나. 이 생태계에서 가장 생산성이 높은 건 유명한 플러그인이 아니라 우리 팀의 배포 절차, 우리 인프라, 우리 문서 양식이 들어간 Skill 하나입니다. 범용 도구는 그걸 모릅니다. 구성 A로 기반을 만든 뒤, skill-creator로 팀 고유 Skill을 하나씩 쌓아가세요.