cc-history

Reference documentation for analyzing Claude Code conversation history files

1. Zlokalizuj katalog projektu Claude Code. Twoja historia konwersacji znajduje się w ~/.claude/projects/ w podkatalogach zakodowanych na podstawie ścieżki roboczej. Aby znaleźć poprawną ścieżkę, przekonwertuj bieżący katalog roboczy, zamieniając wiodący ukośnik na myślnik, pozostałe ukośniki na myślniki, a sekwencje /. (ukryte katalogi) na podwójne myślniki.
2. Otwórz plik JSONL sesji. Główny plik konwersacji ma nazwę {session-uuid}.jsonl i znajduje się bezpośrednio w katalogu projektu. Każda linia tego pliku to jeden obiekt JSON reprezentujący wiadomość.
3. Użyj jq do filtrowania wiadomości. Aby wyodrębnić konkretne informacje, zastosuj polecenia jq na pliku JSONL. Na przykład możesz filtrować po typie wiadomości (user, assistant, system), UUID, znaczniku czasu lub zawartości wiadomości.
4. Sprawdź strukturę wiadomości asystenta. Odpowiedzi modelu mogą zawierać bloki treści o różnych typach: thinking (myślenie modelu), tool_use (użycie narzędzia) i text (tekst). Metadane zawierają również statystyki tokenów, w tym cache_read_input_tokens i cache_creation_input_tokens.
5. Przeanalizuj rozmowy podagentów (opcjonalnie). Jeśli projekt zawiera podagentów, ich rozmowy znajdują się w plikach JSONL w podkatalogu subagents/ (agent-{hash}.jsonl). Duże wyniki narzędzi są przechowywane osobno w katalogu tool-results/.