Podagenci Claude Code i Zespoły Agentów: Praktyczny Przewodnik

Widziałeś słowa "subagenci", "Zespoły Agentów", "orkiestracja" i zastanawiasz się, czy coś ci umyka. Krótka odpowiedź: w przypadku większości zadań, nie. Ale przy dużych projektach, tak, i warto to zrozumieć.

Rozplączmy to bez żargonu.

Czym właściwie jest subagent

Subagent to wyspecjalizowany asystent z własnym kontekstem, własnym promptem i własnymi uprawnieniami do narzędzi.

Gdy główny agent napotyka dobrze zdefiniowane podzadanie, deleguje je do subagenta. Ten subagent pracuje w swoim własnym oknie kontekstu, wykonuje zadanie i zwraca tylko wynik. Główny agent nie dostaje pełnej historii zanieczyszczającej jego kontekst, otrzymuje wnioski.

O to chodzi: utrzymać kontekst głównego agenta czystym. Zamiast jednego agenta tonącego w 50 000 tokenów wyszukiwania plików, masz subagenta, który wykonuje wyszukiwanie i raportuje trzy użyteczne linie.

Deklarujesz swoich subagentów w folderze .claude/agents/ swojego projektu. Każdy ma nazwę, opis mówiący, kiedy go używać, i systemowy prompt.

---
name: test-writer
description: Używaj, gdy trzeba napisać lub poprawić testy
---
Piszesz testy. Dążysz do pokrycia przypadków brzegowych,
nie ścieżki szczęśliwej. Nigdy nie dotykasz kodu produkcyjnego.

Zespoły Agentów, kolejny krok

Zespoły Agentów to orkiestrator wieloagentowy wbudowany w Claude Code. Nadal eksperymentalny, domyślnie wyłączony, ale solidny punkt wyjścia.

Pomysł: główny agent dzieli duże zadanie, deleguje każdą część do specjalistycznego agenta (z własnym modelem, promptami, narzędziami), specjaliści pracują równolegle na wspólnym systemie plików, a wyniki wracają do głównego agenta.

Jeśli "delegowanie do specjalisty" brzmi jak subagenci, to normalne. Zespoły Agentów to ten pomysł posunięty do uruchamiania kilku agentów naprawdę równolegle, a nie tylko jeden po drugim.

Poza wbudowanym, istnieją zewnętrzni orkiestratorzy jak Multiclaude i Gas Town. Mają swoje zdanie, co czyni je dobrymi punktami wyjścia, gdy zaczynasz: decydują za ciebie, dopóki nie wypracujesz własnych nawyków.

Kiedy tego potrzebujesz (a kiedy nie)

Wyjaśnijmy: orkiestracja wieloagentowa jest bezcelowa dla 95% zadań wspomaganych agentem. W przypadku większości codziennej pracy, pojedynczy agent jest szybszy i prostszy.

Obecnie, wieloagentowość to nadal kosztowny i eksperymentalny sposób na atakowanie dużych projektów.

Potrzebujesz tego, gdy:

• Projekt dzieli się na naprawdę niezależne części, które dotykają różnych plików.
• Jedno okno kontekstu nie może pomieścić całości.
• Chcesz zrównoleglić szeroką refaktoryzację lub migrację w całym repozytorium.

Nie potrzebujesz tego do naprawy błędu, skoncentrowanej funkcji, czy czegokolwiek, co mieści się w jednej głowie.

Pułapką jest uruchamianie dziesięcioagentowego "zespołu" dla czegoś, co jeden agent zrobiłby w pięć minut. Płacisz w tokenach i złożoności za równoległość, której zadanie nigdy nie wymagało.

Prawdziwy problem: widoczność

Oto, o czym nie mówi się wystarczająco. W momencie, gdy uruchamiasz kilku subagentów lub Zespół Agentów, tracisz wątek.

Główny agent deleguje do pięciu specjalistów. Który pracuje? Który skończył? Który czeka na decyzję? W terminalu widzisz ścianę przewijającego się tekstu i nie możesz powiedzieć, kto co robi.

Tutaj zmienia wszystko wizualny dashboard. AgentsRoom pokazuje każdego agenta i każdego subagenta jako własny kafelek, z wyraźnie określonym statusem. Obserwujesz, jak delegacja się odbywa, widzisz, kto czeka na twoją odpowiedź, widzisz, kto się zawiesił. Ściana tekstu staje się czytelną mapą.

Bez tego widoku, orkiestracja wieloagentowa pozostaje imponującym demem, które jest niezarządzalne na co dzień. Z nim, staje się narzędziem, którego faktycznie używasz.

Od czego zacząć

Nie skacz od razu do ośmioagentowego zespołu.

Zacznij od jednego lub dwóch subagentów do precyzyjnych, powtarzalnych zadań: jednego, który pisze testy, jednego, który przeszukuje bazę kodu. Szybko poczujesz zysk w kontekście głównego agenta.

Gdy ten mechanizm stanie się naturalny, włącz Zespoły Agentów do pracy, która dzieli się czysto. Obserwuj, kto co robi, zatwierdzaj plany przed wykonaniem i zatrzymaj się, gdy przegląd stanie się twoim wąskim gardłem.

Wieloagentowość nagradza tych, którzy strukturyzują przed uruchomieniem. Nie tych, którzy uruchamiają najwięcej agentów.