Jakub Stankowski – programowanie z AI

O autorze

Jakub Stankowski – programista .NET i Angular od 2018 roku. Pracował nad projektami frontendowymi, backendowymi i fullstackowymi, przestrzegając zasad czystego kodu, DRY i stosując CQRS. Ma również doświadczenie jako trener programowania.

Od 2023 roku intensywnie pracuje z Claude AI oraz metodą Spec-Driven Development (SDD) – produkcyjnym workflow do pracy z AI opartym na zasadzie: najpierw specyfikacja, potem implementacja. Na ProgramujZAI.pl dzieli się praktyczną wiedzą o tym, jak programować z AI bez chaosu w kodzie.

Poznaj Jakuba →

Subagent w Claude Code to osobna instancja agenta z własnym oknem kontekstu, własnym promptem i ograniczonym zestawem narzędzi. Dostaje jedno wąskie zadanie i oddaje do głównej sesji tylko wynik. Używaj go wtedy, gdy zadanie generuje dużo szumu: przeszukiwanie repozytorium, analiza logów, niezależne review. Do prostych pytań subagent tylko dokłada koszt. Własnego subagenta definiujesz jednym plikiem Markdown w katalogu .claude/agents/.

Najważniejsze informacje

  • Subagent chroni kontekst – szum zostaje w jego oknie, do Ciebie wraca podsumowanie.
  • Ma tylko te narzędzia, które mu dasz – nie rozszerzy sobie uprawnień.
  • Wbudowane subagenty (Explore, Plan, general-purpose) pokrywają większość pracy.
  • Własny subagent to plik .md z frontmatterem w .claude/agents/.
  • Pole description decyduje, kiedy Claude sięgnie po subagenta.

Subagent to osobny agent z własnym kontekstem, a nie mądrzejszy Claude

Subagent nie jest lepszym modelem. To ten sam Claude, uruchomiony w czystym oknie kontekstu. Dostaje własny prompt systemowy i listę narzędzi. Gdy skończy, oddaje głównej sesji tylko wynik.

Definiują go trzy cechy:

  • Izolowany kontekst. Pliki, które przeczytał, nie zaśmiecają Twojej rozmowy.
  • Ograniczone narzędzia. Może dostać tylko podzbiór uprawnień sesji głównej.
  • Wąskie zadanie. Krótszy prompt i mniej instrukcji niż w sesji głównej.

W praktyce to rozwiązuje najczęstszy problem długich sesji. Po trzech godzinach pracy agent ma w kontekście dziesiątki plików i wyników grepa. Odpowiada wolniej i gorzej. Opisuję to szerzej w artykule o najczęstszych błędach w Claude Code.

Subagent opłaca się, gdy zadanie generuje dużo szumu

O użyciu subagenta nie decyduje trudność zadania, tylko jego „hałas”. Jeśli praca wymaga przeczytania 30 plików, żeby odpowiedzieć jednym zdaniem, deleguj ją.

Dobre zastosowania:

  • przeszukanie dużego repozytorium pod kątem jednego wzorca,
  • analiza długich logów lub wyników testów,
  • niezależne code review bez wiedzy o tym, jak kod powstał,
  • równoległe zadania, które nie dotykają tych samych plików.

Złe zastosowania:

  • proste pytanie o jeden plik – start nowego okna kosztuje więcej niż odpowiedź,
  • zadania wymagające pełnej wiedzy z rozmowy – subagent jej nie ma,
  • kilka agentów edytujących te same pliki jednocześnie.

Review to mój ulubiony przypadek. Subagent nie widział, jak kod powstawał. Dlatego nie broni decyzji, które sam podjął. Więcej o tym w artykule o code review z AI.

Wbudowane subagenty wystarczą do większości codziennej pracy

Claude Code ma kilka subagentów gotowych od razu. Często uruchamia je sam, bez Twojej prośby.

  • Explore – szybkie przeszukiwanie kodu, tylko do odczytu.
  • Plan – analizuje repozytorium przed zaproponowaniem planu zmian.
  • General-purpose – złożone zadania wieloetapowe.

