Lokalne logi Claude Code i Codex CLI pozwalają śledzić tokeny i obliczać szacunkowy koszt, ale wynik oparty na cenach API nie jest automatycznie kwotą z rachunku za subskrypcję. Jeśli kontrola budżetu pomija tokeny, których nie potrafi wycenić, może też zaakceptować użycie nieuwzględnione w obliczonej sumie.
Co przygotować do śledzenia kosztów
Potrzebujesz lokalnych plików sesji, tabeli stawek dla używanych modeli i osobnego dostępu do informacji o wykorzystaniu lub rozliczeniach na koncie dostawcy. Pliki w formacie JSONL zawierają po jednym obiekcie JSON w każdym wierszu. Lokalny rejestr opisany przez Shattered.io przetwarza takie pliki dla Claude Code i Codex CLI, a następnie może grupować zużycie według dnia, modelu, projektu lub narzędzia.
Poradnik wskazuje logi Claude Code w ~/.claude/projects i pliki sesji Codex w ~/.codex/sessions. OpenAI opisuje zapis sesji Codex w formacie JSONL. Rejestr z poradnika korzysta z tabeli cen utrzymywanej przez użytkownika. Jego przykładowe raporty są syntetyczne, a pokazane w nich liczby nie są rzeczywistym zużyciem ani rachunkiem.
1. Ustal, co oznacza wyliczona kwota
Zanim przeliczysz tokeny na pieniądze, rozdziel użycie API od wykorzystania planu subskrypcyjnego. Według opisu w poradniku Claude Console rozlicza użycie API, natomiast subskrypcja Claude Code podlega limitom planu. W Codex sposób rozliczania zależy od tego, czy korzystasz z konta ChatGPT, czy z klucza API.
Lokalna tabela może przypisać tokenom koszt według stawek API. Taki szacunek równoważny cenom API pomaga porównywać zużycie, ale nie pokazuje sam z siebie kwoty pobranej w ramach subskrypcji. Do rozliczenia i limitów przypisanych do konta służy widok dostawcy.
| Widok | Co pokazuje | Jak go wykorzystać |
| Lokalny raport użycia | Tokeny z logów oraz koszt obliczony według przypisanych stawek | Analiza zużycia według modelu, projektu lub dnia |
| Konto dostawcy | Użycie i rozliczenia przypisane do danego konta lub planu | Sprawdzenie limitów i uzgodnienie wydatków |
2. Sprawdź, jakie liczniki odczytuje parser Codex
W fixture OpenAI, czyli przykładowym rekordzie używanym w testach kodu, znajdują się dwa pola o różnym zakresie: total_token_usage opisuje skumulowane zużycie, a last_token_usage zawiera zużycie przypisane do pojedynczego żądania. Rozróżnienie ma znaczenie przy przetwarzaniu kolejnych wpisów: odejmowanie jednej wartości skumulowanej od następnej to inna metoda niż odczyt licznika dla konkretnego żądania.
| Pole | Zakres | Zastosowanie w analizie |
total_token_usage | Skumulowane zużycie w sesji | Porównywanie kolejnych stanów licznika |
last_token_usage | Zużycie związane z ostatnim żądaniem | Analiza pojedynczego żądania bez wyliczania różnicy między stanami skumulowanymi |
Fixture zawiera też pola cached_input_tokens, cache_write_input_tokens i reasoning_output_tokens. Parser Codex opisany przez Shattered.io wylicza różnice między kolejnymi wartościami skumulowanymi, ale nie zapisuje cache_write_input_tokens. Przy kontroli własnego parsera sprawdź więc, czy zachowuje potrzebne pola z rekordów, zamiast zakładać, że każda kategoria tokenów została uwzględniona.
3. Nie pozwól, by tokeny bez ceny przechodziły przez kontrolę
W opublikowanym kodzie agregator zlicza tokeny bez przypisanej stawki, ale funkcja guard sprawdza sumę w dolarach, a nie licznik niewycenionych tokenów. Jeśli część użycia nie ma ceny, kontrola może zatem zaakceptować działanie, mimo że jej suma nie obejmuje całego zużycia. To ustalenie wynika z inspekcji kodu.
Jeżeli kontrola ma egzekwować limit, powinna traktować niewycenione tokeny jako powód do blokady, a nie jak koszt zerowy. Warto też pamiętać, że kontrola Codex opisana w poradniku jest wywoływana przez funkcję powłoki przed uruchomieniem programu. Bezpośrednie wywołanie codex omija tę funkcję.
W przypadku Claude Code Anthropic opisuje zdarzenie UserPromptSubmit, które uruchamia się przed przetworzeniem promptu. Kod wyjścia 2 blokuje obsługiwane zdarzenie. To punkt kontroli przed nowym promptem, nie mechanizm kończący już wykonywane zadanie.
4. Uzgadniaj lokalny raport z kontem i zaakceptowanym wynikiem
Regularnie porównuj lokalny raport z widokiem użycia lub rozliczeń dostawcy. Jeśli różnią się podstawą naliczania, sam przelicznik cen API nie wyjaśni kwoty z konta. Przy interpretacji pracy agenta osobno zapisuj koszt tokenów, zaakceptowane wyniki i czas przeglądu.
Użytkownik Reddita u/Gooner-Psy opisał osobisty sposób mierzenia kosztu równoważnego API na zaakceptowany tekst, oddzielnie od czasu edycji. W jednym przykładzie podał 2,40 USD kosztu tokenów i trzy godziny pracy nad edycją przeglądu. To pojedyncza relacja, ale pokazuje, dlaczego niski koszt przebiegu nie musi oznaczać małego nakładu pracy, jeśli wynik wymaga poprawek.
5. Traktuj panel jako dodatkowy widok, nie rachunek
W recenzji opublikowanej 14 kwietnia 2026 r. autor AI Coding Daily pokazał w CodeBurn dzienne szacunki kosztów, podział użycia według projektu i modelu, aktywność narzędzi oraz filtrowanie według dostawcy. Recenzent zaznaczył, że wyliczenia bazują na cenach API, więc nie muszą odpowiadać wykorzystaniu subskrypcji.
Po skonfigurowaniu monitoringu sprawdź, czy raport rozdziela użycie lokalne od rozliczenia konta, czy parser zachowuje właściwy zakres liczników i czy kontrola blokuje użycie bez przypisanej ceny. Jeśli któryś z tych warunków nie jest spełniony, raport może pomagać w obserwacji zużycia, ale nie daje wiarygodnej kontroli budżetu.
