클로드 코드(Claude Code)에서 /plugin 명령을 처음 누르시면 화면에 official 마켓의 플러그인 몇 개만 뜨는 경우가 많습니다. “다른 사람들이 만든 좋은 플러그인이 분명 많다고 들었는데 어디서 보지?” 하고 막히는 단계입니다. 답은 단순합니다. 클로드 코드의 마켓플레이스는 기본적으로 공식 채널 한 곳만 자동 연결되어 있고, 커뮤니티 마켓은 본인이 직접 추가하셔야 보입니다. 마켓플레이스가 어떻게 동작하는지, 외부 마켓을 어떻게 연결하는지, 안전하게 쓰려면 무엇을 봐야 하는지를 한 번에 정리해 드립니다.
목차
마켓플레이스라는 게 정확히 뭔가요
클로드 코드의 마켓플레이스는 플러그인을 모아 둔 “레지스트리”입니다. 본질적으로는 .claude-plugin/marketplace.json 파일이 들어 있는 GitHub 저장소(또는 로컬 폴더)입니다. 이 파일 안에 어떤 플러그인이 있는지, 어디에서 받아와야 하는지가 적혀 있고, 클로드 코드는 이 정보를 읽어서 사용자에게 목록을 보여 줍니다.
한 마켓에는 보통 여러 개의 플러그인이 있고, 한 플러그인 안에는 슬래시 커맨드, 스킬, MCP 서버, 훅 등이 묶여 있습니다. 즉 마켓 → 플러그인 → 그 안의 기능들이라는 3단 구조입니다.
왜 official 마켓만 보이나요
클로드 코드는 처음 설치한 직후, 앤트로픽이 운영하는 공식 마켓 한 곳만 자동으로 연결합니다. 보통 claude-plugins-official이라는 이름으로 등록되어 있습니다. 그 외의 마켓은 모두 사용자가 직접 추가해 주셔야 화면에 나타납니다.
이 구조는 의도된 설계입니다. 플러그인은 클로드 코드와 동일한 OS 권한으로 동작하기 때문에, 검증되지 않은 출처를 자동으로 노출하면 위험합니다. 그래서 공식 마켓만 자동 노출되고, 커뮤니티 마켓은 사용자가 명시적으로 동의한 뒤에야 추가되도록 만들어 두었습니다.
커뮤니티 마켓 추가하는 법
가장 흔한 형태는 GitHub 저장소를 마켓으로 등록하는 방식입니다. 클로드 코드 세션 안에서 슬래시 명령으로 처리합니다.
/plugin marketplace add 사용자명/저장소명
예를 들어 어떤 커뮤니티가 운영하는 마켓이 GitHub의 example-org/awesome-claude-plugins라면 다음과 같이 추가합니다.
/plugin marketplace add example-org/awesome-claude-plugins
저장소 호스팅이 GitHub가 아니거나 사내망에 있는 경우엔 전체 URL이나 로컬 경로도 받습니다.
- 전체 URL:
/plugin marketplace add https://github.example.com/team/internal-plugins - 로컬 경로:
/plugin marketplace add ./my-marketplace
마켓이 등록되면 /plugin을 다시 열었을 때 Discover 탭에서 해당 마켓의 플러그인이 함께 보입니다. 등록된 마켓 목록은 /plugin marketplace list로 확인하실 수 있고, 더 이상 쓰지 않는 마켓은 /plugin marketplace remove 마켓이름으로 정리할 수 있습니다.
플러그인 설치와 사용
마켓이 추가됐다면 그 안의 플러그인을 설치하시면 됩니다. 설치 명령은 마켓 이름과 함께 적습니다.
/plugin install 플러그인이름@마켓이름
예를 들어 공식 마켓의 GitHub 연동 플러그인을 깔 때는 다음과 같습니다.
/plugin install github@claude-plugins-official
설치 시 클로드 코드는 적용 범위(scope)를 묻습니다. User를 고르시면 본인의 모든 프로젝트에서 그 플러그인이 활성화되고, Project를 고르시면 현재 저장소에서만 활성화됩니다. 팀과 공유할 도구라면 Project 쪽이 적절합니다.
설치 후 확인은 다음으로 합니다.
/plugin list --installed
여기서 어떤 플러그인이 어떤 scope·어떤 마켓에서 깔렸는지 한눈에 볼 수 있습니다. 활성/비활성 토글은 /plugin UI에서 직접 처리할 수 있습니다.
공식 마켓 vs 커뮤니티 마켓, 무엇이 다른가
두 마켓은 동작 방식은 같지만 운영 정책이 다릅니다. 선택할 때 참고하시면 좋은 차이점은 다음과 같습니다.
| 구분 | 공식 마켓 (Anthropic) | 커뮤니티 마켓 |
|---|---|---|
| 등록 방식 | 설치 시 자동 연결 | 사용자가 직접 추가 |
| 심사 | 앤트로픽 검토 | 없음 (저장소 운영자 책임) |
| 업데이트 | 자동 | 대부분 수동 |
| 주된 콘텐츠 | 공식 도구·기본 워크플로우 | 실험적·전문 분야 도구 |
| 권장 시점 | 처음 사용·범용 도구 | 특정 워크플로우·내부 도구 |
대부분 처음에는 공식 마켓의 도구만으로 충분합니다. 본인의 작업이 좀 더 특수해지면 그때 커뮤니티 마켓을 한두 개 추가하시는 것이 자연스러운 흐름입니다.
안전하게 쓰는 4가지 원칙
커뮤니티 마켓의 플러그인은 본인이 신뢰 결정을 내려야 합니다. 설치 전에 다음을 확인하시는 것이 좋습니다.
- 저장소 활동성: 마지막 커밋 시점, 이슈 응답 속도가 무난한지
- 플러그인 권한: 플러그인이 어떤 명령·MCP 서버·훅을 포함하는지 README와 코드로 확인
- SKILL.md·script 코드: 외부 호출이나 파일 삭제처럼 위험한 동작이 들어 있는지 훑어보기
- scope 선택: 처음 시도하는 플러그인은 Project scope로 한 저장소에만 한정해 깔고 점검
잘 모르는 마켓의 플러그인은 처음부터 User scope로 깔지 않으시는 편이 안전합니다. 문제가 생기더라도 영향이 한 저장소로 제한됩니다.
사내·팀 전용 마켓 만들기
사내 도구를 외부에 공개하지 않고 팀 내부에서만 공유하고 싶다면 비공개 마켓을 직접 만드시면 됩니다. 방법은 단순합니다.
- 사내 GitHub 저장소를 하나 만듭니다.
- 저장소 안에
.claude-plugin/marketplace.json을 두고, 등록할 플러그인 정보를 적습니다. - 각 플러그인은 같은 저장소 안의 폴더 또는 다른 저장소를 가리킬 수 있습니다.
- 팀원은
/plugin marketplace add 사내조직/내부저장소로 등록합니다.
이 방식이면 외부 마켓을 거치지 않고도 팀 표준 도구 세트를 한 번에 배포·갱신할 수 있습니다. 보안 정책이 엄격한 환경에서 자주 쓰는 패턴입니다.
안 보일 때 점검 순서
커뮤니티 마켓을 추가했는데 플러그인이 안 보인다면 다음 순서로 확인하십시오.
- 1.
/plugin marketplace list로 마켓이 정상 등록됐는지 확인 - 2. 등록된 저장소에 실제로
.claude-plugin/marketplace.json이 있는지 GitHub에서 직접 확인 - 3.
/plugin의 Discover 탭을 새로 열어 보고, 그래도 없으면 클로드 코드 세션 재시작 - 4. 사내 저장소라면 본인의 GitHub 인증이 해당 저장소를 읽을 권한이 있는지 확인
- 5. 이름이 같은 마켓이 두 번 등록돼 충돌하지 않았는지 확인
자주 묻는 질문
공식 마켓 외에 어디서 좋은 마켓을 찾을 수 있나요?
대형 커뮤니티는 GitHub 토픽·README의 “Awesome Claude” 류 큐레이션 저장소를 통해 노출되는 경우가 많습니다. 다만 출처를 잘 모르는 마켓은 코드를 한 번 훑어보고 추가하시는 것이 안전합니다.
한 마켓에서 플러그인 일부만 깔 수 있나요?
네. 마켓을 추가하는 것과 그 안의 플러그인을 설치하는 것은 별개의 동작입니다. /plugin install로 필요한 플러그인만 골라 설치하시면 됩니다.
설치한 커뮤니티 플러그인은 자동으로 업데이트되나요?
일반적으로는 자동 업데이트되지 않습니다. /plugin UI에서 업데이트 가능 표시가 뜨면 본인이 명시적으로 갱신하셔야 하는 경우가 많습니다. 마켓 운영자가 자동 갱신을 지원하면 그에 따릅니다.
회사 정책상 외부 마켓을 못 씁니다.
사내 GitHub 저장소를 마켓으로 만들고 거기에만 플러그인을 등록하시면 됩니다. 팀원들에게는 사내 저장소 경로만 추가하도록 안내하시면 외부 노출 없이 같은 도구 세트를 운영할 수 있습니다.
정리
클로드 코드 마켓플레이스에 공식만 보이는 건 정상입니다. 커뮤니티 마켓은 보안상 사용자가 직접 /plugin marketplace add로 추가해야 노출됩니다. 추가는 GitHub 저장소·URL·로컬 경로 모두 가능하며, 설치는 /plugin install 이름@마켓 한 줄이면 끝납니다. 외부 마켓을 쓸 때는 저장소 활동성과 플러그인 코드를 한 번 확인하시고, 새 플러그인은 Project scope로 좁게 시작하시는 습관이 안전합니다. 사내 전용 마켓도 같은 구조로 어렵지 않게 만들 수 있으니, 팀 도구 표준화에도 활용하시면 좋습니다.