조직용 Claude 플러그인 배포 관리

플러그인 마켓플레이스를 사용하면 Team 및 Enterprise 요금제의 소유자가 엄선한 플러그인을 조직 전체에 배포할 수 있습니다. 마켓플레이스를 만들고 플러그인을 추가한 뒤, 팀원이 어떤 플러그인을 보고 쓸 수 있는지 정확하게 제어합니다. 배포한 플러그인은 채팅(웹과 Claude Desktop의 Chat 탭), Claude Cowork, 그리고 멤버가 같은 Claude 계정으로 로그인한 Claude Code 세션에 나타납니다.

Team 및 Enterprise 요금제의 Owner와 Primary Owner는 Organization settings > Plugins & skills 에서 조직 플러그인을 관리할 수 있습니다. Enterprise 요금제에서는 조직 라이브러리 관리 권한이 포함된 사용자 지정 역할을 가진 멤버도 관리할 수 있습니다.

요구 사항: 플러그인 마켓플레이스를 사용하려면 먼저 조직에서 Cowork와 Skills가 모두 켜져 있어야 합니다.

이 제어 기능의 참조용 문서는 Claude Code 문서의 Manage plugins for your organization 을 참고하세요.

참고: 조직에서 Skills를 끄면 스킬과 플러그인이 Claude Code로 동기화되지 않고, 이미 동기화된 항목도 Claude Code에서 제거됩니다. Cowork를 끄는 것은 Claude Code 동기화에 영향을 주지 않습니다. Claude에는 스킬과 플러그인을 그대로 두고 동기화만 멈추려면 Claude Code 관리형 설정에서 syncClaudeAiSkills 와 syncClaudeAiPlugins 를 false 로 설정하세요. 자세한 내용은 Claude Code 관리자 설정 을 참고하세요.

참고: 마켓플레이스는 소유자가 조직에 플러그인을 배포하는 수단입니다. 사용자도 직접 만든 플러그인을 특정 동료나 그룹과 공유하거나, 조직 라이브러리에 게시해 달라고 제출할 수 있습니다. 공유와 게시는 Organization settings > Plugins & skills 의 “Policy” 탭 설정으로 제어하며, 플러그인 제출은 같은 곳의 "Requests" 탭에서 검토합니다. 자세한 내용은 Claude에서 플러그인 사용하기 와 사용자가 조직에 스킬과 플러그인을 게시하도록 허용하기 . 를 참고하세요.

조직에 있는 항목 확인하기

“Inventory” 탭에는 조직이 관리하는 모든 스킬과 플러그인이 나열되며, 사용자가 자신을 위해 만든 항목도 포함됩니다. 이제 스킬과 플러그인이 같은 페이지에 있으므로 설정 사이를 오갈 필요가 없습니다.

표에는 각 항목의 출처, 버전, 기능, 대상, 최근 30일 동안 사용한 사람 수가 표시됩니다.

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

• Source: 조직(Your organization), 조직 라이브러리(Organization library), 또는 특정 마켓플레이스
• Audience: 항목을 사용할 수 있는 사람
• Type: 스킬 또는 플러그인

조직이 관리하는 스킬은 Organization library 아래에 표시됩니다. 플러그인 마켓플레이스는 Marketplaces 탭에서 관리합니다.

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

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

Anthropic이 만든 마켓플레이스 사용하기

Anthropic은 법무, 재무 등 직무별 플러그인을 모은 기본 제공 마켓플레이스를 제공합니다. Knowledge Work 마켓플레이스는 기본적으로 조직에 추가되어 있습니다.

Anthropic이 만든 마켓플레이스를 추가하려면 다음과 같이 합니다.

1. Organization settings > Plugins & skills 로 이동해 “Marketplaces” 탭을 클릭합니다.
2. “Add”를 클릭한 다음 “Add marketplace”를 선택합니다.
3. "Browse Anthropic sources"를 선택합니다.
4. 조직의 모든 사람에게 표시할 마켓플레이스마다 "Add"를 클릭합니다.

