플러그인이란? Claude Code 플러그인 구조와 설치 사용법

원스링크 운영업체Lv.2Claude2026.09.08 12:39· 조회 1

플러그인(Plugin)은 Claude Code에 기능을 덧붙이는 "설치형 묶음"입니다. 스킬 파일 하나가 업무 매뉴얼 한 장이라면, 플러그인은 매뉴얼 여러 장에 담당 직원(에이전트), 자동 동작(훅), 외부 연동(MCP 서버)까지 한 상자에 넣어 통째로 건네는 방식입니다. Claude Code 공식 문서 기준으로 정리했습니다.

플러그인 안에 무엇이 들어가나

구성 요소	위치	쉬운 설명
스킬	`skills/<이름>/SKILL.md`	업무 절차. 설치 후 `/플러그인이름:스킬이름`으로 부름
에이전트	`agents/`	특정 역할을 맡는 보조 작업자 정의
훅	`hooks/hooks.json`	"파일 저장 후에 검사 실행" 같은 자동 동작
MCP 서버	`.mcp.json`	외부 서비스(예: 우리 CMS)와 연결하는 설정
매니페스트	`.claude-plugin/plugin.json`	이름·설명·버전·작성자(선택)

이 밖에 commands/(예전 방식의 슬래시 명령), bin/, settings.json 등도 둘 수 있습니다. 주의: 스킬·에이전트 폴더는 플러그인 루트에 두고 .claude-plugin/ 안에 넣지 않습니다.

마켓플레이스: 플러그인을 받는 곳

플러그인은 마켓플레이스라는 목록에서 받습니다. Anthropic이 관리하는 공식 목록(claude-plugins-official)과 커뮤니티 목록(claude-plugins-community)이 있고, 팀에서 자체 목록을 만들어 등록할 수도 있습니다. 목록 추가는 Claude Code 안에서 슬래시 명령으로 합니다.

/plugin marketplace add owner/repo          # GitHub 저장소
/plugin marketplace add ./local-path        # 내 컴퓨터의 폴더
/plugin marketplace update marketplace-name # 목록 갱신

설치·활성·제거 명령

같은 작업을 Claude Code 안(슬래시)에서도, 터미널(CLI)에서도 할 수 있습니다.

작업	Claude Code 안에서	터미널에서
설치	`/plugin install 이름@마켓`	`claude plugin install 이름@마켓 --scope user`
켜기 / 끄기	`/plugin enable 이름@마켓` / `/plugin disable 이름@마켓`	`claude plugin enable ...` / `claude plugin disable ...`
제거	`/plugin uninstall 이름@마켓`	`claude plugin uninstall 이름@마켓`
목록 보기	`/plugin list --enabled`	`claude plugin list`
다시 읽기	`/reload-plugins`	(세션 안 명령)

스코프(--scope user | project | local)는 "나만 쓸지, 이 프로젝트를 여는 모두가 쓸지"를 정합니다. 설정 파일에서는 enabledPlugins 키로 켜고 끄고, 팀 마켓플레이스는 extraKnownMarketplaces에 등록합니다. 세부 옵션은 아래 공식 문서를 참고하십시오.

플러그인과 MCP 서버는 무엇이 다른가

MCP 서버는 "외부 도구·데이터와 연결하는 통로"입니다. 예를 들어 저희 CMS의 페이지 목록을 읽고 글을 등록하는 기능이 MCP 서버로 제공됩니다. Claude가 필요할 때 도구처럼 호출합니다.
플러그인은 "묶음 포장"입니다. 스킬·에이전트·훅과 함께 MCP 서버 설정도 안에 넣을 수 있습니다. 즉 MCP 서버는 플러그인의 부품 중 하나가 될 수 있고, 플러그인 없이 .mcp.json만으로도 쓸 수 있습니다.

가장 작은 플러그인 만들어 보기

my-first-plugin/
  .claude-plugin/plugin.json      # {"name":"my-first-plugin","version":"1.0.0", ...}
  skills/hello/SKILL.md           # description + 지침 몇 줄

# 설치 없이 바로 시험
claude --plugin-dir ./my-first-plugin
# 세션 안에서
/my-first-plugin:hello

정식 배포 전에는 이렇게 --plugin-dir로 내 폴더를 직접 붙여 시험합니다. 잘 되면 마켓플레이스에 올려 팀원이 /plugin install 한 줄로 받게 합니다.

개원의·마케터에게 의미

스킬 한 장은 "내 노하우"이고, 플러그인은 "우리 팀의 표준 장비"입니다. 리뷰 답변 스킬, 칼럼 검수 스킬, CMS 연동(MCP)을 플러그인 하나로 묶어 두면 새 직원이나 다른 지점도 설치 한 번으로 같은 환경에서 일합니다. 명령은 공식 문서를 옮긴 것이니 실행 전 문서를 한 번 더 확인하시기 바랍니다.

참고 링크

목록으로

AI 주제별 게시판