Claude Code usage tracking by LangWatch

LangWatch: Kompleksowe Śledzenie Zużycia Claude Code i Optymalizacja Pracy z Agentami AI

W dobie rosnącej popularności autonomicznych agentów kodujących, kluczowym wyzwaniem dla programistów i zespołów inżynieryjnych staje się pełna kontrola nad ich działaniem i wydatkami. LangWatch to zaawansowana platforma do inżynierii LLM, zaprojektowana z myślą o zespołach wdrażających rozwiązania AI do produkcji. Narzędzie to umożliwia nie tylko precyzyjne śledzenie zużycia Claude Code, ale także zapewnia głęboki wgląd w działanie takich agentów jak Codex, OpenCode, Copilot, Cursor czy Pi. Dzięki LangWatch, każdy aspekt interakcji z modelem staje się mierzalny, przejrzysty i łatwy do optymalizacji.

Co to jest LangWatch i śledzenie Claude Code?

LangWatch pełni rolę centrum dowodzenia dla Twoich agentów AI. Jest to platforma typu LLM observability, która przechwytuje pełną historię śladów (trace history), pozwalając na ulepszenie przepływu pracy (flow) oraz monitorowanie w czasie rzeczywistym, ile wydajesz na tokeny. Zamiast polegać na prostych, lokalnych czytnikach logów, które ograniczają się do jednej maszyny, LangWatch wykorzystuje natywny eksport OpenTelemetry z Claude Code. Dzięki temu śledzenie zużycia odbywa się płynnie między różnymi urządzeniami, a dane są bezpieczne nawet po wyczyszczeniu lokalnej historii terminala.

Kluczowe Funkcje LangWatch

Platforma LangWatch oferuje szereg specjalistycznych funkcjonalności, które pozwalają na pełne panowanie nad ekosystemem agentów AI:

1. Rozliczanie tokenów i analiza kosztów (Token Accounting)

LangWatch wprowadza rozróżnienie między kosztami teoretycznymi a faktycznie bilingowanymi. Dzięki bezpośredniemu pobieraniu danych z odpowiedzi API, użytkownicy widzą dokładne statystyki zużycia. Jest to szczególnie istotne dla osób korzystających z planów subskrypcyjnych (Claude Pro, Max, Team), gdzie sesje są oznaczane etykietą "Bundled". LangWatch oblicza wtedy teoretyczny koszt na podstawie cenników API (np. dla modeli claude-opus-4-8 czy claude-haiku-4-5), pokazując realną wartość wykonanej pracy.

2. Śledzenie pamięci podręcznej (Cache Hit Tracking)

W nowoczesnych sesjach agentowych, odczyty z pamięci podręcznej stanowią lwią część wolumenu danych. LangWatch traktuje cache read i cache write jako oddzielne klasy tokenów. Są one monitorowane z uwzględnieniem czasu życia (TTL) 5-minutowego i 1-godzinnego. Takie podejście zapobiega błędnemu szacowaniu kosztów, co jest częstym problemem w trackerach sumujących wszystkie tokeny jako standardowe wejście (input).

3. Monitoring narzędzi, umiejętności i MCP

Każda akcja podjęta przez agenta jest rejestrowana jako osobny etap (span). LangWatch śledzi:

• Komendy Bash: Pełna historia poleceń systemowych i ich rezultatów.
• Edycje plików: Zmiany w kodzie wprowadzane przez agenta.
• Protokół MCP (Model Context Protocol): Integracje z zewnętrznymi serwerami MCP, które pozwalają agentowi np. na inspekcję własnej historii śladów i edycję własnych przepływów pracy.

4. Wizualizacja i grafy analityczne

Użytkownicy mogą generować wykresy dla dowolnych metryk. Platforma pozwala na wizualizację sesji uruchomionych równolegle, kosztu przypadającego na konkretną sesję czy czasu bezczynności (idle time), gdy AI oczekuje na reakcję użytkownika. Dostępne są widoki typu Waterfall, Flame, Topology oraz Sequence, które ułatwiają zrozumienie architektury zapytań.

5. AI Insights i analiza wydajności

