Claude Code: czym są wtyczki i ile kosztują?

Czym jest wtyczka Claude Code

Wtyczka Claude Code to katalog komponentów, które Claude Code wczytuje i zarządza nimi jako jedną jednostką. Komponenty te obejmują umiejętności (skills), agentów, hooki, serwery MCP, serwery LSP oraz monitory działające w tle. Instalacja wtyczki dodaje wszystkie jej części jednocześnie pod jedną nazwą, a jej wyłączenie usuwa je w ten sam sposób.

Wtyczka nie nadaje agentowi żadnych nowych możliwości, których nie posiadałby wcześniej. Każdy element wewnątrz wtyczki można napisać samodzielnie w katalogu .claude/. Wtyczka stanowi warstwę pakowania: sposób na wersjonowanie tych części, przekazanie ich innym osobom oraz aktualizację bez konieczności ręcznego kopiowania plików przez użytkowników. Na tym polega cała koncepcja, a większość nieporozumień dotyczących wtyczek wynika z oczekiwania, że stanowią one nowy rodzaj funkcjonalności.

Opcjonalny manifest w .claude-plugin/plugin.json nadaje wtyczce nazwę, która staje się przestrzenią nazw. Umiejętność zawarta we wtyczce o nazwie commit-commands jest wywoływana jako /commit-commands:commit, dzięki czemu dwie wtyczki mogą dostarczać umiejętność o nazwie commit bez wzajemnego przesłaniania się. Agenci wtyczek są objęci tym samym zakresem na liście @-wzmianek jako plugin-name:agent-name.

Wtyczka, umiejętność, serwer MCP lub plik reguł

Te cztery pojęcia bywają używane zamiennie, jakby ze sobą konkurowały. Tak nie jest, a warto raz określić granice między nimi.

• Umiejętność (skill) to pojedyncza jednostka instrukcji, którą Claude wczytuje, gdy wymaga tego zadanie. Zobacz czym faktycznie jest Agent Skill.
• Serwer MCP to oddzielny proces, który udostępnia narzędzia agentowi za pośrednictwem protokołu; często jest to usługa sieciowa uruchamiana samodzielnie.
• Plik reguł, taki jak CLAUDE.md, stanowi kontekst projektu, który jest odczytywany przy starcie sesji i ma zastosowanie do wszystkiego.
• Wtyczka (plugin) to kontener, który może łączyć w sobie umiejętności, agentów, hooki oraz definicje serwerów MCP, a dodatkowo posiada numer wersji i kanał dystrybucji.

Zatem pytanie, na które odpowiada wtyczka, nie brzmi „co potrafi agent”. Brzmi ono „jak dostarczyć to zespołowi i zaktualizować w przyszłym miesiącu”. Jeśli wybierasz między pierwszymi trzema opcjami, porównanie umiejętności, serwerów MCP i plików reguł szczegółowo omawia tę decyzję. Jeśli interesuje Cię kwestia MCP, uruchamianie własnych serwerów MCP na VPS obejmuje aspekty związane z hostingiem.

Lokalizacja wtyczek i ich zawartość

Wtyczka zainstalowana z marketplace jest kopiowana do lokalnej pamięci podręcznej w ~/.claude/plugins/cache, zamiast być uruchamiana z miejsca, z którego została sklonowana. Każda zainstalowana wersja otrzymuje własny katalog. Podczas aktualizacji lub odinstalowania, katalog starej wersji jest oznaczany jako osierocony i usuwany po około dwóch tygodniach. Dzięki temu sesja, która już załadowała starą wersję, działa poprawnie zamiast przerywać pracę w trakcie zadania.

Ponieważ ścieżka zmienia się przy każdej aktualizacji, wtyczka nigdy nie powinna mieć na sztywno wpisanej własnej lokalizacji. Hooki oraz konfiguracje MCP wewnątrz wtyczki używają ${CLAUDE_PLUGIN_ROOT}, co wskazuje na bieżący katalog instalacyjny. Dane stanu, które muszą przetrwać aktualizację, umieszcza się w ${CLAUDE_PLUGIN_DATA}, co wskazuje na stabilny katalog wewnątrz ~/.claude/plugins/data/.

