Jak dopracować CLAUDE.md w pięciu krokach

W tym artykule pokażę ci, co trzeba zrobić, żeby dopracować tak ważny dokument jak CLAUDE.md.

Dobrze napisany CLAUDE.md pomaga Claude pracować zgodnie z twoim procesem, schematem i stylem. Warto więc ustawić go na samym początku. Przejdźmy do konkretów: jak wygląda ten proces?

Sedno sprawy: Najlepszy CLAUDE.md powstaje z twoich rozmów z Claude, z tego, co w nich działa, a co nie.

Mężczyzna przy laptopie zastanawia się, obok dymek z odręcznym zapisem

Krok 1: przeanalizuj swoje rozmowy z Claude

Pierwszy krok to przeanalizowanie twoich rozmów z Claude z wybranego okresu. Na tej podstawie wyciąga się wnioski: co działa, a co nie. Dzięki temu Claude może przygotować podsumowanie, czyli raport, który jasno przedstawia sytuację, wnioski i propozycje zmian.

Najwięcej mówią momenty, w których poprawiałeś Claude. Powtarzające się poprawki pomagają znaleźć zasady, których brakuje w CLAUDE.md albo które są napisane zbyt ogólnie. U mnie Claude przeczytał 221 sesji i 3433 moje wiadomości. Wyszło, że 84 razy napisałem mu „nie rozumiem”, choć w instrukcjach od dawna miałem zdanie „pisz prostym językiem”.

Poniżej masz prompt, który to zrobi. Wklej go na początku nowej sesji w Claude Code, bo to on ma dostęp do zapisów twoich rozmów na komputerze.

Zanim go wkleisz, określ, z jakiego okresu Claude ma przeanalizować rozmowy. Możesz wybrać ostatni miesiąc, dwa albo trzy. Krótszy okres pokaże twój obecny sposób pracy, a dłuższy da więcej przykładów, ale może też obejmować nawyki, które już zmieniłeś. W miejscach [data początkowa] i [data końcowa] wpisz konkretne daty w formacie RRRR-MM-DD.

Prompt · 01
## Cel
Na podstawie moich rozmów z Claude Code ustal, jakie wymagania stawiam sposobowi wykonywania zadań i komunikowania się ze mną.

Znajdź powtarzające się sytuacje, w których poprawiam sposób wykonania zadania, zwracam uwagę na błąd lub pominięcie albo potwierdzam, że dany sposób działania lub odpowiedzi jest zgodny z moimi oczekiwaniami. Uwzględnij też moje wyraźne polecenia dotyczące przyszłej współpracy.

## Po co
Analiza ma dostarczyć materiału do przygotowania moich stałych instrukcji dla Claude. Najpierw chcę ocenić, które wymagania warto w nich zapisać.

## Materiał
Przeanalizuj wszystkie dostępne lokalnie sesje Claude Code z okresu od [data początkowa] do [data końcowa], włącznie z obiema datami. Zapisy znajdziesz w folderze ~/.claude/projects.

W sesjach obejmujących także inne daty jako dowody uwzględnij tylko moje wiadomości z podanego okresu. Przeczytaj też polecenia i odpowiedzi Claude wokół tych wiadomości, żeby ustalić, czego dotyczyła moja reakcja.

## Zasady analizy
- Każdą obserwację powiąż z konkretnym zachowaniem Claude i moją reakcją na nie.
- Ocenę treści lub wyglądu konkretnego projektu uwzględnij tylko wtedy, gdy moja wiadomość określa też wymaganie dotyczące sposobu pracy Claude. Nie wyprowadzaj ogólnych preferencji z samej akceptacji pojedynczego rezultatu.
- Pochwałę uwzględnij tylko wtedy, gdy z rozmowy wynika, jakie zachowanie Claude oceniam pozytywnie. Samo „super” bez takiego kontekstu nie wystarcza.
- Jedną sytuację poprawiania tego samego błędu licz jako jeden przypadek, nawet jeśli obejmuje kilka kolejnych wiadomości. Osobny przypadek to ponowne wystąpienie problemu przy innym zadaniu lub po zakończeniu poprzedniej sytuacji.
- Rozróżnij moje wyraźne polecenia na przyszłość, wymagania powtarzające się w niezależnych zadaniach i uwagi dotyczące jednego zadania. Te ostatnie nie są podstawą do tworzenia stałej zasady.
- Oddziel zaobserwowany problem od przypuszczenia o jego przyczynie. Sam fakt, że poprawiam Claude, nie dowodzi braku zasady w instrukcjach.