Knowledge Work 마켓플레이스가 팀과 관련이 없어 제거하려면 다음과 같이 합니다.

1. Organization settings > Plugins & skills 로 이동해 “Marketplaces” 탭을 클릭합니다.
2. Knowledge Work 를 찾습니다.
3. 오른쪽 위의 메뉴 버튼을 클릭합니다.
4. "Remove"를 선택합니다.

Anthropic이 만든 마켓플레이스는 내부 저장소 슬러그 대신 "Knowledge Work"처럼 읽기 쉬운 이름으로 표시됩니다.

직접 마켓플레이스 만들기

Anthropic이 만든 마켓플레이스 외에 직접 마켓플레이스를 만들 수도 있습니다. 직접 만든 마켓플레이스에 플러그인을 추가하는 방법은 두 가지입니다.

• 수동 업로드: 관리자 UI에서 플러그인 ZIP 파일을 하나씩 업로드합니다. 빠른 반복 작업, 일회성 도구, 또는 플러그인을 Git 저장소에 보관하지 않는 팀에 가장 적합합니다.
• 저장소 동기화: 비공개 GitHub 또는 GitLab 저장소를 연결하면 Claude가 그 저장소에서 플러그인을 동기화합니다. 여러 개발자가 함께 플러그인을 만들거나 버전 관리되는 업데이트가 필요할 때 가장 적합합니다.

두 방식을 함께 쓸 수도 있습니다. 예를 들어 핵심 플러그인은 GitHub 동기화 마켓플레이스로 운영하고, 임시 도구는 별도의 수동 마켓플레이스로 운영할 수 있습니다.

수동 마켓플레이스 설정하기

1. Organization settings > Plugins & skills 로 이동합니다.
2. “Add”를 클릭한 다음 “Upload a plugin”을 선택합니다.
3. 마켓플레이스를 처음 설정하는 경우 "Upload to a new marketplace"가 자동으로 선택됩니다. 나중에 플러그인을 업로드할 때는 "Add to an existing marketplace"를 선택할 수 있습니다.
4. 마켓플레이스 이름을 입력합니다.
5. 파일을 끌어다 놓거나, 업로드 안내 영역을 클릭해 파일을 선택합니다. 파일은 200MB 미만의 올바른 .zip 파일이어야 합니다.
6. 추가할 플러그인마다 이 과정을 반복합니다.
7. "Upload"를 클릭해 새 마켓플레이스에 플러그인을 추가합니다.

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

GitHub 동기화 마켓플레이스 설정하기

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

저장소 준비하기

github.com 또는 조직의 GitHub Enterprise 호스트에 있는 저장소를 연결할 수 있습니다. github.com에서는 저장소가 비공개(private) 또는 내부(internal) 여야 하며, 공개 저장소는 조직 마켓플레이스로 쓸 수 없습니다. GitLab에서 동기화하려면 GitLab 동기화 마켓플레이스 설정하기 를 참고하세요.

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

플러그인 소스가 비공개여도 되는 경우는 세 가지입니다.

• 마켓플레이스 저장소와 소유자가 같은 github.com 소스. 조직 동기화가 Claude GitHub App을 통해 가져옵니다.
• 조직의 GitHub Enterprise 호스트에 있고, 해당 저장소에 조직의 GitHub Enterprise App이 설치된 소스.
• 마켓플레이스 저장소와 같은 GitLab 호스트에 있는 url 또는 git-subdir 소스. gitlab.com에서는 소스가 마켓플레이스 저장소와 같은 최상위 그룹 또는 사용자 네임스페이스 아래에 있어야 합니다.

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

플러그인 코드가 위 조건에 맞지 않는 비공개 저장소에 있다면, 해당 플러그인 폴더를 마켓플레이스 저장소로 복사하고 각 플러그인의 source를 상대 경로로 바꾸세요(git subtree나 파일을 가져오는 CI 단계를 쓰면 편합니다).

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

