Bolek › Poradniki › 1 listopada 2026
Jak napisać plik CLAUDE.md po polsku? Poradnik (2026)
Poradnik · · Maciej Głuszak · wersja .md
W skrócie: CLAUDE.md to plik z zasadami, który Claude Code czyta na starcie każdej rozmowy. Najszybciej napiszesz go, gdy asystent zada Ci kilka pytań i sam ułoży z odpowiedzi krótki plik po polsku.
Wklej do Claude Code:
Przeprowadź ze mną krótki wywiad – maksymalnie 7 pytań, jedno na raz – i na tej podstawie napisz w tym folderze plik CLAUDE.md po polsku: w jakim języku odpowiadać, czego nie robić bez pytania, jak nazywać pliki i jak sprawdzać wynik. Najwyżej 40 linii, każda zasada jednym zdaniem.
Aktualizacja: · sprawdzone na: Claude Code 2.1, Windows 11
Claude Code nie pamięta poprzedniej rozmowy. Pamięta to, co zapiszesz w pliku CLAUDE.md – asystent wczytuje go na początku każdej rozmowy i traktuje jak instrukcję obsługi Ciebie. Bolek, nasz asystent AI na Windows, stoi na takim pliku od pierwszego dnia, więc wszystko poniżej sprawdziliśmy na sobie.
Gdzie leży plik i który wygrywa
| plik | gdzie | do czego |
|---|---|---|
| CLAUDE.md w folderze pracy | w folderze, w którym uruchamiasz claude | zasady jednego projektu: nazwy, układ folderów, jak sprawdzać wynik |
| CLAUDE.md w profilu | w folderze .claude w Twoim profilu użytkownika | zasady dla wszystkich projektów naraz: język, ton, czego nie robić bez pytania |
Asystent czyta oba. Gdy zasady się kłócą, wygrywa ta bliżej pracy, czyli plik z folderu projektu. Język i ton wpisz raz, w profilu – nie musisz ich powtarzać w każdym projekcie.
Krok po kroku
- Otwórz terminal w folderze projektu i uruchom claude.
- Wklej polecenie z ramki na górze tej strony i odpowiedz na pytania asystenta.
- Przeczytaj gotowy plik i skreśl każdą zasadę, której nie rozumiesz albo z którą się nie zgadzasz.
- Zacznij nową rozmowę i sprawdź, czy asystent stosuje zasady – na przykład poproś o nowy plik i zobacz jego nazwę.
- Gdy poprawiasz asystenta drugi raz w tej samej sprawie, dopisz to jedną linią do pliku.
Wbudowane polecenie /init też tworzy taki plik, ale opisuje głównie kod projektu i pisze po angielsku. Jeśli z niego korzystasz, dopisz od razu: „napisz ten plik po polsku”.
Szkielet, od którego zaczynamy
Cztery sekcje wystarczą na start:
- Język i ton – „odpowiadaj po polsku, krótko, bez wstępów”.
- Czego nie robić bez pytania – wysyłanie maili, publikacja, kasowanie plików, płatności.
- Nazwy i porządek – „nazwy plików i folderów bez polskich znaków”, „wyniki zapisuj w folderze wyniki”.
- Jak sprawdzić, że skończone – „zanim powiesz, że gotowe, otwórz plik i sprawdź wynik”.
Pięć pułapek, na które sami wpadliśmy
- Za długi plik. Plik czytany na starcie każdej rozmowy kosztuje miejsce w pamięci roboczej asystenta. Przy kilkuset linijkach zasady zaczynają się gubić. Szczegóły przenieś do osobnych plików i wskaż je w CLAUDE.md jedną linią.
- Zasady bez powodu. „Nie wysyłaj maili” działa słabiej niż „nie wysyłaj maili bez mojego potwierdzenia – raz poszedł szkic do klienta”. Powód pomaga asystentowi rozstrzygnąć przypadek, którego nie przewidziałeś.
- Ogólniki. „Pisz ładnie” nic nie znaczy. „Zdania najwyżej na dwie linijki, bez wykrzykników” da się sprawdzić.
- Sprzeczne zasady. Dwie zasady, które się kłócą, kończą się tym, że asystent wybiera losowo. Raz na jakiś czas przeczytaj plik od góry do dołu.
- Hasła w pliku. CLAUDE.md to zwykły tekst, który często trafia do repozytorium. Hasła i klucze trzymaj w osobnym, prywatnym pliku poza projektem.
Częste pytania
Czy CLAUDE.md może być po polsku? Tak. Asystent rozumie polskie zasady tak samo dobrze jak angielskie. My piszemy po polsku od pierwszego dnia.
Jak sprawdzić, które zasady asystent wczytał? Polecenie /memory w rozmowie pokazuje pliki z zasadami, które są w użyciu, i pozwala je otworzyć do edycji.
Co, jeśli asystent łamie zasadę? Najczęściej zasada jest za ogólna albo zginęła w długim pliku. Skróć ją do jednego konkretnego zdania i przenieś wyżej.
Gotowy skill do pobrania: claude-md-po-polsku.zip (podgląd SKILL.md). Rozpakuj do folderu skills w katalogu .claude w swoim profilu użytkownika – Claude Code wczyta go przy następnej rozmowie. Sam plik z instrukcjami, bez programów do uruchomienia.
Albo jedną linią w terminalu (marketplace na GitHubie):
claude plugin marketplace add MokebeGluszak/bolekrobot-skills; claude plugin install claude-md-po-polsku@bolekrobotTe lekcje pochodzą z codziennej pracy z Bolkiem, asystentem AI na Windows. Własny Bolek – wdrożenie u Ciebie albo zostaw kontakt – odezwiemy się w ciągu 1 dnia roboczego.