## Co ma powstać
Raport napisany prostym językiem:
1. Okres objęty analizą, liczba znalezionych i przeanalizowanych sesji oraz liczba przeanalizowanych moich wiadomości. Podaj też ewentualne braki w materiale.
2. Kilka zdań o najważniejszych wnioskach.
3. Tabela z kolumnami: zachowanie Claude, moje wymaganie wynikające z reakcji, liczba przypadków, liczba różnych sesji, dowód z rozmowy.
4. Wskaż wymagania, które wyraziłem wprost jako zasady na przyszłość, oraz te, które wywnioskowałeś z powtarzających się sytuacji. Przy wnioskach zaznacz ograniczenia i kwestie wymagające mojej oceny.
5. Opisz także zachowania Claude, które wyraźnie oceniłem pozytywnie, podając dowody z rozmów.

## Ważne
- Przy przykładach podaj plik sesji i dosłowny fragment mojej wiadomości. Rozróżnij dokładne zliczenia od szacunków.
- Jeśli nie przeanalizujesz całego wskazanego materiału, oznacz raport jako częściowy i podaj, co pozostało.
- Nie pisz jeszcze instrukcji i niczego nie zmieniaj w moich plikach.

Krok 2: dodaj swoje uwagi i poproś o nową instrukcję

Przeczytaj raport. Dodaj własne spostrzeżenia i wskazówki: to, co ci pasuje, i to, co nie. Następnie poproś Claude o uaktualnienie obecnej instrukcji.

Wklej poniższy prompt w tej samej sesji, bo korzysta z raportu z kroku pierwszego. Dopracuj go, jeśli uznasz to za konieczne. Dzięki niemu otrzymasz jedną samodzielną instrukcję. Jeśli masz już dodatkowe zasady w lokalnym folderze rules, Claude uwzględni je przy analizie, ale gotowy tekst będzie zawierał potrzebne zasady bez odsyłania do plików na twoim komputerze.

Prompt · 02
## Cel
Na podstawie raportu, moich uwag i obecnych instrukcji przygotuj jedną krótką, samodzielną wersję moich globalnych instrukcji dla Claude. Wkleję ją do ustawień instrukcji na claude.ai i do pliku ~/.claude/CLAUDE.md.

Każda zasada ma określać oczekiwane zachowanie Claude oraz sytuację, w której obowiązuje, jeśli jej zakres jest ograniczony. Uwzględnij tylko zasady przydatne w różnych projektach.

## Po co
Chcę, żeby w kolejnych sesjach Claude wykonywał zadania i komunikował się ze mną zgodnie z tymi zasadami, bez powtarzania tych samych wyjaśnień i poprawek.

## Materiał
Raport, który przed chwilą przygotowałeś.
Moje uwagi do raportu: [wpisz swoje uwagi albo napisz „brak”].
Moje obecne instrukcje: [wklej je albo napisz, że jeszcze ich nie masz].

Jeśli są dostępne lokalnie, przeczytaj też ~/.claude/CLAUDE.md oraz pliki reguł w ~/.claude/rules/. Uwzględnij je jako materiał do porównania z raportem i moimi uwagami. Jeśli ich nie ma lub nie możesz ich odczytać, zaznacz to i pracuj na pozostałym materiale.

## Co ma powstać
1. Jeśli mam już instrukcje: wskaż, które wymagania z raportu już obejmują, czego brakuje oraz które zapisy są niejasne, sprzeczne lub zbędne. Uzasadnij proponowane zmiany konkretnymi zapisami instrukcji albo dowodami z raportu. Jeśli raport nie pozwala ustalić przyczyny błędu, zaznacz to.
2. Nowa wersja instrukcji w jednym bloku tekstu, gotowym do skopiowania.

## Ważne
- Instrukcje czytasz na starcie każdej rozmowy, więc mają być krótkie. Uwzględnij moje wyraźne polecenia na przyszłość oraz potwierdzone przeze mnie wnioski z raportu. Pomiń jednorazowe wymagania dotyczące konkretnych zadań oraz to, co i tak robisz dobrze bez instrukcji.
- Zachowaj zakres każdego wymagania. Nie zamieniaj prośby dotyczącej określonego rodzaju zadań w zasadę obowiązującą zawsze.
- Wnioski oznaczone w raporcie jako wymagające mojej oceny uwzględnij tylko wtedy, gdy potwierdziłem je w uwagach. W przeciwnym razie wypisz je osobno jako kwestie do rozstrzygnięcia.
- Dodaj uzasadnienie tylko tam, gdzie pomaga zrozumieć zasadę.
- Gotowa instrukcja ma działać bez dostępu do lokalnych plików. Zapisz potrzebne zasady w jej treści, bez odsyłaczy ani importów do osobnych dokumentów. Z istniejących reguł wybierz tylko te, które są uzasadnione raportem i moimi uwagami. Nie kopiuj automatycznie całej zawartości folderu rules i nie proponuj podziału instrukcji na kolejne pliki.
- Zanim zaproponujesz nową wersję, sprawdź w oficjalnej dokumentacji Anthropic, jak pisać instrukcje dla obecnych modeli.
- Niczego nie zmieniaj w moich plikach, dopóki nie zaakceptuję nowej wersji.