추가 자료:

• 마켓플레이스 만들기
• 플러그인 만들기
• 새 GitHub 저장소 만들기

저장소 연결하기

1. 조직에서 Cowork와 Skills가 모두 켜져 있는지 확인합니다. Cowork 켜기
2. Skills 켜기

• Organization settings > Plugins & skills 로 이동해 “Marketplaces” 탭을 클릭합니다.
• “Add plugins”를 클릭한 다음 “Sync from GitHub”를 선택합니다.
• 저장소를 owner/repo 형식으로 입력합니다(예: acme-corp/claude-plugins).

먼저 개인 GitHub 토큰으로 접근 권한이 있는지 확인한 뒤, Cowork는 동기화 작업에 GitHub App 설치 토큰을 사용합니다.

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

동기화 방식

저장소를 연결하면 첫 동기화가 자동으로 실행됩니다. GitHub 생성 흐름에서는 기본으로 켜져 있는 "Sync automatically"를 끌 수도 있습니다. 이 옵션이 켜져 있으면 마켓플레이스가 따르는 브랜치에 풀 리퀘스트가 병합되거나 누군가 그 브랜치에 직접 푸시할 때 동기화가 실행됩니다.

자동 동기화를 켜거나 끄는 사람은 GitHub에서 해당 저장소의 관리자 수준 권한이 있어야 합니다. 이 권한은 Claude GitHub App 설치와는 별개인 개인 GitHub 연결로 확인합니다. 관리자 권한이 없으면 App이 제대로 설치되어 있고 수동 업데이트가 잘 되더라도 페이지에 "Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed"가 표시됩니다.

Claude GitHub App 설치에서 Webhooks (Read & Write) 권한도 승인되어 있어야 합니다. 이 권한이 도입되기 전에 만든 설치에서는 GitHub에 "Claude is requesting updated permissions" 안내가 표시되며, 저장소 또는 조직 관리자가 이를 승인해야 합니다.

활성화하고 나면 GitHub 저장소의 자동 동기화는 플러그인 버전을 올린 풀 리퀘스트가 저장소의 기본 브랜치에 병합될 때 실행됩니다. 기본 브랜치에 직접 푸시하는 것으로는 동기화가 실행되지 않습니다. 마켓플레이스에서 "Re-sync"를 클릭하면 언제든지 수동으로 동기화할 수 있습니다.

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

중요: 동기화가 실패하면 멤버는 각 플러그인의 마지막 동기화 버전을 계속 사용합니다. 실패 메시지를 확인하고 저장소를 고친 뒤 다시 동기화하세요.

GitLab 동기화 마켓플레이스 설정하기

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

GitLab 지원은 베타이며 플러그인 마켓플레이스 동기화에만 적용됩니다. 웹의 Claude Code는 아직 GitLab 저장소를 지원하지 않습니다.

시작하기 전에

• 역할. GitLab 구성을 추가하려면 Owner 또는 Primary Owner 역할이 필요합니다.
• 프로젝트 공개 범위. gitlab.com에서는 마켓플레이스 프로젝트가 비공개 또는 내부여야 합니다. 자체 관리형 인스턴스에서는 공개 범위와 관계없이 사용할 수 있습니다.
• 액세스 토큰. Claude가 마켓플레이스 프로젝트와 같은 호스트의 플러그인 소스 프로젝트를 읽을 수 있도록 GitLab 액세스 토큰을 만드세요. 개인, 그룹, 프로젝트 액세스 토큰 모두 사용할 수 있습니다. 토큰의 사용자는 해당 프로젝트에서 최소 Reporter 역할이 있어야 합니다. 레거시(범위 지정) 토큰: 최소 read_api 범위.
• 세분화된 개인 액세스 토큰: Project: Read, Branch: Read, Repository: Read 권한.
• 선택 사항, 웹훅 자동 설정용(3단계): 마켓플레이스 프로젝트의 Maintainer 역할과 api 범위(레거시) 또는 Webhook: Create and Delete 권한(세분화). 이 권한이 없으면 웹훅을 한 번 직접 추가해야 합니다(4단계).

