Token Usage

Token Usage

Changelog

Was in welcher Version dazugekommen ist, neueste Version zuerst. Jeder Eintrag hält fest, was damals ausgeliefert wurde.

Ältere Einträge können Aussagen enthalten, die spätere Versionen korrigiert haben, vor allem zu den Limits. Die Korrekturen stehen unter 2.0.0 und 2.1.0.

2.1.0Oktober 2026

Release auf GitHub → (öffnet in neuem Tab)

Sechs Dinge in diesem Plugin waren falsch, und zwei davon waren Aussagen, die wir selbst in den 2.0.0-Notizen unten gemacht haben. Alle sechs sind hier korrigiert. Deine Zahlen ändern sich nach dem Update, meist nach unten, und hier steht, warum.

Korrekturen

  • Lange Antworten wurden vielfach mitgezählt. Claude Code schreibt eine einzelne Antwort einmal pro Inhaltsblock ins Sitzungsprotokoll, bei langer gestreamter Ausgabe bis zu etwa 75 Mal, und jede Zeile wiederholt die vollständigen Token-Zahlen dieser einen Antwort. Das Plugin hat jede Zeile addiert, eine Antwort mit 7,7K Output-Tokens erschien deshalb als rund 580K. In einer gemessenen halben Stunde zeigte die Seitenleiste 1,31M Tokens bei tatsächlich 70K: Der 5-Stunden-Ring sprang auf 448 %, Heute auf 330 % und Diese Woche auf 114 %, obwohl nichts Ungewöhnliches passiert war. Jede Antwort wird jetzt genau einmal gezählt, erkannt an Nachrichten-ID und Request-ID, und die Zeile mit dem höchsten Output-Wert gewinnt. Auch kurze Antworten waren betroffen, etwa um den Faktor zwei, deine Zahlen können nach dem Update also etwas niedriger ausfallen. Weil die 5-Stunden-Schätzung aus denselben Zählungen abgeleitet wird, kann auch sie sich leicht verschieben
  • Die Arbeit von Subagenten wurde nie gezählt. Wenn Claude Code Subagenten einsetzt (das Agent-Werkzeug), schreibt es deren Arbeit in einen Unterordner der Sitzung. Dort hat das Plugin nie nachgesehen, diese Tokens fehlten also in jeder Zahl. In unseren eigenen Daten waren das 0,7 % der letzten 30 Tage, aber bis zu 47K Tokens in einem einzigen 5-Stunden-Fenster, das ans Limit lief. Subagenten-Protokolle werden jetzt gelesen und der Sitzung zugerechnet, zu der sie gehören
  • Cache zählt doch. Hier lagen wir in 2.0.0 falsch. In den 2.0.0-Notizen steht, Cache-Lesen und Cache-Schreiben zählten nicht aufs Limit, „geprüft an über 80 beobachteten Limit-Treffern“. Diese Auswertung lief auf den überhöhten Summen des ersten Fehlers oben und konnte deshalb nicht zeigen, was sie behauptete. Seitdem gegen die offiziellen Prozentwerte gemessen, die Claude Code meldet: Cache-Schreiben zählt deutlich aufs 5-Stunden-Fenster, Cache-Lesen ein wenig. Ein Beispiel aus unseren Daten: Eine lange Sitzung, die nach einer Pause ihren Cache neu aufbauen musste, verbrauchte 17 % eines frischen Fensters bei nur 4,4K Input- und Output-Tokens. Die Zahlen des Plugins zählen weiterhin nur Input und Output, der offizielle Prozentwert kann ihnen also vorauslaufen, am stärksten am Anfang eines Fensters. Glossareintrag und Hilfeabschnitt „Was auf ein Limit einzahlt“ sind neu geschrieben
  • Die Wochenschätzung konnte deutlich zu niedrig liegen. Sie ist die niedrigste Woche, die je ans Wochenlimit kam. In unseren Daten waren das 1,14M Tokens gegenüber rund 2,7M laut offiziellen Prozentwerten, und die Seitenleiste zeigte 141 %, während Claude Code 61 % meldete. Auch Cache, den das Plugin nicht zählt, bringt dich ans Limit, eine Woche kann also bei einer niedrigen Tokenzahl enden. Ohne den neuen Statusline-Feed (unten) kommt die Schätzung weiter aus deinen Treffern, und die Hilfe sagt offen, dass sie zu niedrig sein kann. Mit dem Feed wird der offizielle Wert verwendet
  • „29-Tage-Durchschnitt“ war nicht, was wir gerechnet haben. Die 2.0.0-Notizen und das Dashboard sagen, „Heute“ werde mit deinem 29-Tage-Durchschnitt verglichen. Seit 1.7 nutzt das Plugin tatsächlich alle Tage, die Claude Code aufbewahrt (deine Aufbewahrungseinstellung). Die Beschriftungen sagen das jetzt, die Rechnung bleibt
  • Die Cache-Preise in der Hilfe waren unvollständig und teils veraltet. Wir hatten geschrieben, ein Cache-Write koste etwa 1,25× des Input-Preises. Das gilt für den 5-Minuten-Cache, der 1-Stunden-Cache kostet 2×, und genau der ist bei Claude Code im Abo der Normalfall (rund 90 % in unseren eigenen Logs). Cache-Reads kosten bei Opus 5.5 und Sonnet 5.5 nur 0,05× statt 0,1×. Der Preistabelle auf der Hilfeseite fehlten außerdem die neuesten Modelle, und sie nannte den Sonnet-5-Preis noch einen Einführungspreis. Ein Nutzer im Obsidian-Forum hat uns im Oktober auf den 1-Stunden-Cache hingewiesen, und wir hatten diese Korrektur für 2.1 zugesagt. Glossar, README und Hilfe folgen jetzt der offiziellen Preisseite, Stand Oktober 2026