Do pamięci podręcznej kopiowany jest tylko katalog wtyczki, co prowadzi do problemu, z którym użytkownicy spotykają się na późniejszym etapie. Ścieżka wskazująca poza główny katalog wtyczki, taka jak ../shared-utils, działa podczas programowania z użyciem ścieżki lokalnej, ale przestaje działać po instalacji, ponieważ te pliki nigdy nie zostały skopiowane.

Struktura wygląda następująco.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

Tylko plugin.json znajduje się wewnątrz .claude-plugin/. Wszystkie pozostałe elementy znajdują się w głównym katalogu wtyczki. Umieszczenie skills/ lub hooks/ wewnątrz .claude-plugin/ jest najczęstszą przyczyną sytuacji, w której wtyczka instaluje się poprawnie, a następnie nie wykonuje żadnych działań: Claude Code szuka tych katalogów w głównym folderze, nie znajduje ich i ładuje wtyczkę bez żadnych komponentów.

Sam manifest jest niewielki.

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0"
}

Jak zainstalować wtyczkę Claude Code

Instalacja składa się z dwóch etapów, przy czym pierwszy z nich nie instaluje żadnych plików. Najpierw dodaje się marketplace, czyli katalog wtyczek, a następnie instaluje się z niego poszczególne wtyczki. Oficjalny marketplace Anthropic, claude-plugins-official, jest rejestrowany automatycznie przy pierwszym uruchomieniu Claude Code w trybie interaktywnym. Inne źródła dodaje się samodzielnie.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

Należy pamiętać, że repozytorium to anthropics/claude-code, podczas gdy marketplace nosi nazwę claude-code-plugins. Nazwa pochodzi z pliku katalogu znajdującego się wewnątrz repozytorium, a nie ze ścieżki repozytorium, dlatego przed wpisaniem polecenia instalacji należy odczytać nazwę marketplace z karty Marketplaces w /plugin.

Po zakończeniu instalacji należy zapoznać się z podsumowaniem. Plugin is now active. oznacza, że komponenty zostały załadowane w bieżącej sesji. Run /reload-plugins to activate. oznacza, że nie zostały załadowane i konieczne jest ponowne uruchomienie polecenia. Jeśli /reload-plugins wyświetli ostrzeżenie o konieczności ponownego odczytania konwersacji, należy uruchomić je ponownie jako /reload-plugins --force. Następnie należy potwierdzić obecność wtyczki: /plugin wyświetla ją na karcie Installed, /help wymienia jej umiejętności na karcie Custom commands, a wszelkie błędy ładowania pojawiają się na karcie Errors wraz z przyczyną.

Podczas instalacji wymagane jest określenie zakresu (scope), który decyduje o tym, kto otrzyma dostęp do wtyczki. Zakres użytkownika (user scope) dotyczy bieżącego użytkownika we wszystkich projektach. Zakres projektu (project scope) zapisuje wtyczkę w pliku .claude/settings.json repozytorium w sekcji enabledPlugins, dzięki czemu każdy, kto sklonuje repozytorium, otrzyma propozycję jej instalacji. Zakres lokalny (local scope) dotyczy bieżącego użytkownika tylko w tym konkretnym repozytorium.

W przypadku skryptów, plików Dockerfile lub sesji, w których panel interaktywny nie jest dostępny, należy użyć wersji powłoki (shell form). Instaluje ona wtyczkę w zakresie użytkownika, chyba że zostanie przekazana flaga --scope.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install działa poza sesją, więc otwarta sesja nie wykryje nowej wtyczki, dopóki nie zostanie uruchomione polecenie /reload-plugins lub nie zostanie rozpoczęta nowa sesja.

Zarządzanie posiadanymi wtyczkami odbywa się w ten sam sposób w obu trybach. /plugin list wyświetla zainstalowane elementy i akceptuje flagi --enabled lub --disabled. /plugin disable name@marketplace wyłącza wtyczkę bez jej usuwania, /plugin enable włącza ją ponownie, a /plugin uninstall usuwa ją całkowicie. Polecenia typu slash otwierają panel wtyczek w celu zastosowania zmian, dlatego w skryptach należy używać odpowiedników powłoki claude plugin ....

