CLAUDE.md i Tryb Planowania (Plan Mode)

Dotarliśmy do prawdziwych skarbów, @name! Te funkcje odróżniają zwykłe "gadanie z AI" od profesjonalnego vibecodingu z Claude Code. 🗺️💎

CLAUDE.md - serce projektu

Najważniejszym plikiem w pracy z Claude Code jest CLAUDE.md - markdownowy plik w katalogu głównym projektu, który Claude automatycznie wczytuje na początku każdej sesji. To Twoja mapa przekazywana nawigatorowi, zanim postawi stopę na pokładzie.

Co umieścić w CLAUDE.md?

• Konwencje - jak nazywać pliki, jaki styl kodu, jak formatować
• Architektura - struktura katalogów, kluczowe moduły
• Komendy - jak uruchomić projekt, testy, linter, build

Jak go wygenerować?

Najprościej - niech Claude zrobi to za Ciebie. Wpisz w sesji:

1/init

Claude przeanalizuje projekt i wygeneruje gotowy CLAUDE.md. Możesz go potem edytować ręcznie albo komendą

/memory

.

Hierarchia plików CLAUDE.md

• ~/.claude/CLAUDE.md

  - globalny, działa we wszystkich projektach

• CLAUDE.md

  - w katalogu głównym projektu

• CLAUDE.md

  w podkatalogach - dla konkretnych części projektu

Przykładowy CLAUDE.md:

1# Mój Projekt - Sklep Online
2
3## Stack
4- Next.js + TypeScript
5- Tailwind CSS
6- Prisma + PostgreSQL
7
8## Komendy
9- `npm run dev` - serwer deweloperski
10- `npm test` - testy
11- `npm run lint` - linter
12
13## Konwencje
14- Komponenty: PascalCase w src/components/
15- Zawsze dodawaj typy TypeScript
16- Testy obok plików, w katalogu __tests__/

Tryb planowania (Plan Mode) - najnowsza moc

To jedna z najnowszych i najważniejszych funkcji Claude Code. W trybie planowania Claude najpierw bada projekt i proponuje PLAN działania, a dopiero po Twojej akceptacji zabiera się za edycję plików.

To idealne do dużych, ryzykownych zmian - widzisz, co Claude zamierza zrobić, ZANIM zacznie ruszać kod.

Jak włączyć tryb planowania?

Są dwa sposoby:

1. Klawiszem Shift+Tab - przełącza tryby uprawnień w sesji; jeden z nich to właśnie tryb planowania
2. Flagą przy starcie:

1claude --permission-mode plan "Przebuduj system autoryzacji na JWT"

Tryby uprawnień (permission modes)

Claude Code ma kilka trybów, które decydują, na ile samodzielnie może działać:

• default

  - pyta o zgodę przed ważnymi akcjami (domyślny)

• plan

  - tylko planuje i bada, nie edytuje, dopóki nie zatwierdzisz

• acceptEdits

  - automatycznie akceptuje edycje plików

• bypassPermissions

  - pomija pytania o uprawnienia (ostrożnie!)

Przełączasz je w locie klawiszem Shift+Tab albo flagą

--permission-mode

.

Workflow z trybem planowania

1# 1. Włącz tryb planowania
2claude --permission-mode plan "Dodaj koszyk zakupowy do sklepu"
3
4# 2. Claude bada projekt i przedstawia PLAN:
5#    - jakie pliki utworzy
6#    - jakie zmodyfikuje
7#    - w jakiej kolejności
8
9# 3. Czytasz plan i go akceptujesz
10
11# 4. Dopiero teraz Claude wykonuje zmiany w kodzie

Ustawienia i uprawnienia (settings.json)

Zachowaniem Claude Code sterujesz przez pliki ustawień:

• .claude/settings.json

  - ustawienia projektu (commitowane do repo)

• ~/.claude/settings.json

  - ustawienia globalne

W ustawieniach definiujesz reguły uprawnień - wzorce allow/deny:

1// .claude/settings.json
2{
3  "permissions": {
4    "allow": [
5      "Bash(git*)",
6      "Bash(npm run test)"
7    ],
8    "deny": [
9      "Bash(rm -rf*)"
10    ]
11  }
12}

Dzięki temu np. polecenia

git

wykonają się bez pytania, a niebezpieczne

rm -rf

będą zablokowane. W ustawieniach możesz też zdefiniować zmienne środowiskowe, domyślny model oraz hooki (o nich w następnym ćwiczeniu).

Zarządzanie kontekstem w długich sesjach

Im dłuższa rozmowa, tym więcej kontekstu zużywasz. Dwie kluczowe komendy:

1# Wyczyść kontekst i zacznij od czystej karty
2/clear
3
4# Streść dotychczasową rozmowę i kontynuuj (zachowuje sedno, oszczędza tokeny)
5/compact

Koszt sesji sprawdzisz komendą:

1/cost

Podsumowanie 🎓

✅ CLAUDE.md - pamięć projektu, automatycznie wczytywana; generuj przez

/init

✅ Hierarchia - globalny

~/.claude/CLAUDE.md

+ projektowy + zagnieżdżone ✅ Plan Mode - Claude planuje przed edycją;

Shift+Tab

lub

--permission-mode plan

✅ Tryby uprawnień - default / plan / acceptEdits / bypassPermissions ✅ settings.json - reguły allow/deny (np.

Bash(git*)

), env, model ✅ Kontekst -

/clear

,

/compact

, koszt przez

/cost

W ostatnich dwóch ćwiczeniach poznasz subagentów, skille, MCP i hooki - czyli to, co naprawdę nowe w Claude Code!

Do zobaczenia! 🚀