조직의 플러그인 관리

플러그인 마켓플레이스를 통해 Team 및 Enterprise 플랜 소유자는 조직의 모든 사용자에게 선별된 플러그인을 배포할 수 있습니다. 마켓플레이스를 만들고, 플러그인을 추가하고, 팀 멤버가 볼 수 있고 사용할 수 있는 플러그인을 정확히 제어합니다. 배포하는 플러그인은 채팅(웹 및 Claude Desktop의 Chat 탭), Claude Cowork, 그리고 같은 Claude 계정으로 로그인한 멤버들의 Claude Code 세션에 나타납니다.

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

이러한 제어 기능의 참조 버전은 Claude Code 문서의 조직의 플러그인 관리를 참조하세요.

"인벤토리" 탭에는 사용자가 자신을 위해 만든 것들을 포함하여 조직이 관리하는 모든 스킬과 플러그인이 나열됩니다. 스킬과 플러그인이 이제 같은 페이지에 있으므로 설정 간에 전환할 필요가 없습니다.

각 항목에 대해 표는 소스, 버전, 기능, 대상 사용자, 그리고 지난 30일 동안 사용한 사람의 수를 표시합니다.

항목을 찾으려면 이름으로 검색하거나 필터를 사용하세요:

조직이 관리하는 스킬은 조직 라이브러리 아래에 나타납니다. 플러그인 마켓플레이스는 마켓플레이스 탭에서 관리합니다.

항목에 대해 조치를 취하려면 행 끝의 메뉴 버튼을 클릭하세요. 세부 정보와 파일을 보고, 버전 기록을 확인하고, 기본 및 그룹 액세스를 변경할 수 있습니다.

사용자가 만든 스킬과 플러그인의 경우 인벤토리 탭에는 메타데이터와 공유 상태가 표시됩니다. 파일 자체는 표시되지 않습니다.

Anthropic은 법률 및 금융과 같은 다양한 기능을 위한 기본 제공 플러그인 마켓플레이스를 제공합니다. Knowledge Work 마켓플레이스는 기본적으로 조직에 추가됩니다.

Anthropic 제공 마켓플레이스를 추가하려면:

Knowledge Work 마켓플레이스가 팀과 관련이 없으면 제거하려면:

Anthropic 제공 마켓플레이스는 기본 저장소 슬러그 대신 "Knowledge Work"와 같은 읽기 쉬운 이름을 표시합니다.

Anthropic 제공 마켓플레이스 외에도 자신의 마켓플레이스를 만들 수 있습니다. 만든 마켓플레이스에 플러그인을 추가하는 두 가지 방법이 있습니다:

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

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

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

저장소 준비

github.com에서 호스팅되거나 조직의 GitHub Enterprise 호스트에서 호스팅되는 저장소를 연결할 수 있습니다. github.com에서 저장소는 비공개 또는 내부여야 합니다. 공개 저장소는 조직 마켓플레이스에 허용되지 않습니다. GitLab에서 동기화하려면 GitLab 동기화 마켓플레이스 설정을 참조하세요.

GitHub 동기화 마켓플레이스는 Claude Code보다 marketplace.json에서 더 좁은 범위의 source 유형을 지원합니다. 마켓플레이스 저장소 내 플러그인 폴더로의 상대 경로(예: "source": "./plugins/my-plugin")는 완전히 지원되며 가장 간단한 옵션입니다. github, url, git-subdir 소스 유형도 지원됩니다. npm, archive, command 소스 유형은 지원되지 않습니다.

플러그인 소스는 세 가지 경우에 비공개일 수 있습니다:

다른 모든 소스는 자격 증명 없이 가져오므로 github.com, gitlab.com 또는 bitbucket.org의 공개 저장소여야 합니다. 다른 호스트의 소스는 거부됩니다.

플러그인 코드가 위의 기준을 충족하지 않는 비공개 저장소에 있는 경우, 해당 플러그인 폴더를 마켓플레이스 저장소에 복사하고 각 플러그인의 소스를 상대 경로로 변경합니다(git subtree 또는 파일을 벤더링하는 CI 단계가 잘 작동합니다).

플러그인 구조 및 형식에 대한 자세한 내용은 플러그인 매니페스트 참조를 참조하세요.

추가 리소스:

저장소 연결

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

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

동기화 작동 방식

저장소를 연결할 때 초기 동기화가 자동으로 실행됩니다. GitHub 생성 흐름에서 기본적으로 켜져 있는 "자동으로 동기화"를 끌 수도 있습니다. 이 옵션이 켜져 있으면 마켓플레이스가 따르는 분기에 풀 요청이 병합되거나 누군가 해당 분기에 직접 푸시할 때 동기화가 실행됩니다.

