클로드 코드 플러그인 설치: 마켓플레이스에서 남이 만든 걸 가져다 쓰기

플러그인은 스킬과 서브에이전트, 훅, MCP 서버를 하나로 묶어 한 번에 설치하는 꾸러미입니다. 마켓플레이스는 이 꾸러미를 모아 둔 진열대이고, 설치는 그 진열대에서 하나를 골라 담는 두 단계짜리 절차입니다. 지난 레슨에서 CLAUDE.md 파일 하나로 프로젝트 규칙을 고정했다면, 오늘은 그 규칙 위에서 실제로 동작하는 확장 하나를 설치해 볼 차례입니다. 플러그인 설치 방법이나 삭제하는 법이 급해서 오셨다면 이 레슨만 보셔도 됩니다. 마켓플레이스 목록과 설치 명령은 릴리스마다 조금씩 달라질 수 있으니, 오래된 시점에 읽으신다면 공식 문서를 함께 확인해 주세요.

마켓플레이스 (Marketplace)

마켓플레이스는 다른 사람이 만들어 공유한 플러그인의 카탈로그다. 마켓플레이스를 등록해도 플러그인이 저절로 설치되지는 않는다. 등록은 목록을 훑어볼 수 있게 할 뿐이고, 그 목록에서 플러그인 하나를 실제로 받아오는 일은 별도의 설치 단계다.

마켓플레이스란: 플러그인 진열대

공식 문서는 이 구조를 앱스토어에 비유합니다. 스토어 앱을 설치한다고 그 안의 앱이 저절로 깔리지 않듯이, 마켓플레이스를 등록해도 플러그인은 하나도 설치되지 않습니다. 등록은 카탈로그를 Claude Code(클로드 코드)에 알려주는 일이고, 설치는 그 카탈로그에서 원하는 항목을 고르는 일입니다. 이 둘을 하나로 착각하면 "마켓플레이스를 추가했는데 아무것도 안 보인다"는 혼동이 생깁니다. 정상입니다. 아직 설치를 안 했을 뿐입니다.

마켓플레이스는 신뢰 수준이 서로 다른 세 종류로 나뉩니다.

레슨 1에서 플러그인 자리를 나머지 넷과 다르다고 짚었던 것을 기억하실 겁니다. CLAUDE.md, 스킬, 서브에이전트, 훅은 내가 직접 만드는 것을 대신하고, 플러그인은 남이 만든 것을 설치하는 일을 대신한다고 했습니다. 마켓플레이스는 바로 그 "남이 만든 것"들이 모여 있는 자리입니다. 개인이나 팀 저장소를 마켓플레이스로 등록하는 것도 가능하지만, 지금은 이미 만들어진 세 종류 중에서 하나를 골라 실제로 설치해 보는 편이 빠릅니다.

공식 마켓플레이스에 어떤 것들이 올라와 있는지 감을 잡아두면 나중에 고를 때 도움이 됩니다. GitHub, Slack, Notion(노션) 같은 외부 서비스를 미리 구성된 MCP 서버로 바로 연결해 주는 플러그인, 파이썬이나 타입스크립트 같은 언어의 코드 분석을 도와주는 플러그인, 커밋과 풀 리퀘스트 같은 반복 작업을 스킬로 묶어 놓은 플러그인이 대표적입니다. 마케팅이나 콘텐츠 업무처럼 코드가 아닌 작업에는 이 중 상당수가 해당되지 않지만, 반복되는 절차를 스킬로 묶어 배포하는 방식 자체는 다음 레슨에서 내 절차를 스킬로 만들 때 그대로 참고할 틀이 됩니다.

설치하고 돌려보기

/plugin을 입력하면 Discover(마켓플레이스 전체에서 플러그인 찾아보기), Installed(설치한 플러그인 보기와 관리), Marketplaces(등록한 마켓플레이스 관리), Errors(플러그인 로딩 오류 확인) 네 개 탭이 있는 화면이 뜹니다. 손으로 눌러가며 찾아도 되지만, 이 레슨은 명령을 직접 입력하는 방식으로 안내합니다. 어느 쪽이든 결과는 같습니다.

