Planowanie z Claude Code: zatwierdzony plan przed pierwszą linią kodu

Sekcja planowania w Claude Code to cztery przewodniki dla programistów i tech leadów, które zamieniają cel w plan zatwierdzany, zanim zmieni się jakikolwiek plik: mapowanie nieznanej bazy kodu, projekt funkcji, wybór architektury i start nowego projektu. Każdy z nich korzysta z trybu planowania (plan), który blokuje edycje do chwili akceptacji planu.

Prosisz Claude Code o „logowanie przez OAuth”, a po 40 minutach masz 900 zmienionych linii opartych na modelu sesji, z którego zespół zrezygnował w poprzednim kwartale. Problemem nie jest kod, tylko to, że nikt nie uzgodnił jego kształtu przed napisaniem. Planowanie przenosi twój przegląd na jednostronicowy plan z testowalnymi kryteriami akceptacji, więc diff musi zgadzać się z kontraktem, a nie z tym, co pamiętasz.

Wymaganie wstępne: Claude Code zainstalowany, zalogowany i uruchomiony w twoim repozytorium. Jeśli jeszcze nie jest, zacznij od szybkiego startu Claude Code.

Którego przewodnika po planowaniu potrzebujesz?

Twoja sytuacja	Zacznij od	Z czym wychodzisz
Dołączasz do projektu i nie wiesz, gdzie co leży	Jak zrozumieć nieznaną bazę kodu	Mapę z cytowaniami plików, potwierdzoną zielonym testem
Masz zgłoszenie funkcji i jeszcze żadnego projektu	Planowanie funkcji z głębokim rozumowaniem	Specyfikację z kryteriami akceptacji i listą zadań
Musisz wybrać między projektami albo zaplanować migrację	Analiza architektury i projektowanie systemów	ADR i etapowy, odwracalny plan migracji
Zaczynasz od pustego katalogu	Nowy projekt z terminala	Działającą usługę, zielone CI i CLAUDE.md z poleceniami budowania i testów

Rozpocznij sesję w trybie planowania

Tryb planowania to jeden z trybów uprawnień. Claude czyta pliki, a tam, gdzie dostępny jest tryb automatyczny (auto mode), uruchamia polecenia zatwierdzone przez jego klasyfikator; każda edycja pozostaje zablokowana, dopóki nie zatwierdzisz planu. Aby od razu uruchomić sesję w trybie planowania, wpisz w terminalu:

claude --permission-mode plan --effort high

Aby przełączyć trwającą sesję, wpisz w prompcie Claude Code /plan i cel albo naciskaj Shift+Tab, aż wskaźnik trybu pokaże tryb planowania:

/plan add rate limiting to the public API

Od v2.1.280 (kanał latest) Claude Code startuje na modelu Claude Opus 5.5 z poziomem effort ustawionym na medium we wszystkich płatnych planach i w API Anthropic (Microsoft Foundry domyślnie używa Sonneta 4.5). Przy planowaniu podnieś effort do high lub xhigh, zanim zmienisz model; opusplan, Claude Fable 5.1, wersje i ceny opisuje przegląd modeli.

Uwaga

W kanale stable (2.1.274 w dniu 2026-09-26) Opus 5.5 nie jest dostępny: plany Pro i Team Standard domyślnie używają Sonneta 5, a Max, Team Premium, Enterprise i API – Opusa 5.

Jak sprawdzić plan, nie czytając każdej linii wyniku?

Plan zasługuje na akceptację, gdy każde jego twierdzenie da się sprawdzić narzędziem, a nie pamięcią o kodzie. Zanim go zaakceptujesz, upewnij się, że ma te pięć części:

1. Kryteria akceptacji, z których każde wskazuje nazwany test, napisany tak, by przed implementacją był czerwony. Zobacz wykonywalne kryteria akceptacji.
2. Cytowania w formie path:line przy każdym twierdzeniu o istniejącym kodzie, tak by grep mógł je potwierdzić.
3. Pliki w zakresie i poza nim. Testy i migracje, których agent nie może edytować, trafiają na listę „poza zakresem”.
4. Polecenia weryfikacji, dokładnie takie, jakie uruchamia CI: testy, typecheck, lint.
5. Wycofanie: jak zmianę cofnąć albo wyłączyć.

