Jak tworzyć wtyczki Claude Code: przewodnik krok po kroku

Claude Code radzi sobie z większością zadań developerskich od razu po instalacji, ale każdy zespół ma swoje procesy, których domyślne ustawienia nie obejmują. Możesz chcieć niestandardowej komendy do tworzenia szkieletu komponentów w preferowanej strukturze twojej firmy, automatycznego lintingu przed każdym commitem albo szybkiego dostępu do dokumentacji frameworka, którego stale używasz.

Wtyczki Claude Code pozwalają dodać te funkcje samodzielnie. Możesz instalować wtyczki stworzone przez społeczność lub tworzyć własne.

Jeśli dopiero poznajesz narzędzie do kodowania agentowego Anthropic, polecam zacząć od Przewodnika po Claude Code lub kursu Wprowadzenie do modeli Claude. Ten tutorial zakłada, że masz już zainstalowane Claude Code i używałeś go do podstawowych zadań.

Na końcu będziesz wiedzieć, jak:

• Znajdować i instalować wtyczki z katalogu Anthropic i źródeł społecznościowych
• Zrozumieć trzy typy komponentów, które mogą zawierać wtyczki
• Wybrać właściwy typ do różnych zastosowań
• Budować i udostępniać własne wtyczki

Aby poznać możliwości najnowszego modelu Anthropic, zajrzyj do naszego przewodnika o Claude Sonnet 5.

TL;DR

• Wtyczki Claude Code łączą skills, serwery MCP i hooks w pakiety do udostępniania, które instalujesz poleceniem claude plugin add

• Skills ładują się na żądanie (~100 tokenów każdy); serwery MCP wstępnie ładują definicje narzędzi (ograniczone przez Tool Search); hooks uruchamiają się jako skrypty shellowe bez kosztu tokenów

• Używaj skills do wiedzy i workflow, serwerów MCP do dostępu do zewnętrznych API, a hooks do reguł, które muszą uruchamiać się za każdym razem

• Zbuduj wtyczkę trzema plikami: manifest .claude-plugin/plugin.json, katalog skills/ i plik instrukcji SKILL.md

Czym są wtyczki Claude Code?

Wtyczka to pakiet, który łączy jedno lub więcej rozszerzeń Claude Code, ułatwiając ich udostępnianie i instalację. Zamiast ręcznie kopiować pliki konfiguracyjne między maszynami czy członkami zespołu, możesz spakować wszystko we wtyczkę i dystrybuować ją jako jeden element.

Wtyczki mogą zawierać trzy typy komponentów:

• Skills: Niestandardowe komendy wywoływane przez /skill-name albo kontekstowe podpowiedzi, których Claude używa automatycznie, gdy są istotne

• Serwery MCP: Połączenia z zewnętrznymi usługami i API, które dają Claude dostęp do danych, których inaczej by nie miał

• Hooks: Skrypty shellowe uruchamiane automatycznie przy określonych zdarzeniach, np. przed edycją pliku lub po commicie

Wtyczka może zawierać tylko jeden z tych elementów lub łączyć kilka współpracujących ze sobą. „Wdrożeniowa” wtyczka mogłaby zawierać skill /deploy do ręcznych wdrożeń, serwer MCP sprawdzający status środowiska staging oraz hook uruchamiający testy przed wykonaniem dowolnej komendy wdrożeniowej.

Plik manifestu plugin.json definiuje zawartość wtyczki. Określa, które skills, serwery MCP i hooks zainstalować, wraz z metadanymi takimi jak nazwa, wersja i autor. Podczas instalacji wtyczki Claude Code czyta ten manifest i umieszcza każdy komponent we właściwym miejscu.

Taki format pakowania oznacza, że nie musisz znać wewnętrznej struktury plików rozszerzeń Claude Code. Instalujesz wtyczkę, a wszystko trafia tam, gdzie trzeba.

Wyszukiwanie i instalacja wtyczek Claude Code

