Claude 심화 7단계 플러그인과 마켓플레이스

 

 

 

 

심화 7단계 플러그인과 마켓플레이스

스킬·에이전트·훅·MCP를 한 번에 설치하는 "도구 세트" — 남의 세트를 가져다 쓰고, 내 세트를 팀에 배포하기

Claude 심화 과정 7/12 · 2026년 9월 기준 · ⏱ 1시간 · ★ = 꼭 해볼 것

이번 단계에서 배우는 것

개념

플러그인이 무엇을 묶어 두는 꾸러미인지, 스킬·MCP와 어떻게 다른지

설치

★ Cowork(데스크톱 앱)와 Claude Code에서 남이 만든 플러그인을 설치하고 끄고 지우는 법

만들기

★ 6단계에서 만든 블로그 스킬을 내 플러그인으로 포장하기

배포

마켓플레이스를 만들어 팀원이 한 줄로 설치하게 하기, 그리고 보안 점검

1 플러그인이란? — "도구 세트"와 "앱스토어"

지금까지 스킬(매뉴얼), MCP(손과 발)를 하나씩 따로 설치했습니다. 플러그인은 이런 부품을 한 상자에 담아 한 번에 설치하게 해주는 꾸러미입니다.

공구를 하나씩 사 모으는 대신 "인테리어 공구 세트"를 통째로 사는 것과 비슷합니다. 드라이버, 줄자, 수평계가 한 상자에 들어 있으니 꺼내 쓰기만 하면 됩니다. 그리고 이런 세트를 모아 놓고 골라 설치하는 곳이 마켓플레이스, 즉 앱스토어입니다.

스킬업무 매뉴얼
skills/ 폴더

서브에이전트역할별 팀원
agents/ 폴더

훅자동 규칙
hooks/hooks.json

MCP 서버외부 연결 통로
.mcp.json

명령어단축 버튼
commands/ (예전 방식)

낱개로 설치할 때

스킬 폴더 복사, MCP 추가, 훅 설정을 사람마다 따로 해야 합니다. 팀원 5명이면 5번, 빠뜨리기 쉽습니다.

플러그인으로 설치할 때

명령 한 줄(또는 클릭 한 번)이면 끝. 업데이트도 한 번에 받고, 필요 없으면 통째로 끄거나 지웁니다.

어디서 쓰나? — 플러그인은 Cowork(데스크톱 앱)와 Claude Code에서 설치합니다. Cowork에서 설치한 플러그인은 Claude Code와도 동기화됩니다.

2 Cowork(데스크톱 앱)에서 설치하기 따라해 보기

비개발자라면 여기만 따라 해도 충분합니다. 클릭 몇 번이면 끝납니다.

1. 메뉴 열기

데스크톱 앱 사이드바에서 Customize → Plugins 로 들어갑니다.

2. 둘러보기

Browse plugins 를 눌러 직무·업무별 플러그인 목록을 봅니다. 설명을 읽고 내 일과 맞는 것을 고릅니다.

3. 설치

설치 버튼을 누릅니다. 직접 만든 플러그인 파일이 있다면 같은 화면에서 업로드할 수도 있습니다.

4. 사용

★ 대화창에서 / 를 입력하거나 + 버튼을 누르면 플러그인에 들어 있는 기능이 목록에 나타납니다. 골라서 실행하면 됩니다.

# 설치 후 대화창에서 이렇게 시험해 보세요
/  ← 입력하면 설치한 플러그인의 기능 목록이 뜹니다

방금 설치한 플러그인에 어떤 스킬과 기능이 들어 있는지
하나씩 설명해 주고, 내 업무(블로그 글 작성)에 쓸 만한 것을 추천해 줘.

알아둘 점 — Cowork 플러그인은 유료 요금제에서 쓸 수 있습니다. 새 통합 화면(채팅과 Cowork가 합쳐진 UI)이 순차 적용 중이라 메뉴 위치와 이름은 버전에 따라 다를 수 있습니다. 메뉴가 안 보이면 설정 화면에서 "Plugins" 항목을 찾아보세요.

3 Claude Code에서 설치하기 따라해 보기

Claude Code에서는 /plugin 한 단어로 플러그인 관리 화면이 열립니다.

/plugin

탭으로 된 관리 화면. Discover(찾기) · Installed(설치됨) · Marketplaces(등록된 마켓) · Errors(오류) 탭이 있습니다.

공식 마켓

claude-plugins-official 은 처음부터 자동으로 등록되어 있습니다. 웹에서는 claude.com/plugins 에서 둘러볼 수 있습니다.

# 공식 마켓에서 바로 설치하는 예
/plugin install github@claude-plugins-official

실습: 데모 마켓에서 commit-commands 설치해 보기

1. 마켓 등록

Anthropic이 공개한 데모 마켓플레이스(깃허브 저장소)를 등록합니다.

2. 플러그인 설치

