Blog JSystems - uwalniamy wiedzę!

Szukaj

Claude Code

Claude Code powtarza te same błędy - zapisz regułę w CLAUDE.md

W skrócie

  • Claude Code popełnia w kółko ten sam błąd, mimo że poprawiasz go w czacie za każdym razem.
  • Poprawki w rozmowie znikają wraz z sesją - Claude Code nie pamięta ich w następnej, bo trwałe zasady trzyma w CLAUDE.md.
  • Zapisz reguły w CLAUDE.md (ręcznie albo skrótem z prefiksem hash), tak by opisywały konkretny błąd i pożądane zachowanie, i sprawdź je komendą /memory.

Nic tak nie męczy jak poprawianie tej samej rzeczy trzeci raz w tym samym tygodniu. Claude Code robi jakiś błąd, Ty go korygujesz, w tej sesji jest dobrze, a w kolejnej wszystko wraca. Powód jest prosty i da się go usunąć raz na zawsze: poprawki w czacie są jednorazowe, a trwałe zasady zapisuje się w CLAUDE.md. Pokazujemy, jak zamienić powtarzalne uwagi w regułę.

Jak to wygląda w praktyce

Wzorzec jest zawsze taki sam. Claude Code robi coś w określony sposób, który Ci nie odpowiada - używa złej komendy, dodaje niepotrzebny import, formatuje kod inaczej niż reszta, dopisuje rzeczy, o które nie prosiłeś. Zwracasz uwagę, poprawia się na bieżąco, ale przy następnym zadaniu albo w nowej sesji błąd wraca.

Z czasem masz listę uwag, które powtarzasz jak mantrę. To jasny sygnał, że te uwagi powinny przestać być jednorazowymi komentarzami, a stać się stałą częścią pamięci projektu.

Dlaczego Claude Code tak działa

Poprawka wpisana w czacie działa tylko w obrębie bieżącej rozmowy. Gdy sesja się kończy albo zaczynasz nowe zadanie z czystą historią, ta uwaga już nie obowiązuje - nie została nigdzie utrwalona. To nie jest wada, tylko naturalna granica pojedynczej rozmowy.

Trwała pamięć żyje gdzie indziej: w plikach CLAUDE.md, które Claude Code wczytuje na starcie każdej sesji. Dlatego zasada zapisana w CLAUDE.md obowiązuje od pierwszej wiadomości w każdej nowej rozmowie, a nie tylko w tej jednej, w której akurat coś poprawiłeś. Claude Code daje nawet skrót: linię zaczynającą się od znaku hash w polu wpisu można szybko dopisać do pamięci.

Jak to rozwiązać krok po kroku

  1. Wypisz błędy, które powtarzasz najczęściej. Dla każdego zapisz krótko: co Claude Code robi źle i co ma robić zamiast tego.
  2. Otwórz albo utwórz CLAUDE.md w korzeniu projektu (jeśli zasada dotyczy tylko tego repozytorium) lub w ~/.claude/CLAUDE.md (jeśli ma obowiązywać we wszystkich Twoich projektach).
  3. Zapisz każdą regułę jako jednoznaczne zdanie rozkazujące, na przykład co jest zakazane i jaka jest poprawna alternatywa. Dodaj krótki przykład, jeśli sam opis może być niejasny.
  4. Zamiast edytować plik ręcznie, możesz użyć skrótu: w polu wpisu zacznij linię od znaku #, a Claude Code zaproponuje dopisanie tej myśli do pamięci.
  5. Grupuj pokrewne reguły i nadaj im czytelne nagłówki, żeby plik pozostał przejrzysty w miarę, jak przybywa zasad.
  6. Zapisz plik i uruchom nową sesję, żeby reguły z korzenia zostały wczytane na starcie.

Jak sprawdzić, że zadziałało

Sprawdź przez /memory, że nowa reguła znalazła się na liście wczytanych plików pamięci. To potwierdzenie u źródła, że zasada w ogóle jest widziana.

Potem odtwórz sytuację, w której błąd wcześniej wracał - najlepiej w zupełnie nowej sesji. Jeśli Claude Code od razu zachowuje się poprawnie, bez przypominania w czacie, reguła działa. Gdy błąd nadal wraca mimo obecności reguły, doprecyzuj jej treść, bo prawdopodobnie jest zbyt ogólna.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI, prowadzi Łukasz Matuszewski (JSystems)

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5

Najczęściej zadawane pytania

Dlaczego Claude Code zapomina o poprawce, którą zgłosiłem w poprzedniej sesji?
Poprawka wpisana w czacie działa tylko w obrębie bieżącej rozmowy. Gdy sesja się kończy albo zaczynasz nowe zadanie z czystą historią, ta uwaga już nie obowiązuje, bo nie została nigdzie utrwalona. Trwałe zasady Claude Code trzyma w plikach CLAUDE.md, które wczytuje na starcie każdej sesji.
Jak zamienić powtarzalną uwagę z czatu w trwałą regułę?
Zapisz ją w pliku CLAUDE.md jako jednoznaczne zdanie rozkazujące, które mówi, co jest zakazane i jaka jest poprawna alternatywa. Użyj korzenia projektu, gdy zasada dotyczy tylko tego repozytorium, albo pliku użytkownika, gdy ma obowiązywać wszędzie. Krótki przykład pomaga, jeśli sam opis może być niejasny.
Czy muszę edytować plik CLAUDE.md ręcznie, żeby dodać zasadę?
Nie musisz. Claude Code daje skrót: w polu wpisu zacznij linię od znaku hash, a narzędzie zaproponuje dopisanie tej myśli do pamięci. To wygodne przy szybkim utrwalaniu pojedynczych reguł w trakcie pracy. Reszta pliku i tak zostaje do wglądu, więc później możesz go uporządkować.
Zapisałem regułę, a błąd i tak wraca. Co teraz?
Najpierw sprawdź komendą /memory, czy reguła jest na liście wczytanych plików pamięci, i przetestuj zachowanie w zupełnie nowej sesji. Jeśli błąd nadal wraca mimo obecności reguły, doprecyzuj jej treść, bo najczęściej jest zbyt ogólna. Konkretne zdanie z przykładem działa lepiej niż ogólnik.

Komentarze (0)

Musisz być zalogowany by móc dodać komentarz. Zaloguj się przez Google

Brak komentarzy...