• 자체 관리형 인스턴스만 해당. - 인스턴스의 호스트 이름이 공개 IP 주소로 확인되어야 하고, 인스턴스가 Anthropic의 아웃바운드 IP 주소 에서 오는 HTTPS 연결을 받아들여야 합니다. - 비공개 인증 기관(CA)이 TLS 인증서를 발급했다면 CA 인증서(PEM)를 준비해 두세요. - 자동 동기화용 웹훅 전송은 인스턴스에서 api.anthropic.com으로 나가므로, 인스턴스가 해당 호스트로 아웃바운드 HTTPS 요청을 보낼 수 있어야 합니다.

1단계: GitLab 구성 추가하기

GitLab 구성을 추가하려면 다음과 같이 합니다.

1. Organization settings > Claude Code 로 이동합니다.
2. Self-hosted infrastructure 아래에서 GitLab 을 찾아 "Add configuration"을 클릭합니다.
3. 표시 이름, 호스트 이름(gitlab.com 또는 gitlab.example.com 같은 인스턴스 호스트 이름), 액세스 토큰을 입력하고, 비공개 CA를 쓰는 자체 관리형 인스턴스라면 CA 인증서도 입력합니다.
4. "Add configuration"을 클릭합니다. Claude가 곧바로 연결 테스트를 실행하고 GitLab connection test 대화 상자에 결과를 보여 줍니다.
5. (선택 사항) 토큰이 마켓플레이스 프로젝트를 읽을 수 있는지 확인하려면 Project path 에 프로젝트 경로(예: platform/claude-plugins)를 입력하고 "Test sync access"를 클릭합니다.

구성 메뉴의 Test connection 으로 언제든지 테스트를 다시 실행할 수 있습니다. 호스트 이름은 나중에 바꿀 수 없습니다. 호스트 이름이 바뀌면 구성을 삭제하고 새로 추가하세요.

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

마켓플레이스를 추가하려면 다음과 같이 합니다.