공식 문서가 예제로 쓰는 데모 마켓플레이스로 직접 설치까지 해보겠습니다. 터미널에서 Claude Code 세션을 연 뒤 아래 순서를 그대로 따라 하시면 됩니다.

/plugin marketplace add anthropics/claude-code

이 한 줄이 claude-code-plugins라는 이름으로 마켓플레이스를 등록합니다. GitHub 저장소 안의 카탈로그 파일을 내려받아 목록에만 올려두는 단계라 아직 아무것도 설치되지는 않습니다. 이어서 이 마켓플레이스에 있는 commit-commands 플러그인을 설치합니다. 커밋 메시지를 만들고 푸시하는 절차를 스킬로 묶어 놓은 항목입니다.

/plugin install commit-commands@claude-code-plugins

플러그인 이름 뒤에 @마켓플레이스이름을 붙이는 형식은 같은 이름의 플러그인이 여러 마켓플레이스에 있을 때 어느 쪽을 설치할지 구분하기 위해서입니다. 이 명령을 실행하면 설치 범위를 고르는 화면이 뜹니다.

처음 설치해 볼 때는 사용자 범위로 시작하는 편이 무난합니다. 여러 프로젝트에서 바로 시험해 볼 수 있고, 마음에 안 들면 지우는 절차도 동일하기 때문입니다.

설치 화면에는 이 플러그인이 무엇을 담고 있는지, 그리고 매 턴 컨텍스트에 얼마나 얹히는지도 함께 뜹니다. 설치한 뒤에 같은 내용을 터미널에서 다시 확인하고 싶다면 아래 명령을 씁니다.

claude plugin details commit-commands@claude-code-plugins

실제로 이 명령을 실행해 확인해 보면 이렇게 뜹니다.

스킬만 3개 들어 있고 훅이나 MCP 서버는 없다는 것을 설치 전에 이미 알 수 있다는 뜻입니다. 이 인벤토리를 먼저 보고 설치 여부를 판단할 수 있다는 게 핵심입니다. 설치가 끝나면 이 플러그인의 스킬은 /commit-commands:commit처럼 플러그인 이름이 접두어로 붙습니다. 다른 플러그인이 같은 이름의 스킬을 가져도 충돌하지 않도록 하는 장치입니다.

설치 직후 /plugin의 Installed 탭에서 방금 설치한 플러그인을 열면 담긴 명령 세 개가 그대로 보입니다.

안 맞으면 지운다

자동완성에는 "플러그인 마켓플레이스"만큼이나 "플러그인 삭제"도 잡힙니다. 설치는 안내가 잘 되어 있는데 해제는 상대적으로 덜 알려져 있다는 뜻입니다. 방금 설치한 플러그인을 정리하는 순서로 확인해 보겠습니다.

플러그인을 완전히 지우려면 이렇게 씁니다.

/plugin uninstall commit-commands@claude-code-plugins

지우지 않고 잠깐 꺼두고 싶을 때는 disable을 씁니다. 다시 켤 때는 같은 이름으로 enable을 쓰면 됩니다.

/plugin disable commit-commands@claude-code-plugins

마켓플레이스 자체를 등록 목록에서 빼려면 이렇게 씁니다.

/plugin marketplace remove claude-code-plugins

여기서 한 가지 주의할 점이 있습니다. 공식 문서는 마켓플레이스를 제거하면 그 마켓플레이스에서 설치한 플러그인이 전부 함께 지워진다고 경고합니다. 마켓플레이스 하나만 빼고 플러그인은 남겨두고 싶다면 순서를 반대로 해야 합니다. 플러그인부터 지운 다음 마켓플레이스를 지우는 것이 아니라, 계속 쓸 플러그인이 있다면 그 마켓플레이스는 그대로 두는 편이 맞습니다. 세션 도중에 설치나 삭제, 켜고 끄기를 했다면 /reload-plugins를 한 번 실행해야 재시작 없이 바로 반영됩니다.

