Token-Verbrauch in
Claude Code verstehen

Empirische Limit-Schätzung — eine Zahl, die Anthropic nirgends veröffentlicht

Anthropic veröffentlicht das tatsächliche Token-Limit hinter einem Rate-Limit-Hit nicht — es existiert serverseitig und bleibt unsichtbar, sowohl für das verankerte 5-Stunden-Fenster als auch für das Wochenlimit. Token Usage macht es stattdessen empirisch sichtbar: jeder in deinen eigenen lokalen Session-Dateien erkannte Rate-Limit-Hit wird zu einem Datenpunkt, und genug Datenpunkte ergeben eine Schätzung deines eigenen Session- und Wochenlimits. Keine Vermutung, keine Marketing-Sprache — eine Zahl, die aus dem gebaut ist, was auf deinem Account tatsächlich passiert ist.

Diese Schätzung ist keine einmalige Momentaufnahme. Sie wird mit der Zeit ganz automatisch präziser, je länger du Claude Code nutzt — jeder neue Rate-Limit-Hit verfeinert sie weiter, sodass die Zahl, die du heute siehst, verlässlicher ist als die aus deiner ersten Woche. Weil sie vollständig aus deinen eigenen lokalen Daten aufgebaut wird, gibt es nichts einzustellen und nichts zu aktivieren: die Schätzung verbessert sich einfach von selbst, während du weiterarbeitest.

Die aktuelle Schätzung findest du an zwei Stellen: im Budget-Banner ganz oben im Dashboard und in der Seitenleiste unter Aktueller Stand mit ihren drei Ringen (5h-Fenster, heute, diese Woche). Die Zeile unter den Ringen nennt die 5-Stunden-Schätzung ausdrücklich und sagt, auf wie vielen beobachteten Limit-Treffern sie beruht. Beide Oberflächen lesen aus derselben Berechnung, können also niemals widersprüchliche Zahlen zeigen.

Die 5-Stunden-Schätzung wird als Median mit einem üblichen Band gezeigt: der mittleren Hälfte deiner beobachteten Treffer. Dasselbe Limit wird selten bei exakt derselben Summe erreicht, weil auch anderes Claude-Nutzen, das Token Usage nicht sehen kann (etwa claude.ai im Browser), am selben Limit zehrt. Eine einzelne Zahl würde genauer wirken, als sie ist. Jeder Treffer wird in seinem eigenen verankerten 5-Stunden-Fenster gemessen, genau so, wie der Ring zählt, beide sind deshalb direkt vergleichbar. In der Seitenleiste steht das Band in einer eigenen Zeile unter der Schätzung, im Dashboard ersetzt es im Budget-Banner die frühere Min-Max-Spanne, und der CSV-Export enthält beide Grenzen.

Was ist ein Token?

Ein Token ist ein kleines Textstück — ungefähr drei Viertel eines deutschen Wortes. Es ist weder exakt ein Wort noch exakt ein Zeichen. Der Satz "Guten Morgen, wie geht es dir heute?" ergibt etwa 8 Tokens. Längere oder ungewöhnliche Wörter können mehr kosten, kurze häufige Wörter teilen sich manchmal einen Token.

Input und Output

Input ist alles, was Claude in einer Anfrage empfängt: deine Nachricht, die Systemanweisung, Dateiinhalte, Tool-Ergebnisse und den Gesprächsverlauf, der bei jeder neuen Nachricht erneut mitgeschickt wird.

Output ist das, was Claude zurückschreibt. Output-Tokens sind bei allen aktuellen Modellen teurer als Standard-Input-Tokens.

Eine einzelne Frage ist günstig. Die Kosten entstehen durch Volumen, Kontextgröße und Wiederholung — nicht durch die Komplexität dessen, was du fragst.

C.Write — Cache-Schreiben

Wenn Claude Code einen großen, wiederkehrenden Textblock sendet (Projektdateien, eine lange Systemanweisung, eine komplette Codebasis), kann die Infrastruktur von Anthropic diesen zwischenspeichern. Beim ersten Mal, dass dieser Block verarbeitet wird, wird er in den Cache geschrieben. Das ist ein Cache Write.

Es gibt zwei Arten von Cache Writes mit unterschiedlichem Preis: Ein 5-Minuten-Cache-Write kostet das 1,25-fache des Standard-Input-Preises, ein 1-Stunden-Cache-Write das 2-fache. In unseren eigenen Logs waren rund 90 % der Cache Writes von Claude Code im Abo die 1-Stunden-Art, Subagenten schrieben 5-Minuten-Caches. Seit 2.1.0 zeigt die C.Write-Zeile in der Seitenleiste die Aufteilung, wenn du mit der Maus darüberfährst. Es ist eine Investition: Du zahlst mehr im Voraus, damit nachfolgende Anfragen denselben Inhalt nicht erneut verarbeiten müssen. Cache Writes zählen außerdem auf das 5-Stunden-Limit, siehe Was auf ein Limit einzahlt.

Das Plugin zeigt C.Write in Aqua in der gesamten Seitenleiste.

C.Read — Cache-Lesen

