Workbranch › Poradniki

Jak instalować wtyczki w Claude Code

Wtyczki (plugins) łączą skille, agentów, hooki i serwery MCP w jedną instalację. Ten poradnik pokazuje, skąd pochodzą wtyczki, jak zainstalować wtyczkę w terminalu, jaki zakres wybrać i jak ją później zaktualizować lub usunąć.

Zaktualizowano 30 października 2026

Kroki opisane poniżej są zgodne z dokumentacją Claude Code od Anthropic z października 2026. Dotyczą terminala; aplikacja desktopowa i VS Code mają własne ekrany wtyczek, krótko opisane dalej. Interfejs Claude Code jest po angielsku, więc nazwy kart i opcji podajemy w oryginale. Dopiero zaczynasz z Claude Code? Zacznij od poradnika jak zacząć pracę z Claude Code.

Marketplace: skąd pochodzą wtyczki

Marketplace to katalog wtyczek. Claude Code rejestruje oficjalny marketplace Anthropic, claude-plugins-official, przy pierwszym otwarciu interaktywnej sesji w terminalu, więc jego wtyczki są od razu gotowe do instalacji. Każdy inny (katalog współpracownika, marketplace społeczności Anthropic, firmowe repozytorium) trzeba raz dodać, zanim zainstalujesz z niego wtyczkę.

