클로드코드 플러그인 (Claude code plugin)활용법 — 설치부터 마켓플레이스까지

클로드코드 플러그인은 스킬·에이전트·커맨드·훅·MCP 서버를 하나로 묶어 한 번에 설치하는 배포 단위입니다.

2026년 7월 기준, 플러그인은 마켓플레이스에 등록한 뒤 `/plugin install 이름@마켓명` 한 줄로 설치하고 `/reload-plugins`로 곧바로 켤 수 있습니다.

이 글을 읽으면 플러그인이 정확히 무엇인지, 앞서 다룬 스킬·에이전트와 어떻게 이어지는지, 마켓플레이스를 더하는 것부터 설치·관리·보안 확인까지 전 과정을 명령어 그대로 따라 할 수 있습니다.

플러그인은 여러 확장 요소를 묶은 "세트"입니다. 스킬 하나를 직접 만들어 쓰던 단계에서, 여러 요소를 한 번에 설치하고 팀과 나눠 쓰는 단계로 넘어가는 지점이라고 보면 됩니다. 마켓플레이스는 그 세트를 모아둔 카탈로그고요.

플러그인이란 무엇인가

플러그인은 클로드코드를 확장하는 요소들을 하나로 묶어 배포하는 단위입니다.

클로드코드 공식 문서는 플러그인을 "skills, agents, hooks, MCP servers를 묶어 클로드코드를 확장하는 것"이라고 설명합니다.

설치 상세 화면을 보면 실제로 들어오는 요소에는 커맨드와 LSP 서버까지 더해집니다.

정리하면 플러그인이 담을 수 있는 공식 구성 요소는 여섯 가지입니다.

① 커맨드(슬래시 명령) ② 에이전트(서브에이전트) ③ 스킬 ④ 훅 ⑤ MCP 서버 ⑥ LSP 서버.

앞의 다섯 가지에 코드 편집기와 언어 서버를 연결하는 LSP 서버가 하나 더 붙는다고 기억하면 됩니다.

비유하자면 앱스토어와 비슷합니다.

공식 문서도 "스토어를 추가하면 목록을 둘러볼 수 있지만, 어떤 앱을 내려받을지는 각자 고른다"는 표현을 씁니다.

조립가구 세트처럼 필요한 부품(스킬·에이전트·훅)이 한 상자에 들어 있고, 그 상자를 통째로 내 작업 환경에 끼워 넣는 그림을 떠올려도 좋습니다.

728x90

스킬만 있으면 되지 왜 플러그인인가

스킬 단품은 한 가지 능력, 플러그인은 여러 요소를 묶어 배포·공유·관리하는 단위입니다.

스킬 하나를 직접 만들어 내 컴퓨터에서만 쓴다면 굳이 플러그인이 필요하지 않습니다.

하지만 스킬에 전용 서브에이전트, 슬래시 커맨드, 자동 실행 훅, 외부 도구 연결(MCP)까지 딸려 있다면 이야기가 달라집니다.

이 요소들을 하나로 묶어 마켓플레이스에 올리면, 다른 사람이 명령어 한 줄로 똑같은 환경을 설치할 수 있습니다.

팀과 나눠 쓰고, 버전을 관리하고, 자동으로 업데이트되는 것이 스킬 단품과의 가장 큰 차이입니다.

스킬 자체가 무엇인지 더 알고 싶다면 앞서 정리한 클로드코드 스킬 활용법 글을 먼저 보면 흐름이 자연스럽습니다.

단위	담는 것	언제 쓰나
지침(CLAUDE.md)	프로젝트 규칙·맥락	이 저장소에서 항상 지킬 것을 알려줄 때
스킬	한 가지 능력·지식 묶음	특정 작업을 잘하게 만들 때
에이전트	독립된 하위 작업자	일을 맡겨 병렬로 돌릴 때
플러그인	스킬·에이전트·커맨드·훅·MCP·LSP 묶음	여러 요소를 한 번에 설치·팀 배포·관리할 때

지침으로 규칙을 정하고, 스킬로 능력을 더하고, 에이전트로 일을 맡기던 흐름의 마지막 계단이 플러그인입니다.

개인적으로는 이 네 단계를 "규칙 → 능력 → 일꾼 → 묶어서 나눠 쓰기"로 이해하면 각 개념이 왜 따로 있는지 가장 선명하게 잡힌다고 봅니다.

---

마켓플레이스 구조와 설치 3단계

마켓플레이스는 누군가 만들어 공유한 플러그인 카탈로그입니다.

쓰는 순서는 두 갈래로 나뉩니다.

먼저 마켓플레이스를 등록하고(설치가 아니라 목록에 추가만 하는 것), 그 안에서 원하는 플러그인을 하나씩 설치합니다.