Geändert

  • Der Heute-Ring ist neutral grau. Es gibt kein Tageslimit, und Grün, Gelb und Rot neben zwei echten Limits lesen sich wie eine Warnung. Ein voller Tag ist eine geänderte Arbeitsweise, kein Risiko. Das Dashboard-Panel nennt stattdessen das Vielfache („2.5x your usual day“)

Neu

  • Optional: Limits an den offiziellen Prozentwerten verankert. Claude Code übergibt jedem Statusline-Skript die offiziellen Prozentwerte für das 5-Stunden-Fenster und die Woche. Ein kleines Skript, das mit diesem Release kommt (extras/ratelimit-statusline.js), zeigt sie in deiner Statuszeile und protokolliert sie auf deinem Rechner. Liegt dieses Protokoll vor, beginnt das 5-Stunden-Fenster dann, wenn das offizielle Fenster beginnt, und beide Limit-Ringe zeigen bei jeder Ablesung genau den offiziellen Prozentwert und zählen bis zur nächsten mit deinen Tokens weiter. Ohne das Skript ändert sich nichts. Einrichtung: siehe Hilfeseite, Abschnitt „Offizielle Prozentwerte aus der Statuszeile“
  • Glossareintrag „Der Heute-Ring“, dazu „Was auf ein Limit einzahlt“ neu geschrieben, in allen fünf Sprachen
  • Tooltip an C.Write mit der Aufteilung nach 1 Stunde und 5 Minuten. Fahr mit der Maus über eine C.Write-Zeile, dann siehst du, wie viel davon für eine Stunde und wie viel für fünf Minuten geschrieben wurde. Eine eigene Zeile dafür haben wir geprüft und verworfen: In der Seitenleiste ist kein Platz für eine fünfte Zeile, und das Plugin rechnet keine Kosten aus

Bekannte Grenzen

  • Zwischen zwei Ablesungen addiert das Plugin nur Input und Output. Ein Cache-Neuaufbau (neuer Chat, abgelaufener Cache) erscheint mit der nächsten Ablesung
  • Archivierte Tage, die älter sind als dein Aufbewahrungsfenster, behalten ihre alten Zahlen: Die Protokolle, aus denen man sie neu zählen könnte, gibt es nicht mehr. Tage innerhalb des Fensters werden nach dem Update einmal neu geschrieben
  • Ob 1-Stunden- und 5-Minuten-Cache-Writes unterschiedlich aufs Limit zählen, ist noch offen. In allen Abschnitten, die wir messen konnten, waren die Cache-Writes ausschließlich 1-Stunden-Writes, ein eigenes Gewicht für die 5-Minuten-Art lässt sich daraus noch nicht bestimmen. Wir messen weiter