Sobald ein Block gecacht ist, kann Claude ihn bei nachfolgenden Anfragen aus dem Cache lesen, anstatt ihn von Grund auf neu zu verarbeiten. Das ist ein Cache Read.

Cache Reads kosten nur einen Bruchteil des Standard-Input-Preises: das 0,1-fache bei den meisten Modellen, das 0,05-fache bei Opus 5.5 und Sonnet 5.5, das 0,025-fache bei Fable 5.1. Wenn derselbe Kontext viele Male genutzt wird, machen Cache Reads große Sessions deutlich erschwinglicher.

Das Plugin zeigt C.Read in Violett, um hohes Volumen bei niedrigen Kosten pro Token zu signalisieren.

C.Write vs. C.Read — Der Wiederverwendungsfaktor

Das Verhältnis dieser beiden Werte erzählt eine Geschichte darüber, wie du arbeitest.

Faktor	Was er bedeutet
Unter 2×	Viel neuer Kontext, wenig Wiederverwendung. Explorativer Modus.
2× bis 8×	Ausgewogen. Der Cache zahlt sich aus, der Kontext wechselt aber regelmäßig.
Über 8×	Tiefer Fokus-Modus — gleiche Dateien, lange Session, Cache arbeitet hart für dich.

Ein hoher Wiederverwendungsfaktor ist in der Regel ein gutes Zeichen: Du arbeitest intensiv am gleichen Problem und der Cache spart dir im Vergleich zu reinem Input-Preis erheblich. Das Dashboard zeigt diesen Wert im Abschnitt Cache-Effizienz, inklusive eines Liniendiagramms mit C.Write in Aqua und C.Read in Violett — passend zu den Farben in der Seitenleiste.

Aktuelles 5-Stunden-Fenster

Claude Code setzt ein 5-Stunden-Fenster durch, und das ist verankert, nicht rollierend. Das Fenster öffnet mit deiner ersten Nachricht und läuft dann exakt fünf Stunden; ein neues beginnt erst, wenn diese Zeitspanne vollständig abgelaufen ist — in festen Fünf-Stunden-Blöcken, unabhängig davon, wie viel Leerlauf dazwischen lag. Es sind nicht „die letzten fünf Stunden rückwärts ab jetzt" — und es ist unabhängig vom Wochen-Reset, der nach seinem eigenen Zeitplan läuft und dabei kein neues 5-Stunden-Fenster startet.

Das Plugin rekonstruiert diese echten Fenster aus deiner Aktivität und summiert das gerade offene, mit Input, Output, C.Write und C.Read als separate Zeilen. Das zählt genau im Moment des Fensterwechsels: Eine rollierende Rechnung würde den Schwanz des eben geschlossenen Fensters zum Kopf des eben geöffneten addieren — eine Zahl, die zu keinem von beiden gehört, und das ausgerechnet dann, wenn du sehen willst, dass du frisches Budget hast.

Das ist die aktuellste Ansicht deiner laufenden Arbeit. Das Fenster zeigt, was du seit seiner Öffnung verbraucht hast.

Warum der Countdown eine Tilde (~) zeigt

Der Reset-Countdown unten links in der Seitenleiste lautet "Claude 5h resets in: ~Xh Ym". Die Tilde ist bewusst gesetzt — sie signalisiert, dass es sich um einen Schätzwert handelt, nicht um einen exakten Wert.

Claude Code schreibt Session-Daten in lokale Dateien erst nach dem vollständigen Abschluss einer Antwort — nicht in dem Moment, in dem du deine erste Nachricht sendest. Die erste Anfrage einer Session ist oft lang: Kontext laden, Dateien lesen, Nachdenken. Eine solche erste Antwort kann 10 bis 25 Minuten dauern. Während dieser Zeit wird noch nichts in das lokale Session-Log geschrieben. Der früheste Zeitstempel, den das Plugin lesen kann, ist also nicht dein tatsächlicher Session-Start, sondern der Moment, in dem deine erste Antwort angekommen ist.

Das bedeutet: Der Countdown im Plugin kann 10 bis 25 Minuten hinter Claudes eigener Anzeige liegen. Für die genaue Zurücksetzungszeit schau bitte in den Plan-Nutzungsbereich in Claude Code oder auf claude.ai. Der Plugin-Wert ist eine zuverlässige Orientierung — Claudes eigene Anzeige ist jedoch die verbindliche Quelle.

Die drei Zeitansichten — und ihr Verhältnis zueinander

Die Seitenleiste zeigt drei verschiedene Zusammenfassungen deiner Aktivität: Aktuelles 5-Stunden-Fenster, This Session und Today. Diese drei sind unabhängige Schnitte durch dieselben Daten — sie schachteln sich nicht automatisch ineinander wie Stunden, Tage und Wochen es täten.