LangWatch pozwala na uruchomienie modelu Claude nad własną historią śladów. Pozwala to na głęboką analizę sesji: co było najbardziej pomocne, gdzie wystąpiły błędy i jakie wzorce tarcia (friction patterns) powodują, że sesje kończą się niepowodzeniem. Dzięki temu możesz stale doskonalić swoje umiejętności współpracy z AI.

Jak używać LangWatch z Claude Code? (Instrukcja)

Integracja LangWatch z Twoim środowiskiem pracy jest błyskawiczna i sprowadza się do wykonania jednego polecenia w terminalu.

Kroki konfiguracji:

1. Otwórz swój terminal (np. tmux, iTerm lub terminal wbudowany w VS Code).
2. Uruchom komendę:

   $ npx langwatch claude

3. Polecenie to automatycznie skonfiguruje eksport OpenTelemetry z Claude Code do Twojego konta LangWatch.
4. Po zakończeniu konfiguracji możesz od razu wrócić do pracy. Wszystkie kolejne sesje będą automatycznie logowane w platformie.

Przypadki użycia (Use Case)

Śledzenie zużycia Claude Code za pomocą LangWatch znajduje zastosowanie w wielu codziennych zadaniach inżynieryjnych:

• Diagnozowanie błędów API: Gdy agent nie może połączyć się z usługą (np. Google Ads API), LangWatch pozwala sprawdzić, czy odpowiednie projekty Cloud mają włączone wymagane interfejsy. Przykładem z logów jest wykrycie braku włączonego API, co pozwoliło na szybką naprawę konfiguracji.
• Zarządzanie zasobami i czyszczenie: Agent może zostać poproszony o usunięcie starych artefaktów (np. osieroconych wdrożeń preview czy nieużywanych wolumenów cache). LangWatch zaraportuje dokładnie, ile miejsca odzyskano (np. 4.2GB freed) i jaki był koszt tej operacji.
• Debugowanie regresji: W przypadku znalezienia błędu po mergu (np. w kolejce ponowień), historia śladów pozwala prześledzić krok po kroku, jak agent reprodukuje błąd i czy tworzony test poprawnie go wychwytuje.
• Bezpieczeństwo danych: LangWatch automatycznie redaguje klucze API i dane osobowe (PII) przed ich zapisaniem, co jest kluczowe w środowiskach korporacyjnych (Enterprise).

FAQ – Najczęściej Zadawane Pytania

Jak mogę śledzić moje zużycie Claude Code? Uruchom komendę npx langwatch claude. Konfiguruje ona natywny eksport danych do LangWatch, gdzie każda sesja ląduje jako szczegółowy ślad zawierający turę modelu, wywołania narzędzi i podział tokenów.

Czy narzędzie działa z Cursor, Copilot i innymi agentami? Tak. Wszystkie te agenty eksportują dane przez ten sam punkt końcowy OTLP (OpenTelemetry Protocol), dzięki czemu trafiają do tego samego magazynu danych z taką samą precyzją śledzenia kosztów i tokenów.

Co oznacza etykieta "Bundled" przy kosztach? Sesje w ramach subskrypcji Claude (Pro, Max, Team) nie mają indywidualnych faktur za tokeny. LangWatch oznacza je jako "Bundled" i oblicza teoretyczny koszt na podstawie cen rynkowych API, aby uświadomić użytkownikowi realną wartość zużycia.

Czy tokeny zapisane w cache są liczone? Tak, operacje cache read i cache write są śledzone jako oddzielne klasy tokenów i wyceniane zgodnie z ich specyficznymi stawkami. Precyzyjne śledzenie zapobiega błędom w raportowaniu kosztów całkowitych sesji.

Co w przypadku wklejenia sekretnych kluczy do sesji? LangWatch automatycznie wykrywa i redaguje sekrety API oraz dane PII. Dzięki temu wrażliwe informacje nigdy nie są przechowywane w systemie monitoringu. Dla najwyższego poziomu kontroli dostępne są również opcje self-hosted.

---

LangWatch jest darmowy do użytku indywidualnego i wspiera zespoły w budowaniu wydajniejszych rozwiązań AI na całym świecie.