Nach oben

2.0.0Oktober 2026

Release auf GitHub → (öffnet in neuem Tab)

Drei Annahmen, die dieses Plugin über Anthropics Rate Limits getroffen hatte, waren falsch. Alle drei sind hier korrigiert, deshalb können deine Zahlen nach dem Update anders aussehen.

Korrekturen

  • Es gibt kein Tageslimit. Frühere Versionen haben „Heute“ an einem „fairen Tagesanteil“ des Wochenlimits gemessen, einer Zahl, die das Plugin selbst erfunden hatte, indem es das Wochenlimit durch sieben teilte. Anthropic erzwingt kein solches Limit, der Vergleich stellte also einen echten Tag gegen ein Budget, das es nicht gibt. „Heute“ wird jetzt mit deinem eigenen 29-Tage-Durchschnitt pro aktivem Tag verglichen: Das beansprucht keine Quote und sagt dir nur, ob heute mehr oder weniger los ist als sonst. *(Teilweise falsch: Es waren nie 29 Tage, sondern alle gespeicherten Tage. Korrigiert in 2.1.0.)*
  • Das 5-Stunden-Fenster ist verankert, nicht gleitend. Es öffnet sich mit deiner ersten Nachricht und läuft genau fünf Stunden. Ein neues Fenster beginnt erst, wenn diese Spanne vollständig abgelaufen ist, in festen Blöcken und unabhängig von Pausen dazwischen. Frühere Versionen haben „die letzten fünf Stunden ab jetzt“ summiert. Beim Wechsel eines Fensters mischte das den Schwanz des alten mit dem Kopf des neuen Fensters, eine Zahl, die zu keinem von beiden gehörte, und zwar genau dann, wenn du sehen wolltest, dass dein Budget zurückgesetzt wurde
  • Nur Input und Output zählen aufs Limit. Cache-Lesen und Cache-Schreiben zählen nicht. Das habe ich an über 80 beobachteten Limit-Treffern geprüft, statt es anzunehmen: Ich habe ein gewichtetes Modell getestet, und die Gewichte, die die echten Daten am besten erklärten, waren für beide Cache-Arten null. Das daraus entstehende mittlere 5-Stunden-Budget deckt sich mit dem, was Nutzer tatsächlich beobachten. *(Falsch: Die Auswertung lief auf doppelt gezählten Summen, und Cache-Schreiben zählt. Korrigiert in 2.1.0.)*

Neu

  • Aktivitäts-Heatmap rund um deine Abrechnungswoche. Eine Zeile pro Kalendertag, zwölf 2-Stunden-Felder pro Zeile, über dein tatsächliches Wochenfenster von der Reset-Stunde bis zur Reset-Stunde. Weil dieses Fenster acht Kalendertage berührt, zeigt die Ansicht acht Zeilen, die Felder außerhalb des Fensters sind sichtbar inaktiv. Einklappbar, mit einem Active-Days-Panel daneben
  • Der Wochen-Reset erkennt sich selbst. Das Wochenlimit wird zu einer Stunde zurückgesetzt, die sich je nach Konto unterscheidet. Das Plugin ermittelt diese Stunde jetzt aus deiner eigenen Sitzungshistorie, statt dich raten zu lassen, und sagt in den Einstellungen, ob der Wert erkannt oder von Hand gesetzt wurde
  • CSV-Export, auf zwei Wegen. Aus der Kopfzeile der Seitenleiste in einen einstellbaren Vault-Ordner oder über die Befehlspalette. Drei Dateien (Projekte, Tagesdetail, Kennzahlen), RFC 4180 mit UTF-8-BOM, damit Excel sie auf Anhieb korrekt öffnet
  • 5-Stunden-Schätzung mit üblichem Band. Seitenleiste und Dashboard zeigen den Median und die mittlere Hälfte deiner beobachteten Treffer (zum Beispiel „meist zwischen 214K und 364K“), und der CSV-Export enthält beide Grenzen. Die Schätzung selbst wird jetzt innerhalb der verankerten 5-Stunden-Fenster gemessen, genau so, wie der Ring zählt, beide sind also direkt vergleichbar. Die Zahlen können sich deshalb nach dem Update leicht verschieben
  • Der Kalender zeigt zwei Monate statt einem, damit der Monatsanfang nicht mehr ein fast leeres Raster ist
  • Spanisch. Die Oberfläche und das komplette Glossar gibt es jetzt auch auf Spanisch, neben Englisch, Deutsch, Französisch und Italienisch