Ansicht	Was sie zeigt	Wird zurückgesetzt wenn
Aktuelles 5-Stunden-Fenster	Verankertes Fenster: alles seit seiner Öffnung	Wenn es abläuft — die nächste Nachricht öffnet ein neues, in festen Fünf-Stunden-Schritten, unabhängig von Pausen dazwischen
This Session	Alle Einträge mit der aktuellen Session-ID, unabhängig vom Kalendertag	Wenn du eine neue Claude Code Session startest (neue JSONL-Datei)
Today	Kalendertag: alles seit Mitternacht	Jeden Tag um Mitternacht

Die wichtigste Konsequenz: Eine Session kann mehrere Tage umspannen. Wenn du gestern eine lange Session gestartet und heute weitergemacht hast, zeigt "This Session" mehr Tokens als "Today". Das ist beabsichtigt — die Session akkumuliert über Kalendertaggrenzen hinweg, während "Today" nur ab Mitternacht zählt.

Ähnlich gilt: Das 5-Stunden-Fenster ist kein Teilbereich von „Heute". Ein Fenster, das gestern Abend geöffnet hat, reicht über Mitternacht hinweg, und alles darin zählt weiterhin auf dasselbe Limit. Genauso können beide identisch sein — wenn dein Fenster heute früh geöffnet hat und du davor heute nicht gearbeitet hast, zeigen beide Zahlen dasselbe, bis das Fenster schließt.

Das Plugin macht dies sichtbar: Ein kleiner Sub-Label unter jedem Section-Titel erklärt den genauen Zeitrahmen. Bei "This Session" wird angezeigt, wann die Session gestartet ist — so siehst du sofort, ob die Zahlen mehrere Tage umfassen.

Archiv & Langzeit-Daten

Claude Code löscht seine eigenen Session-Dateien automatisch — standardmäßig nach 30 Tagen, oder nach dem, was du unter Claude-Datenaufbewahrung in den Settings eingestellt hast. Ohne eine Kopie an anderer Stelle ist alles Ältere endgültig weg.

Das Archiv löst das: An jedem Tag, an dem du Claude Code nutzt, schreibt das Plugin eine kleine Zusammenfassungsdatei nach Token Usage Archive/ in deinem Vault — nur aggregierte Summen, nie deine tatsächlichen Gespräche. Jedes Mal, wenn du Obsidian öffnest, prüft es alle noch verfügbaren Tage und füllt jeden Tag nach, der noch keine Datei hat — auch Lücken durch eine Zeit, in der das Plugin nicht lief.

Die ehrliche Grenze: Das Archiv kann nur retten, was zum Zeitpunkt des Öffnens noch existiert. Bleibt Obsidian länger geschlossen als der eingestellte Aufbewahrungszeitraum, sind die dazwischenliegenden Tage bereits weg, bevor das Plugin überhaupt eine Chance hatte hinzuschauen — daran führt ohne durchgehenden Betrieb kein Weg vorbei. Erhöhe die Aufbewahrung (Settings → Claude data retention), wenn du Obsidian seltener als täglich öffnest, um dem Plugin mehr Sicherheitsspielraum zu geben.

Was auf ein Limit einzahlt

Anthropic setzt zwei Limits durch und sonst keins: das 5-Stunden-Fenster und ein Wochenlimit, das an einem festen Wochentag zu einer festen Uhrzeit zurückgesetzt wird. Ein Tageslimit gibt es nicht — die Kachel „Heute" ist deshalb kein Kontingent (siehe Der Heute-Ring).

Input- und Output-Tokens zählen, und Cache ist nicht umsonst. Messungen gegen die offiziellen Prozentwerte, die Claude Code meldet (Oktober 2026), deuten darauf hin, dass Cache Writes deutlich auf das 5-Stunden-Fenster einzahlen und Cache Reads ein wenig. Eine frühere Auswertung beobachteter Limit-Treffer hatte in die andere Richtung gezeigt. Die neuen Messungen sind direkter. Die Zahlen im Plugin zählen weiterhin nur Input und Output. Muss eine lange Session ihren Cache neu aufbauen, etwa in einem neuen 5-Stunden-Fenster nach einer Pause oder wenn ein großer Kontext zum ersten Mal geladen wird, kann der offizielle Wert dem Plugin deshalb vorauslaufen. Praktisch heißt das: Lange Sessions mit großem Kontext verbrauchen das 5-Stunden-Fenster pro Antwort schneller als frische, kurze.

Keines der beiden Limits ist veröffentlicht. Beide Schätzungen stammen aus deiner eigenen Historie, und deshalb kann das Plugin sie erst zeigen, wenn es dich mindestens einmal in ein Limit hat laufen sehen. Bis dahin sagt es das, statt eine Zahl zu erfinden. Die Wochenschätzung aus Treffern ist die niedrigste Woche, die je ans Limit kam, und kann deutlich zu niedrig liegen, weil auch Cache, den das Plugin nicht zählt, dich ans Limit bringt. Mit dem Statusline-Feed (siehe Offizielle Prozentwerte aus der Statuszeile) nutzt das Plugin stattdessen die offiziellen Werte.

Der Heute-Ring

Für den Tag gibt es kein Limit. Anthropic begrenzt nur das 5-Stunden-Fenster und die Woche. Der Heute-Ring vergleicht deinen heutigen Verbrauch mit deinem eigenen Schnitt pro aktivem Tag, gerechnet über alle Tage, die Claude Code aufbewahrt (deine Einstellung zur Datenaufbewahrung, cleanupPeriodDays).

