Blog JSystems - uwalniamy wiedzę!

Szukaj

Claude Code

Plan mode w Claude Code - kiedy i jak używać

W skrócie

  • Przy większej zmianie Claude Code od razu zaczyna edytować pliki, a Ty nie masz szansy zobaczyć planu, zanim cokolwiek dotknie dysku.
  • To domyślne, agentowe zachowanie: bez trybu planowania Claude Code po prostu wykonuje zadanie, bo tak jest zaprojektowany.
  • Rozwiązaniem jest tryb planowania (plan mode) - Claude Code tylko czyta i proponuje plan, a edycje są zablokowane, dopóki go nie zatwierdzisz.

Tryb planowania w Claude Code, oficjalnym narzędziu CLI od Anthropic do programowania z AI, oddziela research i projektowanie zmiany od jej wykonania. W tym trybie Claude Code czyta pliki, uruchamia polecenia rozpoznawcze i pisze plan, ale nie zmienia Twojego kodu. To najprostszy sposób, żeby uniknąć sytuacji, w której model rozwiązuje niewłaściwy problem albo przebudowuje pół projektu, zanim zdążysz zareagować. Poniżej pokazujemy, kiedy go używać i jak przez niego przejść.

Jak to wygląda w praktyce

Prosisz o dodanie logowania przez Google, a Claude Code po chwili zaczyna tworzyć i edytować pliki w kilku miejscach naraz. Zmiany są rozsądne, ale nie takie, jak sobie wyobrażałeś - a już są na dysku. Przy prostym zadaniu to nie problem, bo można cofnąć. Przy zmianie dotykającej wielu plików albo w kodzie, którego dobrze nie znasz, kosztuje to sporo sprzątania. Objaw, że powinieneś był włączyć tryb planowania: łapiesz się na tym, że przerywasz Claude Code i tłumaczysz "nie tak, chciałem inaczej".

Dlaczego Claude Code tak działa

Claude Code to środowisko agentowe: opisujesz cel, a narzędzie samo eksploruje, planuje i wdraża. To jego siła, ale to też powód, dla którego domyślnie działa, a nie czeka. Dokumentacja Anthropic mówi wprost: wpuszczenie Claude Code prosto w kodowanie potrafi dać kod rozwiązujący niewłaściwy problem, dlatego zaleca oddzielenie eksploracji od wykonania. Tryb planowania jest właśnie tą barierą - z założenia trzyma edycje zablokowane, dopóki nie zaakceptujesz planu.

Jak to rozwiązać krok po kroku

  1. Wejdź w tryb planowania. W trakcie sesji naciskaj Shift+Tab, aż na pasku stanu pojawi się ⏸ plan mode on. Możesz też wystartować od razu w tym trybie komendą claude --permission-mode plan, albo poprzedzić jeden prompt komendą /plan.
  2. Faza eksploracji: poproś Claude Code, żeby przeczytał odpowiednie pliki i zrozumiał, jak działa dany fragment. Na tym etapie model tylko czyta i odpowiada, nie zmienia źródeł.
  3. Faza planu: poproś o szczegółowy plan wdrożenia - które pliki się zmienią, jaki będzie przepływ, na co uważać. Claude Code przedstawi plan jako propozycję.
  4. Jeśli chcesz poprawić plan ręcznie, naciśnij Ctrl+G, żeby otworzyć go w swoim edytorze tekstu i edytować przed wykonaniem.
  5. Zatwierdź plan. Claude Code pokaże opcje: "Yes, and use auto mode" (albo "Yes, auto-accept edits", zależnie od sesji), "Yes, manually approve edits" (będziesz akceptować każdą edycję po kolei) oraz "No, keep planning" (zostań w trybie planowania i dopowiedz, co zmienić).
  6. Po zatwierdzeniu Claude Code wychodzi z trybu planowania i zaczyna kodować zgodnie z planem. Możesz od razu dorzucić polecenie w stylu "wdroż plan, dopisz testy do modułu callback i uruchom je".
  7. Żeby zaplanować kolejną zmianę, wróć do trybu planowania przez Shift+Tab albo poprzedź następny prompt komendą /plan. Aby wyjść z trybu bez zatwierdzania planu, naciśnij Shift+Tab ponownie.

Jak sprawdzić, że zadziałało

Najprostszy dowód, że jesteś w trybie planowania, to napis ⏸ plan mode on na pasku stanu. W tym trybie zleć edycję i potwierdź, że Claude Code nie zapisuje zmian, tylko opisuje, co zrobiłby. Kiedy zatwierdzisz plan, pasek zmieni tryb (na przykład na tryb akceptacji edycji), a Claude Code zacznie wprowadzać zmiany - to znak, że przejście z planowania do wykonania zadziałało. Warto pamiętać, że tryb planowania dokłada narzut, więc do drobiazgów, które opiszesz jednym zdaniem (literówka, jedna linia logu, zmiana nazwy zmiennej), Anthropic zaleca po prostu poprosić o wykonanie wprost, bez planu.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI, prowadzi Łukasz Matuszewski (JSystems)

Szkolenie Claude Code - od zera do zespołu agentów AI -->

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 terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5

Najczęściej zadawane pytania

Jak wejść w tryb planowania w Claude Code?
W trakcie sesji naciskaj Shift+Tab, aż na pasku stanu pojawi się napis plan mode on. Możesz też wystartować od razu w tym trybie komendą claude --permission-mode plan albo poprzedzić pojedynczy prompt komendą /plan. W trybie planowania Claude Code czyta i proponuje plan, ale nie edytuje kodu.
Jak zatwierdzić plan i przejść do wykonania?
Gdy plan jest gotowy, Claude Code pokazuje opcje: zatwierdzenie z automatyczną akceptacją edycji, zatwierdzenie z ręcznym akceptowaniem każdej zmiany oraz pozostanie w trybie planowania, żeby dopowiedzieć poprawki. Po zatwierdzeniu narzędzie wychodzi z planowania i zaczyna kodować zgodnie z planem.
Czy mogę poprawić plan, zanim Claude Code zacznie kodować?
Tak, naciśnij Ctrl+G, żeby otworzyć proponowany plan w swoim domyślnym edytorze tekstu i edytować go bezpośrednio przed wykonaniem. To wygodne, gdy chcesz dodać krok, usunąć zbędny fragment albo zmienić kolejność, zanim narzędzie tknie kod.
Kiedy nie warto używać trybu planowania?
Przy drobnych zmianach o jasnym zakresie, które opiszesz jednym zdaniem, na przykład literówka, jedna linia logu albo zmiana nazwy zmiennej. Tryb planowania dokłada narzut, więc dla takich zadań lepiej poprosić o wykonanie wprost. Planowanie zwraca się przy zmianach dotykających wielu plików i w nieznanym kodzie.

Komentarze (0)

Musisz być zalogowany by móc dodać komentarz. Zaloguj się przez Google

Brak komentarzy...