자동 동기화를 켜거나 끄는 사람은 GitHub의 해당 저장소에 대한 관리자 수준의 액세스 권한이 있어야 합니다. 이는 Claude GitHub App 설치와 별개인 개인 GitHub 연결을 통해 확인됩니다. 관리자 액세스 권한이 없으면 App이 올바르게 설치되어 있고 수동 업데이트가 작동하더라도 페이지에 "저장소에 액세스할 수 없습니다. 저장소가 존재하고 Claude GitHub App이 설치되어 있는지 확인하세요"라고 표시됩니다.

Claude GitHub App의 웹훅(읽기 및 쓰기) 권한도 설치에서 승인되어야 합니다. 이 권한이 도입되기 전에 생성된 설치의 경우 GitHub에 저장소 또는 조직 관리자가 승인해야 하는 "Claude가 업데이트된 권한을 요청 중입니다" 프롬프트가 표시됩니다.

활성화되면 GitHub 저장소의 자동 동기화는 플러그인 버전 범프를 포함하는 풀 요청이 저장소의 기본 분기에 병합될 때 실행됩니다. 기본 분기에 직접 푸시하면 동기화가 트리거되지 않습니다. 마켓플레이스에서 "다시 동기화"를 클릭하여 언제든지 동기화를 수동으로 트리거할 수 있습니다.

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

gitlab.com의 저장소 또는 자체 관리 GitLab 인스턴스에서 조직 마켓플레이스를 동기화할 수 있습니다. 지원되는 플러그인 소스 유형 및 비공개 소스가 될 수 있는 소스에 대해서는 위의 저장소 준비를 참조하세요.

시작하기 전에

1단계: GitLab 구성 추가

GitLab 구성을 추가하려면:

구성의 메뉴에서 연결 테스트를 사용하여 언제든지 테스트를 다시 실행할 수 있습니다. 호스트명은 나중에 변경할 수 없습니다. 변경되면 구성을 삭제하고 새 구성을 추가합니다.

2단계: 마켓플레이스 추가

마켓플레이스를 추가하려면:

Claude는 프로젝트의 기본 분기를 읽고 마켓플레이스 파일을 검증한 후 프로젝트 경로를 따라 명명된 마켓플레이스를 만듭니다.

3단계: 자동 동기화

자동 동기화가 켜져 있으면 프로젝트의 기본 분기에 대한 모든 푸시가 GitLab 프로젝트의 웹훅을 통해 동기화를 트리거합니다. 토큰이 웹훅을 관리할 수 있으면(시작하기 전에 참조) Claude가 웹훅을 만들고 추가 작업은 필요하지 않습니다.

나중에 마켓플레이스의 메뉴에서 자동 동기화를 켜거나 끌 수 있습니다. 켜면 같은 방식으로 웹훅이 설정됩니다.

4단계: Claude가 웹훅을 만들 수 없는 경우

토큰이 웹훅을 관리할 수 없으면 Claude는 화면에 GitLab에서 웹훅 설정 완료 메시지를 표시하고 웹훅 URL과 토큰을 제공합니다. 토큰은 한 번만 표시되므로 메시지를 닫기 전에 이 단계를 완료하세요.

토큰을 잃어버린 경우 마켓플레이스의 메뉴에서 웹훅 구성을 열고 "웹훅 제거"를 클릭한 다음 "웹훅 활성화"를 클릭하여 새 토큰을 받습니다. 이전 토큰은 작동하지 않습니다.

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

구성원은 사용자 정의 > 플러그인의 검색 탭에서 사용 가능한 플러그인을 찾아봅니다. "기본값으로 설치됨" 또는 "필수"로 설정한 플러그인은 자동으로 목록에 나타납니다. "설치 가능"으로 설정한 플러그인은 구성원이 직접 추가할 수 있도록 검색에 표시됩니다.

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

엔터프라이즈 관리자는 특정 그룹에 대해 플러그인의 조직 전체 설치 기본 설정을 재정의할 수 있습니다. 예를 들어 엔지니어링 그룹에 대해 플러그인을 자동 설치하고, 법무팀이 직접 설치할 수 있도록 하며, 다른 모든 사람에게는 숨길 수 있습니다.

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

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

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

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

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

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

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

소유자 또는 주 소유자는 허용 목록, 차단 목록 또는 둘 다를 사용하여 조직의 사람들이 추가할 수 있는 플러그인 마켓플레이스를 제한할 수 있습니다. 이러한 목록은 Claude Code 관리 설정에서 설정하지만 Claude 및 Claude Cowork에도 적용됩니다.

허용 목록 또는 차단 목록을 설정하려면:

GitHub 조직 이름을 GitHub에 표시되는 대로 정확히 입력하세요. 허용 목록 일치는 대소문자를 구분합니다. 소스가 두 목록에 모두 있으면 차단됩니다.

