Claude Code: compaction failed - jak naprawić kompakcję kontekstu

Claude Code

Claude Code: compaction failed - jak naprawić kompakcję kontekstu

W skrócie

Claude Code próbuje skompaktować długą rozmowę i zwraca compaction failed. Kompakcja to automatyczne streszczenie sesji, które ma zmieścić ją w oknie kontekstu - gdy padnie, warto wiedzieć, dlaczego i jak ruszyć dalej.

Jak to wygląda w praktyce

Przy próbie skrócenia rozrośniętej rozmowy Claude Code wypisuje compaction failed i nie kończy streszczania. Kontekst pozostaje pełny, a dalsza praca w tej sesji staje się utrudniona albo niemożliwa.

Błąd potrafi wracać przy kolejnych próbach, zwłaszcza gdy sesja jest już bardzo długa - narzędzie za każdym razem zaczyna kompakcję i za każdym razem ją przerywa.

Dlaczego tak się dzieje

Kompakcja polega na wygenerowaniu streszczenia dotychczasowej rozmowy, żeby zwolnić miejsce w oknie kontekstu. Jeśli kontekst jest ekstremalnie duży, nawet to streszczenie razem z resztą materiału potrafi przekroczyć dostępny limit i operacja nie ma się jak zmieścić.

Druga przyczyna jest okazjonalna: w trakcie kompakcji może wystąpić błąd sieci albo limitu - na przykład 429 (limit tempa) lub 529 (przeciążenie). Streszczenie samo w sobie jest zapytaniem, więc te same chwilowe problemy, co przy zwykłej pracy, potrafią je przerwać.

Trzecia to po prostu przerwana sesja - utrata połączenia albo zamknięcie w połowie operacji zostawia kompakcję niedokończoną.

Jak to rozwiązać krok po kroku

1. Ponów kompakcję - jeśli winny był chwilowy błąd sieci albo limitu, kolejna próba często przechodzi.
2. Gdy ponawianie nie pomaga, wyczyść kontekst przez /clear i zacznij nową sesję dedykowaną bieżącemu zadaniu.
3. Rób /compact wcześniej, nie czekając aż kontekst spuchnie do granic - łatwiej streścić mniejszą rozmowę.
4. Pracuj krótszymi sesjami: zamykaj wątek po skończonym zadaniu, zamiast prowadzić jedną nieskończenie długą rozmowę.
5. Sprawdź sieć i ewentualne limity (429/529) - odczekaj chwilę, jeśli usługa jest przeciążona, i spróbuj ponownie.
6. Przed /clear zapisz kluczowe ustalenia (np. w CLAUDE.md albo notatce), żeby nowa sesja miała potrzebny kontekst od startu.

Jak sprawdzić, że zadziałało

Po ponownej kompakcji lub po starcie świeżej sesji sprawdź, czy narzędzie działa płynnie i nie wraca komunikat compaction failed. Jeśli kolejne polecenia przechodzą bez ostrzeżeń o przepełnionym kontekście, problem jest opanowany.

Wróć do listy 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