AI PraktykPO POLSKU

Karty pisze AI wyłącznie z oficjalnej dokumentacji, a program sprawdza cytaty i komendy. Jak to działa

Rozszerzaniezaawansowanymarketplace.json

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.

przykład
To przykładowy plik marketplace z wpisem wskazującym na wtyczkę przechowywaną wewnątrz katalogu marketplace.
{
  "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"
    }
  ]
}
przykład
Taką wartość source można wykorzystać, gdy wtyczka znajduje się we własnym repozytorium GitHub.
{ "source": "github", "repo": "your-org/my-first-plugin" }
przykład
Źródło 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.

WskazówkaPrzed diagnozowaniem marketplace zweryfikuj wtyczkę w miejscu, w którym będzie przechowywana; dzięki temu późniejszy błąd będzie dotyczył marketplace, a nie samej wtyczki.

Zgodne z dokumentacją (sprawdzone 30 października 2026), opis z 30 października 2026. Karta jest pisana od nowa, gdy zmieni się jej fragment dokumentacji.

Otwórz w serwisie (wyszukiwarka i filtry tematów)