마켓플레이스로 쓸 깃 저장소에는 `.claude-plugin/marketplace.json` 파일이 있어야 카탈로그로 인식됩니다.

1단계 — 마켓플레이스 추가

추가할 수 있는 소스는 네 종류입니다.

/plugin marketplace add anthropics/claude-code        # GitHub owner/repo 형식
/plugin marketplace add https://gitlab.com/company/plugins.git   # 다른 git 호스트(.git·https 필수)
/plugin marketplace add ./my-marketplace              # 로컬 경로
/plugin marketplace add https://example.com/marketplace.json     # 원격 marketplace.json URL

특정 브랜치나 태그를 쓰려면 `...plugins.git#v1.0.0`처럼 뒤에 붙입니다.

⚠️ 최신 클로드코드에서는 git URL에 `https://` 접두사가 없으면 거부되니, 주소를 그대로 복사해 넣는 편이 안전합니다.

반응형

2단계 — 플러그인 설치

/plugin install plugin-name@marketplace-name
/plugin install github@claude-plugins-official        # 공식 마켓 예시
/plugin install commit-commands@claude-code-plugins   # 데모 마켓 예시

설치 범위는 세 가지 중에 고를 수 있습니다.

기본값인 유저 스코프(모든 프로젝트에서 사용), 프로젝트 스코프(저장소 협업자와 공유, `.claude/settings.json`에 기록), 로컬 스코프(내 저장소에서만)입니다.

✅ 셸에서 대화 없이 설치하려면 `claude plugin install formatter@your-org --scope project`처럼 한 줄로도 됩니다.

3단계 — 활성화

/reload-plugins

공식 문서는 "설치한 뒤 `/reload-plugins`를 실행해 플러그인을 활성화하라"고 안내합니다.

세션 도중에 설치·활성화·비활성화를 했다면 이 명령 한 번으로 재시작 없이 반영됩니다.

✅ 설치한 플러그인의 스킬은 플러그인 이름으로 구분됩니다. 예를 들어 commit-commands 플러그인의 커밋 스킬은 `/commit-commands:commit`으로 부릅니다.

⚠️ MCP 서버가 포함된 플러그인은 다시 불러올 때 토큰 비용이 크게 들 수 있어 경고가 뜹니다. 이때는 `--force`로 강제 적용합니다.

설치한 플러그인 관리 — 목록·업데이트·제거

설치한 뒤에는 상태를 확인하고, 필요할 때 켜고 끄거나 지웁니다.

/plugin                          # 인터랙티브 패널(Discover / Installed / Marketplaces / Errors)
/plugin list                     # 설치 목록(--enabled / --disabled 필터)
/plugin disable plugin-name@marketplace-name
/plugin enable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

마켓플레이스 자체를 최신으로 새로고침하거나 통째로 지울 수도 있습니다.

/plugin marketplace list                       # 등록한 마켓 목록
/plugin marketplace update marketplace-name    # 플러그인 목록 새로고침
/plugin marketplace remove marketplace-name    # 마켓 제거(설치한 플러그인도 함께 삭제)

Anthropic 공식 마켓은 자동 업데이트가 기본으로 켜져 있고, 서드파티·로컬 마켓은 기본으로 꺼져 있습니다.

자동 업데이트를 전부 끄려면 환경변수 `DISABLE_AUTOUPDATER`를 씁니다.

2026년 7월 기준 쓸 만한 마켓플레이스와 플러그인

공식 마켓부터 보면 됩니다.

claude-plugins-official은 클로드코드를 시작할 때 자동으로 등록되므로, 따로 추가하지 않아도 바로 설치할 수 있습니다.

이 공식 저장소(github.com/anthropics/claude-plugins-official)는 2026년 7월 18일 조회 기준 스타 약 3만 2천 개, 등재 플러그인은 100개 이상입니다.

공식 문서 카테고리 기준으로 실제 쓸 만한 플러그인을 몇 가지 꼽으면 다음과 같습니다.

✅ commit-commands — 스테이징부터 커밋 메시지 생성·푸시·PR까지 깃 작업을 묶어 처리하는 스킬 모음입니다.

✅ security-guidance — 클로드가 만든 변경마다 흔한 취약점(커맨드 인젝션 등)을 검사하고 같은 세션에서 고치도록 안내합니다.

✅ pr-review-toolkit — 여러 관점에서 한 번에 PR을 검토하는 서브에이전트 묶음입니다.

✅ github — GitHub MCP 서버를 미리 구성해 이슈·PR·저장소 정보에 접근하게 해줍니다. MCP 서버가 무엇인지 궁금하면 요즘 뜨는 MCP 서버 정리 글을 참고하면 됩니다.

