핵심 요약
- 공식 마켓플레이스 claude-plugins-official은 첫 대화형 세션을 시작할 때 자동으로 추가됩니다. 설정도, URL 입력도 필요 없습니다.
- /plugin 패널에서 Discover·Installed·Marketplaces·Errors 네 탭을 둘러보거나, 터미널에서 claude plugin install frontend-design@claude-plugins-official 한 줄로 바로 설치하세요.
- 평소 관리는 한 메뉴에서 끝납니다: 비활성화, Mark for update, Update now, 제거. claude plugin marketplace remove로 마켓플레이스를 빼면 그곳에서 깔았던 플러그인도 함께 삭제됩니다.
- 자신만의 마켓플레이스 공유는 사실상 매니페스트 작업입니다: .claude-plugin/marketplace.json을 작성하고, claude plugin validate로 로컬 검증, claude --plugin-dir로 시험 실행까지.
Claude Code Plugins Explained In 7 Minutes
채널: Software Engineer Meets AI7:21
Claude Code Plugins Tutorial: Install & Build Your Own
채널: Leon van Zyl18:21
Plugins — official Claude Code docs
문서: code.claude.com/docs
스크린샷은 Software Engineer Meets AI의 7분 해설 영상(깔끔한 전체 화면 녹화)에서 가져왔습니다. 설치·마켓플레이스·공유 관련 사실은 Leon van Zyl의 상세 튜토리얼과 공식 플러그인 문서로 교차 확인했습니다.
프레임의 저작권은 각 제작자에게 있으며, 해당 장면으로 이어지는 딥링크와 함께 출처를 표기합니다. 본문은 본 사이트의 고유 콘텐츠입니다.
16단계로 끝내는 Claude Code 플러그인 마켓플레이스
설치 전에 알아두기
- 1
플러그인의 정의부터 확인
Claude Code 플러그인은 스킬, 서브에이전트, MCP 서버, 훅, LSP 서버를 하나의 설치 가능한 묶음으로 포장한 확장입니다. 전부 함께 이동하기 때문에 플러그인이 곧 프로젝트 간·팀 공유의 단위가 됩니다. 이 가이드는 탐색부터 설치, 관리, 공유까지 전 과정을 다룹니다.
화이트보드 요약: 플러그인 하나에 확장 기능 다섯 가지.0:21에 시청 - 2
파일 트리로 플러그인을 식별
모든 플러그인은 .claude-plugin 폴더 안의 plugin.json 매니페스트를 축으로 하고, 그 주위에 commands·agents·skills·output styles·hooks 폴더와 .mcp.json이 선택적으로 붙습니다. 전부 필요한 게 아니라 명령 하나만으로도 공유할 수 있습니다. 매니페스트가 있어야 평범한 폴더가 설치 가능한 플러그인이 됩니다.
매니페스트가 먼저, 폴더는 기능별로 — 뼈대는 이게 전부.0:45에 시청 - 3
공식 플러그인 문서에서 시작
code.claude.com 공식 문서가 명령과 매니페스트 필드의 기준이며 플러그인 갤러리로의 링크도 있습니다. 설치 전에 한 번 훑어두면 이 가이드의 패널·명령 이름이 그대로 맞아떨어집니다. 터미널, 데스크톱 앱, VS Code 어디서든 절차는 동일합니다.
탐색·설치·제작을 한 페이지에 — 북마크할 가치가 있습니다.1:00에 시청 - 4
공식 마켓플레이스 그리드 둘러보기
claude-plugins-official은 설치 수와 Claude Code 필터가 붙은 그리드로 플러그인을 보여줍니다 — Frontend Design, Superpowers, Context7, Code Review, Code Simplifier, GitHub, Playwright까지. 설치 수는 인기 지표일 뿐 품질 보증이 아닙니다. 설치 시 입력할 정확한 플러그인 이름을 메모해 두세요.
앱 스토어처럼 스크롤 — 이름이 곧 CLI 입력값입니다.1:10에 시청
마켓플레이스 추가와 설치
- 5
상세 페이지로 플러그인 검증
플러그인을 클릭하면 상세 페이지가 열립니다: 제작자, 포함된 구성, 누적 설치 수. 예컨대 Frontend Design은 Made by Anthropic이고 총 설치 수가 41만을 넘습니다. 도구 접근 권한을 넘기기 전에 제작자를 밝히고 실사용 기록이 있는 플러그인을 고르세요.
제작자·구성·설치 수 — 설치 전 확인 세 가지.1:40에 시청 - 6
CLI에서 이름으로 설치
가장 빠른 길은 명령 한 줄입니다: claude plugin install frontend-design@claude-plugins-official. ID는 항상 플러그인명@마켓플레이스명 형태라, 나중에 추가하는 마켓플레이스에서도 같은 문법이 통합니다. 터미널에는 설치 확인과 함께 플러그인이 등록한 항목이 표시됩니다.
한 줄이면 끝 — @ 앞뒤로 플러그인명과 마켓플레이스명.1:53에 시청 - 7
/plugin 패널에서 플러그인 발견
명령 입력이 편하지 않다면 대화형 세션에서 /plugin을 실행해 Discover 탭을 여세요. superpowers 29.48만, context7 21.22만, code-review 19.19만 설치. 여기서 설치해도 CLI와 완전히 같고, 이후 업데이트도 이 패널에서 처리합니다.
앱 내 스토어 뷰 — 같은 카탈로그, 타이핑 제로.2:00에 시청 - 8
Installed 탭 점검하기
Installed 탭에는 보유한 모든 플러그인이 활성/비활성 상태와 함께, 연결·미연결 MCP 서버 나열됩니다. 세션이 실제로 로드하는 것의 솔직한 목록입니다. 쓰지 않는 플러그인은 제거보다 비활성화로 — 스위치는 언제든 되돌릴 수 있습니다.
활성은 로드됨, 비활성은 설치만 된 상태.2:10에 시청 - 9
플러그인 메뉴로 관리
/plugin 패널에서 플러그인을 열면 관리 메뉴가 나옵니다: Disable plugin, Mark for update, Update now, Uninstall, Back to plugin list. Mark for update는 갱신을 모아두고, Update now는 즉시 적용. Uninstall은 플러그인만 지우고 마켓플레이스는 그대로 둡니다.
다섯 옵션으로 사후 관리 전부 해결.3:38에 시청
설치 후 관리
- 10
변경 후에는 플러그인 다시 불러오기
플러그인 변경은 다음 시작 때 반영되지만, 종료할 필요는 없습니다. /reload-plugins를 실행하면 세션이 즉시 재스캔하고, 현재 활성 상태 — 이 녹화에서는 Enabled frontend-design — 와 로드된 플러그인·스킬·에이전트 요약을 확인해 줍니다. 수동 편집 후에는 습관처럼 실행하세요.
재시작 불필요 — 슬래시 명령 하나로 재스캔.3:45에 시청 - 11
애초에 플러그인이 필요한지 판단
독립 .claude 디렉터리는 개인용, 버전 관리 없는 수정에 딱 맞습니다. 팀원이나 여러 프로젝트가 얽히는 순간에는 버전 관리되고 이름으로 설치되는 플러그인이 빛을 발합니다. 기준은 단순합니다: 다른 사람도 그대로 원할 묶음인가요? 그렇다면 패키지로.
개인 커스텀은 로컬에, 공유할 것은 플러그인으로.4:15에 시청 - 12
마켓플레이스의 정체 이해하기
마켓플레이스는 그저 색인입니다 — 디버깅·디자인·리서치용 플러그인을 가리키는 항목을 모은 앱 스토어죠. 추가한다는 건 Claude Code에 탐색 위치를 알려주는 것뿐, 자체적으로 코드를 실어 오지 않습니다. claude plugin marketplace add에는 로컬 경로, owner/repo 형식, 전체 git URL 세 가지를 쓸 수 있습니다.
스토어는 포인터 목록, 플러그인이 실체.4:46에 시청
내 플러그인 공유하기
- 13
에이전트·명령·스킬 모으기
이미 잘 동작하는 것부터 시작하세요. 프로젝트 .claude 폴더의 design-implementer, e2e-test-architect, quality-assurance 에이전트는 그 자체로 플러그인 소재입니다. 배포할 폴더(agents·commands·skills)를 한곳에 모으세요. 무엇을 뺄지는 무엇을 넣을지만큼 중요합니다.
.claude의 핵심 인력을 줄 세워 포장 준비 완료.5:20에 시청 - 14
Claude Code에게 스캐폴딩 맡기기
폴더를 손으로 조립할 필요 없습니다. quality-assurance 에이전트와 fix-issue 명령을 묶은 공유용 팀 플러그인을 만들어 달라고 프롬프트하면 구조와 매니페스트 초안을 마련해 줍니다. 매니페스트 필드를 만지기 전에 스캐폴드부터 검토하세요.
조립은 Claude에게, 검토는 나에게.5:55에 시청 - 15
plugin.json 매니페스트 채우기
.claude-plugin/plugin.json의 매니페스트는 플러그인 이름·버전·설명을 선언하고 agents·commands·skills 배열을 나열합니다. 여기의 모든 항목은 설치 시 사용자에게 보이므로 정확하고 최소로 유지하세요. 이 11개 파일 트리가 이제 진짜 플러그인입니다.
이름·버전·설명, 그리고 배열들 — 필수는 이것뿐.6:25에 시청 - 16
위협 모델을 염두에 두고 공유
마켓플레이스 저장소는 실행 가능한 신뢰입니다. 2026년 커뮤니티 공개에서는 변조된 GitHub 저장소가 이미 설치된 플러그인에 프롬프트 주입과 권한 변경을 몰래 끼워 넣는 마켓플레이스 플러그인 하이재킹이 보고되었습니다. 공유물의 버전을 고정하고, 저장소 변화를 지켜보며, 모든 플러그인이 온전한 사용자 권한으로 실행된다는 사실을 잊지 마세요.
하이재킹 해부도: 저장소 수정 한 번, 공격 경로 두 가지.6:50에 시청
CLI 레퍼런스: 플러그인에 필요한 모든 명령
여섯 명령이 전체 수명 주기를 커버합니다. 플러그인 상태는 ~/.claude/plugins에 저장되며, 스코프는 기존의 user·project·local 세 단계를 따릅니다.
- 1claude plugin marketplace add — 로컬 경로, owner/repo 형식 또는 전체 git URL로 마켓플레이스를 추가합니다. 공식 claude-plugins-official은 첫 대화형 세션에서 자동 추가됩니다.
- 2claude plugin validate ./my-marketplace — 공유 전 로컬에서 마켓플레이스를 검증해 매니페스트와 source 오류를 조기에 잡아냅니다.
- 3claude plugin list — 설치된 플러그인과 마켓플레이스를 나열합니다. 개별 플러그인 세부 정보는 /plugin 패널에서.
- 4claude plugin install frontend-design@claude-plugins-official — ID로 설치. 형식은 언제나 플러그인명@마켓플레이스명.
- 5claude plugin marketplace remove — 마켓플레이스를 분리하며, 여기서 온 플러그인도 함께 제거합니다.
- 6claude --plugin-dir ./my-plugin — 로컬 플러그인 폴더를 로드한 채 실행. 마켓플레이스 없이 개발 중 테스트에 딱.
세션 안에서는 /plugin 패널의 Discover·Installed·Marketplaces·Errors 탭이 같은 작업을 제공하고, /reload-plugins로 재시작 없이 재스캔할 수 있습니다.
마켓플레이스 보안: Install 누르기 전에 읽기
플러그인은 세션 안에서 여러분의 사용자 권한으로 실행됩니다. 악성 플러그인은 곧 또 하나의 '당신'입니다. 다섯 가지 습관으로 안전하게.
- 1매니페스트를 먼저 읽기. 설치 전 plugin.json과 저장소를 열어 어떤 명령·훅·MCP 서버를 등록하는지 확인하세요. 모든 프롬프트에 걸리는 훅은 슬래시 명령보다 훨씬 무거운 결정입니다.
- 2마켓플레이스 저장소는 재작성될 수 있습니다. 2026년 커뮤니티 공개는 마켓플레이스 플러그인 하이재킹과 의존성 오염 사례를 문서화했습니다 — 설치된 플러그인은 저장소 변화에 따라 바뀌므로, 업데이트도 의존성처럼 검토하세요.
- 3공식 이름은 예약되어 있습니다. claude-plugins-official 같은 식별자는 제3자 사칭을 거부하므로, 공식 마켓플레이스를 가리키는 @ ID는 진품입니다. 플러그인 이름을 믿기 전에 마켓플레이스 접미사를 확인하세요.
- 4기업은 관리 설정으로 통제할 수 있습니다. managed settings로 마켓플레이스를 허용·차단해 사내 장비를 승인된 내부 마켓플레이스에 고정할 수 있습니다.
- 5최소 권한으로 설치. 모든 플러그인은 당신 권한으로 실행됩니다: 최소한만 설치하고, 안 쓰는 것은 비활성화, 모으기보다는 제거.
/plugin 패널의 Errors 탭이 경보 역할을 합니다. 업데이트 후 갑자기 로드에 실패한 플러그인은 다음 세션 전에 매니페스트를 diff해 보세요.