목록이 설정되면 Claude는 조직의 누군가가 Claude, Claude Desktop 또는 Cowork의 Git 저장소에서 마켓플레이스를 추가할 때마다 목록을 확인합니다. 여기에는 사용자가 사용자 정의에서 자신을 위해 추가하는 마켓플레이스와 조직 설정 > 플러그인 및 스킬에서 전체 조직을 위해 추가하는 마켓플레이스가 포함됩니다. Claude는 목록이 허용하지 않는 모든 저장소를 거부합니다. Anthropic 구축 마켓플레이스는 제외됩니다.

다음을 염두에 두세요:

목록이 허용하는 모든 소스 유형에 대해 Claude Code 문서의 사용자가 설치할 수 있는 항목 제한을 참조하세요.

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

플러그인을 제거하려면 조직 설정 > 플러그인 및 스킬에서 "인벤토리" 탭 아래에서 삭제하세요.

변경 사항을 연결된 저장소에 푸시한 다음 조직 설정 > 플러그인 및 스킬로 이동하여 "마켓플레이스" 탭을 클릭하고 마켓플레이스를 찾은 후 "업데이트"를 클릭하여 동기화를 트리거하세요. 각 동기화는 모든 플러그인을 저장소의 현재 상태로 대체합니다. 소유자가 마켓플레이스에 대해 "자동 동기화"를 활성화한 경우, 플러그인 버전 범프가 있는 풀 요청이 저장소의 기본 분기에 병합될 때마다 동기화도 실행됩니다.

GitLab 동기화 마켓플레이스의 경우 GitLab 동기화 마켓플레이스 설정을 참조하세요.

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

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

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

일반적인 원인: 파일이 200 MB를 초과하거나, 유효한 ZIP 파일이 아니거나, 마켓플레이스가 1000개 플러그인 제한에 도달했습니다. 파일 크기와 형식을 확인하고 용량에 도달한 경우 사용하지 않는 플러그인을 제거하세요. 스킬 및 플러그인 스캔이 켜져 있으면 플러그인이 악성 콘텐츠로 플래그되어 거부될 수도 있습니다. 이유를 검토하고 문제를 해결한 후 플러그인을 다시 업로드하세요.

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

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

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

marketplace.json의 하나 이상의 플러그인 항목이 연결된 저장소 외부를 가리키는 source를 사용하고 있으며(github, url 또는 git-subdir 소스), 조직 동기화가 이를 가져올 수 없습니다. 비공개 소스는 세 가지 경우에만 작동합니다: github.com 저장소가 마켓플레이스 저장소의 소유자를 공유하거나, 조직의 GitHub Enterprise 호스트의 저장소에 GitHub Enterprise 앱이 설치되어 있거나, 마켓플레이스 저장소와 동일한 GitLab 호스트의 url 또는 git-subdir 소스(gitlab.com에서는 동일한 최상위 그룹 또는 사용자 네임스페이스 아래)입니다.

다른 개인 소스의 경우, 플러그인 폴더를 마켓플레이스 저장소로 이동하고 각 항목의 source를 상대 경로로 변경한 후(예: "./plugins/my-plugin"), 푸시하고 다시 동기화합니다. 또는 조직 설정 > 플러그인 및 기술을 통해 영향을 받는 플러그인을 개별적으로 업로드합니다. "추가"를 클릭하고 "플러그인 업로드"를 선택한 후 "기존 마켓플레이스에 추가"를 선택합니다. 멤버의 자신의 사용자 정의 메뉴를 통해 업로드된 플러그인은 해당 멤버에게만 설치되며 조직에 배포되지 않습니다. 다만 공유가 활성화된 경우 멤버는 특정 동료 또는 그룹과 플러그인을 공유할 수 있습니다.

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

수동 업데이트는 작동하지만 "자동 동기화"를 켜면 "저장소에 액세스할 수 없습니다. 저장소가 존재하고 Claude GitHub 앱이 설치되어 있는지 확인하세요"라고 표시되면 두 가지 가능한 원인이 있습니다:

GitLab에서 마켓플레이스를 추가할 때 이 메시지가 표시되면 먼저 GitLab 구성을 추가했는지 확인하세요. GitLab 동기화 마켓플레이스 설정의 1단계: GitLab 구성 추가를 참조하세요.

URL의 호스트명이 구성된 GitLab 호스트명과 정확히 일치하는지 확인하세요.

프로젝트의 가시성이 비공개 또는 내부인지 확인하세요. 공개 gitlab.com 프로젝트는 조직 마켓플레이스로 사용할 수 없습니다.

인스턴스가 공개 인터넷을 통해 HTTPS로 도달 가능한지, Anthropic의 아웃바운드 IP 주소가 방화벽을 통과할 수 있는지 확인하세요. "보안 연결을 설정할 수 없음"은 일반적으로 CA 인증서가 누락되었거나 잘못되었음을 의미합니다.

토큰이 만료되었거나 취소되었거나 GitLab 동기화 마켓플레이스 설정의 시작하기 전에 섹션에 나열된 범위 또는 역할이 누락되었습니다. 새 토큰을 만들고 구성에 붙여넣으세요(편집 > 액세스 토큰).