Geändert

  • Neues Aussehen. Die Farbwelt ist nach einer Regel neu aufgebaut: Eine Farbe kennzeichnet entweder eine Token-Art oder einen Status, nie beides. Vorher konnte dasselbe Grün in einem Panel „Output-Tokens“ und im nächsten „alles in Ordnung“ bedeuten
  • Die Classic-Seitenleiste ist entfernt. Was als „NextGen“ optional war, ist jetzt einfach die Seitenleiste, die Einstellung „Sidebar appearance“ gibt es nicht mehr
Nach oben

1.9.0September 2026

Release auf GitHub → (öffnet in neuem Tab)
  • Dashboard: Limit-Hero-Banner. Die empirischen Schätzungen für Session-, Tages- und Wochenlimit bekommen jetzt ein auffälliges Banner ganz oben im Dashboard, über den KPI-Karten, statt in einer KPI-Karte und einer Datentabelle weiter unten zu verschwinden
  • Seitenleiste: Limit Pulse (NextGen). Dieselben Zahlen für „Heute gegen fairen Tagesanteil“ und „diese Woche gegen geschätztes Wochenlimit“ stehen jetzt auch ganz oben auf der Today-Seite, du siehst sie also, sobald du die Seitenleiste öffnest, ohne das Dashboard. Gleiche Berechnung wie beim Limit Hero im Dashboard, die beiden können nie unterschiedliche Zahlen zeigen
  • Aktivitätskalender: größere Trefferfläche. Der Tooltip hängt jetzt an der ganzen Tageszelle und nicht nur am kleinen farbigen Punkt, das lässt sich mit der Maus deutlich leichter treffen
  • Aktivitätskalender: Notizen pro Tag. Klicke einen Tag an und schreibe eine kurze persönliche Notiz zu seinem Verbrauch. Alles bleibt lokal, gespeichert in den Plugin-Einstellungen, als kleine Markierung am Tag und im Tooltip sichtbar
  • Klarheit zu den Plattformen. Token Usage lief schon vollständig unter macOS und Linux: Das Lesen der Sitzungsdateien war von Anfang an plattformneutral (~/.claude/projects/ über Node os.homedir()), dafür war keine Codeänderung nötig
  • Agent-Mode-Suche korrekt auf Windows beschränkt. Die in v1.8.0 hinzugefügte Suche nach Claude-Desktop-Agent-Mode-Sitzungen ist, wie sich zeigte, nur unter Windows nötig, weil nur die Windows-App ihr eingebettetes Claude Code in einer MSIX-Sandbox laufen lässt, die das Dateisystem virtualisiert. Unter macOS und Linux landen Agent-Mode-Sitzungen bereits im selben Standardordner ~/.claude/projects/, den das Plugin ohnehin liest, dort wird nichts geraten und nichts ergänzt
  • Ein kurz eingebauter, nicht belegter Pfad im Stil des Windows-Stores für macOS wurde entfernt und durch eine dokumentierte, belegbare Plattformgrenze im Code ersetzt (die Grundlage steht in claude-dev.tools/docs/log-locations (öffnet in neuem Tab))
  • Die Dokumentation nennt jetzt ausdrücklich, wo die Sitzungsdaten je Plattform liegen
Nach oben

1.8.0September 2026

