claude plugin: 스킬 묶음을 한 번에 설치·관리하는 법

기능 하나하나 따로 설정하다 보면 시간이 꽤 걸려요. 특히 팀원 모두에게 똑같은 환경을 깔아 주려면 손이 많이 가죠. 이럴 때 관련 기능을 통째로 묶어서 한 번에 설치하게 해 주는 게 플러그인이고, 이를 관리하는 명령어가 claude plugin이에요.

정의 (뭐냐면)

claude plugin은 플러그인을 설치하고 관리하는 명령어예요.

플러그인(plugin)은 "스킬 + 연결을 한 묶음으로 포장한 패키지"라고 보면 돼요. 여기서 스킬은 Claude에게 특정 작업을 잘하게 가르치는 설명서 같은 것이고, 연결은 앞서 본 MCP 같은 외부 앱 연결을 말해요. 이 둘을 한 봉지에 담아 둔 게 플러그인이라, 하나만 설치하면 관련 기능이 통째로 들어옵니다.

어떻게 쓰나 (난이도별)

기초 — 설치된 플러그인 목록 보기

claude plugins

이 명령어를 입력하면 지금 설치돼 있는 플러그인 목록을 보여 줘요. "내가 뭘 깔아 놨더라?"를 확인할 때 가장 먼저 쓰면 됩니다.

응용 — 마켓에서 설치하기

claude plugin install code-review@claude-plugins-official

install 뒤에 플러그인 이름을 적으면 마켓(공식 플러그인 저장소)에서 가져와 설치해요. 위 예시는 코드리뷰 플러그인을 설치하는 거예요. @ 뒤의 claude-plugins-official은 "어느 저장소에서 가져올지"를 나타내는 출처 표시입니다.

심화 — 로컬 플러그인 개발하기

claude --plugin-dir ./my-plugin

--plugin-dir로 폴더를 지정하면, 그 폴더 안에서 개발 중인 플러그인을 이번 세션에서만 불러와 테스트할 수 있어요. ./my-plugin은 "지금 폴더 안의 my-plugin 폴더"라는 뜻이에요. 직접 플러그인을 만드는 중이라면 정식 설치 없이 바로 시험해 볼 수 있어서 편합니다.

흔한 함정

• 목록을 볼 때는 claude plugins(복수형), 설치할 때는 claude plugin install처럼 쓰임에 따라 형태가 조금 달라요. 명령어가 안 먹으면 단수·복수를 한번 확인해 보세요.
• --plugin-dir로 불러온 플러그인은 그 세션에서만 임시로 동작해요. 계속 쓰려면 정식으로 설치해야 합니다.

실전 사례

블로그 작업에 쓰는 스킬 3종(기획·조사·작성)을 하나의 플러그인으로 묶어 두면, 팀원에게 "이거 설치하세요" 한마디로 똑같은 작업 환경을 나눠 줄 수 있어요. 각자 따로 설정하느라 시간을 쓰거나, 사람마다 환경이 달라서 결과가 들쭉날쭉하는 문제를 한 번에 해결하는 거죠.

이렇게 더 씁니다

자주 함께 쓰는 스킬과 연결이 손에 익었다면, 그걸 플러그인으로 묶어 패키지로 만들어 두는 걸 권해요. 나중에 새 PC에서 작업을 시작할 때도, 새 팀원이 합류할 때도 "설치 한 번"으로 동일한 환경을 갖출 수 있어요. 우리 팀만의 작업 세트를 하나의 꾸러미로 정리해 두는 셈입니다.

정리

claude plugin은 스킬과 연결을 한 묶음으로 만든 플러그인을 설치·관리하는 명령어예요. claude plugins로 목록을 보고, claude plugin install로 마켓에서 설치하며, --plugin-dir로 개발 중인 플러그인을 테스트할 수 있습니다. 팀에 동일 환경을 한 번에 배포할 때 특히 유용해요.

기준: Claude Code v2.1.154 (2026.05)