CLAUDE.md jest ignorowany - dlaczego Claude go nie czyta

Claude Code

CLAUDE.md jest ignorowany - dlaczego Claude go nie czyta

W skrócie

CLAUDE.md to plik, w którym opisujesz Claude Code Twój projekt: konwencje, komendy, rzeczy zakazane. Gdy działa, oszczędza mnóstwo powtarzania tych samych uwag. Gdy nie działa, masz wrażenie, że piszesz do ściany. Prawie zawsze przyczyna jest prozaiczna: plik jest w niewłaściwym miejscu, ma złą nazwę albo jego treść przegrywa z instrukcją z innego poziomu. Rozłóżmy to na czynniki.

Jak to wygląda w praktyce

Objaw jest charakterystyczny: zapisałeś w CLAUDE.md jasną zasadę, na przykład żeby używać konkretnego menedżera pakietów albo nie dotykać pewnego katalogu, a Claude Code i tak robi po swojemu. Powtarzasz uwagę w czacie i wtedy słucha, ale przy następnym zadaniu znowu zapomina, jakby pliku w ogóle nie było.

Bywa też odwrotnie: część zasad działa, a część nie. To zwykle znak, że Claude Code widzi jakiś CLAUDE.md, ale nie ten, który właśnie edytujesz - albo widzi dwa naraz i stosuje ten z innego poziomu.

Dlaczego Claude Code tak działa

Claude Code ładuje pliki pamięci z kilku poziomów naraz, w ustalonej kolejności od najogólniejszego do najbardziej szczegółowego: polityka zarządzana przez firmę, pliki użytkownika w katalogu domowym (~/.claude/CLAUDE.md), pliki projektu w korzeniu repozytorium (./CLAUDE.md lub ./.claude/CLAUDE.md) oraz lokalne (./CLAUDE.local.md). Plik z korzenia projektu jest wczytywany na starcie, a pliki CLAUDE.md z podkatalogów doczytują się dopiero wtedy, gdy Claude Code sięga do plików w tym podkatalogu.

To prowadzi do dwóch typowych pomyłek. Pierwsza: plik ma niewłaściwą nazwę albo leży poza korzeniem i katalogiem .claude, więc w ogóle nie jest ładowany. Druga, subtelniejsza: wszystkie poziomy są addytywne, więc Claude Code widzi jednocześnie Twój plik projektu i plik użytkownika. Między poziomami nie ma twardej hierarchii - jeśli instrukcje się kłócą, wynik zależy od interpretacji. Dlatego zasada z globalnego CLAUDE.md potrafi wygrać z tą z projektu, a Ty masz wrażenie, że plik projektu jest ignorowany.

Jak to rozwiązać krok po kroku

1. Sprawdź nazwę i położenie pliku. Musi nazywać się dokładnie CLAUDE.md (wielkość liter ma znaczenie) i leżeć w korzeniu projektu jako ./CLAUDE.md albo w ./.claude/CLAUDE.md.
2. Uruchom w sesji komendę /memory. Pokaże ona wszystkie pliki pamięci, które Claude Code aktualnie widzi, i z których poziomów pochodzą. Jeśli Twojego pliku tam nie ma, nie jest ładowany.
3. Jeśli plik leży w podkatalogu, pamiętaj, że wczytuje się dopiero, gdy Claude Code sięga do plików w tym podkatalogu. Zasady, które mają obowiązywać zawsze, przenieś do korzenia projektu.
4. Sprawdź, czy nie masz sprzecznej zasady w globalnym ~/.claude/CLAUDE.md. Jeśli tak, albo ją usuń, albo w pliku projektu zapisz wprost, że te instrukcje mają pierwszeństwo przed domyślnymi ustawieniami użytkownika.
5. Formułuj zasady konkretnie i rozkazująco. Zamiast ogólnego zdania napisz jednoznaczną regułę z przykładem, bo taka jest łatwiejsza do zastosowania.
6. Zapisz plik i uruchom nową sesję Claude Code, żeby zmiany z korzenia zostały wczytane na starcie.

Jak sprawdzić, że zadziałało

Najpewniejszy test to ponowne /memory - Twój CLAUDE.md powinien być na liście wczytanych plików z właściwego poziomu. To odczyt u źródła, a nie domysł.

Potem sprawdź zachowanie na zadaniu, które wprost dotyka jednej z zasad. Jeśli Claude Code zastosuje ją bez przypominania w czacie, plik działa. Gdy nadal jej nie respektuje mimo obecności na liście, poszukaj sprzecznej instrukcji na innym poziomie.

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

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