명령어 대신 화면으로 관리하고 싶다면 /plugin을 열고 Installed 탭으로 이동하면 됩니다. 문제가 있는 플러그인이 맨 위에, 그다음 즐겨찾기, 비활성화한 플러그인은 맨 아래 접힌 채로 정리되어 있어 (2026년 8월 화면 기준) 목록이 길어져도 지울 대상을 찾기 어렵지 않습니다. 설치한 지 2주 넘게, 10세션 넘게 안 쓴 플러그인은 Not used recently 항목으로 따로 모이기도 합니다 (2026년 8월 기준 동작). 오래전에 설치해 두고 잊어버린 플러그인을 정리할 때 참고할 만합니다.

남의 것을 쓸 때 확인할 것: 출처와 인벤토리

플러그인은 스킬만 담는 게 아닙니다. 훅과 MCP 서버까지 함께 설치될 수 있습니다. 공식 문서는 이 지점을 분명히 경고합니다. 플러그인과 마켓플레이스는 내 컴퓨터에서 내 권한으로 임의의 코드를 실행할 수 있는, 상당한 신뢰가 필요한 구성 요소라는 것입니다. Anthropic은 플러그인 안에 포함된 MCP 서버나 파일, 다른 소프트웨어를 직접 통제하지 않고 의도대로 동작하는지 확인해 주지도 않습니다.

그래서 설치 전에 확인할 기준이 필요합니다.

1. 어느 마켓플레이스에서 왔는가: 공식 마켓플레이스는 Anthropic이 직접 심사했고, 커뮤니티 마켓플레이스는 자동화된 검증과 안전 심사를 통과한 항목만 올라갑니다. 둘 다 아닌 낯선 저장소를 마켓플레이스로 등록한다면 신뢰 수준이 한 단계 내려간다고 보시면 됩니다.
2. 설치 전 인벤토리를 먼저 본다: 앞서 확인한 것처럼 설치 화면에는 이 플러그인이 어떤 스킬, 에이전트, 훅, MCP, LSP 서버를 담고 있는지 미리 나열됩니다. 특히 훅과 MCP 서버가 들어 있는지는 꼭 확인할 만합니다. 이 둘은 스킬과 달리 내가 부르지 않아도 정해진 시점에 저절로 실행되거나 외부와 통신하기 때문입니다.
3. 범위를 좁혀서 먼저 써본다: 처음 써보는 플러그인이라면 프로젝트나 로컬 범위로 한 저장소에서만 먼저 돌려보고, 문제가 없으면 그때 사용자 범위로 넓히는 편이 안전합니다.

저도 남이 만든 스킬을 받아 지금도 매일 쓰고 있습니다. 기능을 설계하기 전에 아이디어를 넓혔다 좁히는 브레인스토밍 스킬인데, 제 경우는 마켓플레이스가 아니라 공개 저장소에서 받아 폴더에 직접 옮겨둔 것입니다. 지금 배우는 플러그인 설치는 그 수작업을 관리자 화면 하나로 줄인 경로입니다. 받아 쓰는 경험을 한 번 하고 나면 순서가 바뀝니다. 뭐가 필요할 때 만들기부터 하는 게 아니라, 남이 만들어둔 게 있는지부터 뒤지게 됩니다. 기준을 세우면 이렇습니다. 지금 필요한 절차가 나만 겪는 일이 아니라면(아이디어 정리, 코드 리뷰, 커밋 메시지 정리처럼 누구나 하는 일) 먼저 마켓플레이스를 봅니다. 반대로 우리 회사 용어와 규칙이 절반인 절차라면 받아도 고칠 게 더 많으니 다음 레슨처럼 직접 만드는 쪽이 빠릅니다. 처음 만들어보기 전에 남이 만든 것을 하나 열어 구조를 구경하는 용도로도 마켓플레이스는 좋은 교재입니다.

플러그인이 담을 수 있는 MCP 서버 자체의 위험, 그러니까 악성 서버가 무엇을 노리고 어떻게 가려내는지는 트랙 ②(연결하기)에서 이미 다룬 내용과 같은 축입니다. 여기서 다시 설명하지 않고 그쪽을 참고하시면 됩니다.