✅ plugin-dev — 내 플러그인을 만들고 배포할 때 필요한 매니페스트·구조를 잡아주는 제작 툴킷입니다.

커뮤니티 쪽에는 규모가 큰 저장소도 있습니다.

같은 조회 기준으로 hesreallyhim/awesome-claude-code가 스타 약 5만, wshobson/agents가 약 3만 8천, davila7/claude-code-templates가 약 3만 개입니다.

다만 인기와 안전은 별개라는 점은 바로 다음 섹션에서 짚겠습니다.

📘 클로드코드 공식 플러그인 문서 바로가기 →

---

아무 마켓플레이스나 추가해도 안전한가

플러그인과 마켓플레이스는 내 권한으로 임의 코드를 실행할 수 있는 고신뢰 컴포넌트입니다.

공식 문서의 경고는 분명합니다.

플러그인과 마켓플레이스는 사용자 권한으로 컴퓨터에서 임의 코드를 실행할 수 있는 고신뢰 컴포넌트입니다. 신뢰할 수 있는 출처에서만 설치·추가하세요.

Anthropic도 플러그인에 어떤 MCP 서버나 파일이 들어 있는지 통제하지 않으며, 의도대로 동작하는지 보증하지도 않는다고 명시합니다.

그래서 설치 전에 무엇이 들어오는지 직접 확인하는 습관이 중요합니다.

`/plugin` Discover 탭의 상세 화면에는 토큰 비용 추정(Context cost), 마지막 업데이트 시점(Last updated), 그리고 이번 설치로 추가되는 커맨드·에이전트·스킬·훅·MCP/LSP 서버 목록(Will install)이 표시됩니다.

이 Will install 목록을 보고 낯선 MCP 서버나 훅이 딸려 오는지 먼저 살펴야 합니다.

커뮤니티 마켓 중 Anthropic이 운영하는 claude-plugins-community는 각 플러그인이 특정 커밋에 고정(pinned)돼 있어, 최소한의 안전 스크리닝을 거친다는 점이 신뢰 근거가 됩니다.

개인적으로는 "공식 마켓 먼저, 커뮤니티는 선별해서"가 가장 무난한 순서라고 봅니다. 마켓플레이스에서 무엇을 신뢰할지의 문제는 스킬 공급망 위험을 다룬 글과 그대로 이어집니다.

자주 막히는 부분

설치와 활성화 과정에서 흔히 걸리는 지점을 모았습니다.

☐ 설치했는데 명령이 안 보인다 → 세션 도중 설치했다면 `/reload-plugins`를 실행했는지 확인하세요. 이 단계를 빼먹는 경우가 가장 많습니다.

☐ 마켓 추가가 거부된다 → git URL에 `https://`를 붙였는지, `.git` 접미사가 필요한 호스트인지 확인합니다.

☐ 공식 마켓이 목록에 없다 → 자동 등록이 안 됐다면 `/plugin marketplace add anthropics/claude-plugins-official`로 직접 추가하고, 목록이 오래됐으면 `/plugin marketplace update claude-plugins-official`로 새로고침합니다.

☐ 스킬 이름이 겹친다 → 플러그인 스킬은 플러그인 이름으로 구분되므로 `/플러그인명:스킬명` 형식으로 부르면 됩니다.

정리

플러그인은 스킬·에이전트·커맨드·훅·MCP·LSP 서버를 하나로 묶어 배포하는 단위이고, 마켓플레이스는 그 묶음을 모아둔 카탈로그입니다.

실전 순서는 간단합니다. 마켓 추가 → 플러그인 설치 → `/reload-plugins` 활성화, 그리고 설치 전 Will install로 내용 확인.

지침으로 규칙을 정하고 스킬로 능력을 더하고 에이전트에 일을 맡기던 흐름이, 플러그인에서 "묶어서 나눠 쓰기"로 마무리됩니다.

여기까지 왔다면 남의 플러그인을 쓰는 단계는 충분히 익힌 셈입니다.

다음 편에서는 직접 플러그인을 만들어 마켓플레이스에 올리는 과정을 다룹니다. plugin-dev로 뼈대를 잡는 것부터 차근히 이어가면 됩니다.

 

 

참고한 자료

클로드코드 공식 문서(Discover and install prebuilt plugins through marketplaces), Anthropic 공식·커뮤니티 마켓플레이스 저장소의 marketplace.json, 공식 플러그인 웹 카탈로그, Security Boulevard의 플러그인 추천 기사(2026-06)를 참고했으며, 스타 수는 2026년 7월 18일 조회 기준입니다. 모델·버전·명령 문법은 발행 전 공식 문서 확인이 필요합니다.