조직을 위한 플러그인 추천

• 마켓플레이스 운영자: 제안 작동 방식 읽기, 플러그인 항목에 관련성 추가 및 마켓플레이스 검증
• 관리자: 관리 설정에서 제안 활성화

​

플러그인 관련성 작동 방식 이해

• 스피너 팁: Claude가 응답하는 동안 스피너 아래에 /plugin install 명령이 포함된 메시지가 나타납니다.
• 세션 시작 알림: cwd 신호가 작업 디렉토리와 일치하면 사용자가 첫 번째 메시지를 보내기 전에 한 줄 알림이 나타납니다.
• /plugin Discover 탭: 플러그인이 Discover 목록의 맨 위에 고정됩니다.

​

플러그인 항목에 관련성 추가

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    {
      "name": "terraform-helpers",
      "source": "./plugins/terraform-helpers",
      "description": "Your organization's Terraform conventions and helpers",
      "relevance": {
        "topic": "Terraform",
        "signals": {
          "cli": ["terraform"],
          "filesRead": ["**/*.tf"]
        }
      }
    }
  ]
}

​

필드 참조

​

relevance

​

relevance.signals

​

작업 디렉토리 일치

• 패턴은 절대 경로로 작업 디렉토리와 일치합니다. 세션이 git 저장소 내에 있을 때, 저장소 루트에 상대적인 작업 디렉토리의 경로와도 일치합니다.
• 일치는 정방향 슬래시 정규화 및 대소문자 구분 없음입니다.
• 모든 패턴은 디렉토리 자체 및 그 아래의 모든 항목과 일치하므로 infra, infra/, infra/**는 동일하게 작동합니다.

​

명령 이름 일치

​

매니페스트 종속성 일치

• file: 매니페스트 파일의 경로와 대소문자 구분 없이 일치합니다. 경로는 일반적으로 절대 경로이므로 시작이 아닌 끝에 패턴을 고정합니다. 경로는 이 신호에 대해 구분자 정규화되지 않으므로 Windows 경로는 백슬래시를 사용합니다.
• pattern: 해당 파일의 내용과 대소문자 구분하여 일치합니다.

{
  "name": "your-plugin",
  "source": "./plugins/your-plugin",
  "relevance": {
    "signals": {
      "manifestDeps": [
        {
          "file": "[/\\\\]package\\.json$",
          "pattern": "\"your-sdk\"\\s*:"
        }
      ]
    }
  }
}

​

마켓플레이스 검증

claude plugin validate ./my-marketplace

• relevance 및 relevance.signals 아래의 알 수 없는 키를 경고로 보고합니다.
• relevance 값이 객체가 아닌 경우를 플래그합니다.
• 스키마, 포트 또는 경로를 포함하는 signals.hosts 항목을 거부합니다.

​

관리 설정에서 제안 활성화

• 마켓플레이스 이름을 pluginSuggestionMarketplaces에 추가합니다.
• 공식 Anthropic 마켓플레이스 이외의 마켓플레이스의 경우, 마켓플레이스 소스를 extraKnownMarketplaces의 해당 이름 항목으로 또는 strictKnownMarketplaces의 항목으로 선언합니다.

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "github",
        "repo": "your-org/your-marketplace"
      }
    }
  },
  "pluginSuggestionMarketplaces": ["your-marketplace"]
}

{
  "pluginSuggestionMarketplaces": ["claude-plugins-official"]
}

​

사용자가 보는 내용 미리보기

Working with Terraform? Install the terraform-helpers plugin:
/plugin install terraform-helpers@your-marketplace

plugin suggestion: terraform-helpers@your-marketplace · /plugin

• 제안은 스피너 팁과 세션 시작 알림을 합쳐서 최대 3개 세션마다 한 번 나타납니다.
• 세션 시작 알림은 스피너 팁과 알림이 플러그인을 합쳐서 2번 표시한 후 나타나지 않습니다.
• 스피너 팁과 세션 시작 알림은 플러그인이 설치되면 반복되지 않습니다.
• Discover 탭은 사용자가 플러그인의 신호가 일치하는 동안 탭을 처음 열 때 플러그인을 고정합니다. Claude Code는 이를 ~/.claude.json에 기록하므로 사용자가 나중에 해당 머신에서 /plugin을 열 때마다 플러그인은 정상 순서로 나타납니다.

​

참고 항목

• 마켓플레이스 호스팅: 플러그인을 호스팅하는 마켓플레이스 실행
• 마켓플레이스 참조: 플러그인 항목이 허용하는 모든 필드
• CLI에서 플러그인 추천: Claude Code의 세션 신호 대신 자신의 CLI에서 사용자에게 메시지 표시
• 조직을 위한 플러그인 관리: extraKnownMarketplaces, strictKnownMarketplaces 및 나머지 플러그인 정책 키