이름@마켓이름 형식으로 설치합니다.

3. 실행

플러그인 기능은 /플러그인이름:기능이름 으로 부릅니다. 앞의 이름이 "성(姓)" 역할을 해서 다른 플러그인과 이름이 겹치지 않습니다.

# 1) 데모 마켓플레이스 등록
/plugin marketplace add anthropics/claude-code

# 2) 커밋 도우미 플러그인 설치
/plugin install commit-commands@claude-code-plugins

# 3) 사용 — 변경 사항을 보고 커밋 메시지를 만들어 커밋
/commit-commands:commit

켜기 · 끄기 · 지우기, 마켓 관리

/plugin disable 이름@마켓

잠시 끄기. 설치는 남겨 두고 기능만 멈춥니다. enable 로 다시 켭니다.

/plugin uninstall 이름@마켓

완전히 삭제.

/plugin marketplace list

등록된 마켓 보기. update 로 최신 목록 받기, remove 로 마켓 등록 해제.

claude plugin install

Claude Code를 켜지 않고 터미널(셸)에서 바로 설치. --scope 로 적용 범위를 고릅니다. (3단계 MCP의 local·project·user 범위와 같은 개념)

# 터미널에서 설치 — 팀 프로젝트 범위로
claude plugin install commit-commands@claude-code-plugins --scope project

Tip — 설치했는데 명령어가 안 보이면 /plugin 의 Errors 탭부터 확인하세요. 설정 파일 오류나 빠진 파일이 여기에 표시됩니다.

4 ★ 나만의 플러그인 만들기 — 6단계 스킬 포장하기

6단계에서 만든 tistory-guide-writer 스킬(모듈비트 티스토리 스타일로 HTML 글 쓰기)을 플러그인으로 포장해 봅니다. 포장해 두면 새 컴퓨터나 팀원에게도 한 줄로 옮길 수 있습니다.

① 폴더 구조 만들기

modulebit-blog/                    # 플러그인 폴더 (이름 자유)
├── .claude-plugin/
│   └── plugin.json                # 필수: 이름·설명·버전 (이 폴더엔 이것만!)
├── skills/
│   └── tistory-guide-writer/
│       ├── SKILL.md               # 6단계에서 만든 스킬
│       └── references/
│           └── sample.html        # 참고용 샘플
├── agents/                        # (선택) 9단계에서 만들 검수 에이전트
├── hooks/
│   └── hooks.json                 # (선택) 8단계 훅
└── .mcp.json                      # (선택) 필요한 MCP 서버

가장 흔한 실수 — skills/, agents/ 같은 폴더를 .claude-plugin/ 안에 넣는 것입니다. .claude-plugin/ 안에는 plugin.json 하나만 두고, 나머지는 모두 플러그인 폴더 맨 위(루트)에 둡니다.

② plugin.json 작성

{
  "name": "modulebit-blog",
  "description": "모듈비트 티스토리 스타일 Claude 가이드 글 작성 도구 모음",
  "version": "1.0.0",
  "author": { "name": "모듈비트" }
}

name 이 곧 명령어 앞에 붙는 이름표입니다. 이 플러그인의 스킬은 /modulebit-blog:tistory-guide-writer 로 부르게 됩니다.

③ 설치 전에 로컬에서 시험하기

claude --plugin-dir

마켓에 올리지 않고 내 폴더의 플러그인을 바로 불러와 시험합니다.

/reload-plugins

SKILL.md 등을 고친 뒤 Claude Code를 껐다 켤 필요 없이 변경 사항을 다시 읽어 들입니다.

claude plugin validate

구조와 plugin.json 형식이 맞는지 검사. 배포 전에 꼭 한 번.

# 1) 형식 검사
claude plugin validate ./modulebit-blog

# 2) 플러그인을 불러온 상태로 Claude Code 실행
claude --plugin-dir ./modulebit-blog

# 3) 세션 안에서 시험
/modulebit-blog:tistory-guide-writer 심화 7단계 플러그인 글 초안 써줘

# 4) SKILL.md를 고쳤다면
/reload-plugins

④ Claude에게 포장을 맡기는 프롬프트

~/.claude/skills/tistory-guide-writer 에 있는 내 스킬을 플러그인으로 포장해 줘.
- 플러그인 이름: modulebit-blog
- .claude-plugin/plugin.json 에는 name, description, version, author 를 넣고
- 스킬은 skills/tistory-guide-writer/ 로 복사해 줘
- 다 만들면 claude plugin validate 로 검사하고 결과를 알려줘

Cowork에서 만들고 싶다면 — Cowork에는 플러그인 제작을 도와주는 "Plugin Create" 플러그인이 있습니다. 설치한 뒤 "내 블로그 글쓰기 스킬로 플러그인 만들어줘"처럼 대화로 요청하면 됩니다.

5 마켓플레이스 만들어 팀에 배포하기

