클로드(Claude) 코드 플러그인 사용법, 마켓플레이스 설치부터 팀 공유까지

아직도 동료가 쓰는 Claude Code 스킬과 명령어를 받으려고 폴더를 압축해 메신저로 주고받고, 설정 파일을 하나씩 복사해 붙여 넣고 계신가요? 이렇게 옮긴 설정은 사람마다 버전이 달라져서, 누군가 고쳐도 팀 전체에 반영되지 않습니다.

클로드(Claude) 코드 플러그인은 스킬, 서브에이전트, 훅, MCP 서버를 한 폴더에 묶어 명령어 한 번으로 설치하고 켜고 끌 수 있게 만든 확장 기능입니다. 플러그인을 모아 둔 목록을 마켓플레이스라고 부르며, 마켓플레이스를 한 번 추가하면 그 안의 플러그인을 이름으로 설치하고 업데이트도 받을 수 있습니다. 이 글은 2026년 10월 공식 문서를 기준으로 플러그인과 스킬·훅의 차이, 마켓플레이스 추가부터 설치·끄기까지의 순서, 직접 만든 스킬을 플러그인으로 묶는 구조, 팀 공유 방법과 보안 점검표를 정리합니다. 마지막에는 다글로로 받아쓴 회의 기록을 플러그인 스킬로 작업 목록으로 바꾸는 흐름도 담았습니다.

클로드 코드 플러그인이란? 스킬·훅·MCP와 무엇이 다른가요

스킬·훅·MCP 서버는 각각 혼자서도 작동하는 기능이고, 플러그인은 이것들을 하나로 묶어 배포하는 포장 단위입니다. 그래서 나 혼자 한 프로젝트에서 쓰면 개별 설정으로 충분하고, 여러 프로젝트나 팀원과 함께 쓰려면 플러그인으로 묶습니다.

플러그인의 스킬은 앞에 플러그인 이름이 붙어서, 두 플러그인에 같은 이름의 스킬이 있어도 서로 겹치지 않습니다. 스킬을 만드는 방법은 클로드 코드 스킬 글에, 정해진 시점에 명령을 자동 실행하는 방법은 클로드 코드 훅 글에 정리해 두었습니다.

켜 둔 플러그인의 스킬 이름과 설명은 매 대화에 들어가 사용량을 조금씩 차지하므로, 필요한 플러그인만 켜 둡니다.

마켓플레이스 추가부터 설치·켜기/끄기까지

플러그인 설치는 "마켓플레이스 추가 → 플러그인 설치 → 설치 범위 선택 → 동작 확인" 4단계입니다. Anthropic 공식 마켓플레이스(claude-plugins-official)는 터미널에서 Claude Code를 처음 실행할 때 자동으로 추가되므로 바로 설치할 수 있습니다.

1. 둘러보기: Claude Code에서 /plugin을 입력하면 Discover 탭에 설치할 수 있는 플러그인 목록이 나옵니다. 이름을 입력해 검색하고 Enter로 상세 정보를 엽니다.
2. 다른 마켓플레이스 추가하기: 동료나 회사가 만든 마켓플레이스는 /plugin marketplace add 조직이름/저장소이름으로 한 번만 추가합니다. GitHub 저장소, 다른 git 주소, 내 컴퓨터의 폴더(./my-marketplace)를 모두 쓸 수 있습니다.
3. 설치하기: /plugin install commit-commands@claude-plugins-official처럼 "플러그인이름@마켓플레이스이름"으로 입력하면 상세 화면이 열립니다. 이 화면의 Will install 항목에서 플러그인이 추가할 스킬·훅·MCP 서버를 먼저 확인합니다.
4. 설치 범위 고르기: 나만 모든 프로젝트에서 쓰려면 사용자(user), 이 저장소의 모든 팀원과 쓰려면 프로젝트(project), 이 저장소에서 나만 쓰려면 로컬(local)을 고릅니다.
5. 확인하기: 설치 안내 마지막 줄에 "Plugin is now active."가 보이면 바로 쓸 수 있습니다. /를 입력해 /commit-commands:commit처럼 플러그인 이름이 붙은 명령이 보이는지 확인합니다. 다시 불러오라는 안내가 나오면 /reload-plugins를 실행합니다.