Krok 3: nie akceptuj od razu pierwszej wersji

Nie akceptuj od razu instrukcji, którą Claude wygenerował. Przeanalizuj ją, sprawdź i, jeśli trzeba, porozmawiaj z Claude jeszcze dokładniej. Zadbaj o to, żeby instrukcja była dobrze dopracowana. Dopiero wtedy ją wklej.

Na co zwrócić uwagę:

  • Czy zdania brzmią naturalnie. Instrukcja pisana przez AI potrafi brzmieć jak AI. Jeśli zdanie jest sklejone z listy albo sam musisz je czytać dwa razy, Claude też zrozumie je gorzej.
  • Czy jest krótka. Anthropic pisze w dokumentacji wprost: im instrukcje są konkretniejsze i krótsze, tym pewniej Claude się ich trzyma. Każde zbędne zdanie rozmywa resztę.
  • Czy mówi, po co. Najnowsze modele same wiedzą, jak wykonać zadanie. Potrzebują od ciebie celu i kontekstu: kim jesteś, czego oczekujesz i w jakim zakresie.
  • Czy nie każe Claude robić tego, co robi sam. Anthropic w zaleceniach dla Claude Opus 5 radzi usuwać ogólne polecenia typu „sprawdź jeszcze raz, zanim oddasz”, bo ten model sam to robi. Sprawdź, czy to zalecenie dotyczy też modelu, z którego korzystasz. Zachowaj konkretne wymagania, na przykład „sprawdź liczby w źródłach” albo „uruchom testy po zmianach”.

Krok 4: wdróż instrukcję

Gotowa instrukcja działa tylko tam, gdzie Claude ją przeczyta. A czyta ją z różnych miejsc, zależnie od tego, gdzie pracujesz.

Instrukcja globalna, dla wszystkich projektów na twoim komputerze. Zapisz ją w pliku ~/.claude/CLAUDE.md. Claude Code czyta ten plik zawsze, w każdym projekcie, nad którym pracujesz lokalnie. Tu trafia to, co powstało w kroku drugim: kim jesteś, jak chcesz pracować i jak Claude ma do ciebie pisać.

Instrukcja projektu, tylko dla jednego folderu. Zapisz ją w pliku CLAUDE.md w głównym folderze projektu. Claude czyta ją razem z globalną, więc nie powtarzaj w niej tego, co już jest w globalnej. Dopisz tylko to, co dotyczy tego jednego projektu. Na przykład w projekcie strony internetowej możesz zapisać, dla kogo piszesz teksty, jakich kolorów marki używasz i w którym folderze leżą artykuły. Pilnuj, żeby obie instrukcje sobie nie przeczyły. Anthropic ostrzega, że przy sprzecznych zasadach Claude może wybrać dowolną z nich.

Rozmowy na claude.ai. Wklej instrukcję także w ustawieniach konta, w polu instrukcji dla Claude. Będzie obowiązywać w twoich rozmowach na claude.ai, również w aplikacji desktopowej.

Claude Code w chmurze. Jeśli uruchamiasz zadanie w chmurze, na przykład w aplikacji desktopowej Claude z opcją Cloud, lokalny plik ~/.claude/CLAUDE.md nie jest tam dostępny. Instrukcje projektu umieść w pliku CLAUDE.md zapisanym w repozytorium, z którego korzysta sesja. Dla osobistych instrukcji Anthropic opisuje skrypt konfiguracji środowiska, który tworzy ~/.claude/CLAUDE.md w chmurze. Możesz poprosić Claude o przygotowanie go na podstawie twojej instrukcji. Samo wklejenie jej do preferencji na claude.ai nie daje podstaw do założenia, że przeczyta ją też Claude Code w chmurze.

Krok 5: testuj

Ten krok jest bardzo ważny: testuj rozmowy i sprawdzaj, czy wszystko działa. Czy nowa instrukcja daje Claude dokładnie to, czego chcesz? Czy osiągasz oczekiwany efekt?

Nowa instrukcja zaczyna działać od nowej sesji, bo Claude czyta ją na początku rozmowy. Otwórz więc nową sesję i dopiero wtedy testuj.

