Jak audytować, co Claude Code zrobił w projekcie (logi)

Claude Code

Jak audytować, co Claude Code zrobił w projekcie (logi)

W skrócie

Kiedy Claude Code, oficjalne narzędzie CLI od Anthropic do programowania z AI, samodzielnie edytuje pliki i uruchamia komendy, naturalne jest pytanie: co on właściwie zrobił? Potrzeba audytu pojawia się i u pojedynczego programisty (chcę zweryfikować zmiany przed commitem), i w zespole (chcę wiedzieć, kto i jak używa narzędzia). Dobra wiadomość jest taka, że Claude Code zostawia solidny ślad - lokalnie w postaci pełnych transkryptów sesji, a opcjonalnie także jako strumień zdarzeń do systemu monitoringu. Pokażemy, gdzie tego szukać i jak to włączyć.

Jak to wygląda w praktyce

Po dłuższej sesji masz w projekcie sporo zmian i nie do końca pamiętasz, które z nich pochodzą od agenta, a które zrobiłeś sam. Chcesz też wiedzieć, czy agent nie odpalił jakiejś komendy, o której zapomniałeś, albo wrócić do decyzji sprzed kilku godzin. W zespole dochodzi pytanie o zgodność i bezpieczeństwo: kto wysyłał jakie polecenia, jakie narzędzia były zatwierdzane, ile to kosztowało. Bez wiedzy, gdzie leżą te informacje, łatwo uznać, że praca agenta jest "nieprzejrzysta" - a wcale nie musi taka być.

Dlaczego Claude Code tak działa

Claude Code zapisuje transkrypt każdej sesji lokalnie na Twoim dysku, w katalogu ~/.claude/projects/ w plikach z rozszerzeniem .jsonl. Taki transkrypt zawiera wiadomości użytkownika, odpowiedzi modelu oraz wywołania narzędzi wraz z ich wynikami - to kompletny, chronologiczny ślad tego, co się działo. Do audytu na większą skalę Claude Code ma wsparcie dla OpenTelemetry: po włączeniu telemetrii wysyła metryki i zdarzenia do wskazanego systemu monitoringu. Loguje między innymi zdarzenia takie jak wysłanie polecenia przez użytkownika, decyzje o zatwierdzeniu narzędzi czy wyniki ich wykonania, a metryki obejmują na przykład liczbę sesji, zużycie tokenów, koszt czy liczbę zmienionych linii. Dzięki temu audyt można prowadzić zarówno lokalnie, jak i centralnie dla całego zespołu.

Jak to rozwiązać krok po kroku

1. Najprostszy audyt zmian w kodzie zrób przez git. W trakcie sesji uruchom komendę /diff, żeby zobaczyć wszystkie niezacommitowane zmiany, które agent (i Ty) wprowadziliście w drzewie roboczym.
2. Poza sesją użyj standardowego git status i git diff, a przed commitem przejrzyj zmiany plik po pliku. To najpewniejszy sposób, żeby zweryfikować, co realnie trafi do repozytorium.
3. Aby prześledzić przebieg konkretnej sesji (polecenia, odpowiedzi, wywołania narzędzi), sięgnij do lokalnych transkryptów w ~/.claude/projects/. Każda sesja to osobny plik .jsonl z pełnym, chronologicznym zapisem.
4. Żeby wrócić do wcześniejszej sesji z jej historią, użyj komendy /resume - przywróci poprzednią rozmowę, dzięki czemu możesz przejrzeć, jak agent doszedł do danego stanu.
5. Do audytu zespołowego włącz telemetrię, ustawiając zmienną środowiskową CLAUDE_CODE_ENABLE_TELEMETRY=1 i konfigurując eksport przez OpenTelemetry do swojego systemu monitoringu (endpoint i protokół podajesz standardowymi zmiennymi OTel).
6. Jeśli potrzebujesz w logach pełnej treści poleceń czy szczegółów narzędzi, włącz odpowiednie przełączniki zawartości (na przykład logowanie treści promptów), pamiętając, że to dane wrażliwe - decyzję o ich zbieraniu podejmij świadomie i zgodnie z polityką organizacji.

Jak sprawdzić, że zadziałało

Dla audytu lokalnego potwierdzenie jest proste: /diff i git pokażą Ci konkretną listę zmienionych plików, a w katalogu ~/.claude/projects/ znajdziesz plik transkryptu odpowiadający Twojej sesji z pełnym zapisem przebiegu. Dla telemetrii sprawdź swój system monitoringu - po włączeniu i uruchomieniu sesji powinna pojawić się metryka liczby sesji, a po wysłaniu polecenia zdarzenie odpowiadające promptowi użytkownika. Gdy te dane widać w backendzie, znaczy że eksport działa i masz centralny ślad aktywności Claude Code. Zestawienie zmian w git z zapisem w transkrypcie daje Ci pełny obraz tego, co agent zrobił w projekcie.

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