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, 2.1.0 und 2.5.0.

2.5.1November 2026

Release auf GitHub → (öffnet in neuem Tab)

Ein Patch für zwei Fehler von uns: Die Seitenleiste hat Obsidian einfrieren lassen, während Claude Code beschäftigt war, und unsere Anleitung für die Abfrage unter Windows hat alle 30 Minuten ein Konsolenfenster geöffnet.

Behoben

  • Obsidian ist sekundenlang eingefroren, während Claude Code beschäftigt war. Bei jeder Aktualisierung hat die Seitenleiste alle Session-Logs im Aufbewahrungszeitraum von Claude Code neu gelesen und ausgewertet, im Hauptthread von Obsidian, kleinere Dateien sogar zweimal. Der Datei-Watcher hat so eine Aktualisierung nach jedem Schreibvorgang im Session-Log ausgelöst, und eine beschäftigte Sitzung schreibt viele Male pro Minute. Auf unserem eigenen Rechner (245 Logdateien, 1,1 GB, 120 Tage Aufbewahrung) hat eine Aktualisierung etwa vier Sekunden gedauert und kam alle vier bis sechs Sekunden, Obsidian stand also die meiste Zeit still. Je länger deine Historie und je beschäftigter deine Sitzung, desto schlimmer, und mit Claude Code direkt in Obsidian am schlimmsten. Das war unser Fehler, und er ist uns vorher nicht aufgefallen. Jetzt wird jedes Log einmal ausgewertet und im Speicher gehalten: Unveränderte Dateien werden nicht noch einmal gelesen, und ein gewachsenes Log nur ab der Stelle, an der zuletzt gelesen wurde. Gemessen auf demselben Rechner: etwa 110 ms je Aktualisierung statt vier Sekunden. Nur die erste Aktualisierung nach dem Start von Obsidian liest noch alles, einmal
  • Unsere Windows-Anleitung für die Abfrage hat bei jedem Lauf ein Konsolenfenster geöffnet. Die Befehle für die Aufgabenplanung haben node.exe direkt gestartet. node.exe ist ein Konsolenprogramm, deshalb hat Windows jedes Mal ein Fenster geöffnet, bei der empfohlenen Variante alle 30 Minuten, auch bei Läufen, die gar nichts abgefragt haben. Die Anleitung startet es jetzt über conhost.exe --headless, das hält das Fenster fern, und hat einen Block, der eine bestehende Aufgabe umstellt, ohne sonst etwas zu ändern. Getestet haben wir das unter Windows 11. Microsoft dokumentiert diesen Schalter nicht, und manche Sicherheitssoftware meldet versteckte Konsolenstarts als verdächtig, für diesen Fall bleibt der einfache Start in der Anleitung

Geändert

  • Während eine Sitzung beschäftigt ist, aktualisiert sich die Seitenleiste höchstens alle 30 Sekunden. Bis 2.5.0 hat jeder Schreibvorgang eine kurze Wartezeit von 0,6 Sekunden neu gestartet, eine beschäftigte Sitzung hat also eine Aktualisierung nach der anderen ausgelöst. Die erste Antwort nach einer ruhigen Phase erscheint weiter nach 0,6 Sekunden. Solange weiter geschrieben wird, folgt die nächste Aktualisierung spätestens 30 Sekunden nach der vorigen und enthält alles, was bis dahin geschrieben wurde. Der Aktualisieren-Knopf und das Intervall in den Einstellungen werden nicht gebremst
  • Der Text in den Einstellungen sagt nicht mehr, dass der Datei-Watcher sofort auf jede Antwort reagiert, in allen fünf Sprachen. Mit der 30-Sekunden-Grenze stimmt das nicht mehr, jetzt steht dort „spätestens nach 30 Sekunden". Die Hilfeseite sagt dasselbe
  • Für die Abfrage nur bei Aktivität reicht ein Lauf pro Stunde. Wir hatten alle 30 Minuten empfohlen. Das sind doppelt so viele Anfragen für eine Ablesung, die höchstens eine halbe Stunde frischer ist. Anleitung, cron-Zeile, Skriptkopf und Hilfeseite sagen jetzt stündlich
Nach oben

2.5.0Oktober 2026

Release auf GitHub → (öffnet in neuem Tab)

Prozente kommen nur noch von Anthropic. Das ist die größte Änderung seit 2.0, und sie beginnt mit einer Entscheidung von uns, die falsch war. Die Version springt von 2.1 auf 2.5, damit das sichtbar ist.

