Ile iteracji wykonuje typowa pętla agenta przy prostym zadaniu?

Proste zadania, jak dodanie przycisku czy zmiana koloru w CSS, zajmują zwykle 2-5 iteracji. Średnie zadania, jak refaktoryzacja modułu czy dodanie nowej funkcji z testami, to 8-20 iteracji. Złożone zadania wieloplikowe mogą wymagać 30-100+ iteracji. Im więcej plików jest zależnych od siebie, tym więcej cykli 'odczyt → decyzja → akcja → obserwacja' potrzebuje agent, żeby wszystko ze sobą zgrać. Jeśli zadanie przekracza 50 iteracji bez wyraźnego postępu, warto je podzielić na mniejsze części i dać agentowi po jednej na raz.

Czy mogę przerwać pętlę agenta w trakcie działania?

Tak. W trybie Manual i acceptEdits Claude pyta o zgodę przed każdą akcją — możesz odmówić, co przerywa bieżącą iterację i daje Ci możliwość przekierowania agenta. W trybie Auto Mode naciśnij Ctrl+C w terminalu, aby zatrzymać wykonywanie. Po przerwaniu agent wraca do fazy decyzji i czeka na Twoją instrukcję — nie traci przy tym dotychczasowego kontekstu sesji. Jeśli chcesz całkowicie zatrzymać zadanie i zacząć od nowa, możesz użyć /clear, aby wyczyścić kontekst.

Czy pętla agenta działa tak samo w Plan Mode?

Nie do końca. W Plan Mode pętla agenta działa tylko w zakresie odczytu i analizy — fazy akcji są zablokowane. Agent wciąż czyta pliki i podejmuje decyzje, ale zamiast edytować, zapisuje proponowane zmiany w planie. Po zatwierdzeniu planu i przełączeniu na acceptEdits, pętla wznawia normalne działanie, zaczynając od pierwszego kroku z planu. To jak różnica między architektem rysującym projekt (Plan Mode) a ekipą budowlaną realizującą go cegła po cegle (acceptEdits).

Pętla Agenta w Claude Code (Agent Loop) – jak Claude samodzielnie wykonuje zadania

Czym jest pętla agenta (agent loop)?

Pętla agenta to cykl decyzyjny, który Claude Code powtarza aż do zakończenia zadania. W każdej iteracji agent przechodzi przez cztery fazy: odczyt stanu (czyta pliki, wyniki testów, logi), decyzja (wybiera narzędzie i parametr na podstawie kontekstu), akcja (wywołuje narzędzie — edytuje plik, uruchamia komendę, odpala test), obserwacja (odbiera wynik narzędzia i ocenia, czy krok przybliżył do celu). Ta pętla działa setki razy w trakcie jednej sesji i to właśnie ona sprawia, że Claude Code zachowuje się jak samodzielny programista, a nie jak chatbot, któremu trzeba mówić 'zrób to, teraz to, teraz popraw'.

Cztery fazy pętli agenta

Faza 1 — Odczyt: Claude sprawdza bieżący stan. Czyta pliki, które planuje zmodyfikować, wyniki ostatniego polecenia, ewentualne błędy. To faza 'zorientuj się, gdzie jesteś'. Faza 2 — Decyzja: Na podstawie odczytanego stanu i celu zadania Claude wybiera narzędzie. Może to być edycja pliku (patch), uruchomienie testu (terminal), przeszukanie kodu (search_files) albo zadanie pytania użytkownikowi. Faza 3 — Akcja: Claude wykonuje wybrane narzędzie. Jeśli tryb uprawnień tego wymaga, pyta użytkownika o zgodę. Faza 4 — Obserwacja: Agent czyta wynik — test przeszedł, build się skompilował, a może wyskoczył błąd. Na podstawie tego wyniku planuje następny krok i cykl się powtarza.

Dlaczego pętla agenta ma znaczenie?

Bez zrozumienia pętli agenta praca z Claude Code może być frustrująca. Dlaczego agent edytuje plik, którego nie kazałeś dotykać? Bo w fazie odczytu zauważył zależność, której nie opisałeś w prompcie. Dlaczego utknął w pięciu iteracjach naprawiania tego samego błędu? Bo faza obserwacji daje mu ten sam negatywny wynik, a on próbuje różnych podejść. Dlaczego po /compact zapomniał o halfie zadania? Bo kontekst z wcześniejszych iteracji został skompresowany. Znając te mechanizmy, możesz pisać lepsze prompty — zamiast 'zrób X', napiszesz 'zrób X, sprawdź testami, jeśli test nie przejdzie, pokaż mi błąd zamiast próbować samodzielnie naprawiać'.

Przykład: jak agent loop buduje komponent

Załóżmy, że dajesz Claude Code zadanie: 'Dodaj przycisk CTA do hero section na stronie głównej'. Oto jak wygląda pętla w praktyce. Iteracja 1: Odczyt — Claude czyta page.tsx, HeroSection.tsx, globals.css. Decyzja: użyje search_files, żeby znaleźć istniejące komponenty przycisków. Akcja: przeszukuje repo. Obserwacja: znalazł brand-button-primary w PagePrimitives.tsx. Iteracja 2: Odczyt — czyta PagePrimitives.tsx. Decyzja: użyje patch, żeby dodać przycisk w HeroSection. Akcja: edytuje plik. Obserwacja: zmiana zapisana. Iteracja 3: Odczyt — sprawdza, czy zmiana nie złamała typów. Decyzja: uruchomi tsc --noEmit. Akcja: odpala terminal. Obserwacja: build przechodzi. Zadanie zakończone w 3 iteracjach zamiast jednej gigantycznej edycji.

Jak optymalizować pętlę agenta?

Kilka zasad skutecznej pracy z pętlą agenta. Po pierwsze, dawaj konkretne kryteria sukcesu: zamiast 'popraw ten komponent' napisz 'popraw go tak, żeby build przechodził, a testy w button.test.tsx były zielone'. Agent będzie wiedział, kiedy przestać. Po drugie, ograniczaj zakres zadania: 'dodaj przycisk do hero' jest lepsze niż 'przebuduj homepage'. Mniejszy zakres = mniej iteracji = mniej szans na zejście z kursu. Po trzecie, używaj Plan Mode przed dużymi zadaniami — agent najpierw zaplanuje kroki, a dopiero potem wejdzie w pętlę wykonawczą z gotową mapą. Po czwarte, monitoruj sygnały ostrzegawcze: jeśli agent wykonuje piątą iterację tego samego typu, prawdopodobnie utknął — przerwij, daj mu dodatkowy kontekst i poproś o świeże spojrzenie.

Pętla agenta a Auto Memory

Auto Memory (automatyczna pamięć Claude Code) uczy się właśnie z pętli agenta. Gdy podczas iteracji poprawiasz Claude — 'nie używaj patch, tylko write_file' albo 'najpierw sprawdź testy, potem edytuj' — Claude zapisuje te korekty jako reguły w Auto Memory. W kolejnych sesjach, w fazie decyzji, agent uwzględni te reguły i wybierze lepsze narzędzie bez Twojej interwencji. To dlatego Claude Code staje się coraz lepszy w konkretnym projekcie: pętla agenta generuje dane treningowe, Auto Memory je zapamiętuje, a kolejne pętle są coraz celniejsze.

Pętla Agenta w Claude Code (Agent Loop)