# Claude Code zwalnia: jak wybrać Skills, Subagents, MCP i Plugins

> Porównanie rozszerzeń Claude Code, zużycia kontekstu, siedmiu błędów i minimalnej działającej konfiguracji z zachowaniem przykładów technicznych.

Source: https://ailoot.ai/blog/pl/claude-code-skills-subagents-mcp-plugins/
Canonical: https://ailoot.ai/blog/pl/claude-code-skills-subagents-mcp-plugins/
Language: pl
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-038
Revision: sha256-c28af085a7e506e110b17f30443ce97226cde6ddff2ac104c010626f31b2588c


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Skill to wielokrotnie używana instrukcja ładowana po spełnieniu warunku wyzwalającego (około 100 tokenów w stanie bezczynności). Subagent to odizolowany kontekst 200K z własnymi uprawnieniami. MCP łączy zewnętrzne dane i API. Plugin to gotowy pakiet pierwszych trzech elementów. Główna formuła na 2026 rok: subagent Haiku + wstępnie załadowany skill z konwencjami + jeden MCP o wąsko określonym zakresie do danych na żywo. Reszta albo halucynuje, albo przepełnia kontekst.

</div>



<div class="aside" data-semantic="ailoot-docs-link" aria-label="Ailoot documentation">

Praktyczne instrukcje korzystania z Ailoot znajdziesz w [dokumentacji](https://ailoot.ai/docs/).

</div>

## Dlaczego „upychanie wszystkiego w Claude Code” stało się w 2026 roku największym problemem?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

W czerwcu 2026 roku Claude Code oferuje cztery mechanizmy rozszerzeń: skill, subagent, MCP i plugin. Oficjalny rejestr zawiera 101 plugins, a społecznościowe katalogi — tysiące. Pokusa, by instalować wszystko, sprawia, że Claude zwalnia, myli podobne funkcje i zużywa limity przy każdej wiadomości. Główne pytanie odbiorców brzmi: którego mechanizmu użyć do danego zadania, żeby nie zmienić agenta w składowisko?

</div>

Nawet oficjalna dokumentacja nie zawierała gotowej, całościowej odpowiedzi na pytanie „kiedy wybrać co?”.

Opisane w tym artykule doświadczenia z miesiąca obejmują wszystkie cztery mechanizmy w działających projektach: zestaw subagents do jednego złożonego zadania, niewielki zbiór skills do powtarzalnych procedur, kilka serwerów MCP do danych na żywo oraz wybór kilku plugins z około dwóch tuzinów. Ten przewodnik zbiera przykłady w macierzy wyboru, zawiera gotowe drzewo decyzyjne, cytaty Anthropic i siedem antywzorców, przez które Claude staje się bezużyteczny.

## Czym skill różni się od subagenta, MCP i plugina? Jedna tabela

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Cztery mechanizmy to cztery warstwy jednej architektury. Skill uczy Claude procedury. Subagent izoluje zadanie w osobnym kontekście. MCP łączy zewnętrzne dane. Plugin łączy pierwsze trzy elementy w jeden pakiet. Każdy ma własną klasę zadań, zużycie tokenów i ryzyko zaśmiecenia kontekstu. Konflikty pojawiają się tylko wtedy, gdy wybierzesz niewłaściwą warstwę.

</div>

Macierz wyboru:

| Właściwość | Skill | Subagent | Serwer MCP | Plugin |
|----|----|----|----|----|
| Odizolowany kontekst | Nie | **Tak** (nowy 200K) | Nie | Za pośrednictwem własnych subagents |
| Zewnętrzne dane i API | Nie | Tylko przez przypisany MCP | **Tak** | Za pośrednictwem własnych serwerów MCP |
| Oszczędność tokenów | 70–90% (progressive disclosure) | Do 70% przy złożonych zadaniach | Zależy od wyszukiwania narzędzi | Zależy od zawartości pakietu |
| Ograniczenia narzędzi | Przez `allowed-tools` | Ścisłe, w frontmatter | Przez subagenta lub politykę | Część pakietu |
| Wybór tańszego modelu | Przez pole `model` | **Tak**, w frontmatter | Nie dotyczy | Za pośrednictwem własnych subagents |
| Czas konfiguracji | Kilka minut | Kilka minut | Od kilku godzin do kilku dni | Jedno kliknięcie w marketplace |
| Główny przypadek użycia | Listy kontrolne, konwencje, styl | Delegowane zadanie z dużą ilością szumu | Baza danych, API, dane na żywo | Gotowy workflow społeczności |
| Główna pułapka | Rozrośnięty SKILL.md powyżej 500 linii | Subagent z uprawnieniami na poziomie rodzica | Więcej niż 3 serwery MCP | Pakiet z nieprzeczytaną zawartością |

Prosta analogia dla przedsiębiorcy: wyobraź sobie, że jesteś CEO dziesięcioosobowej firmy:

- **CLAUDE.md** — statut firmy. Zawsze wisi na ścianie, wszyscy go czytają i nikt z nim nie dyskutuje.
- **Skill** — wewnętrzna procedura. „Jak przeprowadzamy przeglądy”, „jak piszemy informacje o wydaniu”, „jak przyjmujemy płatności”.
- **Subagent** — specjalista z osobnym biurem i wąską listą uprawnień. Jeśli dasz mu klucze do wszystkiego, dostaniesz drugiego CEO, a nie pracownika.
- **Serwer MCP** — systemy firmowe: CRM, bank, magazyn. To nie jest wiedza, tylko połączenie.
- **Plugin** — gotowe rozwiązanie ze sklepu. Pakiet procedur, specjalistów i integracji w jednym pudełku.

Gdy zrozumiesz, że są to cztery warstwy jednego systemu, a nie czterej konkurenci, pytanie „co jest lepsze?” znika. Pozostaje pytanie „co gdzie umieścić?”.

## Czym jest skill w Claude Code i kiedy warto go zainstalować?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Skill to folder zawierający plik `SKILL.md` (frontmatter YAML + instrukcje Markdown), umieszczony w `~/.claude/skills/<name>/` albo w projekcie, w `.claude/skills/<name>/`. Działa przez progressive disclosure: podczas uruchamiania ładowane są tylko nazwa i opis (około 100 tokenów); cała treść jest pobierana dopiero wtedy, gdy zadanie pasuje do warunku wyzwalającego. To najtańszy z czterech mechanizmów w stanie bezczynności.

</div>

Oficjalna definicja Anthropic:

<figure>
<blockquote>
<p>Skills to zasoby plikowe wielokrotnego użytku, które zapewniają Claude wiedzę dziedzinową: workflow, kontekst i dobre praktyki, zmieniające agenta ogólnego przeznaczenia w specjalistę.</p>
</blockquote>
<figcaption>— Anthropic Docs, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview</figcaption>
</figure>

Skill ma trzy poziomy:

1.  **Metadane.** Zawsze ładowane podczas uruchamiania sesji: nazwa i opis z frontmatter. Jeden skill zużywa przy starcie około 100 tokenów.
2.  **Instrukcje.** Ładowane tylko wtedy, gdy Claude otrzyma pasujące żądanie wyzwalające. Do 5,000 tokenów — czyli treść SKILL.md.
3.  **Zasoby.** Ładowane tylko wtedy, gdy instrukcje wyraźnie się do nich odwołują. Pliki pakietu, skrypty w `scripts/`, materiały referencyjne w `references/`. Skrypty są uruchamiane przez `bash`; sam kod nie trafia do kontekstu.

Anthropic nazywa tę zasadę progressive disclosure:

<figure>
<blockquote>
<p>Progressive disclosure to podstawowa zasada projektowania, która zapewnia Agent Skills elastyczność i skalowalność.</p>
</blockquote>
<figcaption>— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills</figcaption>
</figure>

W tym samym artykule znajduje się metafora, która lepiej niż cokolwiek innego wyjaśnia tę ideę:

<figure>
<blockquote>
<p>Tworzenie skilla dla agenta przypomina pisanie przewodnika wdrożeniowego dla nowego pracownika.</p>
</blockquote>
<figcaption>— Anthropic Engineering, https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills</figcaption>
</figure>

**Kiedy używać skilla:**

- Gdy wielokrotnie powtarzasz standardową procedurę. Przeglądy PR-ów, informacje o wydaniach, przegląd kodu zgodny z twoim przewodnikiem stylu.
- Gdy sekcja w `CLAUDE.md` zmieniła się z informacji w procedurę i zaczyna przeszkadzać we wszystkim innym.
- Gdy chcesz, by ta sama instrukcja była konsekwentnie stosowana w różnych projektach.

Praktyczna zasada: **jeśli robisz coś więcej niż kilka razy, przekaż to systemowi**. Za pierwszym razem użyj ręcznego promptu. Za drugim razem warto rozważyć skill.

**Kiedy NIE używać skilla:**

- Jeśli zadanie wymaga **danych na żywo** (bazy danych, API, wyszukiwania, bieżących danych giełdowych). Do tego służy MCP, nie skill. Skill próbujący „pobrać aktualną cenę” będzie halucynować.
- Jeśli zadanie wymaga **odizolowanego kontekstu**. Do tego służy subagent.
- Jeśli potrzebujesz **egzekwowanego sprawdzenia** („zablokuj commit zawierający .env”), użyj hooka dla objętej nim ścieżki commitowania zamiast polegać na skillu. Sprawdź i przetestuj rzeczywisty zakres ochrony; hook nie blokuje wszystkich sposobów odczytywania, kopiowania lub publikowania pliku.

Ograniczenia, które warto znać wcześniej:

- Nazwa skilla może mieć maksymalnie 64 znaki i zawierać tylko małe litery, cyfry oraz łączniki. Słowa `anthropic` i `claude` są zarezerwowane.
- Opis może mieć maksymalnie 1,024 znaki. W wykazie łączna wartość `description` + `when_to_use` jest ucinana do 1,536 znaków.
- Zalecana długość treści SKILL.md to nie więcej niż 500 linii. Dłuższe materiały przenieś do `references/` i `scripts/`.
- Podczas automatycznej kompakcji kontekstu (auto-compaction) ponownie dołączane jest pierwszych 5,000 tokenów każdego aktywnego skilla. Łączny limit dla wszystkich skills wynosi 25,000.

## Czym jest subagent i dlaczego istnieje 5 poziomów zagnieżdżenia?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Subagent to podrzędny Claude z własnym kontekstem na 200K tokenów, system promptem, ograniczoną listą narzędzi i niezależnymi uprawnieniami. Jego głównym celem jest izolacja: zaszumione wyszukiwania, długie logi i prace eksploracyjne pozostają w subagencie, a do głównego kontekstu wraca tylko końcowe podsumowanie. Od 10 czerwca 2026 roku subagents mogą być zagnieżdżane rekurencyjnie do 5 poziomów.

</div>

Z oficjalnej dokumentacji:

<figure>
<blockquote>
<p>Subagents to wyspecjalizowani asystenci AI, którzy obsługują określone klasy zadań. Użyj subagenta, gdy zadanie poboczne mogłoby zapełnić główną rozmowę wynikami wyszukiwania, logami lub zawartością plików, do których nie będziesz wracać. Subagent wykonuje tę pracę we własnym kontekście i zwraca tylko podsumowanie.</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/sub-agents</figcaption>
</figure>

Claude Code ma trzy wbudowane subagents, z których już korzystasz, nawet o tym nie wiedząc:

| Subagent | Model | Dostęp | Zakres działania |
|----|----|----|----|
| **Explore** | Haiku | Tylko do odczytu | Wyszukiwanie kodu; oszczędza kontekst, pomijając CLAUDE.md i git status |
| **Plan** | Haiku | Tylko do odczytu | Tryb planowania — analizuje przed napisaniem kodu |
| **General-purpose** | Sonnet/Opus | Wszystkie narzędzia | Złożone zadania wieloetapowe |

10 czerwca 2026 roku Anthropic wydał Claude Code v2.1.172 i usunął ograniczenie obowiązujące od czasu wprowadzenia subagents: agenci potomni mogą teraz uruchamiać własne subagents do 5 poziomów w głąb.

Liczba 5 to górna granica bezpieczeństwa, a nie cel optymalizacji.

Szczegółowy opis funkcji z szablonami orchestratora w YAML znajduje się w [przewodniku po zagnieżdżonych subagents](https://ailoot.ai/blog/pl/claude-code-nested-subagents/).

**Kiedy używać subagenta:**

- Do eksploracji kodu lub logów, po której potrzebujesz tylko krótkiego wniosku.
- Do zadań równoległych, które mogą działać obok siebie.
- Do delegowania według specjalizacji: backend / frontend / test / review — każdy obsługuje jedną funkcję.
- Do kontroli kosztów: subagent Haiku zamiast Sonnet lub Opus. Koszt spada 5–7 razy.

**Kiedy NIE używać subagenta:**

- Przy jednorazowym, banalnym zadaniu lub prostym wywołaniu narzędzia. Uruchomienie subagenta ma swój koszt.
- Gdy zadania muszą współdzielić stan. Subagents nie widzą wzajemnie swoich kontekstów; powiązane prace powinny pozostać w głównym wątku.

Główny antywzorzec:

Przyznanie subagentowi Opus i dostępu do wszystkich narzędzi po prostu tworzy kolejną główną sesję. Jeśli jego lista narzędzi pokrywa się z listą głównego agenta, subagent nie jest odpowiednio ograniczony.

Innymi słowy, subagent z takimi samymi uprawnieniami jak rodzic to po prostu drugi CEO. Niepotrzebny i kosztowny.

## Czym jest serwer MCP i kiedy warto połączyć go z Claude Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

MCP (Model Context Protocol) to otwarty standard opracowany przez Anthropic, służący do łączenia AI z systemami zewnętrznymi: bazami danych, API, systemami plików i SaaS. Do czerwca 2026 roku obsługuje go Claude, ChatGPT, Cursor, VS Code i dziesiątki innych klientów. Strona modelcontextprotocol.io proponuje trafną metaforę: MCP to port USB-C dla aplikacji AI.

</div>

Oficjalna definicja:

<figure>
<blockquote>
<p>Pomyśl o MCP jak o porcie USB-C dla aplikacji AI. Tak jak USB-C ujednoliciło sposób łączenia urządzeń elektronicznych, MCP zapewnia standardowy sposób łączenia aplikacji AI z systemami zewnętrznymi.</p>
</blockquote>
<figcaption>— modelcontextprotocol.io, https://modelcontextprotocol.io/introduction</figcaption>
</figure>

Co MCP pozwala robić w praktyce:

- Połączyć Claude z Google Calendar i Notion, by stworzyć osobistego asystenta.
- Połączyć go z Figma, aby Claude generował gotowy projekt internetowy na podstawie projektu graficznego.
- Połączyć firmowego chatbota z kilkoma bazami danych jednocześnie.
- Połączyć Blender z drukarką 3D, aby tworzyć modele i od razu je drukować.

Najbardziej znane serwery MCP instalowane na początek:

| Serwer MCP | Co łączy | Skąd go pobrać |
|----|----|----|
| **Context7** | Aktualna dokumentacja dowolnej biblioteki | Plugin z claude-plugins-official |
| **GitHub** | Issues, PRs, repositories | claude-plugins-official |
| **Filesystem** | Pliki w dozwolonych folderach (w Claude Code — tylko foldery robocze) | Referencyjny serwer projektu MCP, repository modelcontextprotocol/servers |
| **Postgres** | Bezpośredni dostęp do bazy danych | Serwer referencyjny został wycofany; aktywnym zamiennikiem jest DBHub firmy Bytebase |
| **Magic MCP by 21st.dev** | Animacje i komponenty UI | Katalog MCP |
| **Slack / Linear / Jira / Notion** | Integracje do pracy | claude-plugins-official |

Informacje o połączeniach i poleceniach instalacyjnych zebrano w katalogu MCP.

**Kiedy używać MCP:**

- Przy każdym połączeniu z zewnętrznymi danymi lub działaniami: „pobierz wiersze z bazy danych”, „odczytaj zgłoszenia Jira”, „opublikuj na Slacku”.
- Gdy ten sam serwis jest potrzebny w wielu projektach lub agentom — łatwiej utrzymywać jeden scentralizowany serwer.

**Kiedy NIE używać MCP:**

- Do statycznej wiedzy lub procedur. To zadanie dla skilla, nie MCP. „Instrukcje przeprowadzania przeglądu kodu” to skill. „Przeczytaj najnowszy PR z GitHub i go zrecenzuj” wymaga MCP.
- Do jednorazowego polecenia CLI. Łatwiej użyć `Bash` niż konfigurować serwer.
- Gdy chcesz zbudować MCP „dla poprawnej architektury”. To kwestia estetyki, a nie zadanie.

Główna pułapka MCP to jedno z największych źródeł skarg, że „Claude Code zachowuje się głupio” w 2026 roku:

Jeśli zainstalujesz wszystkie te MCP naraz, zadusisz okno kontekstowe LLM: wszystkie dostępne narzędzia zostaną załadowane do kontekstu.

Praktyczna zasada: utrzymuj najwyżej 2–3 aktywne serwery MCP, każdy ukierunkowany na konkretne zadania. W opisanym doświadczeniu z wieloma serwerami uruchamianie trwało dłużej i częściej występowały błędy.

**MCP tool search** dodano w Claude Code v2.1.x: narzędzia nie są już ładowane zachłannie do kontekstu, lecz indeksowane i pobierane na żądanie. Zmniejsza to koszt „wielu MCP w projekcie”, ale nie eliminuje go całkowicie.

## Czym plugin różni się od skilla i dlaczego granica między nimi się zaciera?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Plugin to zapakowany zestaw. Może zawierać skill, subagent, serwer MCP i hook w dowolnej kombinacji. Anthropic połączyło wszystko w jeden format, aby można było instalować rozszerzenia jednym poleceniem `/plugin install` i aktualizować je automatycznie. Marketplace `claude-plugins-official` uruchomiono w lutym 2026 roku; do czerwca zawierał już 101 plugins. Różnica między „samodzielnym skillem” a „pluginem złożonym z jednego skilla” dotyczy wyłącznie sposobu pakowania.

</div>

Oficjalne sformułowanie:

<figure>
<blockquote>
<p>Plugins rozszerzają Claude Code o skills, agents, hooks i serwery MCP. Plugin marketplaces to katalogi, które pomagają znajdować i instalować te rozszerzenia bez konieczności samodzielnego ich składania. Można to porównać do połączenia ze sklepem z aplikacjami: po dodaniu sklepu masz dostęp do kolekcji, ale sam decydujesz, które aplikacje pobrać.</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/discover-plugins</figcaption>
</figure>

Liderzy pod względem liczby instalacji w czerwcu 2026 roku:

| Miejsce | Plugin | Instalacje | Zawartość |
|----|----|----|----|
| 1 | **Frontend Design** (Anthropic) | 829 316 | Skills + subagents do projektowania |
| 2 | **Context7** (Upstash) | 348 660 | Wrapper MCP do dokumentacji |
| 3 | **Code Review** (Anthropic) | 347 221 | 5 równoległych subagents do przeglądów |
| 4 | **Code Simplifier** | 284 632 | Skill + hook do upraszczania |
| 5 | **TypeScript LSP** | 177 136 | Plugin LSP |
| 6 | **Pyright LSP** | 91 225 | Plugin LSP |

Pełną analizę wyboru znajdziesz w przewodniku po 10 najlepszych plugins spośród 101.

**Kiedy używać plugina:**

- Gdy gotowy pakiet społecznościowy obejmuje dużą część workflow, na przykład projektowanie lub przegląd.
- Jeśli nie chcesz ręcznie składać zestawu „skill + subagent + MCP + hook”, możesz użyć gotowego rozwiązania.
- Do dystrybucji firmowej: administrator tworzy marketplace zespołu, a programiści instalują z jednego prefiksu.

**Kiedy NIE używać plugina:**

- Gdy do rozwiązania zadania wystarczy jeden skill, ale pakiet zawiera jeszcze pięć MCP „na wszelki wypadek”. To czyste zaśmiecanie kontekstu.
- Gdy plugin ma zamknięty kod źródłowy i nie można go skontrolować. Działa z twoimi uprawnieniami — przed instalacją przeczytaj jego zawartość.
- Gdy masz już własny plugin na ten sam temat. Duplikat w kontekście oznacza podwójny problem.

Claude Code v2.1.143+ przed instalacją pokazuje **Context cost**, czyli szacunkową liczbę tokenów, które plugin doda do każdej wiadomości. Od v2.1.145+ wyświetla również pole **Will install** z pełną listą commands, agents, skills, hooks, MCP i LSP zawartych w pakiecie. To pierwszy ekran, który należy otworzyć przed kliknięciem instalacji.



## Która macierz wyboru sprawdza się w 2026 roku?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Głównym elementem przewodnika jest drzewo decyzyjne z sześcioma pytaniami. Przechodź od góry do dołu i zatrzymaj się przy pierwszej odpowiedzi, która pasuje. Algorytm obejmuje 95% zadań. Pozostałe 5% to złożone scenariusze wymagające połączenia subagenta Haiku, wstępnie załadowanego skilla z konwencjami oraz serwera MCP o wąskim zakresie do danych na żywo. To „formuła 2026”, która się sprawdza.

</div>

Sześć pytań według priorytetu:

1.  **Czy to powtarzalna procedura, styl lub lista kontrolna?** Jeśli tak — **skill**.
2.  **Czy potrzebujesz zewnętrznych danych lub działań** (baza danych, API, Slack, GitHub, Figma)? Jeśli tak — **serwer MCP**.
3.  **Czy chcesz osobnego kontekstu**, żeby nie zaśmiecać głównego? Jeśli tak — **subagent**.
4.  **Czy potrzebujesz sprawdzenia lub automatycznego kroku przy określonym zdarzeniu?** Jeśli tak — **hook** z przetestowanym zakresem działania; szersze granice dostępu wymagają uprawnień lub izolacji środowiska.
5.  **Czy chcesz jednym kliknięciem otrzymać gotowy pakiet obejmujący elementy 1–4?** Jeśli tak — **plugin** z marketplace.
6.  **Czy to złożone zadanie wymagające danych, kontekstu i stylu?** Użyj wtedy **połączenia**: subagent Haiku + wstępnie załadowany skill + jeden MCP o wąskim zakresie.

Formuła połączenia:

Subagent Haiku z wstępnie załadowanym skillem zawierającym konwencje i serwerem MCP o wąskim zakresie do danych na żywo to wzorzec, który naprawdę się sprawdza.

Główna zasada dotycząca kierunku zależności:

Subagents mogą korzystać z serwerów MCP. Serwery MCP nie mogą korzystać z subagents.

Innymi słowy, MCP zawsze dostarcza dane i działania, a nie agentów. Jeśli chcesz delegować zadanie, to subagent wywołuje MCP, a nie odwrotnie.

Konkretny przykład opisany w tym artykule to silnik redakcyjny agencji cyfrowej, który pisze jeden artykuł SEO w 60 minut. Wewnątrz działa **25 subagents i 14 etapów przeglądu** — kolejno, każdy z własnym kontekstem, uprawnieniami i skillem zawierającym konwencje redakcyjne. Jeden subagent łączy się z serwerem MCP mającym bazę gotowych tagów i starszych artykułów. Główny orchestrator agent działa na Opus, a agenci potomni na Haiku, dzięki czemu budżet pozostaje rozsądny.

To nie jest „fabryka artykułów”, lecz przykład połączenia wszystkich czterech mechanizmów w jeden system, gdy zadanie wymaga wysokiej jakości, a nie szybkości.

## Które 7 błędów warto natychmiast usunąć z Claude Code?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Oto siedem głównych błędów omawianych w artykule. Każdy obniża jakość odpowiedzi i zużywa tokeny. Każdy można poprawić w 5–15 minut. Jeśli w zeszłym miesiącu zainstalowałeś ponad dziesięć plugins, niemal na pewno popełniasz co najmniej trzy z nich.

</div>

1.  **Zainstalowano wszystkie 10 najlepszych plugins, „bo są na czasie”.** Każdy dodaje tokeny do każdej wiadomości. Otwórz `/plugin list` i sprawdź Context cost każdego pluginu. Usuń te, których nie używasz od dwóch tygodni.

2.  **Skopiowano 15 serwerów MCP z cudzego `.mcp.json`.** Konfiguracja innej osoby jest dostosowana do jej projektu i zadań. W bieżącym projekcie utrzymuj nie więcej niż 2–3 aktywne MCP. Przenieś pozostałe do osobnej konfiguracji dla innego projektu albo usuń je teraz.

3.  **Skill i plugin MCP robią to samo.** Skill mówi „przeprowadź przegląd kodu”, a plugin `pr-review-toolkit` uruchamia własny proces przeglądu. Zaczynają konkurować o priorytet. Objaw: „Claude, dlaczego ciągle zmieniasz zdanie?”. Rozwiązanie: pozostaw jedno źródło prawdy. W opisanej konfiguracji wybrano skill, aby zachować kontrolę nad instrukcjami.

4.  **Używanie skilla do egzekwowania reguły, gdy potrzebny jest hook.** Skill to sugestia, a nie gwarancja. Aby „zablokować `.env` w commicie”, **hook pre-commit** może sprawdzać daną ścieżkę commitowania. Oddzielnie przetestuj zawartość indeksu i inne ścieżki; nie zapobiega to wszystkim odczytom ani innym sposobom publikacji. Sam skill nie egzekwuje tej granicy.

5.  **Subagent z takimi samymi uprawnieniami jak jego rodzic.** Dałeś mu Opus i wszystkie narzędzia, a otrzymałeś kolejną główną sesję. System prompt w oficjalnej dokumentacji zaleca przydzielenie subagentowi wąskiej listy narzędzi i odrębnego zadania z ograniczeniami. W przeciwnym razie to tylko kosztowna kopia.

6.  **Nie sprawdzono Will install przed instalacją plugina.** W Claude Code v2.1.145+ to pole pokazuje pełną zawartość pakietu. Plugin „do jednej małej rzeczy” często zawiera trzy serwery MCP, dwa subagents i pięć hooks. Wszystkie zaczynają zajmować miejsce w kontekście.

7.  **Stare `.claude/commands/` dubluje nowe skills.** Anthropic podaje w dokumentacji:

<figure>
<blockquote>
<p>Własne commands zostały połączone ze skills. Plik <code>.claude/commands/deploy.md</code> i skill <code>.claude/skills/deploy/SKILL.md</code> tworzą <code>/deploy</code> i działają tak samo.</p>
</blockquote>
<figcaption>— Claude Code Docs, https://code.claude.com/docs/en/skills</figcaption>
</figure>

Stary folder `commands/` nadal działa, ale standardem są teraz skills. W opisanym przykładzie używano obu folderów; usunięto `commands/`, pozostawiając skills z dołączonymi plikami i warunkami wyzwalającymi.

Oznaki, że Claude Code jest „zagracony”:

- Każda wiadomość zaczyna się od wzmianki o dostępnych narzędziach zajmującej ponad 200 linii.
- Proste zadania trwają dłużej niż miesiąc temu.
- Claude myli dwa podobne skills lub plugins.
- Przy uruchamianiu sesji pojawiają się ostrzeżenia o konfliktach nazw.
- Claude wywołuje niewłaściwe narzędzie — na przykład skill A zamiast potrzebnego MCP B.

Jeśli rozpoznajesz co najmniej dwa z tych objawów, otwórz teraz `/plugin list` i `/skill list`. Najpierw usuń to, czego nie używasz od dwóch tygodni. Następnie sprawdź Context cost każdego elementu. Potem zajmij się powyższymi antywzorcami.

## Ile skills i MCP można zachować, żeby nie wyczerpać kontekstu?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Nie ma ścisłych limitów, ale istnieją praktyczne progi. Utrzymuj do 10–12 aktywnych skills, bo przy większej liczbie met limity Anthropic zaczną przycinać każdy z nich podczas auto-compaction. W projekcie używaj najwyżej 2–3 aktywnych serwerów MCP. Instaluj plugins tylko wtedy, gdy ich Context cost wynosi mniej niż 1,000 tokenów na wiadomość. Te progi wynikają z praktyki, nie z teorii.

</div>

Co Claude Code pokazuje bezpośrednio:

- `/skill list` — wszystkie aktywne skills i ich rozmiar w tokenach.
- `/plugin list` — wszystkie plugins i ich Context cost.
- `/mcp list` — serwery MCP i liczba ich narzędzi.

Budżet tokenów w liczbach:

| Mechanizm | Koszt w stanie bezczynności | Koszt po wyzwoleniu | Pojemność kontekstu |
|----|----|----|----|
| **Skill** | ~100 tokenów (tylko metadane) | Faktycznie wczytane instrukcje i materiały | Korzysta z kontekstu wywołującego |
| **Subagent** | ~50 tokenów (nazwa i opis) | Faktyczne dane wejściowe, odpowiedzi, wyniki narzędzi i kolejne tury | Osobne okno; przykład 200K oznacza pojemność, nie opłatę za delegowanie |
| **Serwer MCP** | Opisy narzędzi wczytane przez klienta | Wczytane argumenty i wyniki; usługa może naliczać osobną opłatę | Korzysta z kontekstu wywołującego |
| **Plugin** | Suma wczytanych komponentów wewnętrznych | Faktyczne użycie komponentów | Zależy od komponentów |

Okno kontekstu to maksymalna przestrzeń robocza, a nie liczba tokenów zużywana w każdym zadaniu. Porównuj zmierzone dane wejściowe, dane wejściowe z pamięci podręcznej, odpowiedzi i kolejne tury dla tego samego wyniku. Izolacja może ograniczyć kontekst rodzica, ale subagent nadal zużywa własne tokeny.

Na swoim blogu technicznym Anthropic podaje liczby dotyczące auto-compaction dla skills: ponownie dołączanych jest pierwszych 5,000 tokenów każdego aktywnego skilla, a łączny limit wynosi 25,000. Oznacza to, że przy więcej niż 5 aktywnych „ciężkich” skills Claude zaczyna tracić część instrukcji.

Prosta zasada praktyczna:

- **Skills:** nie więcej niż 5–7 aktywnych w bieżącym projekcie. Resztę umieść w `~/.claude/skills/disabled/`; w razie potrzeby możesz je przenieść z powrotem.
- **MCP:** nie więcej niż 2–3 na projekt. Context7 do dokumentacji prawie zawsze warto mieć; pozostałe dobieraj do konkretnego zadania.
- **Plugins:** instaluj ściśle po jednym i po dwóch tygodniach sprawdź, czy go używałeś. Jeśli nie, usuń go.

Szczegółowa analiza raportu Anthropic 2026 Agentic Coding Trends Report i przyczyn, dla których 80% programistów nie potrafi w pełni delegować Claude zadania, znajduje się w osobnym przewodniku. Główna liczba z raportu: ludzie używają AI przy 60% swojej pracy, ale w pełni przekazują mu tylko 0–20% zadań. Główną przyczyną jest przeciążenie kontekstu i utrata kontroli nad narzędziami.

## Od czego powinien zacząć początkujący? Minimalna działająca konfiguracja

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

Najważniejsza informacja

Jeśli dopiero zaczynasz i nie wiesz, co wybrać, nie instaluj żadnego z wymienionych tu elementów. Najpierw zbuduj podstawy: CLAUDE.md, osobny folder z kontekstem projektu oraz podstawową strukturę zadań. Przez dwa tygodnie wykonuj rzeczywiste zadania w podstawowym Claude Code. Potem stanie się jasne, gdzie masz powtarzalną procedurę (to skill), gdzie brakuje ci danych na żywo (to MCP), a które zadanie zaczyna zapełniać kontekst (to subagent).

</div>

Minimalny zestaw po dwóch tygodniach pracy:

1.  **CLAUDE.md** w katalogu głównym z zasadami projektu.
2.  **AGENTS.md** zapewniający zgodność z innymi narzędziami, jeśli planujesz pracować poza Claude Code. Więcej informacji w [„Jak utworzyć jeden plik instrukcji dla Claude Code, Codex i Cursor”](https://ailoot.ai/blog/pl/agents-md-claude-md-one-instruction-file/).
3.  **1 skill** do głównego powtarzalnego zadania. Na przykład zacznij od `code-review` zgodnego z twoim przewodnikiem stylu.
4.  **1 serwer MCP**: Context7 do aktualnej dokumentacji. Bez niego Claude nadal halucynuje nieistniejące API.
5.  **0 plugins i 0 subagents** w pierwszym miesiącu. Nie chodzi o oszczędzanie pieniędzy, lecz o kontrolę. Zanim poznasz podstawy, pakiety będą cię dezorientować.

Dalej kieruj się zadaniami. Pojawia się powtarzalna procedura? Zmień ją w skill. Potrzebujesz danych na żywo z konkretnej usługi? Dodaj MCP. Duże zadanie zaczyna wypełniać główny kontekst? Przekaż je subagentowi.

Oto mapa trzech poziomów: **najpierw kontekst**, potem **przekazanie systemowi tego, co robisz częściej niż kilka razy**, a następnie **automatyczne kontrole, żeby system sam nie popełniał błędów**. Dodaj każdy kolejny poziom dopiero wtedy, gdy poprzedni już działa.

<div class="section" role="doc-bibliography" aria-label="Sources">

### Źródła

- [Agent Skills Overview - Anthropic Docs](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)
- [Skills - Claude Code Docs](https://code.claude.com/docs/en/skills)
- [Subagents - Claude Code Docs](https://code.claude.com/docs/en/sub-agents)
- [Plugins - Claude Code Docs](https://code.claude.com/docs/en/discover-plugins)
- [Equipping Agents for the Real World with Agent Skills - Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills)
- [MCP Introduction - modelcontextprotocol.io](https://modelcontextprotocol.io/introduction)
- [GitHub anthropics/skills - open repository](https://github.com/anthropics/skills)
- [Anthropic 2026 Agentic Coding Trends Report](https://resources.anthropic.com/2026-agentic-coding-trends-report)

</div>







<div class="aside" data-semantic="ailoot-link" aria-label="Ailoot">

Możesz dalej odkrywać Ailoot na stronie [ailoot.ai](https://ailoot.ai/).

</div>

## Pytania i odpowiedzi

### Czy delegowanie zadania subagentowi automatycznie zużywa 200K tokenów?

Nie. Okno kontekstu opisuje pojemność. Zużycie wynika z faktycznie przetworzonych danych wejściowych i odpowiedzi, wyników narzędzi i kolejnych tur. Porównuj całe zmierzone zużycie, również dane wejściowe z pamięci podręcznej, zamiast traktować maksymalne okno jako stałą opłatę za delegowanie.

### Kiedy wybrać skill, serwer MCP lub subagenta?

Skill służy do powtarzalnej procedury, MCP do dostępu do działających systemów, a subagent do ograniczonego zadania, którego szczegóły robocze nadmiernie rozbudowałyby główną rozmowę. Plugin pakuje te komponenty; przed instalacją sprawdź jego zawartość.


## Ailoot · Firma i jej portfel projektów

Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.

Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.

Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.
