조직을 위한 Claude Cowork 플러그인 관리

플러그인 마켓플레이스를 통해 Team 및 Enterprise 플랜 소유자는 Claude Cowork을 통해 조직의 모든 사람에게 선별된 플러그인을 배포할 수 있습니다. 마켓플레이스를 만들고, 플러그인을 추가하고, 팀 멤버가 볼 수 있고 사용할 수 있는 플러그인을 정확히 제어합니다.

요구사항: 플러그인 마켓플레이스를 사용하기 전에 조직에서 Cowork과 Skills를 모두 활성화해야 합니다.

마켓플레이스에 플러그인을 추가하는 두 가지 방법이 있습니다:

두 가지 방식을 병렬로 사용할 수 있습니다. 예를 들어, 핵심 플러그인용 GitHub 동기화 마켓플레이스와 임시 도구용 별도의 수동 마켓플레이스를 사용할 수 있습니다.

기존 플러그인과 같은 이름의 플러그인을 업로드하면 이전 버전이 자동으로 덮어씌워집니다. 먼저 이전 버전을 삭제할 필요가 없습니다.

GitHub 동기화를 통해 저장소에서 코드로 플러그인을 관리할 수 있습니다. 변경 사항을 푸시할 때 동기화를 트리거하여 마켓플레이스를 업데이트할 수 있습니다. 수동 또는 자동으로 업데이트할 수 있습니다.

저장소는 비공개 또는 내부여야 합니다. 공개 저장소는 조직 마켓플레이스에 허용되지 않습니다. 사용자 정의 GitHub Enterprise Server 인스턴스에서 호스팅되는 저장소는 지원되지 않습니다. 저장소는 github.com에서 호스팅되어야 합니다.

GitHub 동기화 마켓플레이스는 Claude Code CLI보다 marketplace.json에서 더 좁은 범위의 source 유형을 지원합니다. 연결된 저장소 내의 플러그인 폴더에 대한 상대 경로(예: "source": "./plugins/my-plugin")는 완전히 지원됩니다. github, url 및 git-subdir 소스 유형은 대상 저장소가 공개일 때만 지원됩니다. npm 및 pip 소스 유형은 지원되지 않습니다. 플러그인 코드가 별도의 비공개 저장소에 있는 경우 해당 플러그인 폴더를 마켓플레이스 저장소에 복사하고(git 서브모듈, git 서브트리 또는 CI 단계가 잘 작동함) 상대 경로로 참조합니다.

플러그인 구조 및 형식에 대한 자세한 내용은 플러그인 참조 문서를 참조하세요.

추가 리소스:

개인 GitHub 토큰이 확인되어 액세스 권한이 있는지 확인한 후 Cowork이 동기화 작업을 위해 GitHub App 설치 토큰을 사용합니다.

저장소가 보이지 않나요? Claude GitHub App이 해당 저장소에 설치되어 있는지 확인합니다.

저장소를 연결할 때 초기 동기화가 자동으로 실행됩니다. 그 후 조직 소유자는 조직 설정 > 플러그인으로 이동하여 마켓플레이스의 오른쪽 위 모서리에 있는 메뉴 버튼을 클릭한 후 "자동 동기화" 토글을 켜서 마켓플레이스별로 계속 자동 업데이트를 선택할 수 있습니다(라이브러리 아래):

그러면 GitHub 마켓플레이스는 PR이 해당 저장소에 병합될 때마다 자동으로 동기화됩니다. 마켓플레이스에서 "업데이트"를 클릭하여 동기화를 수동으로 트리거할 수도 있습니다.

동기화 중에 Cowork은 저장소의 최신 커밋을 마지막 동기화된 커밋과 비교합니다. 변경 사항이 없으면 동기화를 건너뜁니다. 변경 사항이 있으면 Cowork이 매니페스트를 읽고 각 플러그인을 검증한 후 마켓플레이스의 모든 플러그인을 저장소의 현재 상태로 바꿉니다. 동기화는 플러그인 수에 따라 최대 30분이 걸릴 수 있습니다.

마켓플레이스에 플러그인이 있으면 설치 기본 설정을 사용하여 배포 방식을 제어합니다. 각 플러그인에 대해 4가지 옵션 중 하나를 설정할 수 있습니다:

구성원은 Cowork의 플러그인 검색 모달을 통해 사용 가능한 플러그인을 검색합니다. 자동 설치된 플러그인은 설치된 목록에 자동으로 나타납니다. 사용 가능한 플러그인은 셀프 서비스 설치를 위해 카탈로그에 표시됩니다.

구성원은 조직에서 관리하는 플러그인을 편집할 수 없으므로 공유 도구에 대한 충돌하는 변경을 방지합니다.

엔터프라이즈 관리자는 특정 그룹에 대해 플러그인의 조직 전체 설치 기본 설정을 재정의할 수 있습니다. 예를 들어 Engineering 그룹에 플러그인을 자동 설치하고, Legal이 자신의 설치를 위해 사용 가능하게 하며, 다른 모든 사람에게는 숨길 수 있습니다.

마켓플레이스의 각 플러그인에는 조직 전체 설치 기본 설정(기본적으로 설치됨, 설치 가능, 필수 또는 사용 불가)이 있습니다. 기본적으로 모든 그룹은 조직 전체 설정을 상속합니다.