Geändert

  • Prozente kommen nur noch von Anthropic. Bis 2.1 hat Token Usage für das 5h-Fenster und die Woche einen Prozentwert geschätzt, aus deinen eigenen Limit-Treffern oder hochgerechnet aus dem Feed. Wir haben diese Schätzung elf Tage lang gegen die offiziellen Werte gelegt. Beim 5h-Fenster lag sie im Schnitt 36 Punkte daneben, und in dem Moment, in dem ein Fenster offiziell voll war, stand unser Ring irgendwo zwischen 61 und 217 Prozent (eigene Messung, 37 Ablesungen, 06. bis 17.10.2026). Wie schnell ein Fenster voll ist, hängt stark davon ab, wie viel Kontext eine Sitzung mitschleppt, und das lässt sich aus den lokalen Logs nicht verlässlich ablesen. Die Ringe haben damit eine Genauigkeit vorgegeben, die sie nie hatten. Das war unsere Entscheidung, und sie war falsch. Ab 2.5 gilt eine einfache Regel: Einen Prozentwert für ein Limit zeigen wir nur, wenn er von Anthropic kommt, zusammen mit der Uhrzeit, zu der er abgelesen wurde. Dafür brauchst du den Feed (Anleitung in der Hilfe). Bei der Woche machen wir eine Ausnahme: Zwischen zwei Ablesungen rechnen wir vom letzten offiziellen Wert mit deinen gezählten Tokens weiter und kennzeichnen das auch so, weil sich das Wochenlimit in derselben Messung als stabil erwiesen hat (im Mittel 1,2 Punkte Abweichung). Ohne Feed siehst du, was wir sicher wissen: deine Tokens im laufenden Fenster und in der Woche, die Zeit bis zum Reset und die Spanne, in der dein 5h-Fenster bisher voll war
  • Der Heute-Ring zeigt ein Vielfaches, kein Prozent. „1,5x dein üblicher Tag“ statt „150 %“. Damit kommt jedes Prozentzeichen auf dem Bildschirm entweder von Anthropic oder ist eine gekennzeichnete Wochen-Hochrechnung aus einem Anthropic-Wert
  • Die Heatmap misst jede Zelle an deinem eigenen üblichen 2-Stunden-Block (dem Schnitt deiner aktiven 2-Stunden-Blöcke über die gespeicherten Tage, der Wert steht unter dem Raster). Bis 2.1 wurde sie am geschätzten 5-Stunden-Limit gemessen, das es nicht mehr gibt
  • Die Spanne statt einer Schätzung. Unter den Ringen steht jetzt „Bei dir war das 5h-Fenster bisher nach 51K bis 316K voll (102 Limit-Treffer)“. Das ersetzt die alte Zeile „5h-Limit geschätzt auf X, Median aus n Treffern“ und zeigt, wie breit der Bereich wirklich ist
  • Dashboard und CSV-Exporte folgen derselben Regel. Die Budget-Panels, die Gesamtzone, die Karte Limit Health und die Wochenleiste nutzen nur offizielle Werte, ohne sie zeigen die Panels gezählte Tokens und die Zeit bis zum Reset. Die Zeilen mit geschätzten Limits in beiden CSV-Exporten sind ersetzt durch die offiziellen Werte mit Uhrzeit der Ablesung, die gekennzeichnete Wochen-Hochrechnung, das Wochenlimit, das der Feed ergibt, und die Spanne

Sicherheit

  • Das Dashboard hat Ordner- und Modellnamen ungefiltert in die Seite gesetzt. Der Projektname im Dashboard ist der letzte Ordner des Arbeitsverzeichnisses, in dem eine Sitzung begann. Ein präparierter Ordnername, etwa eines geklonten Repositorys, hätte Skript in der Dashboard-Seite in deinem Browser ausführen können, ein Modellname mit </script> hätte die ganze Seite zerbrechen können. Das Dashboard öffnet sich als lokale Datei im Browser, ohne Zugriff auf deine übrigen Dateien oder auf Obsidian, ein solches Skript hätte aber die Dashboard-Zahlen nach außen schicken können. Alle Namen werden jetzt maskiert, die Sortierköpfe tragen keine Namen mehr in Inline-Handlern, und die eingebetteten Daten können ihren Skriptblock nicht mehr schließen. Gefunden haben wir das in unserem eigenen Sicherheitscheck im Oktober 2026, einen Hinweis auf Ausnutzung gibt es nicht, und ein neuer Test lässt das echte Dashboard mit präparierten Namen laufen. Die Seitenleiste in Obsidian war nicht betroffen: Sie hat Namen nie in HTML gesetzt
  • CSV-Exporte entschärfen Formeln. Eine Textzelle, die mit =, +, - oder @ beginnt (etwa ein Ordnername), wäre von Excel oder LibreOffice als Formel ausgeführt worden. Solche Zellen beginnen jetzt mit einem Hochkomma, reine Zahlen bleiben, wie sie sind
  • Der Release-Workflow bindet seine Actions an feste Commits statt an Versions-Tags, die sich verschieben lassen, und lässt kein Token mehr im Checkout liegen