Większość wtyczek znajduje się w dwóch miejscach. Oficjalny katalog Anthropic na claude.com/plugins obejmuje wtyczki stworzone przez Anthropic, zweryfikowane wkłady społeczności i popularne rozszerzenia firm trzecich. Każda pozycja pokazuje, jakie komponenty zawiera wtyczka, informacje o kompatybilności i instrukcje instalacji.

Drugim źródłem jest GitHub:

Gdy znajdziesz interesującą wtyczkę, komenda instalacyjna zależy od miejsca, w którym się znajduje:

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

Po zainstalowaniu kilku wtyczek warto nad nimi panować. Komenda plugin obsługuje listowanie, aktualizacje i usuwanie:

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

Jedną z decyzji podczas instalacji jest zakres. Wtyczki mogą działać w dwóch miejscach: w zakresie użytkownika instalują się do ~/.claude/plugins/ i działają we wszystkich twoich projektach, a w zakresie projektu instalują się do .claude/plugins/ w konkretnym repozytorium.

Domyślny jest zakres użytkownika. Aby zainstalować wtyczkę tylko dla bieżącego projektu, dodaj flagę --project:

claude plugin add @anthropic/deploy-helper --project

Wtyczki w zakresie projektu mają sens, gdy rozszerzenie jest powiązane z konkretną bazą kodu. 

Wtyczka znająca proces wdrażania w twojej firmie należy do tego projektu. Wtyczka formatująca kod według twoich osobistych preferencji należy do poziomu użytkownika. Gdy wtyczka istnieje na obu poziomach, wersja projektowa ma pierwszeństwo, co pozwala zespołom egzekwować specyficzne konfiguracje projektu, a deweloperom zachować swoje osobiste wtyczki aktywne gdzie indziej.

Wybór odpowiedniego typu wtyczki Claude Code

Trzy typy komponentów służą różnym celom i zużywają tokeny okna kontekstu w inny sposób. Zrozumienie tych kompromisów pomaga dobrać właściwy typ do każdego zadania.

Skills vs serwery MCP: kompromis tokenów

Serwery MCP ładują wszystkie definicje narzędzi do okna kontekstu przy starcie sesji. Każde narzędzie potrzebuje nazwy, opisu i pełnego schematu parametrów, co zwykle kosztuje 100–300 tokenów na narzędzie. Konfiguracja z pięcioma serwerami zużywa około 55 000 tokenów, zanim napiszesz choć jeden znak:

• GitHub: 35 narzędzi
•  Slack: 11 narzędzi
• Sentry: 5 narzędzi
• Grafana: 5 narzędzi
• Splunk: 2 narzędzia

Jedna analiza wykazała, że konfiguracje z 7+ serwerami zużywają 67 000+ tokenów, czyli jedna trzecia twojego okna kontekstu 200K znika, zanim rozmowa się zacznie.

Skills podchodzą do tego inaczej, poprzez progresywne ujawnianie. Na starcie sesji Claude widzi tylko nazwę i jednolinijkowy opis każdego skill z front matter YAML, około 100 tokenów na skill. 

Pełne instrukcje ładują się dopiero, gdy Claude uzna, że dany skill jest istotny dla bieżącego zadania. Pliki referencyjne ładują się tylko wtedy, gdy są konkretnie potrzebne. A skrypty w ogóle nie trafiają do okna kontekstu; Claude uruchamia je na zewnątrz, a wraca jedynie wynik.

Anthropic zaadresował tę nierównowagę pod koniec 2025 roku dzięki funkcji Tool Search, która wprowadza leniwe ładowanie dla serwerów MCP. 

Zamiast wstępnie ładować wszystkie definicje narzędzi, Claude Code wykrywa, kiedy opisy narzędzi pochłonęłyby ponad 10% dostępnego kontekstu i przełącza się na ładowanie na żądanie. 

Testy wewnętrzne pokazały spadek użycia kontekstu z ~134 000 tokenów do ~5 000 tokenów dla dużych bibliotek narzędzi. Poprawiła się też trafność wyboru narzędzi: Opus 4 skoczył z 49% do 74%, a Opus 4.5 z 79,5% do 88,1% w ewaluacjach MCP.