플러그인에 대해 그룹 수준 재정의를 설정하면 해당 그룹의 구성원에 대해 조직 전체 설정을 대체합니다. 해결 순서는 다음과 같습니다: 그룹 설정, 조직 전체 설정, 마켓플레이스 기본값.

수동으로 생성된 그룹과 ID 공급자의 SCIM 프로비저닝된 그룹이 모두 그룹 선택기에 나타나며 동일한 방식으로 작동합니다.

구성원이 동일한 플러그인에 대해 다른 설정을 가진 2개 이상의 그룹에 속하는 경우 가장 허용적인 설정이 적용됩니다. 가장 허용적인 것부터 가장 제한적인 것까지의 순서는 다음과 같습니다: 필수 > 기본적으로 설치됨 > 설치 가능 > 사용 불가.

예를 들어 그룹 A가 플러그인을 "사용 불가"로 설정하고 그룹 B가 "기본적으로 설치됨"으로 설정하면 두 그룹에 속한 구성원은 기본적으로 플러그인이 설치됩니다.

그룹이 제거되면(예: ID 공급자에서 삭제된 경우) 재정의는 관리자 UI에 남아 있지만 고아로 표시됩니다. 삭제된 그룹에 속한 사람이 없으므로 구성원에게 영향을 주지 않으며 사용자 정의 액세스 배지에 포함되지 않습니다. 플러그인의 사용자 정의 액세스 설정에서 고아 재정의를 지울 수 있습니다.

예. GitHub 연결 마켓플레이스를 재동기화할 때 그룹 수준 재정의가 유지됩니다. 플러그인 자체가 마켓플레이스에서 삭제된 경우에만 제거됩니다.

플러그인을 업데이트하려면 동일한 플러그인 이름으로 새 ZIP 파일을 업로드합니다. 새 버전이 기존 버전을 자동으로 덮어씁니다. 플러그인 이름은 고유 식별자입니다. legal은 항상 legal을 대체합니다.

조직 설정 > 플러그인에서 마켓플레이스에서 플러그인을 삭제하여 제거합니다.

변경 사항을 연결된 저장소에 푸시한 다음 조직 설정 > 플러그인으로 이동하여 마켓플레이스를 찾고 "업데이트"를 클릭하여 동기화를 트리거합니다. 각 동기화는 모든 플러그인을 저장소의 현재 상태로 대체합니다. 소유자가 GitHub 동기화 마켓플레이스에 대해 "자동 동기화"를 활성화한 경우 저장소에 변경 사항을 푸시한 후 자동으로 발생합니다.

플러그인을 제거하려면 저장소에서 삭제하고 동기화를 트리거합니다.

플러그인 이름은 소문자 단어를 하이픈으로 구분하여 사용해야 합니다(예: deployment-tools, Deployment Tools 아님). 다음 마켓플레이스 이름은 예약되어 있으며 사용할 수 없습니다:

공식 Anthropic 마켓플레이스를 사칭하는 이름도 차단됩니다.

일반적인 원인: 파일이 50 MB를 초과하거나, 유효한 ZIP 파일이 아니거나, 마켓플레이스가 100개 플러그인 제한에 도달했습니다. 파일 크기와 형식을 확인하고, 용량이 가득 찬 경우 사용하지 않는 플러그인을 제거하세요.

마켓플레이스 설정에서 플러그인의 설치 기본 설정을 확인하세요. 사용 불가로 설정되어 있으면 멤버가 볼 수 없습니다. 또한 조직에서 Cowork와 Skills가 모두 활성화되어 있는지 확인하세요.

변경 사항은 각 멤버의 다음 세션 또는 플러그인 새로고침 시 적용됩니다. 업데이트가 여전히 표시되지 않으면 마켓플레이스에서 플러그인 버전을 확인하여 업로드가 성공했는지 확인하세요.

저장소의 하나 이상의 플러그인 형식이 잘못되었을 가능성이 있습니다. 형식 문제를 수정하고 업데이트를 GitHub에 푸시한 후 동기화를 다시 트리거하세요. 플러그인 구조 요구 사항은 플러그인 참조 문서를 참조하세요.

marketplace.json의 하나 이상의 플러그인 항목이 연결된 저장소 외부를 가리키는 source(github, url 또는 git-subdir 소스)를 사용하고 있으며, 대상 저장소가 비공개입니다. 조직 동기화는 현재 공개 저장소에서만 외부 소스를 가져올 수 있습니다. 플러그인 폴더를 마켓플레이스 저장소로 이동하고 각 항목의 source를 상대 경로(예: "./plugins/my-plugin")로 변경한 후 푸시하고 다시 동기화하세요. 또는 사용자 지정 > 플러그인 추가 > 플러그인 만들기 > 플러그인 업로드를 통해 영향을 받는 플러그인을 개별적으로 업로드하세요.

실패한 GitHub 동기화로 인해 마켓플레이스에서 플러그인이 일시적으로 제거될 수 있습니다. 기본 문제를 해결하고 동기화를 다시 성공적으로 수행한 후 설치 기본 설정이 올바르게 설정되어 있는지 확인하세요. 기본 설정이 재설정되었을 수 있습니다.

Cowork GitHub 앱이 해당 저장소에 설치되어 있는지 확인하세요. 개인 GitHub 토큰이 먼저 확인되어 액세스를 확인하지만, 동기화 자체는 GitHub 앱 설치 토큰을 사용합니다.