Najprostszy sprawdzian to twoje poprawki. Jeśli wracają te same, sprawdź, czy Claude wczytał właściwy plik i czy instrukcje sobie nie przeczą. Jeśli obie rzeczy są w porządku, przyjrzyj się samej zasadzie: może jej brakować albo może być zbyt ogólna. Wtedy po jakimś czasie powtórz cały proces.

  1. 01
  2. 02
  3. 03
  4. 04
  5. 05

Jak może wyglądać gotowa instrukcja

Poniżej pokazuję fragment moich własnych instrukcji, które wypracowałem podczas współpracy z Claude. Te zasady dotyczą tego, co jest dla mnie ważne i na co zwracam uwagę, kiedy z nim pracuję. To część większej całości. Informacje o mnie zastąpiłem miejscami w nawiasach kwadratowych.

U siebie zastanów się, na czym tobie zależy. Co Claude ma robić sam, kiedy ma zapytać cię o zdanie i jak chcesz, żeby z tobą rozmawiał? Zapisz to, co ma znaczenie w twojej pracy. Mój przykład może ci pomóc, ale twoje instrukcje powinny wynikać z twoich doświadczeń i oczekiwań.

CLAUDE.md
# Praca ze mną

## Kim jestem

Mów do mnie [twoje imię]. [Czym się zajmujesz, jednym zdaniem]. [Czego nie umiesz albo w czym nie jesteś ekspertem]. Takie sprawy tłumacz mi tak, żebym mógł podjąć decyzję albo zrobić coś sam.

## Bądź partnerem

Przytakiwanie nic mi nie daje. Wartość pracy z tobą polega na tym, że widzisz rzeczy, których ja nie widzę, i mówisz mi o nich wprost.

- Jeśli uważasz, że coś robię źle, powiedz mi to od razu. Tak samo, gdy mój pomysł niepotrzebnie wszystko komplikuje, niesie ryzyko albo powtarza coś, co już mamy, albo gdy widzisz prostszy sposób. Napisz krótko, dlaczego tak uważasz i co byś zrobił zamiast tego. Nawet jeśli o to nie pytam.
- Gdy przy zadaniu zauważysz coś obok, co warto poprawić, zaproponuj to. Zmieniaj dopiero po mojej zgodzie.
- Gdy czegoś nie wiesz, powiedz to. Pewny siebie błąd kosztuje mnie więcej niż „nie wiem”.
- Gdy po twoim sprzeciwie zdecyduję, wykonaj to i nie wracaj do tematu bez nowego argumentu.

## Jak wykonywać zadania, które ci zlecam

Chcę dostać to, o co prosiłem, w takim zakresie, o jaki prosiłem. Jak to zrobisz, zostawiam tobie.

- Jeśli zadaję pytanie albo rozmawiamy o pomyśle, odpowiedz i niczego jeszcze nie zmieniaj.
- Kiedy piszesz dla mnie tekst, nie wymyślaj niczego, czego ci nie podałem: faktów o mnie, przykładów ani ostrzeżeń.
- Kiedy poprawiasz tekst, zmieniaj tylko to, co tego wymaga.
- Drobne sprawy rozstrzygaj sam. O kierunku decyduję ja.

Wnioski

Kiedy pracujesz z Claude, z czasem widzisz, co robi zgodnie z twoimi oczekiwaniami, a co musisz mu ciągle tłumaczyć. W tych powtarzających się poprawkach znajdziesz materiał do własnych instrukcji.

U mnie ważne było, żeby Claude mówił wprost, gdy widzi problem, sam rozstrzygał drobne sprawy i pilnował zakresu zadania. Ty możesz zwracać uwagę na coś innego. Dlatego przejrzyj swoje rozmowy i wybierz zasady, które mają znaczenie w twojej pracy.

Nie musisz od razu opisać wszystkiego. Zacznij od kilku konkretnych zasad, sprawdź je w kolejnych zadaniach i poprawiaj, gdy zobaczysz, że czegoś brakuje albo Claude rozumie zapis inaczej, niż chciałeś.

Pierwszy krok

Porozmawiajmy. To zawsze jest dobry start.

Napisz kilka zdań o swojej pracy lub firmie, sytuacji i tym, czego chcesz dowiedzieć się o AI. Odezwę się, porozmawiamy i wspólnie ustalimy, od czego najlepiej zacząć.

Jeśli chcesz od razu rozpocząć praktyczną pracę z AI, dobrym rozwiązaniem może być Dzień Startowy AI. Możemy też porozmawiać o szkoleniu, warsztacie, prelekcji lub indywidualnym wdrożeniu.

Pierwsza rozmowa służy przede wszystkim temu, żeby dobrze określić potrzeby i sprawdzić, jaka forma współpracy ma w twojej sytuacji największy sens.

Administratorem danych z formularza jest Marek Prusiński AI2Expert. Szczegóły w polityce prywatności.