마켓플레이스로 내 AI 도구 관리하기 — 클론·풀·푸시 쉽게 이해

스마트폰에는 앱스토어(App Store)가 있습니다. 앱스토어에 들어가면 수천 개의 앱이 카탈로그로 정리되어 있고, 원하는 앱을 탭 한 번으로 설치할 수 있습니다. Claude Code의 플러그인 마켓플레이스도 정확히 같은 개념입니다. 앱스토어에서 앱을 받듯, 마켓플레이스에서는 플러그인을 받습니다. 플러그인은 Claude Code에 기능을 추가하는 패키지입니다. '앱'이 스마트폰에 기능을 추가하는 것처럼, '플러그인'은 Claude Code에 새로운 기능을 추가합니다. 용어를 정리하면 이렇습니다. 플러그인 = 앱. Claude Code에 설치하는 기능 묶음입니다. 스킬(Skill) = 앱 안의 기능. 슬래시 커맨드(/연차계산, /계약서검토)로 실행하는 구체적인 행동 단위입니다. 하나의 플러그인 안에 여러 스킬이 들어있을 수 있습니다. 마켓플레이스 = 앱스토어. 플러그인들이 모여있는 카탈로그입니다. `/plugin marketplace add 레포주소`로 원하는 마켓플레이스를 추가하고, Discover 탭에서 플러그인을 찾아 설치합니다. 설치 명령어는 한 줄입니다. `/plugin marketplace add anthropics/claude-plugins-official` 이 명령어를 입력하면 Anthropic 공식 플러그인 카탈로그가 Claude Code에 추가되고, Discover 탭에서 공식 플러그인들을 볼 수 있게 됩니다. 커뮤니티가 만든 수백 개의 마켓플레이스도 같은 방식으로 추가할 수 있습니다.

마켓플레이스가 앱스토어라면, 그 앱스토어의 기반 기술은 git(깃)입니다. git은 파일의 변경 이력을 추적하고 여러 기기·여러 사람이 같은 파일을 공유할 수 있게 해주는 시스템입니다. 개발자들이 코드를 공유하는 방식이지만, 비개발자에게는 '버전 관리가 되는 구글 드라이브'로 이해하면 충분합니다. 구글 드라이브와 비교하면 이렇습니다. **클론(Clone) = 구글 드라이브 폴더를 내 컴퓨터에 처음으로 통째로 다운로드** 누군가가 만든 플러그인 레포지토리를 처음 받아올 때 씁니다. 마치 '공유된 구글 드라이브 폴더를 내 컴퓨터에 처음으로 동기화'하는 것과 같습니다. 한 번만 하면 됩니다. `git clone https://github.com/silobust-hash/handong-cowork-plugins` **풀(Pull) = 구글 드라이브에서 변경된 파일을 내 컴퓨터로 당겨오기** 이미 받아둔 플러그인이 업데이트됐을 때 최신 버전을 가져옵니다. 구글 드라이브에서 '동기화'를 누르는 것과 같습니다. Claude Code는 시작할 때 설치된 플러그인을 자동으로 풀(pull)해서 항상 최신 상태로 유지할 수 있습니다. **푸시(Push) = 내 컴퓨터의 변경 내용을 구글 드라이브에 올리기** 내가 스킬이나 설정을 수정했을 때 그 변경 사항을 원격 레포지토리에 올립니다. 구글 드라이브에 파일을 저장하면 자동으로 업로드되는 것과 비슷하지만, git은 '저장하겠다'고 명시적으로 알려줘야 합니다. 세 가지 흐름을 일상에 비유하면 이렇습니다. - 처음 도구를 받는다 → 클론(한 번) - 업데이트를 받는다 → 풀(필요할 때마다) - 내 수정을 공유한다 → 푸시(내가 수정했을 때)

git의 진짜 위력은 '한 번 설정, 어디서든 동일하게'에 있습니다. 박실로 노무사가 실제로 사용하는 방법을 예시로 봅시다. 노무법인 업무에 맞게 만든 스킬(연차계산, 취업규칙검토, 산재보상계산 등)과 플러그인 설정이 `github.com/silobust-hash/handong-cowork-plugins` 레포 하나에 저장되어 있습니다. 이 레포가 바로 '내 마켓플레이스'입니다. 이점은 세 가지입니다. **기기 간 동기화**: 사무실 맥미니와 외출할 때 쓰는 맥북에서 `/plugin marketplace add silobust-hash/handong-cowork-plugins`를 한 번씩 실행하면, 두 기기에서 완전히 같은 도구 환경이 만들어집니다. 설정을 처음부터 다시 할 필요가 없습니다. **자동 업데이트**: Claude Code는 시작 시 마켓플레이스와 설치된 플러그인을 자동으로 풀(pull)할 수 있습니다. 레포에서 스킬을 수정하고 푸시하면, 다음에 Claude Code를 시작할 때 두 기기 모두 최신 버전으로 자동 갱신됩니다. **백업 내재화**: 로컬 파일이 날아가도 GitHub에 레포가 있는 한 언제든 복구할 수 있습니다. '내 설정이 사라졌다'는 상황이 사라집니다. 실제로 자신만의 마켓플레이스를 만드는 순서는 이렇습니다. 1. GitHub에 새 레포를 만듭니다 (예: `my-claude-plugins`). 2. 내 스킬과 설정 파일을 레포에 올립니다(푸시). 3. `.claude-plugin/marketplace.json` 파일을 추가해 플러그인 목록을 선언합니다. 4. 다른 기기에서 `/plugin marketplace add 내아이디/my-claude-plugins`로 한 번에 불러옵니다.

마켓플레이스 구조의 또 다른 장점은 협업입니다. 내가 만든 플러그인과 스킬을 동료에게 공유하는 방법은 GitHub 레포 주소를 알려주는 것으로 끝입니다. 예를 들어 팀에서 함께 쓰는 '주간 업무 보고서 작성 스킬'을 만들었다면, 동료에게 이렇게 전달하면 됩니다. '터미널에서 `/plugin marketplace add 우리팀/weekly-report-plugin` 입력해봐요' 동료가 이 명령어 한 줄을 실행하면 동일한 스킬이 설치됩니다. 이후 내가 스킬을 업데이트해서 레포에 푸시하면, 팀원들이 다음에 Claude Code를 시작할 때 자동으로 최신 버전을 받습니다. Anthropics 공식 플러그인 디렉토리(`anthropics/claude-plugins-official`)에는 검증된 플러그인들이 모여있습니다. git commit·push·PR 생성 워크플로우를 자동화하는 `commit-commands`, PR 리뷰 에이전트인 `pr-review-toolkit` 같은 플러그인들이 예입니다. 커뮤니티 마켓플레이스에는 이미 수백 개의 플러그인이 공개되어 있으며, 계속 늘어나고 있습니다. 이 모든 것이 가능한 이유는 마켓플레이스 자체가 git 레포이기 때문입니다. 스킬·플러그인·에이전트의 버전관리·백업·공유가 전부 git의 클론-풀-푸시 흐름 위에서 작동합니다.