CLAUDE.md – konfiguracja projektu
To jeden z tych plików który robi ogromną różnicę a mało kto o nim wie.
Czym jest CLAUDE.md?
CLAUDE.md to plik tekstowy w głównym katalogu projektu który Claude Code czyta automatycznie przy każdym uruchomieniu. To Twoje instrukcje dla Claude – kontekst projektu, zasady kodowania, struktura, stack technologiczny.
Bez CLAUDE.md Claude Code musi za każdym razem samodzielnie odkrywać projekt. Z CLAUDE.md wie od razu z czym ma do czynienia.
Przykładowy CLAUDE.md dla projektu WordPress
# Projekt: Sklep giemza.nl
## Stack technologiczny
- WordPress 6.5
- PHP 8.2
- MySQL 8.0
- Motyw: GeneratePress Premium (child theme)
- WooCommerce 9.x
## Struktura projektu
- /wp-content/themes/giemza-child/ ← aktywny child theme
- /wp-content/plugins/giemza-custom/ ← własna wtyczka
- Nie modyfikuj plików poza tymi katalogami
## Zasady kodowania
- PHP: PSR-12 + WordPress Coding Standards
- Komentarze: po polsku
- Nazwy funkcji i klas: przedrostek "giemza_"
- Zawsze sanityzuj input, escapuj output
- Używaj nonces dla formularzy
## Ważne informacje
- Środowisko deweloperskie: localhost:8080
- Produkcja: giemza.nl
- Backup przed każdą zmianą w bazie
## Czego NIE robić
- Nie edytuj plików core WordPress
- Nie używaj przestarzałych funkcji WP (sprawdź czy są deprecated)
- Nie commituj danych wrażliwych (.env, wp-config.php)
Gdzie umieścić CLAUDE.md?
projekt/
├── CLAUDE.md ← główne instrukcje
├── wp-content/
│ └── themes/
│ └── moj-motyw/
│ └── CLAUDE.md ← opcjonalne, dla konkretnego modułu
Co warto wpisać do CLAUDE.md?
- Stack technologiczny – wersje, frameworki, biblioteki
- Strukturę projektu – co jest gdzie i po co
- Zasady kodowania – standardy, prefiksy, konwencje
- Czego NIE robić – ograniczenia, pliki których nie ruszać
- Kontekst biznesowy – dla kogo, jaki cel
- Środowisko – dev vs produkcja, bazy danych, porty
Im więcej kontekstu dasz w CLAUDE.md, tym mniej będziesz powtarzał te same informacje w każdej rozmowie. Oszczędza czas i tokeny.
Następna strona: Skille i MCP w Claude Code