Release auf GitHub → (öffnet in neuem Tab)
  • Aktivitätskalender (NextGen-Seitenleiste). Ein Monatsraster am unteren Rand jeder Seite der Leiste, ein farbiger Punkt pro Tag, bemessen an deinem eigenen jüngsten Tagesdurchschnitt (grün darunter, bernstein darum herum, rot bei einer Spitze ab dem Doppelten). Du kannst in deiner Historie zurückblättern und den Kalender unter Einstellungen → Activity calendar ausschalten
  • Nutzung der Claude-Desktop-App zählt jetzt mit. Der in der Desktop-App eingebaute Agent Mode führt Claude Code aus und schreibt dieselben JSONL-Sitzungsdateien an einen eigenen Ort. Das Plugin liest sie jetzt ebenfalls, damit dieser Verbrauch nicht mehr in deinen Summen und Limit-Schätzungen fehlt. Ein einmaliger Neuaufbau des Archivs beim ersten Start füllt die betroffenen Tage nach
  • Dashboard: aufklappbares Unterprojekt-Detail. Die Projects-Ansicht zeigt standardmäßig eine Zeile pro Vault. Mit „Show sub-project detail“ klappst du einen Vault auf und siehst die Aufteilung nach Unterordnern direkt in der Tabelle, nicht nur im Markdown-Export
  • Klarerer Geltungsbereich. Ein neuer Glossareintrag „What is measured“ und ein Hinweis im Dashboard machen deutlich, dass das Plugin Claude Code überall erfasst, nicht aber normale Claude-Chats (die keine lokalen Token-Zahlen schreiben)
  • Handbuch. Ein kapitelweiser Leitfaden entsteht unter langeatn.de/media/token-usage/manual/, die Gliederung ist online, die Inhalte kommen in den nächsten Releases dazu
Nach oben

1.7.1September 2026

Release auf GitHub → (öffnet in neuem Tab)
  • NextGen-Seitenleiste (optional unter Einstellungen → Sidebar appearance, die Classic-Seitenleiste bleibt standardmäßig unverändert). Icon-Leiste zur Navigation (Today / Overview / Settings), eine 7-Tage-Aktivitäts-Heatmap und farbige KPI-Kacheln mit Trend-Sparklines
  • Vault Token Usage Controlling. Die neue Projects-Ansicht im Dashboard schlüsselt den Token-Verbrauch nach Vault und Unterprojekt auf, sodass du den Verbrauch über mehrere Vaults hinweg (zum Beispiel getrennte Kunden-Arbeitsbereiche) an einer Stelle verfolgen und vergleichen kannst. Sortierbare Übersichts- und Tag-nach-Vault-Tabellen (Klick auf eine Spaltenüberschrift, Standard „heute zuerst“) sowie ein eigenständiger Export Vault_Token_Usage_Projects.md für die Abrechnung
  • Neu gestaltetes Dashboard. Fünf KPI-Karten (Wochenprognose, Limit-Gesundheit, Cache-Effizienz, Tagestempo, Focus Score), eine Wochen-Statusleiste mit Prognose, ein Zeitraum-Dropdown (30/60/180/360 Tage) und ein neuer Reports-Tab
  • Historische Auswertung über 30 Tage hinaus. Der Tagesverbrauch wird jetzt direkt in deinem Vault archiviert, die Ansichten über 60/90+ Tage funktionieren also auch dann, wenn Claude Code seine eigenen lokalen Logs schon gelöscht hat
  • Einstellbare Aufbewahrung der Claude-Daten. Du legst direkt in den Plugin-Einstellungen fest, wie lange die originalen Sitzungsdateien auf der Platte bleiben
  • „What's new“-Popup in der App. Nach einem Update erscheint einmal eine kurze Zusammenfassung der letzten Änderungen. Du kannst sie jederzeit über die Befehlspalette → „Show what's new“ wieder öffnen
Nach oben

1.6.0August 2026