마켓플레이스는 거창한 서버가 아니라 플러그인 목록이 적힌 파일 하나가 들어 있는 깃허브 저장소입니다. 사내 "우리 팀 앱스토어"를 하나 차리는 셈입니다.

team-claude-plugins/               # 깃허브 저장소
├── .claude-plugin/
│   └── marketplace.json           # 마켓 목록 파일
└── plugins/
    ├── modulebit-blog/            # 위에서 만든 플러그인
    └── formatter/                 # 다른 플러그인

.claude-plugin/marketplace.json

{
  "name": "acme-tools",
  "owner": { "name": "DevTools Team" },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting"
    },
    {
      "name": "modulebit-blog",
      "source": "./plugins/modulebit-blog",
      "description": "블로그 글 작성 도구 모음"
    }
  ]
}

1. 저장소에 올리기

위 구조를 깃허브 저장소(예: my-team/team-claude-plugins)에 푸시합니다. 사내용이면 비공개 저장소로.

2. 팀원이 등록·설치

/plugin marketplace add my-team/team-claude-plugins → /plugin install modulebit-blog@acme-tools

3. 자동 안내하기

★ 프로젝트의 .claude/settings.json 에 extraKnownMarketplaces 를 적어 두면, 그 프로젝트를 여는 팀원에게 마켓이 자동으로 알려집니다.

.claude/settings.json (프로젝트에 커밋)

{
  "extraKnownMarketplaces": {
    "acme-tools": {
      "source": { "source": "github", "repo": "my-team/team-claude-plugins" }
    }
  }
}

버전 관리 — 플러그인을 고치면 plugin.json의 version 을 올리고 저장소에 푸시합니다. 팀원은 /plugin marketplace update 로 최신 목록을 받습니다. 설정 파일의 세부 형식은 업데이트될 수 있으니 공식 문서(마켓플레이스 페이지)를 함께 확인하세요.

6 보안 — 플러그인은 "내 권한으로" 실행됩니다

공식 문서의 표현 그대로, 플러그인은 내 컴퓨터에서 내 사용자 권한으로 임의의 코드를 실행할 수 있습니다. 앱스토어 앱보다는 "남이 준 USB를 꽂는 일"에 가깝게 생각하세요.

출처 확인

공식 마켓(claude-plugins-official)이나 믿을 수 있는 회사·동료가 만든 것만. 별이 많다고 안전한 것은 아닙니다.

내용 검토

설치 전에 저장소를 열어 hooks/hooks.json(자동 실행 명령), .mcp.json(외부 연결), scripts/ 를 훑어봅니다.

회사에서

회사가 승인한 플러그인만 설치. 팀 마켓을 만들어 검토를 거친 플러그인만 올리는 방식이 가장 안전합니다.

안 쓰면 정리

쓰지 않는 플러그인은 disable 이나 uninstall. 켜둔 것이 많을수록 컨텍스트도 먹고 위험 면적도 넓어집니다.

# 설치 전 검토를 Claude에게 맡기는 프롬프트
이 깃허브 저장소의 플러그인을 설치하려고 해. 설치하지 말고 내용만 읽어서
1) 훅으로 자동 실행되는 명령이 있는지
2) 외부로 데이터를 보내는 MCP 서버나 스크립트가 있는지
3) 파일 삭제·네트워크 접속 등 위험해 보이는 부분이 있는지
표로 정리해 줘.

7 정리 & 체크리스트

플러그인 = 스킬·에이전트·훅·MCP를 담은 도구 세트, 마켓플레이스 = 그 세트를 모아 둔 앱스토어. 아래를 모두 해봤다면 7단계 완료입니다.

☐ 개념

플러그인이 스킬·MCP와 무엇이 다른지 한 문장으로 설명할 수 있다

☐ Cowork 설치

Customize → Plugins 에서 플러그인 하나를 설치하고 / 로 불러 봤다

☐ Claude Code 설치

/plugin 탭을 둘러보고, commit-commands 를 설치·실행·끄기까지 해봤다

☐ 내 플러그인

★ tistory-guide-writer 스킬을 플러그인으로 포장하고 validate · --plugin-dir 로 시험했다

☐ 팀 배포

marketplace.json 구조와 extraKnownMarketplaces 의 역할을 이해했다

☐ 보안

설치 전 출처를 확인하고 훅·MCP·스크립트를 검토하는 습관을 들였다

다음 단계에서는 플러그인 상자 안에 들어가는 부품 중 명령어와 훅을 직접 만들어 봅니다. 여기서 만든 modulebit-blog 플러그인에 나중에 훅과 에이전트를 추가해 넣으면 됩니다.

이전 글: 심화 6단계 ★ 나만의 스킬 만들기 · 다음 글: 심화 8단계 커스텀 명령어와 훅(Hook)
공식 문서: 플러그인 만들기 · 플러그인 찾기·설치 · 마켓플레이스 · 스킬