클로드 코드 플러그인·마켓플레이스 사용법 2026 — 설치 전 알아야 할 것

플러그인은 스킬·서브에이전트·자동 실행 규칙·외부 도구 연결을 하나로 묶어 나눠 쓸 수 있게 포장한 확장팩입니다. 마켓플레이스는 그 확장팩을 모아 둔 카탈로그이며, 공식 문서는 마켓플레이스를 다른 사람이 만들어 공유한 플러그인의 카탈로그라고 설명합니다.

공식 문서에 따르면 플러그인 하나에 들어갈 수 있는 것은 스킬, 서브에이전트, 특정 시점에 자동 실행되는 훅, MCP 서버 설정, 몇 가지 부속 파일입니다. 여기서 중요한 지점이 나옵니다. 플러그인은 파일 몇 개가 아니라 실행되는 것을 담을 수 있으며, 이 사실이 아래 보안 이야기의 근거가 됩니다.

가장 흔한 오해가 이것입니다. 마켓플레이스를 추가하면 그 안의 플러그인이 저절로 깔린다고 생각하기 쉽습니다. 공식 문서는 두 단계로 나눠 설명합니다.

마켓플레이스 추가는 카탈로그를 등록하는 것뿐이며, 이 시점에는 아무것도 설치되지 않았습니다. 플러그인 설치는 이때부터 실제로 들어오는 단계이며, 설치할 때 나만 쓸지 이 프로젝트에서 쓸지 범위도 고릅니다.

설치 후 요약 메시지를 확인하면 됩니다. 공식 문서에 따르면 지금 활성화되었다고 뜨면 바로 쓸 수 있고, 별도 명령을 실행해 활성화하라고 뜨면 그 명령을 한 번 더 실행해야 합니다. 이 단계를 놓치면 설치가 안 된 줄 알고 같은 명령을 반복하는 일이 생깁니다.

패널을 여는 명령으로 둘러보기, 설치됨, 마켓플레이스, 오류, 통계 탭을 볼 수 있습니다. 설치 목록은 별도 명령으로 확인하고, 지우지 않고 끄는 명령과 완전히 제거하는 명령이 나뉘어 있습니다. 마켓플레이스 자체도 목록 확인·갱신·제거 명령으로 관리합니다.

끄기와 지우기가 나뉘어 있는 점이 실무에서 유용합니다. 안 쓰는 것을 먼저 꺼 두고, 한 달쯤 지나도 다시 켜지 않으면 그때 지우는 방식이 안전합니다.

직접 만들 수도 있습니다. 공식 문서에는 플러그인을 만드는 최소 절차도 있습니다. 폴더를 만들고 매니페스트 파일에 이름과 설명을 적고, 그 옆에 스킬 폴더를 두면 됩니다. 마켓플레이스에 올리지 않고 로컬에서 바로 시험해 볼 수도 있습니다. 다만 스킬·에이전트·훅 폴더를 매니페스트 파일이 들어가는 폴더 안에 함께 넣으면 안 된다는 점이 공식 문서에 굵게 적혀 있습니다.

공식 문서의 보안 경고는 분명합니다. 플러그인과 마켓플레이스는 사용자 권한으로 임의의 코드를 실행할 수 있는, 높은 신뢰가 필요한 구성 요소이므로 신뢰하는 출처의 플러그인과 마켓플레이스만 설치하라고 안내합니다. 같은 문서에는 Anthropic이 플러그인에 어떤 MCP 서버·파일·소프트웨어가 포함되는지 통제하지 않으며, 의도대로 작동하는지 검증할 수 없다는 문장도 있습니다.

정리하면 목록에 올라와 있다는 것은 안전 인증이 아닙니다. 설치는 내 컴퓨터에서 남의 코드를 돌리는 일에 가깝습니다. 이름을 사칭하는 문제도 공식적으로 다뤄지며, 공식 이름을 흉내 낸 마켓플레이스 이름은 예약돼 등록이 막혀 있지만 그래도 최종 확인은 사용자 몫입니다.

플러그인을 고를 때 가장 먼저 볼 것은 화려한 기능 목록이 아니라 무엇이 들어 있는지입니다. 스킬만 든 플러그인과 훅·MCP까지 든 플러그인은 위험도가 다르고, 후자는 내 컴퓨터에서 코드가 실행된다는 뜻입니다. 한 번에 여러 개를 한꺼번에 깔면 문제가 생겼을 때 어느 것 때문인지 알 수 없으므로, 하나씩 깔고 확인하는 순서가 안전합니다. 안 쓰는 플러그인을 계속 쌓아 두면 확인해야 할 대상만 늘어나므로, 켜 둔 것 각각이 무엇을 해결하는지 한 줄로 말할 수 없다면 그건 정리 대상으로 보는 편이 낫습니다.

공식 마켓플레이스는 자동으로 등록되나요?

공식 문서에 따르면 클로드 코드를 처음 대화형으로 시작할 때 공식 마켓플레이스가 자동 등록됩니다. 실패했다면 수동으로 추가할 수 있고, 커뮤니티 마켓플레이스는 직접 추가해야 합니다.

팀에 배포하려면 어떻게 하나요?

프로젝트 설정에 마켓플레이스를 넣어 둘 수 있습니다. 다만 공식 문서는 외부 소스 플러그인은 팀원이 각자 설치해야 로드된다고 안내합니다.

플러그인과 스킬은 뭐가 다른가요?

스킬은 절차 파일 하나이고, 플러그인은 스킬을 포함해 여러 요소를 묶어 배포하는 포장 단위입니다. 혼자 쓸 절차라면 스킬로 충분합니다.

추가와 설치는 다른 단계이고, 설치는 남의 코드를 내 컴퓨터에서 돌리는 일입니다. 고르는 기준을 먼저 정하고 하나씩 설치하는 것이 안전하며, 최신 명령어와 보안 안내는 공식 문서에서 확인해야 합니다.

• Anthropic — Claude Code Plugins (https://code.claude.com/docs/en/plugins, 확인일 2026-09-18)
• Anthropic — Discover plugins (https://code.claude.com/docs/en/discover-plugins, 확인일 2026-09-18)
• Anthropic — Plugin marketplaces (https://code.claude.com/docs/en/plugin-marketplaces, 확인일 2026-09-18)