Plan Mode w Claude Code — zaplanuj zmianę zanim AI ruszy kod
Zanim Claude Code zacznie edytować pliki, warto go zatrzymać na etapie planu. Plan Mode robi dokładnie to.
Plan Mode każe Claude Code najpierw pokazać plan, zanim tknie kod. Pokazujemy, jak go używać, żeby uniknąć niespodzianek przy większych zmianach.
Kurs Claude Code - Lekcja 6 z 28
Ten artykuł jest częścią bezpłatnego kursu Claude Code - największej polskojęzycznej serii 28 lekcji dla programistów. Od pierwszego uruchomienia do autonomicznych agentów AI.
<-- Lekcja 5: Komendy /slashLekcja 7: Skróty i sztuczki w terminalu
Z tego artykułu dowiesz się:
- Na czym polega tryb planowania (Plan mode) i jaki problem rozwiązuje
- Jak go włączyć i po czym poznać, że jest aktywny
- Co dokładnie dzieje się w tym trybie - i dlaczego agent nie może wtedy nic zepsuć
- Jak wygląda zatwierdzanie planu w praktyce, na zrzucie z prawdziwej sesji
- Kiedy warto planować, a kiedy szkoda na to czasu
Domyślnie Claude Code działa szybko: mówisz, co ma zrobić, a on od razu zabiera się do pisania. Przy drobnej, jednoznacznej zmianie to idealne - ale przy większym zadaniu bywa pułapką. Agent rusza w stronę, którą uznał za najlepszą, i po dwóch minutach masz gotowe rozwiązanie, tyle że oparte na założeniu, którego byś nie przyjął. Trzeba je teraz cofać i tłumaczyć od nowa. Tryb planowania odwraca tę kolejność: najpierw plan, akceptacja, a dopiero potem kod.
Tryb planowania wstawia między „pomysł” a „zmianę” moment, w którym widzisz, co agent zamierza - i możesz to skorygować
1. Jak włączyć tryb planowania
Najszybciej skrótem Shift+Tab. To ten sam skrót, którym przełączasz w locie tryby pracy agenta - kolejne naciśnięcia prowadzą przez tryb domyślny, automatyczne akceptowanie zmian i właśnie tryb planowania. Gdy plan mode jest aktywny, na dole ekranu pojawia się wyraźna informacja:
Po włączeniu trybu planowania na dole widać plan mode on (shift+tab to cycle) - dopóki to widzisz, agent niczego nie zmienia
Alternatywnie możesz wpisać komendę /plan - efekt jest ten sam. Tę i pozostałe wbudowane komendy zebraliśmy w ściądze komend /slash.
Po wpisaniu /plan Claude Code od razu podpowiada tę komendę wraz z opisem - obok innych wbudowanych komend zaczynających się od ukośnika
2. Co dzieje się w trybie planowania
Kluczowa cecha tego trybu: agent działa wyłącznie w trybie odczytu. Czyta pliki, przeszukuje repozytorium, rozumie strukturę kodu - ale nie zapisuje żadnych zmian i nie uruchamia poleceń, które coś modyfikują. Cokolwiek się stanie z plikami, stanie się dopiero po Twojej akceptacji. Dzięki temu możesz spokojnie pozwolić mu rozpoznać nawet duży, nieznany projekt, nie ryzykując niczego.
Spójrzmy na prawdziwą sesję. Poprosiliśmy o dodanie funkcji rabatu do prostego sklepiku. Zwróć uwagę, czego agent nie robi - nie pisze od razu kodu:
W trybie planowania agent najpierw rozpoznaje kod (osobny krok „Explore”), a potem dopytuje o decyzję projektową, zanim w ogóle zaproponuje konkretny plan
Widać tu dwie rzeczy, które robią różnicę. Po pierwsze, agent uruchomił osobny krok rozpoznania kodu, zebrał informacje i dopiero na tej podstawie się odzywa. Po drugie - i to jest najcenniejsze - zamiast zgadywać, zapytał o decyzję projektową: jak właściwie ma działać ten rabat (osobna funkcja, parametr w istniejącej, czy globalny stan). To dokładnie ten moment, w którym Ty, jako osoba znająca cel biznesowy, naprowadzasz rozwiązanie na właściwe tory - zanim powstała choćby linijka kodu.
3. Zatwierdzanie planu
Gdy agent zbierze wszystkie potrzebne ustalenia, przedstawia gotowy plan i pyta, czy ruszać. Masz wtedy do wyboru: zaakceptować plan i pozwolić mu działać - od razu albo z ręcznym zatwierdzaniem każdej zmiany - zlecić poprawki (napisać, co zmienić, a Claude przeplanuje) albo zostać w trybie planowania. To jest właśnie ta jedna decyzja, dla której cały tryb istnieje: zgoda na podejście, a nie na pojedynczą komendę.
Gotowy plan i jedna decyzja: zaakceptować (od razu albo z ręcznym zatwierdzaniem każdej zmiany), zlecić poprawki, albo zostać w trybie planowania - dopiero po akceptacji Claude może cokolwiek zmienić
Dopiero po akceptacji Claude wychodzi z trybu planowania i zaczyna wykonywać uzgodnione kroki - tym razem już z pełnym obrazem tego, co i dlaczego robi. Nie ma niespodzianek, bo niespodzianki zostały wyjaśnione na etapie planu.
Wskazówka: jeśli przedstawiony plan jest prawie dobry, nie odrzucaj go w całości. Napisz krótko, co poprawić („pomiń krok 3, a zamiast nowego pliku dopisz to do istniejącego”) - Claude zaktualizuje plan, zachowując resztę. To szybsze niż zaczynanie od nowa.
4. Kiedy planować, a kiedy nie
Tryb planowania to narzędzie, nie obowiązek. Włączaj go tam, gdzie kierunek rozwiązania nie jest oczywisty:
| Warto planować | Szkoda czasu na plan |
|---|---|
| Większe zmiany dotykające wielu plików | Literówka, poprawka jednego zdania |
| Refaktoryzacja istniejącego kodu | Dodanie oczywistego, krótkiego fragmentu |
| Praca w nieznanym albo cudzym projekcie | Zadanie, które robiłeś już dziesięć razy |
| Zadanie z kilkoma możliwymi podejściami | Zmiana, gdzie jest tylko jedna sensowna droga |
Reguła jest prosta: im większy koszt pójścia w złą stronę, tym bardziej opłaca się najpierw zaplanować. Przy drobiazgach plan tylko spowalnia. Przy poważnej zmianie pięć minut na uzgodnienie podejścia oszczędza pół godziny odkręcania błędnego rozwiązania. To jeden z tych nawyków, które najszybciej podnoszą jakość pracy z agentem - obok świadomego zarządzania kontekstem, o którym pisaliśmy osobno.
Szkolenie Claude Code - od zera do zespołu agentów AI
Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma termin gwarantowany - odbędzie się niezależnie od liczby zgłoszeń.
Poprzednia lekcja
Następna lekcja