플러그인 마켓플레이스를 통해 Team 및 Enterprise 플랜 소유자는 Cowork를 통해 조직의 모든 사람에게 큐레이션된 플러그인을 배포할 수 있습니다. 마켓플레이스를 만들고, 플러그인을 추가하고, 팀 멤버가 볼 수 있고 사용할 수 있는 플러그인을 정확히 제어합니다.
Team 및 Enterprise 플랜의 소유자 및 주요 소유자는 Claude Desktop에서 조직 플러그인을 관리할 수 있습니다.
요구사항: 플러그인 마켓플레이스를 사용하기 전에 조직에서 Cowork와 Skills를 모두 활성화해야 합니다.
마켓플레이스에 플러그인을 추가하는 두 가지 방법이 있습니다:
수동 업로드 — 관리자 UI를 통해 개별 플러그인 ZIP 파일을 업로드합니다. 빠른 반복, 일회성 도구 또는 플러그인 개발에 GitHub를 사용하지 않는 팀에 최적입니다.
GitHub 동기화 — 비공개 GitHub 저장소를 연결하면 Cowork가 자동으로 플러그인을 동기화합니다. 여러 개발자가 플러그인에서 협업하거나 버전 제어 업데이트를 원할 때 최적입니다.
두 가지 방식을 병렬로 사용할 수 있습니다. 예를 들어, 핵심 플러그인용 GitHub 동기화 마켓플레이스와 임시 도구용 별도의 수동 마켓플레이스를 사용할 수 있습니다.
수동 마켓플레이스 설정
Claude Desktop을 열고 조직 설정 > 플러그인으로 이동합니다.
"플러그인 추가"를 클릭하고 소스로 "파일 업로드"를 선택합니다.
마켓플레이스를 처음 설정하는 경우 "새 마켓플레이스에 업로드"가 자동으로 선택됩니다.
앞으로 플러그인을 업로드할 때 "기존 마켓플레이스에 추가"를 선택할 수 있습니다.
마켓플레이스의 이름을 입력합니다.
파일을 드래그하거나 업로드 프롬프트를 클릭하여 파일을 선택합니다.
참고: 파일은 50MB 미만의 유효한 .zip 파일이어야 합니다.
추가하려는 각 플러그인에 대해 반복합니다.
"업로드"를 클릭하여 플러그인을 새 마켓플레이스에 추가합니다.
기존 플러그인과 같은 이름의 플러그인을 업로드하면 이전 버전이 자동으로 덮어씌워집니다. 먼저 이전 버전을 삭제할 필요가 없습니다.
GitHub 동기화 마켓플레이스 설정
GitHub 동기화를 통해 저장소에서 플러그인을 코드로 관리할 수 있습니다. 변경사항을 푸시하면 동기화를 트리거하여 마켓플레이스를 업데이트할 수 있습니다.
저장소 준비
저장소는 비공개 또는 내부여야 합니다. 공개 저장소는 조직 마켓플레이스에 허용되지 않습니다. 사용자 정의 GitHub Enterprise Server 인스턴스에서 호스팅되는 저장소는 지원되지 않습니다. 저장소는 github.com에서 호스팅되어야 합니다.
플러그인 구조 및 형식에 대한 자세한 내용은 플러그인 참조 문서를 참조하세요.
추가 리소스:
저장소 연결
조직에서 Cowork와 Skills가 모두 활성화되어 있는지 확인합니다.
조직 설정 > 플러그인으로 이동합니다.
"플러그인 추가"를 클릭하고 소스로 "GitHub"를 선택합니다.
owner/repo형식으로 저장소를 입력합니다(예:acme-corp/claude-plugins).
개인 GitHub 토큰이 확인되어 액세스 권한을 확인한 후 Cowork는 동기화 작업을 위해 GitHub App 설치 토큰을 사용합니다.
저장소가 보이지 않나요? Cowork GitHub App이 해당 저장소에 설치되어 있는지 확인하세요.
동기화 작동 방식
저장소를 연결할 때 초기 동기화가 자동으로 실행됩니다. 그 후 조직 설정 > 플러그인에서 마켓플레이스의 "업데이트 확인"을 클릭하여 동기화를 수동으로 트리거할 수 있습니다.
동기화 중에 Cowork는 저장소의 최신 커밋을 마지막 동기화 커밋과 비교합니다. 변경사항이 없으면 동기화를 건너뜁니다. 변경사항이 있으면 Cowork는 매니페스트를 읽고 각 플러그인을 검증한 후 마켓플레이스의 모든 플러그인을 저장소의 현재 상태로 바꿉니다. 동기화는 플러그인 수에 따라 최대 30분이 걸릴 수 있습니다.
중요: 동기화가 실패하면 팀 멤버의 플러그인이 일시적으로 제거될 수 있습니다. 이 경우 실패 메시지를 확인하고 저장소의 문제를 해결한 후 업데이트를 푸시하고 동기화를 다시 트리거합니다. 동기화가 성공하면 설치 기본 설정이 여전히 올바르게 설정되어 있는지 확인하세요. 실패 중에 재설정되었을 수 있습니다.
플러그인 배포 제어
마켓플레이스에 플러그인이 있으면 설치 기본 설정을 사용하여 배포 방식을 제어합니다. 각 플러그인에 대해 다음 세 가지 옵션 중 하나를 설정할 수 있습니다:
기본 설정 | 수행 작업 | 멤버가 보는 것 |
자동 설치 | 모든 조직 멤버를 위해 자동으로 설치됨 | 플러그인이 아무 조치 없이 설치된 목록에 나타납니다. 멤버는 원하면 제거할 수 있습니다. |
사용 가능 | 플러그인 카탈로그에 나열됨 | 멤버는 플러그인을 검색할 때 이를 보고 직접 설치할 수 있습니다. |
사용 불가 | 카탈로그에서 완전히 숨겨짐 | 멤버는 플러그인을 보거나 설치할 수 없습니다. 플러그인을 준비하거나 중단할 때 유용합니다. |
기본 설정 지정
조직 설정 > 플러그인에서 마켓플레이스로 이동합니다.
각 플러그인의 설치 기본 설정을 선택합니다.
변경사항은 각 멤버의 다음 세션 또는 플러그인 새로고침 시 적용됩니다.
멤버 경험
멤버는 Cowork의 플러그인 검색 모달을 통해 사용 가능한 플러그인을 검색합니다. 자동 설치된 플러그인은 설치된 목록에 자동으로 나타납니다. 사용 가능한 플러그인은 셀프 서비스 설치를 위해 카탈로그에 표시됩니다.
멤버는 조직에서 관리하는 플러그인을 편집할 수 없으므로 공유 도구에 대한 충돌하는 변경사항을 방지합니다.
플러그인 업데이트 및 제거
수동 마켓플레이스
플러그인을 업데이트하려면 같은 플러그인 이름으로 새 ZIP 파일을 업로드합니다. 새 버전이 기존 버전을 자동으로 덮어씌웁니다. 플러그인 이름이 고유 식별자입니다. legal은 항상 legal을 바꿉니다.
플러그인을 제거하려면 조직 설정 > 플러그인에서 마켓플레이스에서 삭제합니다.
GitHub 동기화 마켓플레이스
변경사항을 연결된 저장소에 푸시한 후 조직 설정 > 플러그인으로 이동하여 마켓플레이스를 찾고 "업데이트 확인"을 클릭하여 동기화를 트리거합니다. 각 동기화는 모든 플러그인을 저장소의 현재 상태로 바꿉니다.
플러그인을 제거하려면 저장소에서 삭제하고 동기화를 트리거합니다.
제한
제한 | 값 | 참고 |
최대 플러그인 ZIP 크기(업로드) | 50MB | 클라이언트 측과 서버 측 모두에서 적용됨 |
마켓플레이스당 최대 플러그인(수동) | 100 | 마켓플레이스당 |
마켓플레이스당 최대 플러그인(GitHub 동기화) | 500 | 마켓플레이스당 |
최대 플러그인 이름 길이 | 64자 | 하이픈으로 구분된 소문자 단어를 사용해야 함 |
동기화 시간 초과 | 30분 | 동기화 작업당 |
GitHub 저장소 가시성 | 비공개 또는 내부만 | github.com에서 호스팅되어야 합니다. 공개 저장소 및 GitHub Enterprise Server 인스턴스는 지원되지 않습니다. |
명명 규칙
플러그인 이름은 하이픈으로 구분된 소문자 단어를 사용해야 합니다(예: deployment-tools, Deployment Tools 아님). 다음 마켓플레이스 이름은 예약되어 있으며 사용할 수 없습니다:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
공식 Anthropic 마켓플레이스를 사칭하는 이름도 차단됩니다.
수동 업로드와 GitHub 동기화 중 선택
시나리오 | 권장 방식 |
플러그인이 버전 제어 및 CI/CD로 유지됨 | GitHub 동기화 |
여러 개발자가 플러그인에서 협업 | GitHub 동기화 |
자동 업데이트 전파를 원함 | GitHub 동기화 |
마켓플레이스에 100개 이상의 플러그인이 필요 | GitHub 동기화 |
빠른 프로토타이핑 또는 일회성 도구 | 수동 업로드 |
비엔지니어링 팀에서 빌드한 플러그인 | 수동 업로드 |
GitHub 액세스가 없는 환경 | 수동 업로드 |
동기화된 저장소에 추가하기 전에 플러그인 테스트 | 수동 업로드 |
문제 해결
업로드 거부됨
일반적인 원인: 파일이 50MB를 초과하거나 유효한 ZIP 파일이 아니거나 마켓플레이스가 100개 플러그인 제한에 도달했습니다. 파일 크기와 형식을 확인하고 용량에 도달한 경우 사용하지 않는 플러그인을 제거합니다.
플러그인이 멤버에게 나타나지 않음
마켓플레이스 설정에서 플러그인의 설치 기본 설정을 확인합니다. 사용 불가로 설정되어 있으면 멤버가 이를 볼 수 없습니다. 또한 조직에서 Cowork와 Skills가 모두 활성화되어 있는지 확인합니다.
업데이트된 플러그인이 멤버에게 반영되지 않음
변경사항은 각 멤버의 다음 세션 또는 플러그인 새로고침 시 적용됩니다. 업데이트가 여전히 표시되지 않으면 마켓플레이스에서 플러그인 버전을 확인하여 업로드가 성공했는지 확인합니다.
GitHub 동기화가 콘텐츠 오류로 실패함
저장소의 하나 이상의 플러그인이 형식이 잘못되었을 가능성이 높습니다. 형식 문제를 해결하고 GitHub에 업데이트를 푸시한 후 동기화를 다시 트리거합니다. 플러그인 구조 요구사항은 플러그인 참조 문서를 참조하세요.
실패한 동기화 후 플러그인이 사라짐
실패한 GitHub 동기화는 마켓플레이스에서 플러그인을 일시적으로 제거할 수 있습니다. 기본 문제를 해결하고 동기화를 다시 성공한 후 설치 기본 설정이 올바르게 설정되어 있는지 확인합니다. 재설정되었을 수 있습니다.
연결할 때 GitHub 저장소가 보이지 않음
Cowork GitHub App이 해당 저장소에 설치되어 있는지 확인합니다. 개인 GitHub 토큰이 먼저 확인되어 액세스를 확인하지만 동기화 자체는 GitHub App 설치 토큰을 사용합니다.