Oto jak zdecydować między nimi.

Skills najlepiej sprawdzają się, gdy chcesz, by Claude miał dostęp do wiedzy lub workflow, które może stosować z wyczuciem. Skill opisujący checklistę code review twojego zespołu zostanie załadowany, gdy Claude recenzuje kod, ale to Claude decyduje, jak zastosować każdy punkt w kontekście. 

Skills mają też sens przy operacjach wymagających skryptów do cięższych obliczeń, bo kod skryptu pozostaje poza oknem kontekstu.

Serwery MCP najlepiej nadają się, gdy Claude potrzebuje danych w czasie rzeczywistym ze zewnętrznych usług, takich jak wiadomości Slack, PR-y GitHuba czy zapytania do bazy. To także właściwy wybór, gdy wiele agentów AI potrzebuje tych samych narzędzi lub gdy potrzebujesz funkcji klasy enterprise, jak dzienniki audytu i jawne uprawnienia.

Wiele konfiguracji łączy oba podejścia: skills dostarczają „jak” i „kiedy” poprzez instrukcje w języku naturalnym, a serwery MCP obsługują właściwe wywołania API.

Popularne skills do Claude Code, warte instalacji

• Superpowers (nasz tutorial): 20+ przetestowanych w produkcji workflow do TDD, debugowania i planowania strukturalnego
• frontend-design: Instrukcje dla Claude, by unikał generycznej estetyki i podejmował odważne decyzje projektowe
• mcp-builder: Przewodnik po tworzeniu serwerów MCP do integracji zewnętrznych API
•  webapp-testing: Testowanie lokalnych aplikacji webowych z użyciem Playwright do weryfikacji UI
•  skill-creator: Interaktywne narzędzie prowadzące przez tworzenie nowych skills

Popularne serwery MCP, które warto podłączyć

• Context7: Wyszukiwanie dokumentacji w czasie rzeczywistym i dla konkretnych wersji
• GitHub: Wyszukiwanie w repozytorium, zarządzanie PR-ami, śledzenie zgłoszeń
• Playwright: Automatyzacja przeglądarki z użyciem drzew dostępności zamiast zrzutów ekranu
• Supabase: Zapytania do bazy z uwzględnieniem Row Level Security
• Sentry: Śledzenie błędów i wydajności bezpośrednio w edytorze

Możesz też przeczytać nasz przewodnik po najlepszych zdalnych serwerach MCP.

Hooks: warstwa deterministyczna

Hooks stoją całkiem poza sporem skills kontra MCP. Podczas gdy zarówno skills, jak i serwery MCP są skierowane do Claude (Claude decyduje, kiedy ich użyć), hooks są skierowane do systemu. Uruchamiają się przy zdarzeniach takich jak PreToolUse czy PostToolUse, uruchamiając skrypty shellowe przed lub po podjęciu przez Claude konkretnych działań. Claude nie ma wpływu na to, czy hook się uruchomi.

To sprawia, że hooks są właściwym wyborem, gdy coś musi wydarzyć się bez wyjątku: linting przed każdym commitem, blokowanie zapisów do chronionych katalogów, logowanie każdej komendy bash lub uruchamianie testów przed wdrożeniem.

Ta deweloperka poleca hooks „block-at-submit” zamiast „block-at-write”. Zatrzymywanie Claude w środku zadania wprowadza agenta w konsternację i pogarsza wyniki. Jej zespół używa hooka PreToolUse, który opakowuje Bash(git commit) i sprawdza plik tymczasowy istniejący tylko, jeśli testy przeszły. Brak pliku, brak commita. Agent kończy pracę, a walidacja odbywa się na końcu.

Hooks nie dodają żadnych kosztów tokenów, bo są uruchamiane jako skrypty shellowe poza oknem kontekstu.

Przydatne hooki Claude do skonfigurowania

