Systemy AI (AI OS)

Subagenci i hooki w Claude Code w praktyce: co automatyzuję w firmie jednoosobowej

Jak w firmie jednoosobowej używam subagentów i hooków w Claude Code: telefon po długim zadaniu, blokada pliku .env i audyt bezpieczeństwa w osobnym oknie.

  • 7 min czytania
Spis treści

W lekcjach kursu pokazałem subagentów i hooki na trzech przykładach: audyt aplikacji w osobnym oknie, telefon po skończonym zadaniu i blokada pliku .env. Subagent to osobny pracownik z własnym oknem kontekstowym, który wraca tylko z raportem. Hook to nadzorca: przy zdarzeniu odpala skrypt, który może zadzwonić albo zablokować plik.

Jak to wiem? Tak tłumaczyłem i pokazywałem to na żywo w lekcjach kursu Claude Code o subagentach i hookach. Poniżej zostawiam tylko to, co tam faktycznie zrobiłem, plus to, co w dokumentacji Claude Code było aktualne 14.11.2026.

Definicje zostawiam hasłom: subagenci w Claude Code i hooki w Claude Code. Tu interesuje mnie, co z tego działa w firmie, w której pracuję sam. Jeśli dopiero zaczynasz z Claude Code, najpierw przeczytaj, jak pracuję w nim w jednym oknie.

Czym różni się subagent od skilla?

Skill zmienia, jak Claude pracuje. Subagent zmienia, kto pracuje.

Tak to rozrysowałem na lekcji. Skill to instrukcja, playbook. Kiedy zadanie dotyczy na przykład bezpieczeństwa, Claude ładuje skill do Twojego głównego wątku i sam robi robotę, w Twoim kontekście. Dlatego skill przydaje się do konwencji, stylu pisania, wytycznych designu albo stałego sposobu pracy. Własne skille, których używam w marketingu, opisałem osobno we wpisie o skillach w Claude.

Subagent to osobny pracownik z osobnym biurkiem. Ma swoje okno kontekstowe, swój zestaw narzędzi i swoją instrukcję. Odchodzi, robi robotę i wraca z raportem. W wersji, której używałem na lekcji, główny wątek w tym czasie czekał albo robił coś innego.

Kiedy chcesz obu naraz? Kiedy dajesz takiemu pracownikowi instrukcję. Subagent nie dziedziczy skilli z Twojej sesji automatycznie. Musisz mu je podać w pliku agenta, w frontmatterze, w polu skills. Na lekcji właśnie na tym złapałem pierwszy szkic: Claude utworzył subagenta, ale pominął to pole, i trzeba było to poprawić, patrząc w dokumentację subagentów (otwiera się w nowej karcie) (stan na 14.11.2026).

Co z tego dla Ciebie: jeśli chcesz, żeby Claude pamiętał Twoje zasady przy bieżącej pracy, dajesz skill. Jeśli chcesz, żeby ktoś osobny przewertował stertę plików i wrócił ze streszczeniem, dajesz subagenta.

Jak używam subagentów, żeby audyt nie zalał mi głównego okna?

Odpalam subagenta do jednej, wyraźnej roboty, a do głównej rozmowy wraca tylko raport.

W projekcie kursowym miałem w folderze agents 13 subagentów. Każdy od czegoś innego: bezpieczeństwo, wydajność, architektura, research, przegląd kodu. Nie dlatego, żeby mieć katalog dla zasady. Żeby dało się delegować typowe, powtarzalne zadania.

Na lekcji wziąłem subagenta od audytu bezpieczeństwa i odpaliłem go na aplikacji do usuwania tła. Wywołałem go znakiem małpki, czyli @, i dałem krótkie polecenie: sprawdź bezpieczeństwo aplikacji, szczególnie obsługę klucza API i walidację plików.

Subagent uruchomił się we własnym oknie. Główny wątek dostał na końcu raport i podsumowanie, nie całą historię jego klikania. Raport zapisałem w folderze docs, nawet jeśli ta runda była poglądowa.

W tej demonstracji narzędzie pokazało, że subagent zużył prawie 65 tysięcy tokenów. To ważna poprawka do pierwszego wrażenia. Osobne okno znaczy, że logi i odczyty plików nie zajmują miejsca w głównej rozmowie. Nie znaczy, że praca jest za darmo. Dokumentacja Claude Code z 14.11.2026 mówi wprost: żądania subagenta wliczają się do tych samych limitów użycia co główna rozmowa.