200 % heißt, dass du heute doppelt so viel arbeitest wie sonst, mehr nicht. Ein voller Tag ist eine geänderte Arbeitsweise, keine Warnung. Wie nah du an einem Limit bist, zeigen nur die Ringe für das 5-Stunden-Fenster und die Woche. Deshalb bleibt der Ring seit 2.1.0 neutral grau.

Offizielle Prozentwerte aus der Statuszeile

Optional, seit 2.1.0. Token Usage funktioniert auch ohne. Claude Code kennt die offiziellen Prozentwerte deines Tarifs, also die Zahlen, die /usage anzeigt. Zwei kleine Skripte aus dem Plugin-Repository schreiben sie nach ~/.claude/ratelimit-log.jsonl. Liegt diese Datei vor, verankert das Plugin seine Ringe daran. Die vollständige Anleitung (Englisch) liegt im Ordner extras auf GitHub.

Was du davon hast

	Ohne Feed	Mit Feed
Start des 5-Stunden-Fensters	Rekonstruiert aus deiner ersten geloggten Nachricht	Der offizielle Start, auch wenn das Fenster auf claude.ai, einem anderen Gerät oder in einem anderen Werkzeug geöffnet wurde
5-Stunden-Ring	Deine Tokens gegen den Median deiner eigenen Limit-Treffer	Bei jeder Ablesung genau der offizielle Prozentwert, dazwischen zählt er mit deinen Tokens weiter
Wochen-Ring	Deine Tokens gegen die niedrigste Woche, die je ans Limit kam, das kann deutlich zu niedrig sein	Bei jeder Ablesung genau der offizielle Prozentwert
Braucht zuerst einen Limit-Treffer	Ja	Nein

Voraussetzungen

• Ein Pro- oder Max-Abo, mit dem Claude Code angemeldet ist. Mit einem API-Schlüssel gibt es keine Tarif-Prozentwerte.
• Node.js, denn beide Skripte sind kleine Node-Programme. Prüfen mit node --version. Fehlt es, installiere die LTS-Version von der Node.js-Website. Wurde Claude Code mit dem nativen Installer eingerichtet, bringt es Node.js nicht mit.
• Eine aktuelle Claude-Code-Version, und für die Abfrage die Claude-Code-Kommandozeile claude.

Welches Skript brauche ich?

Wo du arbeitest	Skript
Im Terminal	ratelimit-statusline.js als Statuszeile. Kostenlos, die Ablesungen kommen, während du arbeitest
In Obsidian, einem Editor oder einem anderen Programm ohne Statuszeile	ratelimit-poll.js, zeitgesteuert ausgeführt
Beides	Beide. Sie schreiben in dieselbe Datei

Eine Statuszeile läuft nur, solange das interaktive Claude-Code-Terminal offen ist. Programme, die Claude Code einbetten, führen sie nicht aus. Dort liefert die Statuszeile allein also kaum oder keine Ablesungen.

Weg A: Statuszeilen-Skript

Kopiere das Skript nach ~/.claude/ratelimit-statusline.js und ergänze diesen Eintrag in ~/.claude/settings.json, neben den Einträgen, die schon dort stehen:

"statusLine": { "type": "command", "command": "node ~/.claude/ratelimit-statusline.js" }

Unter Windows nimm den vollständigen Pfad mit Schrägstrichen nach vorn, zum Beispiel node C:/Users/<du>/.claude/ratelimit-statusline.js. Starte Claude Code neu, die Statuszeile zeigt dann 5h 12% | week 34%. Du nutzt schon eine eigene Statuszeile? Behalte sie und übernimm den Protokoll-Teil unseres Skripts.

Weg B: zeitgesteuerte Abfrage

Bevor du es einrichtest: Jeder Lauf ist eine echte, sehr kleine Anfrage (der Prompt ok an Haiku, ohne gespeicherte Session) und zählt auf deinen Verbrauch. Ist in dem Moment kein 5-Stunden-Fenster offen, öffnet die Anfrage eins, dein nächstes Fenster beginnt dann zur Abfragezeit. Plane sie für Zeiten, zu denen du ohnehin arbeitest. Dreimal am Tag reicht völlig.

Kopiere das Skript nach ~/.claude/ratelimit-poll.js und starte es einmal von Hand mit node ~/.claude/ratelimit-poll.js. Es gibt 5h 12% | week 34% aus. Dann plane es ein.

Windows (PowerShell, läuft um 12:00, 17:00 und 22:00 und holt verpasste Läufe nach, wenn der Rechner aus war):