Po implementacji zatwierdzasz dowody: nowe testy przeszły z czerwonych na zielone, CI przechodzi, a diff dotyka tylko plików z zakresu. Plan funkcji zatwierdza programista; wszystko, co zmienia decyzję architektoniczną, zatwierdza tech lead. Uzasadnienie znajdziesz w tekście dowody zamiast diffów.

Prompt do skopiowania: plan, który da się zweryfikować

Plan this change; do not edit anything yet: add per-API-key rate limiting
(100 requests per minute) to the public REST endpoints.

Produce a plan with exactly these sections:
1. Current state: how requests reach the handlers today, with path:line
   citations for every claim.
2. Acceptance criteria: 3-6 Given/When/Then statements, each mapped to the
   name of a test that will fail before the change and pass after it.
3. Files to change, and files you must not touch (existing tests, migrations).
4. Steps in order, each small enough to review on its own.
5. Verification: the exact test, typecheck, and lint commands CI runs.
6. Rollback: how to switch the limit off without a deploy.
List open questions at the end instead of guessing.

Prompt do skopiowania: podważ plan, zanim go zatwierdzisz

Use a subagent to review the plan above against the codebase. It must:
- check every path:line citation and report any that are wrong;
- name any caller, job, or config the plan misses that reads the code it changes;
- say which acceptance criterion could pass while the feature is still broken.
Report findings only. Then revise the plan and mark each change.

Po akceptacji poproś Claude’a, by przed pierwszą edycją zapisał plan jako docs/plans/<topic>.md; wtedy przetrwa /compact, nową sesję i przekazanie pracy.

Co się psuje przy planowaniu z Claude Code?

Objaw	Prawdopodobna przyczyna	Jak to naprawić
Plan jest ogólnikowym konspektem	Prompt podał cel, a nie ograniczenia	Wymień wymagane sekcje, jak w pierwszym prompcie, i wskaż pliki, które mają znaczenie
Plan cytuje pliki lub funkcje, które nie istnieją	Twierdzenia oparte na założeniach	Uruchom prompt z przeglądem; odrzuć każdy plan z błędnym cytowaniem
Implementacja odjeżdża od zatwierdzonego planu	Plan istniał tylko w rozmowie	Zapisz go w docs/plans/, a w każdej nowej sesji napisz: „Follow docs/plans/X.md; stop and ask before deviating”
Kontekst zapełnia się w trakcie eksploracji	Główna sesja przeczytała całe drzewo katalogów	Zleć eksplorację wbudowanemu subagentowi Explore; zobacz analizę bazy kodu
Edycje pojawiły się przed akceptacją	Sesja nie była w trybie planowania; od v2.1.283 (kanał latest) sesje interaktywne startują w trybie auto	Sprawdź wskaźnik trybu pod promptem; cofnij zmiany przez /rewind (albo Esc Esc) i zacznij od nowa z --permission-mode plan
/ultraplan nie jest dostępny	Zniknął z listy poleceń w v2.1.222 i domyślnie jest wyłączony	Używaj /plan

Co dalej, gdy plan jest zatwierdzony

• Spec-driven development: to specyfikacja, a nie kod, jest tym, co ludzie przeglądają, niezależnie od narzędzia.
• Budowanie z Claude Code: wykonanie zatwierdzonego planu.
• Etapy planowania i budowania w metodzie: jak intent.md zasila ten plan i jak zatwierdzony plan.md prowadzi implementację oraz jej dowody.
• Ten sam etap w innych narzędziach: planowanie z Codexem i planowanie z Cursorem.

Jak zrozumieć nieznaną bazę kodu Zmapuj repozytorium w trybie planowania, zanim zaplanujesz jakąkolwiek zmianę