Aby udostępnić marketplace całemu zespołowi, należy umieścić go w pliku .claude/settings.json projektu. Członkowie zespołu otrzymają monit o instalację po zaufaniu folderowi repozytorium.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Podczas tworzenia własnej wtyczki należy pominąć marketplace. claude --plugin-dir ./my-plugin ładuje katalog dla bieżącej sesji, /reload-plugins uwzględnia wprowadzane zmiany bez konieczności restartu, a claude plugin validate ./my-plugin sprawdza manifest, umiejętności, frontmatter agenta oraz hooks/hooks.json, zanim wtyczka zostanie udostępniona innym.

Ile kosztuje wtyczka Claude Code?

Mechanizm jest bezpłatny. Według stanu na sierpień 2026 r. nie ma opłat za dodanie marketplace'u, instalację wtyczki ani utrzymywanie jej w stanie włączonym. Oficjalne i społecznościowe marketplace'y to publiczne repozytoria git, a wtyczka jest katalogiem plików tekstowych.

Koszt wtyczki wyraża się w tokenach, a tokeny są jednostką, którą mierzy subskrypcja lub rachunek za API. To, w jaki sposób wtyczka wpływa na zużycie, zależy od modelu płatności za narzędzie, a koszty Claude Code w poszczególnych planach przedstawiają poziomy subskrypcji w zestawieniu z cenami API za token. Koszt ten generowany jest na trzy sposoby, które różnią się charakterystyką.

Koszt stałego kontekstu. Zawartość wtyczki znajduje się w kontekście i jest odczytywana przy każdej turze sesji. Przed instalacją widok szczegółów /plugin pokazuje szacunkowe zużycie Context cost w tokenach oraz sekcję Will install z listą poleceń, umiejętności, agentów, hooków oraz serwerów MCP i LSP, które zostaną dodane. Należy zapoznać się z oboma elementami. Wtyczki z lokalnych lub niestandardowych marketplace'ów mogą nie dostarczać tych danych; w takim przypadku szacunki trzeba wykonać samodzielnie. Wtyczka zawierająca serwer MCP jest zazwyczaj najbardziej obciążająca, ponieważ definicje narzędzi są duże, choć w modelach wspierających wyszukiwanie narzędzi MCP definicje te są odraczane do momentu, gdy narzędzie będzie potrzebne.

Koszt wywołania. Uruchomienie umiejętności wtyczki dołącza jej instrukcje do konwersacji, więc za treść umiejętności płaci się tylko wtedy, gdy jest używana. Sama treść jest tania, ale to, co umiejętność nakazuje agentowi zrobić, już niekoniecznie: metoda Depth Tree w umiejętności unlazy zużywa większość tokenów na dodatkowe przebiegi wymuszane przed uznaniem zadania za wykonane, a nie na sam zainstalowany plik. Agent działa inaczej. Subagent prowadzi własną konwersację z własnym system promptem i własną pamięcią podręczną, zaczynając od braku trafień w cache, więc wtyczka, której przepływ pracy tworzy agentów, kosztuje znacznie więcej, niż sugeruje szacunek kontekstu.

Koszt pamięci podręcznej (cache). Włączenie lub wyłączenie wtyczki w trakcie sesji może wymusić ponowne przetworzenie całej konwersacji przy kolejnym żądaniu. Umiejętności, polecenia, agenci, hooki, serwery LSP, monitory i motywy nigdy tego nie powodują: to, co dodają, jest dołączane po istniejącej historii, więc kolejne żądanie płaci za nową zawartość, nadal odczytując wszystko wcześniej z cache. Wyjątkiem jest wtyczka dostarczająca serwer MCP. Jeśli jej narzędzia są odraczane przez wyszukiwanie narzędzi, cache pozostaje nienaruszony. Jeśli ładują się do prefiksu promptu, kolejne żądanie odczytuje całą konwersację jako niebuforowane dane wejściowe. Właśnie dlatego /reload-plugins wyświetla ostrzeżenie i odmawia działania w takim przypadku, dopóki nie zostanie przekazana flaga --force.