설치한 플러그인은 /plugin의 Installed 탭에서 관리합니다. 목록에서 Space를 누르면 켜고 끄며, Enter로 상세 메뉴를 열면 업데이트(Update now)와 삭제(Uninstall)를 고를 수 있습니다. 터미널에서는 claude plugin disable 이름@마켓플레이스, claude plugin enable 이름@마켓플레이스로 같은 작업을 합니다.

직접 만든 스킬을 플러그인으로 묶는 기본 구조

플러그인은 매니페스트 파일(.claude-plugin/plugin.json) 하나와 구성 요소 폴더로 이루어진 폴더입니다. 이미 .claude 폴더에 만들어 둔 스킬이 있다면 새 폴더로 복사하고 매니페스트만 추가하면 플러그인이 됩니다.

1. 폴더 만들기: mkdir -p meeting-tools/.claude-plugin meeting-tools/skills/action-items
2. 매니페스트 쓰기: meeting-tools/.claude-plugin/plugin.json에 {"name": "meeting-tools", "description": "회의록을 작업 목록으로 정리", "version": "1.0.0"}을 적습니다. name은 띄어쓰기 없이 쓰며, 모든 스킬 이름 앞에 붙습니다.
3. 스킬 넣기: 기존 스킬을 skills/action-items/SKILL.md로 옮깁니다. 스킬 폴더는 .claude-plugin 안이 아니라 그 옆에 둬야 불러와집니다.
4. 검사하기: 터미널에서 claude plugin validate ./meeting-tools를 실행해 "Validation passed"가 나오는지 확인합니다.
5. 설치 없이 시험하기: claude --plugin-dir ./meeting-tools로 Claude Code를 실행하면 그 세션에서만 플러그인이 켜집니다. /meeting-tools:action-items로 스킬을 불러 보고, 파일을 고친 뒤에는 /reload-plugins로 다시 불러옵니다.

팀에 플러그인을 공유하는 방법

팀 공유는 마켓플레이스 저장소를 하나 만들어 플러그인 목록을 적고, 팀원이 그 저장소를 한 번 추가하는 방식이 기본입니다. 한두 명에게만 줄 때는 플러그인 폴더나 zip 파일을 그대로 건네도 됩니다.

1. 마켓플레이스 폴더 만들기: team-plugins/.claude-plugin/marketplace.json을 만들고 플러그인 폴더를 team-plugins/plugins/ 아래에 둡니다.
2. 목록 적기: {"name": "team-plugins", "owner": {"name": "마케팅팀"}, "plugins": [{"name": "meeting-tools", "source": "./plugins/meeting-tools", "description": "회의록을 작업 목록으로 정리"}]}처럼 name, owner, plugins를 적습니다. 목록의 플러그인 이름은 plugin.json의 name과 같게 맞춥니다.
3. 검사 후 올리기: claude plugin validate ./team-plugins로 확인한 뒤 GitHub 같은 git 저장소에 올립니다. 비공개 저장소도 팀원 컴퓨터에 git 로그인이 되어 있으면 쓸 수 있습니다.
4. 팀원이 설치하기: 팀원은 /plugin marketplace add 조직이름/team-plugins로 한 번 추가하고 /plugin install meeting-tools@team-plugins로 설치합니다.
5. 저장소에서 함께 켜기: 프로젝트 범위로 설치하면 .claude/settings.json에 켜짐 설정이 기록되고, 이 파일을 커밋하면 같은 저장소의 팀원에게도 켜집니다. 다만 팀원 각자의 컴퓨터에 플러그인을 내려받는 설치는 한 번씩 해야 합니다.