Potem zbudowaliśmy jeszcze jednego: UX Tester. Miał testować interfejs w prawdziwej przeglądarce: otworzyć stronę, sprawdzić kontrast, obsługę klawiatury, dostępność i responsywność. Do tego dostał skille do przeglądarki i do wytycznych UX. Aplikację najpierw odpaliłem lokalnie, potem wywołałem subagenta przez @ i w tamtej wersji mogłem przenieść go do tła skrótem Ctrl+B, żeby odblokować główny wątek.

Co z tego dla Ciebie: nie zaczynaj od trzynastu ról. Weź jedno zadanie, które zalewa Ci czat, na przykład audyt albo przegląd wielu plików, i niech wróci z niego jeden raport.

Jak działa hook, jeśli nie programujesz?

Hook to nadzorca. Uruchamia się, gdy w Claude wydarzy się konkretna rzecz, i ma przypisaną akcję, najczęściej skrypt.

Na lekcji użyłem takiej metafory, bo sama koncepcja bywa ciężka, jeśli nie programujesz na co dzień. Jest Claude, który edytuje pliki, czyta je i woła narzędzia. Jest hook, który pilnuje wybranego zdarzenia. I jest akcja: dźwięk, mail, blokada albo telefon.

Do zrozumienia wystarczą cztery pojęcia:

  1. Event, czyli wydarzenie. Na przykład zapis pliku, użycie narzędzia, start albo koniec sesji, albo moment, w którym Claude kończy odpowiedź.
  2. Matcher, który mówi, przy których zdarzeniach nadzorca ma się odezwać.
  3. Command, czyli skrypt w terminalu.
  4. Exit code, bo skrypt może pracę przepuścić albo zablokować.

Eventów jest dużo. Na lekcji powiedziałem wprost, że większości nie znam i nie zamierzam znać na pamięć. Pełniejszy spis jest w przewodniku po hookach (otwiera się w nowej karcie) i w dokumentacji subagentów (otwiera się w nowej karcie) (oba stan na 14.11.2026). Hasło o hookach zostawiam w encyklopedii.

Hooki, tak jak skille, żyją w folderze .claude. Same skrypty miałem w podfolderze hooks, a to, kiedy się uruchamiają, zapisuje się w settings.json. Zakres jest taki sam jak przy innych ustawieniach: dla użytkownika (we wszystkich projektach), dla projektu albo tylko lokalnie.

Co z tego dla Ciebie: hooka używasz wtedy, gdy coś ma dziać się zawsze, a nie wtedy, gdy Claude „sam sobie przypomni”.

Jak hook dzwoni do mnie, gdy zadanie się skończy?

Ustawiam hook na zdarzenie Stop i skrypt, który dzwoni na telefon.

To była pierwsza demonstracja na lekcji. Poprosiłem Claude, żeby podsumował ostatnie zmiany w integracji z Supabase i żebym dostał telefon, gdy skończy. Telefon zadzwonił. Agent powiedział krótko, co się udało. Jeśli nie siedzę przy komputerze, nie muszę czytać terminala. Mogę po prostu odebrać.

Po co mi to w firmie jednoosobowej? Bo mam komendę, której używam przy planie wdrożenia. Nazywa się dev autopilot. Kiedy plan jest już rozpisany, na przykład na 6 faz, a każda faza to około 1,5 godziny pracy, odpalam ją i idę do innego zadania albo odchodzę od komputera. Hook ma wtedy sens: po wielogodzinnej fazie ktoś ma mi dać znać, że można wrócić.

W projekcie ten hook nazywał się Notify Phone. W settings.json był podpięty pod event Stop i odpalał skrypt z folderu hooks. Po demie wyłączyłem go, bo przeszkadzałby w dalszej pracy na lekcji, i zrestartowałem sesję.

Co z tego dla Ciebie: jeśli zostawiasz Claude przy dłuższej robocie, najprostszy pierwszy hook to powiadomienie, nie kolejna instrukcja w pliku.

Jak hookiem chronię plik .env?

Hookiem, który blokuje odczyt, edycję i inną pracę z tym plikiem, zanim Claude do niego zajrzy.

W projekcie miałem plik .env z tokenami i kluczami. Claude nie musi go otwierać, żeby korzystać z konfiguracji, bo kod wczytuje wartości sam. Mimo to nie chcę, żeby asystent zaglądał tam, gdzie nie powinien.