$node     = (Get-Command node).Source
$script   = "$env:USERPROFILE\.claude\ratelimit-poll.js"
$action   = New-ScheduledTaskAction -Execute $node -Argument "`"$script`""
$triggers = '12:00','17:00','22:00' | ForEach-Object { New-ScheduledTaskTrigger -Daily -At $_ }
$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable
Register-ScheduledTask -TaskName 'TokenUsageLimitPoll' -Action $action -Trigger $triggers -Settings $settings

macOS und Linux (crontab -e, mit vollständigen Pfaden aus which node und which claude, weil cron mit einem minimalen PATH läuft):

0 12,17,22 * * * CLAUDE_BIN=/voller/pfad/zu/claude /voller/pfad/zu/node /Users/<du>/.claude/ratelimit-poll.js

Unter Linux heißt der Benutzerordner meist /home/<du>. Fehler zeitgesteuerter Läufe landen in ~/.claude/ratelimit-poll-errors.log. Findet das Skript die Claude-Code-Kommandozeile nicht, setze CLAUDE_BIN auf ihren vollständigen Pfad.

Prüfen, ob es läuft

• Die Datei ~/.claude/ratelimit-log.jsonl existiert und bekommt neue Zeilen.
• In der Seitenleiste endet die Zeile unter den drei Ringen mit "abgeleitet aus dem offiziellen Prozentwert in deinem Statusline-Feed". Der Tooltip am Wochen-Ring sagt dasselbe für das Wochenlimit.
• Direkt nach einer Ablesung zeigen /usage in Claude Code und die Ringe des Plugins dieselben Prozentwerte.

Wie das Plugin die Ablesungen nutzt

Jede Ablesung enthält den Zeitpunkt, zu dem das aktuelle 5-Stunden-Fenster zurückgesetzt wird. So kennt das Plugin den echten Fensterstart. Die letzte Ablesung im offenen Fenster ist der Sockel des 5-Stunden-Rings, zwischen zwei Ablesungen kommen deine neuen Tokens mit der Rate dazu, die deine letzten Fenster tatsächlich hatten. Die letzte Ablesung der laufenden Woche ab 10 % legt das Wochenlimit fest. Ablesungen unter 10 % sind zu grob, weil die Werte als ganze Prozent kommen. Passt keine Ablesung, nutzt das Plugin wie bisher seine eigenen Schätzungen.

Bekannte Grenzen

Zwischen zwei Ablesungen zählt das Plugin nur Input und Output. Offiziell zählen auch Cache Writes auf das 5-Stunden-Fenster, ein Cache-Neuaufbau (ein neuer Chat, oder die erste Nachricht nach einer langen Pause in einer langen Session) erscheint deshalb erst mit der nächsten Ablesung. Ablesungen gibt es nur, solange eine Statuszeile angezeigt wird, oder zu den geplanten Zeiten.

Fehlersuche

Was du siehst	Was zu tun ist
Die Statuszeile ist leer	Node.js wird nicht gefunden. Prüfe node --version, unter Windows den vollständigen Pfad zu node.exe in den Befehl schreiben
5h ? | week ?	Es kommen keine Prozentwerte an. Mit dem Abo statt mit einem API-Schlüssel anmelden, Claude Code aktualisieren
Abfrage: "Claude Code CLI not found"	CLAUDE_BIN auf den vollständigen Pfad von claude setzen
Abfrage: "No rate_limit_event in the output"	claude einmal von Hand starten und mit dem Abo anmelden
Das Plugin zeigt noch die alten Texte	Im laufenden Fenster oder in der Woche gibt es noch keine Ablesung. Die Abfrage einmal von Hand starten, dann die Seitenleiste aktualisieren

Datenschutz und Entfernen

Alles bleibt auf deinem Rechner. Jede Zeile enthält einen Zeitstempel, die beiden Prozentwerte mit ihren Reset-Zeiten und, von der Statuszeile, die Session- und Modell-ID. Das Plugin liest die Datei nur und führt die Skripte nie selbst aus. Zum Entfernen löschst du den Eintrag statusLine, die geplante Aufgabe (Unregister-ScheduledTask -TaskName 'TokenUsageLimitPoll') oder die cron-Zeile, und wenn du magst die Protokolldatei. Das Plugin nutzt dann wieder seine eigenen Schätzungen.

Aktualisiert am 10. Oktober 2026: Die erste Fassung dieses Abschnitts erwähnte Node.js nicht und bot nur die Statuszeile an, die in Programmen wie Obsidian nicht läuft. Beides ist ergänzt.

Wöchentlicher Reset

Das Wochenlimit wird an einem festen Wochentag zu einer festen Uhrzeit zurückgesetzt, und zwar je Konto unterschiedlich. Alles Wochenbezogene hängt daran: der Wochen-Ring, die Prognose, die Aktivitäts-Heatmap und die Wochenschätzung selbst.

Normalerweise musst du hier nichts einstellen. Wenn du in ein Wochenlimit läufst, schreibt Claude den nächsten Reset-Zeitpunkt in die Meldung, und das Plugin liest ihn von dort — die Einstellungen zeigen dann einen grünen Haken und das Datum des Treffers, aus dem der Wert stammt. Solange das noch nie passiert ist, nimmt es Sonntag 18:00 an und sagt das auch.

Von Hand geht es unter Einstellungen → Wöchentlicher Reset. Eine manuelle Einstellung gewinnt: Die automatische Erkennung überschreibt sie nicht, sie bestätigt sie nur. Nach einer Zeitumstellung lohnt ein Blick, falls dein Reset um eine Stunde verschoben wirkt.

Die Seitenleiste, Heatmap und Kalender

Eine Icon-Leiste links wechselt zwischen vier Seiten. Seit Version 2.0 ist das die einzige Darstellung — die frühere „Classic"-Ansicht und der Schalter, der zwischen beiden umstellte, sind entfallen.

Seite	Was darauf liegt
Today	Drei Ringe (5h-Fenster, heute, diese Woche), die Aktivitäts-Heatmap der laufenden Abrechnungswoche, deine letzte Aktion und die Token-Aufschlüsselung
Kalender	Die letzten zwei Monate als Monatsraster
Analytics	Die 7-Tage- und N-Tage-Zusammenfassungen als KPI-Kacheln mit Trend-Sparklines, dazu die Modellverteilung
Einstellungen	Dieselben Einstellungen wie im Obsidian-Einstellungstab, ohne die Seitenleiste zu verlassen

Alles auf Today stammt bewusst von heute oder aus der laufenden Woche; was längere Zeiträume umfasst, liegt auf Analytics oder im Dashboard. Im Kopfbereich erzeugen Dashboard und Report Dateien, CSV exportiert in deinen Vault, und der Pfeil aktualisiert sofort.

Jede der vier Token-Zeilen im Heute-Bereich trägt eine kompakte Markierung — ein grüner Punkt, wenn der Wert nahe an deinem eigenen jüngsten Durchschnitt liegt, ein gelber Pfeil, wenn er deutlich darüber liegt. Das Vergleichsfenster richtet sich nach deiner eingestellten Claude-Datenaufbewahrung, nicht nach einer festen Anzahl Tage.

Aktivitäts-Heatmap

Das Raster auf der Today-Seite zeigt deine laufende Abrechnungswoche. Eine Zeile je Kalendertag, eine Zelle je zwei Stunden, zwölf Zellen pro Tag.

Es hat acht Zeilen, nicht sieben: Eine Woche, die etwa von Sonntag 18:00 bis Sonntag 17:59 läuft, berührt acht Kalendertage, die erste und die letzte Zeile sind deshalb bewusst Teiltage. Zellen außerhalb des Fensters sind nur als leere Rahmen gezeichnet — genau das macht die Grenze deines Zyklus sichtbar, statt sie in künstlichen 24-Stunden-Scheiben zu verstecken.

Die Farbe zeigt das Tempo, nicht die Menge. Ein 5-Stunden-Fenster fasst zweieinhalb 2-Stunden-Abschnitte; das Budget gleichmäßig verbraucht sind also 40 % davon je Abschnitt — das Tempo, bei dem du exakt mit Ablauf des Fensters an die Wand kommst. Rot markiert dieses Tempo oder schneller, die Stufen darunter sind ein Viertel, die Hälfte und bis dahin. Die Tonabstufung innerhalb einer Stufe zeigt, wo genau darin der Wert sitzt.

Drei Arten von Nichts bleiben getrennt: außerhalb des Fensters (nur Rahmen), noch nicht erreicht (blass) und wirklich keine Aktivität (gefüllt). Nur das Letzte sagt etwas darüber aus, wie deine Woche lief. Neben dem Raster zählt Aktive Tage die Tage dieser Abrechnungswoche mit Aktivität.

Aktivitätskalender

Die Kalender-Seite zeigt die letzten zwei Monate untereinander. Zwei statt einem, weil ein einzelnes Raster am Monatsanfang nur eine Handvoll brauchbarer Tage zeigt und genau den Anlauf verbirgt, den man dort sucht. Die Pfeile verschieben das Paar weiter zurück, so weit das Archiv reicht; in die Zukunft geht der Kalender nie.

Jeder vergangene Tag trägt einen farbigen Punkt, gewichtet gegen deinen eigenen jüngsten Tagesdurchschnitt: grün darunter, gelb um den Schnitt herum, rot bei einem Ausschlag (2× oder mehr). Tage ohne Aktivität haben keinen Punkt. Ein Klick auf einen Tag legt eine private Notiz an — sie liegt in den Plugin-Einstellungen, nie in deinen Session-Daten.

Daten exportieren (CSV)

Drei CSV-Dateien: die Projektübersicht, die Tag-mal-Vault-Matrix und die Kennzahlen. Zwei Wege dorthin, und sie landen an verschiedenen Orten.

CSV-Button im Kopf der Seitenleiste — das Plugin schreibt die Dateien in deinen Vault, in den Ordner aus Einstellungen → CSV-Export-Ordner. Das Menü nennt diesen Ordner, bevor du klickst. Dieselben Exporte liegen in der Befehlspalette unter „Export".

CSV-Export-Menü im Dashboard — das Dashboard ist eine Browser-Seite, übergibt die Datei also dem Browser, und der entscheidet über den Ablageort, üblicherweise dein Download-Ordner. Eine Webseite kann keinen Zielordner wählen; das ist eine Browser-Regel, keine fehlende Funktion.

Beide Wege liefern rohe Zahlen und ISO-Datumsangaben, direkt weiterrechenbar in Excel, Sheets oder einem Skript. Alles entsteht lokal — kein Upload, kein Netzwerk, wie im ganzen Plugin.

Modelle

Claude Code leitet Anfragen je nach Aufgabe an verschiedene Modelle weiter. Die Seitenleiste zeigt einen gestapelten Prozentbalken der Modellverteilung der letzten 7 Tage, mit jeder Modellfamilie in einer eigenen Farbe:

Modell	Farbe in der Sidebar	Typische Rolle
Haiku	Cyan	Schnelle, einfache Aufgaben, niedrigste Kosten
Sonnet	Blau	Ausgewogenes Verhältnis aus Fähigkeit und Preis
Opus	Lila	Komplexes Denken, anspruchsvolle Aufgaben
Fable	Amber	Höchste Fähigkeit, höchste Kosten
Sonstige	Grau	Unbekannte oder zukünftige Modell-Strings

Die Modellverteilung erklärt viele Kostenschwankungen von Tag zu Tag. Ein Tag mit viel Opus sieht in der Abrechnung ganz anders aus als ein Tag, der hauptsächlich in Haiku verbracht wurde.

Sessions

Claude Code schreibt eine JSONL-Logdatei pro Session. Das Plugin liest alle Dateien unter ~/.claude/projects/ und gruppiert den Verbrauch nach Sessions. Die Top-Sessions-Tabelle im Dashboard zeigt, welche einzelnen Läufe die meisten Tokens verbraucht haben — nützlich, um unerwartet teure Sessions zu identifizieren.

Vault Token Usage Controlling

Wenn du Claude Code über mehr als ein Obsidian-Vault hinweg nutzt — getrennte Vaults pro Kunde, oder ein privates Vault neben einem Arbeits-Vault —, schlüsselt die Projects-Ansicht im HTML-Dashboard den gesamten Token-Verbrauch nach Vault auf, und innerhalb eines Vaults zusätzlich nach Unterprojekt, wann immer sich dein Arbeitsverzeichnis innerhalb einer Session geändert hat.

Jedes Vault bekommt eine eigene Zeile: Gesamt-Tokens, Anteil am Gesamtverbrauch, aktive Tage sowie erster und letzter aktiver Tag. Eine Tag-für-Vault-Detailtabelle zeigt dieselbe Aufschlüsselung pro Kalendertag, und ein eigenständiger Vault_Token_Usage_Projects.md-Export (Command Palette oder Settings) ist für Tabellenkalkulationen gedacht — nützlich, um Kosten bei der Abrechnung auf Kunden oder Projekte aufzuteilen.

„Vault“ meint hier eigentlich den Ordner, in dem eine Session gestartet wurde — meist dein Obsidian-Vault, aber auch die Agent-Modus-Sessions der Claude-Desktop-App (als Claude Desktop (Agent Mode)) oder jedes Verzeichnis, in dem du Claude Code aufgerufen hast. Ordner unter 1 % der Gesamtsumme werden zu einer Other-Zeile zusammengefasst, damit die Liste lesbar bleibt.

Was gemessen wird (und was nicht)

Das Plugin liest, was Claude Code auf die Festplatte schreibt. Damit ist jede Art erfasst, wie du Claude Code nutzt: im Terminal, in Obsidian, in einem Editor wie VS Code sowie im Agent-Modus der Claude-Desktop-App. Die Desktop-App führt Claude Code eingebettet aus und schreibt dasselbe Session-Format an einen eigenen Ort, den das Plugin ebenfalls liest (seit v1.8). All das fließt in dieselben Zahlen ein.

Nicht zeigen kann es den normalen Chat — also die Gespräche in der Claude-Desktop-App oder auf claude.ai. Dort werden keine Token-Werte auf deinem Rechner gespeichert. Verfügbar ist dort nur ein gerundeter Prozentwert deiner aktuellen Auslastung, nicht die Token-Zahlen pro Anfrage, auf denen dieses Plugin aufbaut.

API-Preisübersicht

API-Preise von Anthropic pro Million Tokens — Standard-Input / Output, Stand Oktober 2026:

Modell	Input / 1M	Output / 1M
Haiku 5.5 *	$0,10	$0,50
Haiku 4.5	$1,00	$5,00
Sonnet 5.5	$2,00	$10,00
Sonnet 5 **	$2,00	$10,00
Sonnet 4.6	$3,00	$15,00
Opus 5.5	$4,00	$20,00
Opus 5	$5,00	$25,00
Fable 5.1	$10,00	$50,00
Fable 5	$10,00	$50,00

* Haiku 5.5 für Prompts bis 100.000 Tokens, darüber $0,50 Input / $2,50 Output.
** Sonnet 5 startete mit $2 / $10 als Einführungspreis bis 31. August 2026. Anthropic hat ihn inzwischen zum regulären Preis gemacht, die angekündigte Erhöhung auf $3 / $15 fand nicht statt. Die frühere Fassung dieser Seite sagte das noch anders.

Cache-Preise zusätzlich zum Standard-Input-Preis:

• C.Write: das 1,25-fache des Standard-Input-Preises für einen 5-Minuten-Cache, das 2-fache für einen 1-Stunden-Cache (bei Claude Code im Abo der Normalfall)
• C.Read: das 0,1-fache des Standard-Input-Preises, das 0,05-fache bei Opus 5.5 und Sonnet 5.5, das 0,025-fache bei Fable 5.1

Kosten und Limits rechnen unterschiedlich. Cache-Tokens kosten Geld nach ihrem eigenen Preis. Auf das Limit zählen sie nach neueren Messungen ebenfalls, Cache Writes deutlich, Cache Reads wenig. Siehe Was auf ein Limit einzahlt.

Warum Kosten entstehen

Eine einzelne Anfrage ist selten teuer. Kurzes Rechenbeispiel mit Sonnet 5 zum regulären Preis von $2 / $10 pro Million:

• 10.000 Input-Tokens × $2 / 1M = $0,02
• 2.000 Output-Tokens × $10 / 1M = $0,02
• Gesamt: ca. $0,04

Das ist nahezu nichts. Das Problem ist Wiederholung und Kontextwachstum. Jede neue Nachricht in einer Session schickt typischerweise den bisherigen Gesprächsverlauf und alle offenen Dateien erneut als Input mit. Nach zehn Austauschen trägt Nachricht zehn alle neun vorherigen Runden plus alle angehängten Dokumente — der Input-Zähler wächst also mit jedem Schritt, selbst wenn du nur einen kurzen Satz schreibst.

Die Frage selbst ist selten der Kostentreiber. Entscheidend ist, was zur Beantwortung mitgesendet wird.

Was die Kosten treibt

• Lange Sessions, in denen ein großes Kontextfenster bei jeder Anfrage erneut gesendet wird
• Große angehängte Dateien oder komplette Codebasen, die als Input bei jeder Nachricht mitreisen
• Häufige schnelle Anfragen in kurzer Zeit
• Ein teures Modell für Aufgaben, die ein günstigeres genauso gut erledigt

Praktische Tipps

Erst messen. Das Tagesdiagramm und die Session-Tabelle des Plugins zeigen, wo die Tokens tatsächlich hingehen. Optimieren ohne Datengrundlage bringt wenig.

Unnötigen Kontext vermeiden. Große Dateien, die nur "für den Fall der Fälle" angehängt werden, zählen bei jeder Anfrage als Input. Nur das mitschicken, was Claude für die aktuelle Aufgabe braucht.

Modell nach Aufgabe wählen. Nicht jede Anfrage braucht Opus. Kurze Fragen, Formatierungsaufgaben und einfache Code-Änderungen funktionieren oft mit Haiku oder Sonnet zu einem Bruchteil der Kosten. Qualität und Gesamtkosten pro erledigter Aufgabe vergleichen, nicht nur den Preis pro Token.

Den Cache verstehen. Ein Anstieg bei C.Write zu Beginn einer Session ist normal — ein großer Kontext wurde aufgebaut. Entscheidend ist, ob C.Read folgt. Wenn derselbe Kontext bei vielen nachfolgenden Anfragen wiederverwendet wird, amortisieren sich die einmaligen Write-Kosten schnell und die effektiven Kosten pro Anfrage sinken deutlich.

Das Dashboard nutzen. Das HTML-Dashboard (öffnet über den Diagramm-Button in der Seitenleiste) zeigt deine Nutzungshistorie — 30, 60, 180 oder 360 Tage über den Zeitraum-Dropdown im Header —, dazu Modellverteilung und den Cache-Effizienz-Trend. Muster über mehrere Tage hinweg zeigen sich hier, nicht in der Einzel-Session-Ansicht.

Kompatibilität & Claude Code Updates

Token Usage liest die JSONL-Session-Dateien, die Claude Code lokal schreibt. Anthropic aktualisiert Claude Code regelmäßig — manchmal auf eine Weise, die beeinflusst, wie Session-Daten aufgezeichnet oder wie interne Telemetrie gezählt wird.

Wir prüfen Anthropics Release-Notes bei jedem größeren Claude Code Update und passen das Plugin bei Bedarf an. Wesentliche Kompatibilitätsänderungen sind im Plugin-Changelog auf GitHub dokumentiert.

Über dieses Plugin

Token Usage ist ein quelloffenes Obsidian-Community-Plugin. Es liest lokale JSONL-Dateien von Claude Code — keine Daten werden übertragen.

• Ausführliches Handbuch (auf Englisch): Token Usage Docs — Installation, Datenquellen, Kernkonzepte, Einstellungsreferenz und FAQ, alles auf einer Seite
• GitHub: beolatn/TokenUsage
• Obsidian Plugin-Verzeichnis: Token Usage
• Autor: Björn-Olaf Lange · langeatn.de

Die Preise auf dieser Seite stammen aus den Anthropic Platform Docs. Stand Oktober 2026. Preise können sich ändern — aktuelle Werte immer direkt auf der Anthropic-Website prüfen.