1. Uruchom Claude Code poleceniem claude.
2. Uruchom /plugin marketplace add, a po nim podaj źródło:
   • Repozytorium GitHub: /plugin marketplace add owner/repo (dodaj #v1.2.0, żeby przypiąć tag lub gałąź)
   • Dowolny inny serwer git: pełny adres do klonowania, razem z https://
   • Folder na twoim komputerze: ścieżka zaczynająca się od ./ lub ../
   • Plik katalogu w sieci: adres https:// jego pliku marketplace.json
3. Poczekaj na komunikat Successfully added marketplace. Jego wtyczki pojawią się teraz na karcie Discover.

W przypadku prywatnego repozytorium Claude Code używa danych logowania git, które już masz na komputerze, i nigdy nie pyta o hasło, więc najpierw upewnij się, że zwykłe git clone tego repozytorium działa.

Zainstaluj wtyczkę

1. Uruchom /plugin install name@marketplace, na przykład /plugin install commit-commands@claude-plugins-official. W sesji otwiera to szczegóły wtyczki zamiast od razu ją instalować. Żeby przeglądać, uruchom samo /plugin, pisz na karcie Discover, żeby wyszukać, i naciśnij Enter na wtyczce.
2. Przeczytaj panel szczegółów. Will install (Zainstaluje) wymienia polecenia, agentów, skille, hooki i serwery, które dodaje. Dla wtyczek z oficjalnego marketplace Anthropic pokazuje też Last updated (Ostatnia aktualizacja), a gdy otwierasz wtyczkę poleceniem instalacji lub z karty Marketplaces, także szacunek Context cost (koszt kontekstu) w tokenach.
3. Wybierz zakres (zobacz tabelę poniżej).
4. Przeczytaj ostatnią linię podsumowania instalacji. Plugin is now active oznacza, że gotowe. Jeśli każe uruchomić /reload-plugins, Claude Code zrobi to za ciebie po zamknięciu panelu. Jeśli dołączony serwer wymaga konfiguracji, otwórz wtyczkę na karcie Installed (Zainstalowane) i wybierz Configure (Konfiguruj).
5. Sprawdź, czy zadziałało: wpisz / i poszukaj skilli wtyczki w postaci /plugin-name:skill albo uruchom w powłoce claude plugin list.

Skrót dla marketplace, którego jeszcze nie dodałeś: /plugin install name --marketplace owner/repo dodaje go (po prośbie o potwierdzenie) i od razu otwiera wtyczkę. W sesji wymaga to Claude Code w wersji v2.1.275 lub nowszej.

Jaki zakres wybrać

Zakres projektu włącza wtyczkę dla współpracowników, ale jej za nich nie pobiera: każdy z nich raz uruchamia claude plugin install name@marketplace --scope project. Gdy wtyczka jest ustawiona w kilku zakresach, lokalny wygrywa z projektowym, a projektowy z użytkownika.

Aktualizowanie wtyczek

• Automatycznie: domyślnie włączone dla oficjalnego marketplace Anthropic, domyślnie wyłączone dla marketplace społeczności, zewnętrznych i lokalnych. Włączysz lub wyłączysz to dla każdego marketplace na karcie Marketplaces w /plugin opcją Enable auto-update lub Disable auto-update.
• Co zobaczysz: trwająca sesja zachowuje starą wersję. Komunikat poprosi o uruchomienie /reload-plugins; w przeciwnym razie nowa wersja wczyta się w następnej sesji.
• Jedna wtyczka od razu: otwórz ją na karcie Installed i wybierz Update now (Aktualizuj teraz) albo uruchom claude plugin update name@marketplace.
• Wszystkie wtyczki z jednego marketplace: wybierz marketplace na karcie Marketplaces i wybierz Update marketplace. Nie ma polecenia, które za jednym razem aktualizuje wszystkie twoje wtyczki ze wszystkich marketplace.

Wyłączanie i odinstalowywanie wtyczki

1. Uruchom /plugin i naciśnij Tab, żeby przejść do Installed.
2. Naciśnij Space (spację) na wtyczce, żeby ją wyłączyć lub włączyć, albo naciśnij Enter i wybierz Disable plugin (Wyłącz wtyczkę) lub Uninstall (Odinstaluj).
3. Z powłoki użyj claude plugin disable, enable lub uninstall z name@marketplace; w razie potrzeby dodaj --scope project.

Nagłówek Not used recently (Nieużywane ostatnio) na karcie Installed to szybki sposób na znalezienie wtyczek, które wciąż zużywają kontekst w każdej sesji. Usunięcie całego marketplace (/plugin marketplace remove name) odinstalowuje też wszystkie wtyczki, które z niego zainstalowałeś.

Warto wiedzieć

• Zaufanie: wtyczka może uruchamiać hooki i serwery MCP na twoim komputerze. Przeczytaj panel szczegółów, zanim zainstalujesz cokolwiek z marketplace, którego nie znasz.
• Inne aplikacje: w aplikacji desktopowej na karcie Code kliknij + obok pola promptu i wybierz Add plugins (Dodaj wtyczki). W VS Code wpisz /plugins, żeby otworzyć Manage plugins (Zarządzaj wtyczkami).
• Wtyczki z claude.ai: wtyczki włączone na twoim koncie claude.ai synchronizują się do sesji w terminalu i pokazują się jako name@synced. Usuwaj je na claude.ai.
• Zasady firmy: wtyczki zainstalowane przez twoją organizację mają zakres Managed (zarządzany) i nie możesz ich usunąć.

Jeśli to nie działa

• Adres marketplace jest odrzucany: dodaj https://. Sam adres gitlab.example.com/group/repo.git jest odczytywany jako skrót GitHub i nie działa.
• Polecenia nie pojawiają się po instalacji: uruchom /reload-plugins. Jeśli podsumowanie mówiło The plugin couldn't be loaded, otwórz kartę Errors (Błędy) w /plugin, żeby poznać przyczynę.
• „/plugin isn't available in this environment”: pracujesz w trybie nieinteraktywnym, takim jak claude -p. Użyj zamiast tego poleceń powłoki claude plugin.
• Współpracownikowi brakuje wtyczki projektu: jest włączona w repozytorium, ale nie zainstalowana na jego komputerze; musi uruchomić polecenie instalacji z --scope project.

Śledź, co każda sesja zostawia otwarte

Jeśli pracujesz w wielu sesjach Claude Code, wtyczkę Workbranch dla Claude Code instaluje się tak samo jak każdą inną. Powiedz „save this to Workbranch” (zapisz to w Workbranch), a Claude zapisze zadania, decyzje i otwarte pytania z sesji w projekcie, a gdy zaczniesz sesję w folderze połączonym z tym projektem, pokaże, co jest jeszcze otwarte. Szczegóły znajdziesz na stronie Workbranch dla Claude.

Źródła

• Claude Code user FAQ (Centrum pomocy Claude, sprawdzono 30 października 2026)
• Install and manage plugins (Claude Code Docs, sprawdzono 30 października 2026)

Najczęściej zadawane pytania