Najprostszy sposób użycia to poproszenie o subagenta w zwykłym poleceniu. Na przykład: „Użyj subagenta, żeby znaleźć wszystkie miejsca, gdzie wysyłamy maile, i zwróć listę plików”. Działa to w terminalu, w IDE i w aplikacji desktopowej.

Własny subagent to plik Markdown z frontmatterem

Własnych subagentów trzymasz w dwóch miejscach. Katalog .claude/agents/ w projekcie trafia do repozytorium i jest wspólny dla zespołu. Katalog ~/.claude/agents/ to Twoje prywatne narzędzia.

Najszybciej stworzysz go komendą /agents. Możesz też napisać plik ręcznie:

---
name: code-reviewer
description: Używaj po każdej zmianie w kodzie przed commitem. Sprawdza błędy, bezpieczeństwo i zgodność ze specyfikacją.
tools: Read, Grep, Glob
model: sonnet
---
Jesteś recenzentem kodu. Przeczytaj zmienione pliki i specyfikację zadania.
Zwróć listę problemów w trzech grupach: krytyczne, ważne, drobne.
Przy każdym podaj plik, linię i proponowaną poprawkę.
Nie edytuj plików.

Najważniejsze jest pole description. Na jego podstawie sesja główna decyduje, czy użyć subagenta. Pisz je jak ogłoszenie o pracę: konkretny warunek, a nie „pomaga z kodem”.

Pole tools to Twoja warstwa bezpieczeństwa. Recenzent nie potrzebuje zapisu ani Basha. Szerzej piszę o tym w artykule o bezpieczeństwie kodu AI.

Subagent, skill i CLAUDE.md rozwiązują różne problemy

Mechanizm Co robi Kiedy go użyć
Subagent wykonuje zadanie w osobnym kontekście praca generuje dużo szumu lub wymaga niezależnej oceny
Skill dokłada instrukcje i skrypty do bieżącej sesji powtarzalna procedura, np. publikacja lub raport
CLAUDE.md stałe zasady projektu ładowane na start konwencje, komendy, reguły, kiedy delegować

Te mechanizmy działają razem. W CLAUDE.md zapisujesz regułę: „każde review rób subagentem code-reviewer”. Subagent wykonuje pracę. Skille dają mu gotowe procedury.

Jak wdrożyć to w praktyce

  1. Zacznij od wbudowanych subagentów. Przez tydzień proś o subagenta przy każdym przeszukiwaniu repozytorium.
  2. Stwórz jednego własnego subagenta. Najlepiej recenzenta tylko do odczytu, jak w przykładzie wyżej.
  3. Dopisz regułę do CLAUDE.md. Określ, przy jakich zadaniach Claude ma go użyć.
  4. Zacommituj .claude/agents/. Cały zespół dostanie tego samego recenzenta.
  5. Sprawdzaj wyniki. Jeśli subagent uruchamia się za często lub za rzadko, popraw description.

FAQ: subagenci Claude Code

Czym są subagenci w Claude Code?

To osobne instancje Claude z własnym kontekstem, promptem i listą narzędzi. Wykonują wąskie zadanie i zwracają wynik do głównej sesji.

Jak stworzyć subagenta w Claude Code?

Wpisz komendę /agents i wybierz tworzenie nowego agenta. Możesz też dodać plik Markdown z frontmatterem do katalogu .claude/agents/ w projekcie.

Czy subagenci zwiększają koszt Claude Code?

Każdy subagent startuje z nowym kontekstem, więc zużywa dodatkowe tokeny. Przy zadaniach z dużą ilością szumu często wychodzi taniej, bo główna sesja nie puchnie.

Czy subagenci mogą pracować równolegle?

Tak. Bezpiecznie jest to robić przy zadaniach, które nie edytują tych samych plików. Przy równoległych zmianach w kodzie używaj osobnych worktree.

Subagenci Claude Code to najprostszy sposób na dłuższe i czystsze sesje. Zacznij od jednego recenzenta tylko do odczytu i dopisz go do CLAUDE.md. Pokazuję tę konfigurację na żywo na kanale YouTube. Gotowe definicje agentów znajdziesz w AI Workflow Bonus na standev.it.


Dodaj komentarz

Twój adres email nie zostanie opublikowany. Wymagane pola są oznaczone *