• ESLint/Prettier przy edycji: Automatyczne formatowanie plików po zapisaniu przez Claude
• Bramka testów przy commicie: Blokuj commity, jeśli testy nie przeszły
• Chronione ścieżki: Uniemożliwiaj zapisy do migrations, configs lub vendor
• Powiadomienie po zakończeniu: Wysyłaj alerty Slack lub systemowe, gdy długie zadania się kończą
• Kopia zapasowa transkryptu: Zapisuj historię rozmowy przed uruchomieniem kompakcji

Jak zbudować własne wtyczki Claude Code

Gdy skill znajduje się w twoim prywatnym katalogu .claude/, tylko ty możesz go używać. Spakowanie go jako wtyczki pozwala udostępniać go współpracownikom lub używać ponownie w innych projektach.

Zbudujemy wtyczkę o nazwie session-logger, która dodaje komendę /session-logger:summarize. Po wywołaniu Claude przegląda rozmowę i dopisuje ustrukturyzowane podsumowanie do SESSION_LOG.md.

Utwórz strukturę wtyczki

Wtyczki mogą znajdować się gdziekolwiek w systemie plików. W tym tutorialu utworzymy jedną w twoim katalogu domowym:

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

To tworzy:

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Napisz manifest

Utwórz ~/session-logger/.claude-plugin/plugin.json:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

Pole name staje się prefiksem przestrzeni nazw. Wszystkie komendy w tej wtyczce będą zaczynać się od /session-logger:.

Napisz skill

Utwórz ~/session-logger/skills/summarize/SKILL.md:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

Linia disable-model-invocation: true mówi Claude, że tylko ty możesz wyzwolić ten skill. Bez tej flagi Claude mógłby autonomicznie zdecydować o uruchomieniu komendy, jeśli uzna, że pomoże to rozmowie. W przypadku loggera czy narzędzia do wdrożeń zwykle chcesz mieć kontrolę ręczną.

Przetestuj lokalnie

Przejdź do dowolnego projektu, w którym chcesz użyć wtyczki, a następnie uruchom Claude Code z flagą --plugin-dir wskazującą na twoją wtyczkę:

cd ~/your-project
claude --plugin-dir ~/session-logger

Wpisz /session-logger:summarize, aby wywołać komendę. Zwróć uwagę, że komendy wtyczek nie pojawiają się w podpowiedziach autouzupełniania, dopóki nie wpiszesz pełnej nazwy. Tekst zmienia kolor na niebieski, gdy Claude Code rozpozna go jako poprawną komendę.

Po wykonaniu pracy w sesji uruchom komendę. Claude przejrzy rozmowę i dopisze wpis do SESSION_LOG.md w bieżącym katalogu projektu.

Udostępnij innym

Wypchnij wtyczkę na GitHuba. Aby dystrybuować ją szerzej niż przez ręczne klonowanie, dodaj ją do marketplace'u wtyczek. Przewodnik po marketplace'ach opisuje tworzenie własnego marketplace'u lub zgłaszanie do istniejących.

Na koniec

Wtyczki zmieniają Claude Code z uniwersalnego asystenta w narzędzie dopasowane do twojego workflow. Zbudowany przez nas logger sesji zajął około pięciu minut i trzy pliki. Większość przydatnych wtyczek nie jest wiele bardziej skomplikowana.

Jeśli podążałeś krok po kroku, masz teraz działającą wtyczkę na swojej maszynie. Spróbuj ją podrasować: zmień format podsumowania, dodaj nowe sekcje albo zastąp ją czymś, czego twój zespół naprawdę potrzebuje. Struktura pozostaje taka sama, niezależnie czy budujesz szybkie narzędzie osobiste, czy coś dla setek deweloperów.

Dodatkowo, przy okazji przejrzyj repozytoria społeczności. Zobaczenie, jak inni strukturują swoje wtyczki, uczy wzorców, których dokumentacja nie odda.

Aby wejść głębiej w Claude Code, sprawdź nasze tutoriale o najlepszych praktykach Claude Code, frameworku skills Superpowers, komendach slash dla dłuższych sesji oraz bezpieczeństwie i uprawnieniach. Jeśli chcesz dowiedzieć się więcej o modelach Claude, polecam kurs Wprowadzenie do modeli Claude.