Można to monitorować, zamiast zgadywać. Każda odpowiedź API raportuje cache_read_input_tokens oraz cache_creation_input_tokens, a niestandardowy pasek statusu pokazujący bieżące zużycie tokenów prezentuje obie te wartości. Zdrowa sesja odczytuje znacznie więcej, niż tworzy. Jeśli tworzenie pozostaje wysokie przez kolejne tury, coś w prefiksie zmienia się przy każdym kroku. Aby uzyskać szerszy obraz tego, co wypełnia okno, zobacz jak zarządzać oknem kontekstu Claude Code oraz co faktycznie oznaczają te liczby tokenów.

Jedna czynność porządkowa zwraca się z nawiązką. Karta Installed grupuje wtyczki, które nie były używane przez co najmniej dwa tygodnie, pod nagłówkiem Not used recently, z linią Last used w widoku szczegółów. Takie wtyczki nadal obciążają czas uruchamiania i kontekst w każdej sesji. Należy je wyłączyć lub odinstalować.

Wtyczka działa z Twoimi uprawnieniami

Własna dokumentacja Anthropic jasno to określa: wtyczki i markety to komponenty o wysokim poziomie zaufania, które mogą wykonywać dowolny kod na Twojej maszynie z uprawnieniami Twojego użytkownika. Nie jest to sytuacja hipotetyczna. Haki wtyczki uruchamiają polecenia powłoki przy zdarzeniach sesji, w tym przed i po wywołaniach narzędzi. Jej katalog bin/ jest dodawany do PATH narzędzia Bash, gdy wtyczka jest włączona. Jej serwery MCP to procesy, które sama uruchamia. Nic tutaj nie jest odizolowane od Twojego konta użytkownika.

Na laptopie ryzyko to jest ograniczone do zasobów dostępnych dla użytkownika pulpitu. Na serwerze zazwyczaj tak nie jest. Konto uruchamiające agenta często posiada klucze SSH, tokeny wdrożeniowe, sesję cloud CLI oraz dostęp do gniazda Docker, więc "dowolny kod jako Twój użytkownik" oznacza przejęcie maszyny. Jeśli Claude Code działa na VPS, przeczytaj jak bezpiecznie uruchomić Claude Code na VPS przed zainstalowaniem czegokolwiek oraz jak chronić poświadczenia przed dostępem agenta przed zainstalowaniem wtyczki komunikującej się z usługą zewnętrzną. Inne środowiska napotykają tę samą barierę na tym samym wynajętym serwerze, dlatego wtyczki DeepSeek Harness warte zainstalowania to głównie limity wydatków, reguły uprawnień narzędzi i skanowanie pod kątem wstrzykiwania kodu, a nie nowe funkcjonalności.

Istnieją pewne zabezpieczenia i warto wiedzieć, które z nich działają. Wtyczka o zasięgu projektu pochodzi z repozytorium, a nie od Ciebie, więc ładuje się dopiero po zaufaniu do obszaru roboczego, jej serwery MCP nadal wymagają zatwierdzenia dla każdego serwera, jej serwery LSP czekają na to zaufanie, a jej monitory działające w tle w ogóle się nie ładują. Agenci dostarczani przez wtyczki nie mogą deklarować haków, serwerów MCP ani trybu uprawnień. Wtyczki z marketu są kopiowane do pamięci podręcznej, a dowiązania symboliczne wskazujące poza market są pomijane, więc wtyczka nie może pobrać dowolnych plików hosta.

Nic z tego nie zastępuje czytania tego, co instalujesz. Sprawdzaj listę Will install, preferuj wtyczki, których kod źródłowy możesz otworzyć i przeczytać, przechowuj wtyczki swojego zespołu w repozytorium marketu, które kontrolujesz, i uruchamiaj claude plugin validate na wszystkim, co napiszesz samodzielnie.

FAQ

Czy wtyczki do Claude Code wymagają dodatkowych opłat?

