Docs · Token Usage Plugin
Token-Verbrauch in
Claude Code verstehen
Token Usage ist ein Obsidian-Community-Plugin, das deine Claude-Code-Session-Logs liest und den aktuellen Token-Verbrauch direkt in deiner Seitenleiste anzeigt. Kein API-Key erforderlich, keine Daten verlassen dein Gerät — das Plugin liest die JSONL-Dateien, die Claude Code lokal unter ~/.claude/projects/ schreibt.
Diese Seite erklärt jeden Begriff, den du in der Seitenleiste, im Dashboard und in den Reports siehst — und was die Zahlen für deine tatsächlichen Kosten bedeuten.
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.
Jeder API-Aufruf wird nach zwei Werten abgerechnet: wie viele Tokens hineingehen und wie viele Tokens herauskommen. Das ist alles, was für die Rechnung zählt.
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.
Cache Writes kosten ca. 1,25-mal den Standard-Input-Preis — etwas teurer als normaler Input. Es ist eine einmalige Investition: Du zahlst etwas mehr im Voraus, damit nachfolgende Anfragen denselben Inhalt nicht erneut verarbeiten müssen.
Das Plugin zeigt C.Write in Lila in der gesamten Seitenleiste, um die höheren Kosten zu signalisieren.
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 etwa 10% des Standard-Input-Preises — zehnmal günstiger als normaler Input. Wenn derselbe Kontext viele Male genutzt wird, machen Cache Reads große Sessions deutlich erschwinglicher.
Das Plugin zeigt C.Read in Amber, 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.
Wiederverwendungsfaktor = C.Read ÷ C.Write
| 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 30-Tage-Liniendiagramms mit C.Write in Lila und C.Read in Amber — passend zu den Farben in der Seitenleiste.
Die letzten 5 Stunden
Claude Code arbeitet intern mit einem rollierenden 5-Stunden-Fenster für seine Rate-Limits. Das Plugin verfolgt dasselbe Fenster: Es summiert alle Aktivitäten der letzten 5 Stunden und zeigt Input, Output, C.Write und C.Read als separate Zeilen.
Das ist die aktuellste Ansicht deiner laufenden Session. Wenn du seit einigen Stunden ohne längere Pause gearbeitet hast, zeigt dieses Fenster ungefähr das, was du seit Beginn 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: Last 5 Hour Session, 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 |
|---|---|---|
| Last 5 Hour Session | Rollierendes Fenster: alles von vor 5 Stunden bis jetzt | Kontinuierlich — älteste Einträge fallen heraus sobald sie älter als 5h werden |
| 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 "Today", wenn es vor 05:00 Uhr ist — dann reicht das rollierende Fenster noch in den gestrigen Tag zurück. Ab 05:00 Uhr liegt das 5-Stunden-Fenster immer vollständig im heutigen Tag.
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.
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.
API-Preisübersicht
API-Preise von Anthropic pro Million Tokens — Standard-Input / Output, Stand August 2026:
| Modell | Input / 1M | Output / 1M |
|---|---|---|
| Haiku 4.5 | $1,00 | $5,00 |
| Sonnet 5 * | $2,00 | $10,00 |
| Sonnet 4.6 | $3,00 | $15,00 |
| Opus 5 | $5,00 | $25,00 |
| Fable 5 | $10,00 | $50,00 |
* Sonnet 5 Einführungspreis gilt bis 31. August 2026. Danach: $3,00 Input / $15,00 Output.
Cache-Preise zusätzlich zum Standard-Input-Preis:
- C.Write: ca. 1,25-facher Standard-Input-Preis des Modells
- C.Read: ca. 0,10-facher Standard-Input-Preis (10-mal günstiger)
Das sind API-Nutzungspreise, keine monatlichen Abo-Preise für die Claude-App oder Claude Code Max. Das Token Usage Plugin liest lokal gespeicherte Daten — es macht keine API-Aufrufe und hat keinen Zugriff auf dein Anthropic-Konto.
Warum Kosten entstehen
Eine einzelne Anfrage ist selten teuer. Kurzes Rechenbeispiel mit Sonnet 5 zum Einführungspreis:
- 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 30 Tage Historie, Modellverteilung und den Cache-Effizienz-Trend. Muster über mehrere Tage hinweg zeigen sich hier, nicht in der Einzel-Session-Ansicht.
Über dieses Plugin
Token Usage ist ein quelloffenes Obsidian-Community-Plugin. Es liest lokale JSONL-Dateien von Claude Code — keine Daten werden übertragen.
- 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 August 2026. Preise können sich ändern — aktuelle Werte immer direkt auf der Anthropic-Website prüfen.