Behoben

  • Der Wochen-Reset lag nach der Umstellung auf Winterzeit eine Stunde daneben. Anthropic setzt zu einem festen Zeitpunkt in UTC zurück. Das Plugin hatte ihn als lokalen Wochentag mit Uhrzeit gespeichert, nach der Zeitumstellung lag deshalb jede Wochengrenze ein halbes Jahr lang eine Stunde daneben. Der Reset kommt jetzt als genauer Zeitpunkt aus dem Feed oder aus deiner Wochenlimit-Meldung, und die Woche rechnet von dort weiter. Ein Reset, den du von Hand setzt, bleibt in Ortszeit. Das Dashboard nimmt außerdem nicht mehr für alle Sonntag 16:00 UTC an, das war der Zeitplan eines einzelnen Kontos
  • Usage Credits haben das aus dem Feed abgeleitete Wochenlimit aufgebläht. Mit Usage Credits geht die Arbeit nach dem Wochenlimit weiter. Das Plugin hat diese zusätzlichen Tokens durch die 100-%-Ablesung geteilt, das abgeleitete Limit wuchs also mit jedem Credit-Token. Ablesungen ab 100 % und alles danach in derselben Woche werden nicht mehr verwendet, eine Woche bei 100 % zeigt den offiziellen Wert ohne Hochrechnung
  • Der CSS-Lint-Hinweis zu :has aus der Community-Review ist weg. Diesen Fix hatten wir im Forum für 2.1 zugesagt und zweimal verpasst
  • Das Glossar sagte noch, Cache zähle nicht aufs Limit. Das widersprach unserer eigenen Korrektur aus 2.1.0, im Eintrag „Kostenübersicht“, in allen fünf Sprachen. Korrigiert
  • Die Trendlinien der 7-Tage-Kacheln unter Auswertung waren flach. Die Kacheln lasen je Tag einen Wert, den die 7-Tage-Reihe nie geliefert hat: Calls und Active Days von Anfang an, Total und Avg / Active Day seit 2.0. Die 30-Tage-Kacheln waren nicht betroffen. Aufgefallen ist es uns erst an den neuen Store-Bildern für 2.5, die Bilder von 2.0 zeigten es schon

Neu

  • Weitere offizielle Fenster werden gezeigt, wenn Anthropic sie meldet, etwa ein eigenes Wochenlimit für ein Modell. Beide Feed-Skripte schreiben solche Fenster jetzt mit, das Plugin schätzt dafür nichts
  • Das Abfrage-Skript versucht es nach einer Zeitüberschreitung noch einmal. Eine geplante Abfrage direkt nach dem Aufwachen aus dem Standby hat oft noch kein Netz
  • Das Abfrage-Skript kann nur laufen, während du arbeitest. Mit --only-when-active fragt es nur, wenn Claude Code in den letzten 20 Minuten in seine Logs geschrieben hat. Dann ist ohnehin ein 5h-Fenster offen, das Skript öffnet also praktisch keins selbst und kann alle 30 Minuten laufen. Bei drei festen Abfragen am Tag blieb der 5h-Ring meist grau, das ist uns im eigenen Test vor dem Release aufgefallen
  • Ein Hinweis unter den Ringen, wenn kein Feed da ist, mit Link zur Einrichtung
  • Prozent und Tokens, erklärt. Die Tooltips von 5h- und Wochen-Ring und die Hinweiszeile über den Dashboard-Panels sagen jetzt, warum beides nicht direkt zusammenpasst: Gezählt werden Input und Output, Anthropic rechnet den mitgeschickten Kontext mit
  • Die Hilfeseite ist neu gebaut und jetzt auch auf Italienisch. Ein Aufbau für Englisch, Deutsch, Französisch, Spanisch und Italienisch, in jeder Sprache dieselben Abschnitte, ein Inhaltsverzeichnis neben dem Text. Bis 2.1 fehlten der deutschen und der französischen Seite vier Abschnitte, die spanische war ein kürzerer eigener Text, und alle Seiten nannten noch die Modellfarben von vor 2.0

Bekannte Grenzen

  • Ohne Feed gibt es keine Limit-Prozente. In Clients ohne Statuszeile, etwa Obsidian, kommen die Ablesungen aus der geplanten Abfrage, die jedes Mal eine kleine echte Anfrage ist und ein 5h-Fenster öffnet, wenn gerade keins offen ist
  • Mit einer Abfrage zu festen Zeiten, wenige Male am Tag, ist der 5h-Ring meist grau: Eine 5h-Ablesung zählt nur in dem Fenster, in dem sie genommen wurde. Abhilfe ist die Abfrage nur bei Aktivität (siehe Neu)
  • In 2.1.0 hatten wir als offen genannt, ob 1-Stunden- und 5-Minuten-Cache-Writes unterschiedlich aufs Limit zählen. Das blieb nicht messbar: In allen Abschnitten bis zum 17. Oktober waren die Cache-Writes praktisch ausschließlich 1-Stunden-Writes. Seit 2.5 schätzt das Plugin keine Limits mehr, die Frage beeinflusst also keine Zahl mehr, die es zeigt
Nach oben

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. *(Entfernt in 2.5.0: Gegen die offiziellen Werte gemessen, lag die Schätzung im Schnitt 36 Punkte daneben. Prozentwerte kommen jetzt nur noch von Anthropic.)*
  • 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 →