Nie. System wtyczek, korzystanie z marketplace oraz instalacja wtyczek są bezpłatne. Koszt wynika wyłącznie z zużycia tokenów, rozliczanego zgodnie z planem lub wydatkami na API, tak jak w przypadku każdego innego kontekstu. Wtyczka dodaje stały kontekst do każdej tury, zwiększa go przy wywołaniu umiejętności lub agenta oraz może wymusić jedną kosztowną turę bez cache'owania, jeśli dostarcza serwer MCP, którego narzędzia są ładowane do prefiksu promptu. Widok szczegółów /plugin wyświetla szacunkowe zużycie Context cost przed instalacją.

Jaka jest różnica między wtyczką a umiejętnością?

Umiejętność to pojedyncza jednostka instrukcji. Wtyczka to pakiet zawierający umiejętności, agentów, hooki, serwery MCP, serwery LSP oraz monitory, posiadający nazwę, wersję i źródło instalacji (marketplace). Samodzielną umiejętność należy napisać w .claude/, jeśli jest przeznaczona tylko dla użytkownika i bieżącego projektu. Umiejętność jednofunkcyjna, taka jak Ponytail, która nakierowuje agenta na najmniejszą działającą zmianę, jest tego najlepszym przykładem: jeden plik z jedną regułą, dopóki nie stanie się potrzebna całemu zespołowi. Wtyczkę należy stworzyć, gdy inne osoby potrzebują danego rozwiązania i wymaga ono regularnych aktualizacji. Umiejętności wtyczek posiadają własną przestrzeń nazw, dlatego umiejętność wewnątrz wtyczki wywołuje się jako /plugin-name:skill-name, a nie /skill-name.

Wtyczka została zainstalowana, ale jej umiejętności nie są widoczne. Co jest nie tak?

Najpierw sprawdź podsumowanie instalacji. Jeśli pojawił się komunikat Run /reload-plugins to activate., komponenty nie zostały jeszcze załadowane; jeśli przeładowanie ostrzega o ponownym odczycie konwersacji, uruchom je ponownie jako /reload-plugins --force. Jeśli wtyczka załadowała się, ale nic nie wyświetla, otwórz /plugin i sprawdź kartę Errors. Najczęstszym błędem strukturalnym jest umieszczenie skills/, agents/ lub hooks/ wewnątrz .claude-plugin/, gdzie Claude Code ich nie wyszukuje. Pamiętaj, że umiejętności wtyczek mają własną przestrzeń nazw, więc szukaj /plugin-name:skill-name w karcie Custom commands narzędzia /help. W ostateczności użyj rm -rf ~/.claude/plugins/cache, zrestartuj i zainstaluj ponownie.

Czy można instalować wtyczki bez panelu interaktywnego?

Tak. Użyj polecenia powłoki claude plugin install name@marketplace, które instaluje wtyczkę w zakresie użytkownika, chyba że użyjesz flagi --scope project lub --scope local. Działa to w skryptach, obrazach i środowiskach nieinteraktywnych, gdzie panel /plugin jest niedostępny. Ponieważ instalacja odbywa się poza sesją, otwarta sesja wymaga /reload-plugins, aby zmiany wprowadzone przez wtyczkę zaczęły obowiązywać.

Czy instalacja wtyczki z marketplace znalezionego na GitHub jest bezpieczna?

Traktuj to tak samo, jak uruchamianie skryptu instalacyjnego z tego repozytorium na własnym koncie, ponieważ jest to zbliżone działanie. Wtyczka może wykonywać polecenia powłoki poprzez hooki, dodawać pliki wykonywalne do PATH narzędzia Bash oraz uruchamiać serwery MCP – wszystko to z uprawnieniami użytkownika. Anthropic nie kontroluje ani nie weryfikuje zawartości wtyczek firm trzecich. Instaluj tylko ze źródeł, które możesz przejrzeć, sprawdź listę Will install przed potwierdzeniem i zachowaj większą ostrożność na serwerze niż na laptopie, ponieważ konto serwerowe zazwyczaj przechowuje klucze i tokeny, które mogą stać się celem ataku.