Własny marketplace wtyczek
Marketplace wtyczek to katalog lub repozytorium z plikiem .claude-plugin/marketplace.json, który wymienia wtyczki i miejsca, z których można je pobrać. Własny katalog pozwala udostępnić wybrane wtyczki zespołowi lub organizacji i kontrolować katalog, z którego je instalują. Repozytorium może być prywatne i zawierać dowolną liczbę wtyczek, a administrator może wymagać jego obecności na każdej maszynie.
Plik marketplace.json wymaga pól name, owner oraz tablicy plugins. Każdy obiekt w plugins opisuje jedną wtyczkę i musi zawierać name oraz source. Dla wtyczki przechowywanej w katalogu marketplace wartość source podaje ścieżkę względną od jego katalogu głównego. Opcjonalny opis to tekst widoczny obok wtyczki podczas przeglądania marketplace w panelu /plugin.
Przygotuj katalog marketplace i jego folder .claude-plugin/, a wtyczkę umieść pod plugins/. Zapisz plik pod ścieżką my-marketplace/.claude-plugin/marketplace.json i dodaj do niego wymagane pola oraz wpisy wtyczek. Sprawdź marketplace poleceniem claude plugin validate uruchomionym na jego katalogu; weryfikacja obejmuje składnię JSON, wymagane pola i wpisy wtyczek. Po dodaniu marketplace instalator identyfikuje wtyczkę przez połączenie nazwy wpisu, znaku @ i nazwy marketplace.
Wybierz źródło odpowiednio do miejsca przechowywania plików: może to być ścieżka względna, repozytorium GitHub albo podkatalog innego repozytorium. Wtyczki mogą też pochodzić z repozytorium Git pod adresem URL, archiwum ZIP pobranego przez HTTPS, pakietu npm lub katalogu utworzonego przez komendę. Utrzymuj zgodność nazwy wpisu w marketplace z nazwą wtyczki w jej plugin.json, ponieważ rozbieżność może spowodować błąd wyszukiwania.
{
"name": "my-marketplace",
"description": "Plugins for my team",
"owner": {
"name": "Your Name"
},
"plugins": [
{
"name": "my-first-plugin",
"source": "./plugins/my-first-plugin",
"description": "A greeting plugin to learn the basics"
}
]
}source można wykorzystać, gdy wtyczka znajduje się we własnym repozytorium GitHub.{ "source": "github", "repo": "your-org/my-first-plugin" }git-subdir wskazuje wtyczkę będącą podkatalogiem innego repozytorium, na przykład monorepo.{ "source": "git-subdir", "url": "your-org/monorepo", "path": "tools/my-first-plugin" }Zastosowanie w praktyce
Użyj własnego marketplace, gdy chcesz udostępniać wtyczki wybranemu zespołowi lub organizacji i kontrolować katalog aktualizacji. To rozwiązanie pasuje do prywatnego repozytorium, które może zawierać wiele wtyczek. Administrator może też wymagać używania marketplace na każdej maszynie.