Lokale Protokolle von Claude Code und Codex CLI liefern Tokenzahlen und daraus berechnete Kostenschätzungen. Was ein Abo tatsächlich verbraucht oder berechnet, zeigt dagegen die jeweilige Anbieter-Kontoansicht. Wer eine lokale Budgetprüfung nutzt, muss außerdem verhindern, dass nicht bepreiste Tokens unbemerkt aus der Summe fallen.
Was du für die Auswertung brauchst
Du brauchst lokale Sitzungsprotokolle und, wenn du Geldbeträge schätzen willst, eine gepflegte Preistabelle. JSONL-Dateien (JSON Lines) speichern einzelne Datensätze als separate JSON-Zeilen. Das Tutorial von Shattered.io nennt ~/.claude/projects und ~/.codex/sessions als Speicherorte für Protokolle, sofern keine anderen Verzeichnisse konfiguriert sind.
Die lokale Auswertung betrifft Sitzungen, deren Protokolle auf deinem Rechner liegen. Der Entwickler von optimAIzr schrieb auf Reddit, dass Sitzungen über iOS Remote Control erfasst werden können, wenn Claude Code auf dem Rechner läuft. Cloud-Sitzungen hinterließen seiner Aussage nach keine solchen lokalen Protokolle auf dem Gerät. Für die Desktop-App bezog sich seine Aussage auf Sitzungen im Code-Tab; gewöhnliche Claude-Chats seien von dieser lokalen Methode nicht abgedeckt.
So trennst du Nutzung und Abrechnung
1. Lege fest, welche Nutzung du erfassen willst
Unterscheide zuerst zwischen API-Abrechnung und Abo-Nutzung. Das Tutorial behandelt Claude-Console-API-Abrechnung getrennt von der Nutzung über ein Abo. Bei Codex hängt die Abrechnungsart davon ab, ob du ein ChatGPT-Konto oder einen API-Schlüssel verwendest. Eine Schätzung anhand von API-Preisen ist deshalb nicht automatisch der Betrag, der bei einem Abo anfällt.
| Ansicht | Was sie abbildet | Wofür sie taugt |
| Lokaler Nutzungsbericht | Token aus Sitzungsprotokollen; mit gepflegter Preistabelle auch eine daraus berechnete Kostenschätzung | Nutzung nach Modell, Projekt oder Zeitraum untersuchen |
| Anbieter-Kontoansicht | Nutzung oder Gebühren des jeweiligen Kontos und Abrechnungswegs | Anbieter-seitige Nutzung und tatsächliche Gebühren prüfen |
Die im Tutorial gezeigten Beispielberichte sind ausdrücklich synthetisch. Ihre Summen sind keine Messwerte einer echten Nutzung und keine Rechnungsbeträge.
2. Prüfe, welche Codex-Zähler dein Parser verwendet
OpenAI führt in einem Quellcode-Fixture sowohl einen kumulierten Sitzungswert als auch einen Wert für die letzte Anfrage auf. Die beiden Felder beschreiben unterschiedliche Zeiträume:
| Feld | Erfasster Umfang | Bedeutung für die Auswertung |
total_token_usage | Kumulierte Token-Nutzung | Zeigt den Gesamtstand der Sitzung; aufeinanderfolgende Werte lassen sich voneinander abziehen. |
last_token_usage | Token-Nutzung der letzten Anfrage | Liefert den Wert für die einzelne Anfrage. |
Das OpenAI-Fixture mit den Nutzungsfeldern führt außerdem unter anderem zwischengespeicherte Eingabe, Cache-Schreibvorgänge und Reasoning-Ausgabe auf. Der Codex-Parser im Shattered.io-Tutorial zieht aufeinanderfolgende kumulierte Werte voneinander ab, übernimmt aber cache_write_input_tokens nicht. Welche Abrechnungsfolge dieses Feld für ein bestimmtes Modell hat, lässt sich daraus nicht ableiten.
3. Lass ungepreiste Tokens die Budgetprüfung stoppen
Im veröffentlichten Python-Beispiel zählt die Aggregation Tokens ohne passende Preiszuordnung als ungepreist. Die Budgetprüfung kontrolliert jedoch nur die berechnete US-Dollar-Summe, nicht den Zähler für ungepreiste Tokens. Fehlt ein Modell oder ein erforderlicher Preis, kann die Prüfung daher eine zu niedrige Summe verwenden und trotzdem passieren.
Eine solche Prüfung ist kein verlässlicher Ausgabenstopp, solange ungepreiste Nutzung nicht ebenfalls zur Sperre führt. Der im Tutorial gezeigte Codex-Shell-Wrapper prüft vor dem Start über diese Funktion. Wer codex direkt aufruft, umgeht die Prüfung.
Für Claude Code dokumentiert Anthropic UserPromptSubmit als Ereignis vor der Verarbeitung eines Prompts. Bei einem unterstützten Ereignis blockiert der Exit-Code 2 die Ausführung. Das ist eine Prüfmöglichkeit vor einem Prompt; sie beendet keine bereits laufende Aufgabe. Anthropic beschreibt die Hooks und ihre Blockierverhalten.
4. Gleiche lokale Schätzungen mit Anbieterwerten ab
Nutze lokale Tokenberichte, um Verläufe und Projekte zu vergleichen, und gleiche sie regelmäßig mit der Kontoansicht des jeweiligen Anbieters ab. So bleiben eine API-Preis-Schätzung und die Nutzung oder Gebühr eines Abos getrennte Größen.
Für den Aufwand zählt neben dem Tokenverbrauch auch, welches Ergebnis angenommen wird und wie viel Nacharbeit nötig ist. Der Reddit-Nutzer u/Gooner-Psy beschrieb, API-äquivalente Tokenkosten pro akzeptiertem Entwurf zu erfassen und die Bearbeitungszeit getrennt zu zählen. Für einen Überblickstext nannte er 2,40 US-Dollar an Tokenkosten und drei Stunden Bearbeitungszeit. Das ist ein persönlicher Erfahrungsbericht, kein allgemeiner Vergleichswert.
Was ein Nutzungs-Dashboard zusätzlich zeigt
Ein Review von AI Coding Daily führte CodeBurn als Terminal-Dashboard mit täglichen Kostenschätzungen, Aufschlüsselungen nach Projekt und Modell, Tool- und MCP-Nutzung sowie einer Anbieterfilterung vor. Der Reviewer erklärte, dass die Kosten auf API-Preisen beruhen und daher nicht zwingend den Verbrauch eines Abos abbilden. Solche Kategorien können beim Beobachten der Nutzung helfen; für die tatsächliche Anbieterabrechnung bleibt die Kontoansicht der passende Abgleich.
So erkennst du, ob die Budgetprüfung greift
Prüfe vor dem Verlassen auf eine Sperre, dass ein Modell ohne Preiszuordnung die Ausführung tatsächlich blockiert. Gleiche anschließend den lokalen Bericht mit der Kontoansicht des verwendeten Anbieters ab. Erst wenn auch die ungepreiste Nutzung die Prüfung stoppt, kann der errechnete Betrag als vorgesehene Budgetgrenze dienen.
