Chcesz, żeby AI przeanalizowało Twój kod — ale boisz się, że coś zmieni bez Twojej wiedzy? Plan Mode w Claude Code rozwiązuje ten problem. Agent czyta, myśli, planuje — ale nie dotyka ani jednego pliku, dopóki nie będziesz gotowy.
- Czym jest Plan Mode
- Kiedy używać Plan Mode
- Jak włączyć Plan Mode
- Przykład: Planowanie złożonego refaktoringu
- Porównanie trybów uprawnień
- Najlepsze praktyki
Czym jest Plan Mode
Plan Mode to tryb pracy Claude Code, w którym agent analizuje kod wyłącznie poprzez operacje tylko do odczytu. Może czytać pliki, przeszukiwać bazę kodu, odpowiadać na pytania — ale nie może niczego edytować ani uruchamiać komend.
W praktyce oznacza to:
- Pełny dostęp do odczytu — Claude widzi wszystkie pliki, rozumie strukturę projektu
- Blokada zmian — żadne edycje, żadne komendy shell
- Interaktywne planowanie — Claude zadaje pytania, doprecyzowuje wymagania
- Bezpieczna eksploracja — możesz badać kod bez ryzyka przypadkowych zmian
Idea: Plan Mode to jak konsultacja z architektem przed remontem. Architekt ogląda dom, analizuje konstrukcję, proponuje rozwiązania — ale nic nie burzy, dopóki nie zatwierdzisz planu.
Kiedy używać Plan Mode
Plan Mode sprawdza się najlepiej w trzech scenariuszach:
Wielokrokowe implementacje
Gdy funkcjonalność wymaga zmian w wielu plikach, warto najpierw stworzyć plan. Claude przeanalizuje zależności, zidentyfikuje miejsca do modyfikacji i zaproponuje kolejność zmian — zanim dotknie pierwszego pliku.
Eksploracja kodu
Dołączyłeś do nowego projektu? Plan Mode pozwala zadawać pytania o architekturę, wzorce, konwencje — bez ryzyka, że przypadkowo coś zmienisz podczas nauki.
Interaktywne dopracowywanie pomysłów
Czasem nie wiesz dokładnie, czego chcesz. Plan Mode umożliwia iteracyjną rozmowę: proponujesz kierunek, Claude doprecyzowuje, Ty koregujesz — dopóki plan nie będzie idealny.
Jak włączyć Plan Mode
Masz trzy sposoby na aktywację Plan Mode:
W trakcie sesji
Użyj Shift+Tab do przełączania między trybami. Pierwszy raz przełącza na Auto-Accept Mode (⏵⏵ accept edits on), drugi raz na Plan Mode (⏸ plan mode on).
Przy starcie sesji
claude --permission-mode plan
Dla jednorazowego zapytania (headless)
claude --permission-mode plan -p "Przeanalizuj system autoryzacji i zaproponuj ulepszenia"
| Metoda | Komenda / Skrót | Użycie |
| W sesji | Shift+Tab (2x) | Szybkie przełączanie |
| Start sesji | --permission-mode plan | Cała sesja w Plan Mode |
| Headless | -p z --permission-mode plan | Jednorazowa analiza |
Przykład: Planowanie złożonego refaktoringu
Załóżmy, że chcesz przepisać system autoryzacji na OAuth2. Zamiast od razu edytować kod, najpierw stwórz plan.
Start:
claude --permission-mode plan
Pierwszy prompt:
Muszę przebudować nasz system autoryzacji na OAuth2.
Stwórz szczegółowy plan migracji.
Claude analizuje aktualną implementację: przegląda pliki, identyfikuje punkty integracji, sprawdza zależności. Następnie przedstawia plan.
Doprecyzowanie:
A co z kompatybilnością wsteczną?
Jak powinniśmy przeprowadzić migrację bazy danych?
Claude odpowiada, rozbudowuje plan, uwzględnia nowe wymagania.
Edycja planu: Naciśnij Ctrl+G — plan otworzy się w Twoim domyślnym edytorze tekstu. Możesz go ręcznie poprawić, zanim Claude przejdzie dalej.
Gdy plan jest gotowy, wyłącz Plan Mode (Shift+Tab) i powiedz Claude, żeby go zrealizował.
Porównanie trybów uprawnień
| Tryb | Odczyt | Edycja | Komendy | Użycie |
| default | ✅ Tak | ✅ Pyta | ✅ Pyta | Codzienna praca |
| acceptEdits | ✅ Tak | ✅ Auto | ✅ Pyta | Szybkie kodowanie |
| plan | ✅ Tak | ❌ Nie | ❌ Nie | Bezpieczna analiza |
| dontAsk | ✅ Tak | ❌ Domyślnie nie | ❌ Domyślnie nie | Restrykcyjne |
Plan Mode to najbardziej restrykcyjny tryb pod względem działań, ale daje pełny dostęp do informacji. To idealne połączenie dla eksploracji i planowania.
Najlepsze praktyki
Checklista Plan Mode:
- ✅ Zacznij od Plan Mode przy złożonych zadaniach
- ✅ Używaj Ctrl+G do ręcznej edycji wygenerowanych planów
- ✅ Doprecyzowuj wymagania iteracyjnie — Claude zadaje pytania
- ✅ Przełącz na normalny tryb dopiero gdy plan jest kompletny
- ✅ Zapisz plan do pliku przed implementacją (dla dokumentacji)
Konfiguracja jako domyślny tryb
Dla zespołów, które preferują ostrożne podejście:
// .claude/settings.json
{
"permissions": {
"defaultMode": "plan"
}
}
Każda sesja startuje w Plan Mode. Programiści świadomie przełączają się na tryb edycji, gdy są gotowi.
Więcej o konfigurowaniu uprawnień znajdziesz w artykule o bezpieczeństwie i kontroli uprawnień w Claude Code. A jeśli dopiero zaczynasz, sprawdź kompletny poradnik instalacji.
Bezpieczne wdrożenie agentów AI