CLAUDE.md za długi zżera kontekst - jak go odchudzić

Claude Code

CLAUDE.md za długi zżera kontekst - jak go odchudzić

W skrócie

CLAUDE.md ma jedną niebezpieczną właściwość: rośnie. Dopisujesz kolejną zasadę, potem jeszcze jedną, i po kilku tygodniach masz plik na kilkadziesiąt kilobajtów, który Claude Code wczytuje na starcie każdej sesji. To realny koszt: im więcej miejsca zajmują stałe instrukcje, tym mniej zostaje na kod i rozmowę. Pokazujemy, jak odchudzić plik bez tracenia wiedzy o projekcie.

Jak to wygląda w praktyce

Pierwszy sygnał to szybko topniejący licznik dostępnego kontekstu - już na początku sesji, zanim wkleiłeś cokolwiek. Drugim bywa to, że Claude Code gubi wątek w dłuższych zadaniach albo szybciej dochodzi do momentu, w którym trzeba ścisnąć historię rozmowy.

Często plik puchnie od rzeczy, które nie muszą być w nim cały czas: długich fragmentów dokumentacji, wypisanych krok po kroku procedur uruchamiania, historii decyzji projektowych. To wszystko wartościowe, ale nie musi obciążać każdej sesji od pierwszej sekundy.

Dlaczego Claude Code tak działa

Plik CLAUDE.md z korzenia projektu jest wczytywany w całości na starcie sesji, razem z plikiem użytkownika i innymi poziomami pamięci. To celowe: dzięki temu Claude Code zna zasady od pierwszej wiadomości. Skutek uboczny jest taki, że każda linia pliku zajmuje miejsce w oknie kontekstu przez całą sesję, niezależnie od tego, czy akurat jest potrzebna.

Dlatego długość pliku przekłada się wprost na koszt. Nie chodzi o to, że długa treść jest zła - chodzi o to, że treść, która przyda się tylko czasem, nie powinna być ładowana zawsze. Claude Code daje na to narzędzia: pliki reguł w katalogu .claude/rules można zawęzić do konkretnych typów plików lub podkatalogów, a pliki CLAUDE.md w podkatalogach doczytują się dopiero, gdy Claude Code sięga do tego fragmentu projektu.

Jak to rozwiązać krok po kroku

1. Przejrzyj plik i podziel treść na dwie grupy: zasady, które muszą obowiązywać zawsze i wszędzie, oraz szczegóły potrzebne tylko przy pewnych zadaniach lub w pewnych katalogach.
2. Zostaw w głównym CLAUDE.md wyłącznie te pierwsze: krótkie, wysokopoziomowe reguły i wskaźnik, gdzie szukać reszty. Długie procedury i dokumentacje wytnij.
3. Szczegóły przypisane do konkretnych obszarów przenieś do plików reguł w .claude/rules/*.md. Reguły można zawęzić do określonych typów plików lub podkatalogów, więc ładują się tylko wtedy, gdy są potrzebne.
4. Instrukcje dotyczące jednego modułu przenieś do CLAUDE.md w podkatalogu tego modułu - taki plik doczyta się dopiero, gdy Claude Code będzie tam pracował.
5. Skracaj język: zamiast rozwlekłych akapitów używaj krótkich punktów i jednoznacznych reguł. Usuń powtórzenia i nieaktualne wpisy.
6. Zapisz zmiany, uruchom nową sesję i sprawdź licznik kontekstu na starcie oraz komendę /memory, żeby potwierdzić, co realnie się ładuje.

Jak sprawdzić, że zadziałało

Po odchudzeniu porównaj dostępny kontekst na starcie nowej sesji z tym sprzed zmian. Powinno go być wyraźnie więcej, bo mniej zajmują stałe instrukcje.

Sprawdź też, czy nic nie zginęło z zachowania: uruchom typowe zadanie i zobacz, czy Claude Code nadal respektuje kluczowe zasady. Jeśli jakaś reguła była ważna, a wpadła do doczytywanego pliku reguł, upewnij się, że aktywuje się w odpowiednim kontekście. Komenda /memory potwierdzi, które pliki są aktualnie wczytane.

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