Tego hooka nie pisałem ręcznie od zera. Użyłem wtyczki Hookify z oficjalnego marketplace'u Anthropic (stan na 14.11.2026). Powiedziałem: stwórz hook, który zablokuje Claude możliwość odczytu, edycji albo jakiejkolwiek pracy z plikiem .env. Po zapisie zrestartowałem sesję, żeby hook się wczytał, i sprawdziłem to poleceniem: zobacz, jakie mamy klucze w pliku .env, ale nie podawaj wartości, tylko nazwy kluczy. Odczyt został zablokowany.

Hookify potrafi też przejrzeć historyczne sesje i commity i zaproponować kolejne hooki do projektu. Na lekcji dostałem między innymi propozycje wokół kluczy API, konwencji projektu, ochrony samych hooków przed samodzielną edycją i jakości kodu. Zanim cokolwiek wdrażasz z takiej listy, dopytaj, jaką realną korzyść ma Ci to dać. Nie każdy pomysł jest dla firmy jednoosobowej.

Co z tego dla Ciebie: jeśli w projekcie leży plik z kluczami, nie licz na to, że w CLAUDE.md wystarczy prośba „nie otwieraj .env”. Hook to zasada, która odpala się zawsze.

Od czego zacząć w firmie jednoosobowej?

Od jednej rzeczy, która albo zalewa Ci okno, albo ma dziać się za każdym razem.

Nie od trzynastu subagentów i pełnej listy eventów. W moich demonstracjach wystarczyły trzy zastosowania:

  1. Subagent do audytu albo przeglądu, który wraca z raportem.
  2. Hook, który dzwoni albo powiadamia, gdy dłuższe zadanie się skończy.
  3. Hook, który broni pliku z kluczami.

Dokumentacja z 14.11.2026 potwierdza ten podział. Subagenta odpalisz językiem naturalnym albo przez @. Hooka dopisujesz do settings.json albo tworzysz z pomocą wtyczki. Jeśli subagent ma korzystać ze skilli, wpisz je w polu skills. Jeśli ma iść na tańszym modelu, ustaw mu model w pliku agenta, zamiast zostawiać dziedziczenie po głównej rozmowie.

Do zrobienia w tym tygodniu: wybierz jedną automatyzację. Albo subagenta do zadania, które zazwyczaj rozpycha Ci czat, albo hooka, który powiadomi Cię po pracy albo zablokuje .env. Resztę dopisz, dopiero gdy ten pierwszy przypadek powtórzy się kilka razy.

A jeśli chcesz dostawać takie rozbiory na maila, zapisz się do newslettera.

Bartek Bąkowski

Autor

Bartek Bąkowski

Soloprzedsiębiorca, twórca i DJ. Buduję systemy AI, strony internetowe i automatyzacje dla ekspertów oraz twórców. Pokazuję, jak łączyć technologię z autentycznością i robić to po swojemu.

Więcej o mnieYouTube (otwiera się w nowej karcie)Newsletter

Najczęstsze pytania

Czy subagent oszczędza tokeny?

Oszczędza miejsce w głównym oknie kontekstowym, bo do rozmowy wraca raport, a nie cały przebieg pracy. Same operacje subagenta i tak zużywają tokeny i wliczają się do limitów konta, jak mówi dokumentacja subagentów (stan na 14.11.2026).

Czy hook zastępuje CLAUDE.md i skille?

Nie. CLAUDE.md i skille to instrukcje, które Claude stosuje przy pracy. Hook to skrypt odpalany przy zdarzeniu, niezależnie od tego, czy model „sobie przypomni”. W praktyce używam obu warstw: stałe zasady w pliku i skillach, a rzeczy, które mają dziać się zawsze, w hooku.

Co niedzielę jeden konkret

O marce, systemach AI i pracy po swojemu. Dokumentuję swoją drogę: co testuję, co działa i czego unikać. Bez spamu, jeden mail tygodniowo.

Archiwum wydań

„Ten newsletter nie jest nachalny, urzeka autentycznością, a osobiste historie Bartka są świetnym punktem odniesienia do moich własnych doświadczeń.”
Małgorzata BabskaMałgorzata Babskaarchitektka

Chcesz to wdrożyć u siebie?

W 30 minut przechodzimy przez Twój biznes i mówię wprost, co zrobiłbym najpierw.

Prywatność i cookies

Odwiedziny liczę anonimowo. Za Twoją zgodą włączę analitykę i marketing, żeby wiedzieć, co działa. Polityka prywatności

Kategorie plików cookies