Operating Plugin Marketplaces

A marketplace is any repository or directory that contains a marketplace.json manifest. Use marketplaces to centrally manage and distribute plugins across teams and organizations.

마켓플레이스 구조

my-marketplace/
├── .claude-plugin/
│   └── marketplace.json    # Marketplace declaration
└── plugins/
    ├── plugin-a/           # Plugin directory
    │   ├── .claude-plugin/
    │   │   └── plugin.json
    │   └── skills/
    └── plugin-b/

marketplace.json 기본 형식

{
  "name": "my-org-plugins",
  "description": "Internal team plugin marketplace",
  "plugins": [
    {
      "name": "formatter",
      "description": "Code formatter and linter automation",
      "source": "./plugins/formatter"
    },
    {
      "name": "deploy-kit",
      "description": "Deployment automation tool suite",
      "source": "https://github.com/my-org/deploy-kit"
    }
  ]
}

Plugin sources can be a local path, GitHub repo URL, Git URL, or Zip archive URL.

마켓플레이스 로컬 테스트

Add and verify marketplaces locally:

# Add local marketplace
/plugin marketplace add ./my-marketplace

# Or specify the JSON file path directly
/plugin marketplace add ./my-marketplace/.claude-plugin/marketplace.json

Once registered, inspect available plugins in the /plugin Discover tab.

마켓플레이스 호스팅

GitHub 저장소로 호스팅

The most direct approach:

# Add marketplace repository
/plugin marketplace add your-org/plugins

# Pin to branch or tag
/plugin marketplace add your-org/plugins#v2.0.0

HTTPS URL로 마켓플레이스 JSON 호스팅

Host static marketplace.json on any web server or CDN:

/plugin marketplace add https://cdn.example.com/marketplace.json

Zip 아카이브 배포 (v2.1.224+)

Distribute plugins over HTTPS without Git repositories. Set source to an archive URL:

{
  "name": "internal-toolkit",
  "source": {
    "type": "archive",
    "url": "https://cdn.example.com/plugins/internal-toolkit-v1.2.zip",
    "sha256": "e3b0c44298fc1c149afbf4c8996fb924..."
  }
}

Providing sha256 enables automatic download integrity verification.

자동 업데이트 설정

Control auto-update behavior at the marketplace level:

Marketplace Type	Auto-update Default
Anthropic Official (claude-plugins-official, etc.)	ON
Community, Third-party, Local	OFF

Users can toggle this manually under /plugin → Marketplaces.

버전 관리

Set the version field in plugin.json to pin users to a release. Release tag convention:

{plugin-name}--v{version}

Example: secrets-vault--v2.1.0

Validate and push tags:

claude plugin tag --push

플러그인 추천 (relevance, v2.1.152+)

Allow Claude Code to suggest contextual plugins based on work activity. Add a relevance block to entries in marketplace.json:

{
  "name": "terraform-helpers",
  "source": "./plugins/terraform-helpers",
  "relevance": {
    "topic": "Terraform",
    "signals": {
      "cli": ["terraform"],
      "filesRead": ["**/*.tf"]
    }
  }
}

Available Signals:

Signal	Description
cwd	Current working directory pattern
cli	Commands run by the user
hosts	Accessed hostnames
filesRead	Patterns of files read
manifestDeps	Manifest dependencies

Signal matching runs strictly locally on the user's machine; no telemetry is sent to Anthropic or marketplace operators.

Activation Requirement

The relevance block alone does not activate suggestions. An administrator must add the marketplace to pluginSuggestionMarketplaces in managed settings.

플러그인 배포 방법

직접 전달 (소수 대상)

Direct distribution via Zip or directory without needing a marketplace:

# Load directly from path
claude --plugin-dir ./received-plugin

자체 마켓플레이스 경유

Team members register the marketplace once and install by name:

# Register marketplace
/plugin marketplace add your-org/plugins

# Install by name
/plugin install formatter@your-org

Anthropic 공식 디렉토리 제출

To distribute publicly to the broader ecosystem:

1. Write a comprehensive README.md
2. Follow semantic versioning
3. Verify with claude plugin validate ./my-plugin
4. Submit at claude.ai/marketplace

조직 단위 플러그인 관리

Enterprise administrators can enforce policies via managed settings:

{
  "pluginSuggestionMarketplaces": ["your-org-plugins"],
  "allowedPluginMarketplaces": ["claude-plugins-official", "your-org-plugins"],
  "forcedPlugins": ["security-scanner@claude-plugins-official"]
}

• allowedPluginMarketplaces: Allowlist of permitted marketplaces
• forcedPlugins: Plugins forcefully installed and enabled for all organization users

For detailed enterprise policy setup, see the official plugin organization docs.

---

Next chapter: Plugin System Overview →