직접 만든 마켓플레이스는 자동 업데이트가 기본으로 꺼져 있으니, 새 버전을 낸 뒤에는 Marketplaces 탭의 Update marketplace로 받도록 안내하세요.

설치 전 확인할 플러그인 보안 점검표

플러그인은 내 계정 권한으로 명령을 실행할 수 있습니다. 특히 훅과 MCP 서버는 Claude Code의 권한 확인을 거치지 않고 실행되므로, 신뢰할 수 있는 출처의 플러그인만 설치하고 설치 전에 내용을 직접 읽어 봅니다.

• 출처 확인: claude-plugins-official처럼 Anthropic 이름을 쓰는 마켓플레이스는 github.com/anthropics 저장소에서 온 것만 인정됩니다. 그 밖의 마켓플레이스는 동료가 만든 것이라도 제3자 마켓플레이스로 보고 저장소 주인을 확인합니다.
• Will install 읽기: /plugin 상세 화면에서 플러그인이 추가할 스킬·훅·MCP 서버 목록을 봅니다.
• 실행 내용 읽기: hooks/hooks.json의 각 명령, .mcp.json의 서버 주소와 실행 명령, bin/ 폴더의 파일을 직접 엽니다. 목록에는 훅이 있다는 사실만 나오고 무엇을 실행하는지는 나오지 않습니다.
• 자동 업데이트 주의: 자동 업데이트가 켜진 마켓플레이스는 내가 검토한 뒤에도 파일이 바뀔 수 있습니다. 중요한 저장소에서는 버전을 고정하거나 업데이트 내용을 확인한 뒤 받습니다.
• 믿지 못하게 되면 바로 삭제: claude plugin uninstall 이름 --scope 설치한범위로 지우고, 그 마켓플레이스도 믿기 어렵다면 Marketplaces 탭에서 마켓플레이스째 제거합니다.

다글로 회의 기록을 플러그인 스킬로 작업 목록으로 만들기

플러그인 스킬은 받아쓴 회의 기록처럼 형식이 일정한 입력에 반복 적용할 때 효과가 큽니다. 회의를 다글로로 받아쓰면 누가 말했는지 구분된 원문과 요약이 남아, 스킬이 바로 읽을 수 있는 자료가 됩니다.

1. 참석자 동의를 받고 회의를 녹음한 뒤 다글로에 올려 받아씁니다.
2. 보드챗에 "이번 회의에서 결정된 일과 후속 작업을 말한 사람별로 정리해 줘"라고 묻고, 답변을 받아쓴 원문과 바로 대조합니다.
3. 정리된 내용을 복사해 프로젝트 폴더의 meeting-notes.md에 저장하고, Claude Code에서 /meeting-tools:action-items meeting-notes.md처럼 플러그인 스킬을 실행합니다. 스킬에는 "작업마다 할 일·관련 파일·확인 방법을 표로 만든다" 같은 팀의 정리 규칙을 적어 둡니다.

회의마다 같은 형식으로 정리하고 싶다면 2번의 요청을 다글로 '내 템플릿'에 저장해 두세요. 다글로가 프롬프트를 기억해 녹음이 끝날 때마다 그 형식으로 자동 요약합니다.

정리하면, 공식 마켓플레이스에서 플러그인 하나를 설치해 구조를 익히고, 자주 쓰는 스킬을 plugin.json과 함께 묶어 --plugin-dir로 시험한 뒤 팀 마켓플레이스로 공유하면 됩니다. 명령어와 설정 형식은 버전마다 바뀔 수 있으니 적용 전에 공식 플러그인 문서를 한 번 더 확인하세요.

#클로드코드플러그인 #ClaudeCode #클로드코드 #플러그인마켓플레이스 #클로드코드스킬 #MCP #하네스엔지니어링 #다글로

👉 회의 기록 무료로 받아쓰기 시작하기