Release auf GitHub → (öffnet in neuem Tab)
  • Mehrsprachige Oberfläche. Englisch, Deutsch und Französisch. Das Sprach-Dropdown in den Einstellungen wirkt sofort, ohne Neustart. Die französische Übersetzung wurde muttersprachlich geprüft.
  • Einstellungs-Button (⚙) in der Kopfzeile der Seitenleiste. Er öffnet die Plugin-Einstellungen direkt, ohne Umweg über das Obsidian-Menü
  • Automatische Erkennung von Rate Limits. Session- und Wochenlimit-Treffer werden jetzt automatisch aus den lokalen JSONL-Dateien von Claude Code gelesen, ein manueller Button ist nicht mehr nötig. Das Plugin erkennt den genauen Moment, in dem ein Limit erreicht wurde, und welcher Art es war (Session oder Woche)
  • Dashboard: Rate-Limits-Abschnitt. Tabelle aller erkannten Limit-Ereignisse mit der jeweils relevanten Token-Kennzahl zum Zeitpunkt des Treffers (5-Stunden-Fenster bei Session-Limits, gesamte Abrechnungswoche bei Wochenlimits) sowie empirische Schätzungen der Schwellen für Session- und Wochenlimit aus deiner eigenen Nutzungshistorie
  • Dashboard: Diagramm zum Wochenverbrauch. Balkendiagramm über sechs Wochen, ausgerichtet an Claudes Abrechnungswochengrenze (Sonntag 18:00 → Sonntag 18:00 Europe/Berlin), mit Hervorhebung der Wochen, in denen das Wochenlimit erreicht wurde
  • Spike-Warnung. Bernsteinfarbenes Abzeichen neben „Heute“, wenn der Tagesverbrauch mindestens das Doppelte deines persönlichen 29-Tage-Durchschnitts beträgt (nur aktive Tage)
  • Last-Action-Chips. Vier farbige Chips (In / Out / C.Wr / C.Rd) ersetzen die reine Textzeile im Abschnitt Last Action, passend zum Farbschema der Minibalken in der ganzen Seitenleiste
  • Einklappbare Abschnitte. Alle fünf Zeitbereiche lassen sich einzeln mit einem Klick einklappen. Der Zustand bleibt über Datenaktualisierungen hinweg erhalten
  • Anzeige „Fenster geleert“. Zeigt in Grün „Window cleared · full 5h available“, wenn das 5-Stunden-Fenster leer ist, aber in den letzten sechs Stunden Aktivität aufgezeichnet wurde
  • Fehlerbehebung. Einträge mit null Tokens werden jetzt aus dem 5-Stunden-Fenster gefiltert und beeinflussen weder den Countdown noch die Anzeige
Nach oben

1.5.0August 2026

Release auf GitHub → (öffnet in neuem Tab)
  • Kontext-Unterzeilen unter jedem Abschnittstitel. Sie zeigen auf einen Blick, was jeder Zeitbereich abdeckt („Rolling window · counts toward rate limit“, Startzeit der Session, „Calendar day · since midnight“)
  • ← Zurück-Button in der Kopfzeile des Glossars. Er führt zur Datenansicht zurück, ohne dass du nach dem ?-Button suchen musst
  • Logarithmische Skala der Minibalken. Alle vier Token-Arten (Input, Output, C.Write, C.Read) bleiben auch bei großen Größenunterschieden gut lesbar
  • Feststehende Kopfzeile. Logo und Buttons bleiben sichtbar, auch wenn das Panel klein ist oder gescrollt wird
  • Fehlerbehebung. Der C.Write-Balken war wegen einer fehlenden CSS-Klasse (.au-bar-purple) unsichtbar
  • Neuer Glossareintrag. „The three time views“ erklärt, dass Last 5 Hour Session, This Session und Today voneinander unabhängige Schnitte durch dieselben Daten sind
  • GitHub-Artifact-Attestierungen. Release-Dateien sind jetzt kryptografisch signiert
Nach oben

1.4.1August 2026

Release auf GitHub → (öffnet in neuem Tab)
  • Neu gestaltete Kopfzeile mit Logo, SVG-Diagrammsymbol und Farbverlaufstext
  • Eingebautes Glossar, umschaltbar mit dem ?-Button, erklärt alle Token-Begriffe und enthält eine ungefähre Kostenübersicht
  • HTML-Dashboard mit 30-Tage-Diagrammen, Modell-Donut, Tabelle der größten Sessions und Analyse der Cache-Effizienz
  • C.Write und C.Read sind in der ganzen Seitenleiste in getrennte Zeilen aufgeteilt
  • Gestapelter 7-Tage-Balken zur Modellverteilung (Haiku / Sonnet / Opus / Fable)
  • Hilfeseite unter langeatn.de/media/token-usage/ (Englisch und Deutsch, automatisch erkannt)
Nach oben

1.0.0 – 1.0.2Juli 2026

Release auf GitHub → (öffnet in neuem Tab)
  • Erstveröffentlichung
  • Live-Dateiüberwachung der aktiven Claude-Code-Sitzung
  • Token-Aufschlüsselung nach Last Action, This Session, Today, 7 Days, 30 Days
  • Ausweich-Abfrageintervall (einstellbar)
  • Freigegeben und gelistet im Obsidian-Community-Plugin-Verzeichnis
Nach oben

Quelle: Changelog in der README des Projekts, hier ins Deutsche übertragen. Zur Projektseite →