1. Organization settings > Plugins & skills 로 이동해 "Marketplaces" 탭을 클릭합니다.
2. "Add"를 클릭한 다음 "Sync from GitLab"을 선택합니다.
3. GitLab repository URL 에 프로젝트의 HTTPS URL을 입력합니다(예: https://gitlab.example.com/platform/claude-plugins). 중첩된 하위 그룹의 프로젝트도 사용할 수 있습니다.
4. 푸시할 때 동기화가 실행되게 하려면 Sync automatically 를 켜 둡니다(3단계 참고).
5. 마켓플레이스에 들어 있는 플러그인의 Default access 를 선택합니다.
6. "Create"를 클릭합니다.

Claude는 마켓플레이스를 만들기 전에 프로젝트의 기본 브랜치를 읽고 마켓플레이스 파일을 검증합니다. 마켓플레이스 이름은 프로젝트 경로를 따라 정해집니다.

3단계: 자동 동기화

Sync automatically 가 켜져 있으면 프로젝트 기본 브랜치에 푸시할 때마다 GitLab 프로젝트의 웹훅을 통해 동기화가 실행됩니다. 토큰에 웹훅 관리 권한이 있으면(시작하기 전에 참고) Claude가 웹훅을 대신 만들어 주므로 더 할 일은 없습니다.

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

4단계: Claude가 웹훅을 만들지 못하는 경우

토큰에 웹훅 관리 권한이 없으면 Claude가 화면에 Webhook URL 과 토큰이 담긴 Finish webhook setup in GitLab 메시지를 표시합니다. 토큰은 한 번만 표시되므로 메시지를 닫기 전에 이 단계를 끝내세요.

1. GitLab 프로젝트에서 Settings > Webhooks 를 열고, 메시지에 있는 URL로 새 웹훅을 추가합니다.
2. 필드에 토큰을 붙여 넣습니다. 메시지에 Secret token 이 표시되면 GitLab의 Secret token 필드에 붙여 넣습니다.
3. 메시지에 Signing token 이 표시되면(gitlab.com 및 자체 관리형 19.1 이상) GitLab에서 "Generate signing token"을 선택하고, 생성된 값을 Claude가 준 값으로 바꿉니다.

• Push events 를 켜고 저장합니다.
• (선택 사항) GitLab에서 새 웹훅의 Test > Push events 를 실행해 HTTP 200이 반환되는지 확인합니다.

토큰을 잃어버렸다면 마켓플레이스 메뉴에서 Configure webhook 을 열고 "Remove webhook"을 클릭한 다음 "Enable webhook"을 클릭해 새 토큰을 받으세요. 이전 토큰은 더 이상 작동하지 않습니다.

수동 업로드와 저장소 동기화 중 선택하기

플러그인 배포 제어하기

마켓플레이스에 플러그인이 생기면 설치 기본 설정으로 배포 방식을 제어합니다. 플러그인마다 네 가지 옵션 중 하나를 설정할 수 있습니다.

중요: "Installed by default" 또는 "Required"로 설정한 플러그인은 Claude 계정으로 로그인하는 사용자의 Claude Code에도 설치됩니다. Claude Code에서는 플러그인의 훅, 서브에이전트, MCP 서버가 사용자의 컴퓨터에서 실행되며, "Required" 플러그인은 그곳에서 비활성화할 수 없습니다. 플러그인을 "Required"로 설정하기 전에 훅을 검토하세요. 자세한 내용은 Claude Code 문서의 동기화된 플러그인 을 참고하세요.

기본 설정 지정하기

1. Organization settings > Plugins & skills 에서 “Inventory” 탭을 클릭합니다.
2. 플러그인을 찾아 해당 행 끝의 메뉴 버튼을 클릭합니다.
3. “Default access”를 클릭한 다음 Install 아래에서 옵션을 선택합니다.
4. 변경 사항은 각 멤버의 다음 세션이나 플러그인 새로 고침 때 적용됩니다.

멤버가 겪는 경험

멤버는 Customize > Plugins 의 Discover 탭에서 사용 가능한 플러그인을 둘러봅니다. "Installed by default" 또는 "Required"로 설정한 플러그인은 목록에 자동으로 나타납니다. "Available to install"로 설정한 플러그인은 Discover 에 표시되어 멤버가 직접 추가할 수 있습니다.

멤버는 조직에서 관리하는 플러그인을 편집할 수 없으므로, 공유 도구가 서로 충돌하는 변경을 막을 수 있습니다.

그룹별 플러그인 액세스 맞춤 설정하기

Enterprise 관리자는 특정 그룹에 대해 플러그인의 조직 전체 설치 기본 설정을 재정의할 수 있습니다. 예를 들어 Engineering 그룹에는 플러그인을 자동 설치하고, Legal 그룹은 직접 설치할 수 있게 하며, 나머지 모두에게는 숨길 수 있습니다.

그룹 수준 플러그인 액세스는 Enterprise 요금제에서 사용할 수 있습니다. 같은 Organization settings > Plugins & skills 페이지에서 설정하며, Owner 또는 조직 라이브러리 관리 권한이 포함된 사용자 지정 역할이 필요합니다.

그룹 재정의 방식

마켓플레이스의 각 플러그인에는 조직 전체 설치 기본 설정(Installed by default, Available to install, Required, Not available)이 있습니다. 기본적으로 모든 그룹은 이 조직 전체 설정을 상속합니다.

플러그인에 그룹 수준 재정의를 설정하면, 해당 그룹의 멤버에게는 조직 전체 설정 대신 그 값이 적용됩니다. 적용 순서는 그룹 설정, 조직 전체 설정, 마켓플레이스 기본값 순입니다.

그룹에 플러그인 액세스 설정하기

1. Organization settings > Plugins & skills , 에서 “Inventory” 탭을 클릭합니다.
2. 맞춤 설정할 플러그인을 찾아 해당 행 끝의 메뉴 버튼을 클릭합니다.
3. “Group access…”를 클릭합니다.
4. Install targeting 옆의 “Add groups”를 클릭합니다.
5. 그룹을 선택하고 위에 나열한 설치 기본 설정 중 하나를 고릅니다.

직접 만든 그룹과 ID 공급자에서 SCIM으로 프로비저닝한 그룹 모두 그룹 선택기에 나타나며 똑같이 동작합니다.

멤버가 여러 그룹에 속한 경우

멤버가 같은 플러그인에 대해 서로 다른 설정을 가진 두 개 이상의 그룹에 속해 있으면 가장 허용 범위가 넓은 설정이 적용됩니다. 허용 범위가 넓은 순서는 Required > Installed by default > Available to install > Not available입니다.

예를 들어 그룹 A가 플러그인을 "Not available"로, 그룹 B가 "Installed by default"로 설정했다면 두 그룹에 모두 속한 멤버에게는 플러그인이 기본으로 설치됩니다.

참고: 이 방식은 그룹 지출 한도가 정해지는 방식과 다릅니다. 지출 한도는 Multi-group spend limit 설정에 따라 그룹 값 중 더 높은 값이나 더 낮은 값을 적용합니다. 플러그인 액세스는 가장 허용 범위가 넓은 값을 적용하는데, 여기서 그룹은 도구가 필요한 팀에 액세스를 열어 주기 위한 것이지 보안 경계 역할을 하기 위한 것이 아니기 때문입니다. 플러그인을 확실히 차단해야 한다면 조직 전체 기본 설정을 "Not available"로 두고, 필요한 그룹에만 액세스를 부여하세요.

그룹이 삭제된 경우

그룹이 제거되면(예: ID 공급자에서 삭제된 경우) 재정의는 관리자 UI에 남지만 고아(orphaned) 항목으로 표시됩니다. 삭제된 그룹에는 아무도 속하지 않으므로 멤버에게는 영향이 없고, 사용자 지정 액세스 배지에도 집계되지 않습니다. 고아 재정의는 플러그인의 “Group access…” 설정에서 지울 수 있습니다.

마켓플레이스를 다시 동기화해도 그룹 설정이 유지되나요?

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

사용자가 추가할 수 있는 마켓플레이스 제한하기

Owner 또는 Primary Owner는 허용 목록, 차단 목록, 또는 둘 다를 사용해 조직 구성원이 추가할 수 있는 플러그인 마켓플레이스를 제한할 수 있습니다. 이 목록은 Claude Code 관리형 설정에서 지정하지만 Claude와 Claude Cowork에도 적용됩니다.

허용 목록이나 차단 목록을 설정하려면 다음과 같이 합니다.

1. Organization settings > Claude Code 로 이동합니다.
2. Managed settings 를 찾습니다.
3. “Manage”를 클릭합니다.
4. JSON에 strictKnownMarketplaces(허용 목록), blockedMarketplaces(차단 목록), 또는 둘 다를 추가합니다.
5. “Add settings” 또는 “Update settings”를 클릭합니다.

허용 목록 매칭은 대소문자를 구분하므로 GitHub 조직 이름을 GitHub에 표시된 그대로 입력하세요. 어떤 소스가 두 목록에 모두 있으면 차단됩니다.

목록을 설정하면 조직의 누군가가 Claude, Claude Desktop, Cowork에서 Git 저장소의 마켓플레이스를 추가할 때마다 Claude가 목록을 확인합니다. 사용자가 Customize에서 직접 추가하는 마켓플레이스와 Organization settings > Plugins & skills 에서 조직 전체용으로 추가하는 마켓플레이스가 모두 해당됩니다. Claude는 Anthropic이 만든 마켓플레이스를 제외하고, 목록이 허용하지 않는 저장소를 모두 거부합니다.

유의할 점:

• 목록은 Organization settings에서 설정하세요. 컴퓨터에 배포한 managed-settings.json 파일이나 MDM 정책은 해당 컴퓨터의 Claude Code에만 적용됩니다.
• 기존 마켓플레이스는 다시 확인하지 않습니다. 목록을 설정하기 전에 추가한 마켓플레이스는 누군가 제거할 때까지 남아 있습니다.
• 업로드한 플러그인은 확인하지 않습니다. 사용자가 플러그인 파일을 업로드하지 못하게 하려면 Organization settings > Plugins & skills 의 “Policy” 탭에서 User-created skills 를 끄세요.

목록에서 허용하는 모든 소스 유형은 Claude Code 문서의 Restrict what users can install 을 참고하세요.

플러그인 업데이트 및 제거

수동 마켓플레이스

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

플러그인을 제거하려면 Organization settings > Plugins & skills 의 “Inventory” 탭에서 마켓플레이스의 해당 플러그인을 삭제하세요.

GitHub 동기화 마켓플레이스

연결된 저장소에 변경 사항을 푸시한 다음, Organization settings > Plugins & skills 로 이동해 “Marketplaces” 탭을 클릭하고, 마켓플레이스를 찾아 "Update"를 클릭해 동기화를 실행합니다. 동기화할 때마다 모든 플러그인이 저장소의 현재 상태로 교체됩니다. 소유자가 마켓플레이스에 "Sync automatically"를 켜 두었다면, 플러그인 버전을 올린 풀 리퀘스트가 저장소의 기본 브랜치에 병합될 때마다 동기화가 실행됩니다.

GitLab 동기화 마켓플레이스는 GitLab 동기화 마켓플레이스 설정하기 를 참고하세요.

플러그인을 제거하려면 저장소에서 삭제한 뒤 동기화를 실행하세요.

제한

이름 규칙

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

• claude-code-marketplace
• claude-code-plugins
• claude-plugins-official
• anthropic-marketplace
• anthropic-plugins
• agent-skills
• life-sciences

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

참고: 플러그인 작성자는 displayName 을 설정해 카탈로그에서 슬러그 대신 읽기 쉬운 이름이 표시되게 할 수 있습니다. 작성자가 설정하지 않으면 플러그인은 슬러그(예: deployment-tools)로 표시됩니다.

문제 해결

업로드가 거부됨

흔한 원인은 파일이 200MB를 넘거나, 올바른 ZIP 파일이 아니거나, 마켓플레이스가 플러그인 1000개 한도에 도달한 경우입니다. 파일 크기와 형식을 확인하고, 한도에 도달했다면 사용하지 않는 플러그인을 제거하세요. 스킬 및 플러그인 스캐닝이 켜져 있으면 악성 콘텐츠로 표시되어 거부될 수도 있습니다. 사유를 확인하고 문제를 고친 뒤 다시 업로드하세요.

멤버에게 플러그인이 보이지 않음

마켓플레이스 설정에서 플러그인의 설치 기본 설정을 확인하세요. Not available 로 설정되어 있으면 멤버에게 보이지 않습니다. 조직에서 Cowork와 Skills가 모두 켜져 있는지도 확인하세요.

업데이트한 플러그인이 멤버에게 반영되지 않음

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

GitHub 동기화가 콘텐츠 오류로 실패함

저장소의 플러그인 중 하나 이상이 잘못된 형식일 가능성이 높습니다. 형식 문제를 고치고 GitHub에 업데이트를 푸시한 뒤 다시 동기화하세요. 플러그인 구조 요구 사항은 플러그인 매니페스트 참조 문서 를 참고하세요.

"External plugin source type is not supported. Supported types: git-subdir, github, url" 오류로 동기화가 실패하거나 "Repository not found on gitlab.com. Check the URL and make sure the repository is public." 메시지와 함께 플러그인을 건너뜀

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

그 밖의 비공개 소스라면 플러그인 폴더를 마켓플레이스 저장소로 옮기고 각 항목의 source 를 상대 경로(예: "./plugins/my-plugin")로 바꾼 뒤 푸시하고 다시 동기화하세요. 또는 Organization settings > Plugins & skills 에서 해당 플러그인을 하나씩 업로드할 수도 있습니다. “Add”, “Upload a plugin”을 클릭한 다음 "Add to an existing marketplace"를 선택하세요. 멤버가 자신의 Customize 메뉴에서 업로드한 플러그인은 그 멤버에게만 설치되고 조직에 배포되지 않습니다. 다만 공유가 켜져 있으면 멤버가 특정 동료나 그룹과 플러그인을 공유할 수 있습니다.

연결할 때 GitHub 저장소가 보이지 않음

해당 저장소에 Claude GitHub App이 설치되어 있는지 확인하세요. 먼저 개인 GitHub 토큰으로 접근 권한을 확인하지만, 동기화 자체에는 GitHub App 설치 토큰을 사용합니다.

"Sync automatically"를 켤 때 "Cannot access repository"가 표시됨

수동 업데이트는 되는데 "Sync automatically"를 켜면 "Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed"가 표시된다면, 원인은 두 가지일 가능성이 높습니다.

• 저장소에 대한 관리자 권한이 없습니다. 자동 동기화를 켜면 웹훅이 만들어지는데, 이를 위해서는 개인 GitHub 연결을 통한 저장소 관리자 수준 권한이 필요합니다. 저장소 관리자에게 토글을 켜 달라고 요청하거나, GitHub 권한을 올려 달라고 하세요.
• Claude GitHub App의 Webhooks 권한이 승인되지 않았습니다. 오래된 설치에서는 GitHub에 "Claude is requesting updated permissions" 안내가 표시됩니다. 저장소 또는 조직 관리자가 설치에서 Webhooks (Read & Write) 권한을 승인해야 합니다.

마켓플레이스를 추가할 때 "No GitLab instance is configured for your organization yet. Add one under Claude Code settings, then come back here"가 표시됨

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

"This URL isn’t on a configured GitLab instance"

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

gitlab.com 프로젝트를 추가할 때 "Failed to create marketplace. Try again."으로 실패함

프로젝트 공개 범위가 비공개 또는 내부인지 확인하세요. 공개 gitlab.com 프로젝트는 조직 마켓플레이스로 쓸 수 없습니다.

연결 테스트가 Reach host 단계에서 실패하거나(예: "The hostname couldn’t be resolved," "The connection was refused," "GitLab didn’t respond in time"), 자체 관리형 인스턴스에서 마켓플레이스 추가가 일반 오류로 실패함

인스턴스가 공개 인터넷에서 HTTPS로 접근 가능한지, 그리고 방화벽이 Anthropic의 아웃바운드 IP 주소를 허용하는지 확인하세요. "A secure connection couldn’t be established"는 보통 CA 인증서가 없거나 잘못되었다는 뜻입니다.

"Authentication to … failed" 또는 "Access denied"로 시작하는 오류

토큰이 만료되었거나, 취소되었거나, GitLab 동기화 마켓플레이스 설정하기 의 시작하기 전에 에 나온 범위나 역할이 빠져 있는 경우입니다. 새 토큰을 만들어 구성에 붙여 넣으세요(Edit > Access token).

관련 문서

• Claude에서 플러그인 사용하기
• Claude Code용 Code Review 설정하기
• 스킬, 커넥터, 플러그인을 하나의 디렉터리에서 둘러보기
• 스킬 및 플러그인 스캐닝 시작하기
• 조직의 Claude에서 Salesforce 설정하기

출처

• 원문: https://support.claude.com/en/articles/13837433-manage-plugins-for-your-organization (2026-10-07 · support.claude.com)