Token-Verbrauch von Claude Code und Codex: Was der Token Meter liest

Was der Token Meter anzeigt

Sobald ein installierter Agent oder ein gespeicherter Konto-Schlüssel etwas zum Anzeigen liefert, sitzt der Token Meter in der rechten Gruppe der Schaltflächen in der Titelleiste und bleibt dort, solange die App läuft. Sie müssen also kein Panel öffnen, um ihn zu finden.

Die Leiste zeigt eine einzige Zahl: das Kontingent, das am stärksten ausgereizt ist, eingefärbt danach, wie nah es am Limit liegt. Meldet keiner Ihrer eingerichteten Anbieter ein Kontingent, zeigt der Chip die Token-Summe der letzten 5 Stunden von Claude Code, oder von Codex, wenn Claude Code nicht installiert ist. Gibt es keinen installierten Agent und nur Kontostände, zeigt er das niedrigste Guthaben in USD.

Ein Klick darauf öffnet eine Übersicht. Jeder Anbieter, den Sie eingerichtet haben, bekommt einen zweizeiligen Eintrag: In der ersten Zeile stehen sein Name und der Reset-Zeitpunkt, der gerade zählt. In der zweiten stehen die Balken für 5 Stunden und die Woche, wo ein Limit bekannt ist, oder sonst die Ausgaben und Tokens von heute. Der Anbieter, den Sie unter Einstellungen → Token Meter anheften, steht an erster Stelle (Claude Code, solange Sie das nicht ändern, oder keiner).

Öffnen Sie einen Eintrag, sehen Sie die Details zu diesem Agent. Die Detailansicht listet die Tokens der letzten 5 Stunden und der letzten 7 Tage, abgekürzt mit K, M oder B, dazu eine Sparkline der letzten 24 Stunden mit einem Balken pro Stunde. Kosten-Kacheln zeigen die geschätzten Kosten von heute und der letzten 7 Tage zu API-Preisen, mit dem Datum, an dem die Preistabelle zuletzt aktualisiert wurde.

Die 7-Tage-Aufschlüsselung umfasst frische Eingabe, Ausgabe, Cache-Writes, Cache-Reads und die Zahl der Turns. Die Werte aktualisieren sich im Hintergrund etwa einmal pro Minute.

Ein Agent erscheint nur, wenn er installiert ist, das heißt, wenn sein Transkript-Ordner existiert. Gibt es weder einen lokalen Agent noch einen gespeicherten Konto-Schlüssel, zeigt der Meter gar nichts an statt einer leeren Anzeige. Eine Anzeige, die null zeigt, behauptet, Sie hätten nichts verbraucht. Das ist nicht dasselbe wie nicht zu wissen.

Welche Agents der Token Meter von der Festplatte liest

Für die Token-Zahlen hat der Token Meter genau eine Quelle: das Transkript, das jeder Agent auf Ihrer Festplatte führt. Claude Code, Codex, Gemini CLI und omp halten darin die Token-Zahlen jedes Turns fest. Der Meter ruft keine Anbieter-API auf und verlangt keine Anmeldung. Sie müssen keinen API-Schlüssel einfügen und kein Konto verbinden, und für die Token-Zahlen wird nichts irgendwohin gesendet.

Die Liste hat vier Namen, weil der Meter die Transkript-Ordner von Claude Code, Codex, Gemini CLI und omp liest. OpenCode liest er nicht. Dafür zeigt er daher nichts an, statt zu raten.

Mit 1.0.22 kam eine zweite, getrennte Quelle hinzu, die keine Transkripte nutzt. Fügen Sie unter Einstellungen → Token Meter einen API-Schlüssel für einen von sechs Konto-Anbietern ein, bekommt dieser Anbieter eine eigene Zeile. Die Zeile zeigt, was der Anbieter an seinem eigenen Endpunkt meldet: ein Guthaben, ein Tarif-Kontingent oder Ausgaben. Das ist eine andere Messung mit anderen Einschränkungen. Lesen Sie den Unterschied zwischen Verbrauch und Guthaben, bevor Sie eine dieser Zahlen mit einer anderen gleichsetzen.

Warum Cache-Reads eine eigene Zeile bekommen

Die meisten Tokens einer langen Agent-Sitzung sind Cache-Reads: Kontext, den der Agent schon gesendet hat und der bei jedem neuen Turn aus dem Cache des Anbieters zurückkommt. Zusammen mit allem anderen gezählt, lassen sie eine Sitzung viel größer aussehen, als sie ist.

Mit einer eigenen Zeile stören Cache-Reads nicht, und Sie sehen, was der Rest der Sitzung tatsächlich ausgemacht hat.

Was er nicht anzeigt

Standardmäßig meldet der Token Meter den Verbrauch: bereits genutzte Tokens. Er sagt nicht voraus, wie viel Sie noch nutzen können. Die Transkripte von Claude Code halten nicht fest, wo ein Abonnement steht, daher braucht ein Claude-Prozentwert eine andere Quelle. Die Sitzungsdateien von Codex enthalten dessen Rate-Limit-Werte, aber nur so aktuell wie Ihr letzter Codex-Turn. Zwei Schalter, die Sie selbst aktivieren, liefern jetzt für beide einen Live-Wert.

Für Claude kam mit 1.0.21 der Schalter Tarif-Limits hinzu, der nur unter macOS funktioniert. Schalten Sie ihn unter Einstellungen → Token Meter ein. Die App liest dann die gespeicherte Anmeldung von Claude Code über das System-Tool security aus Ihrer macOS-Keychain, sodass macOS nicht jedes Mal nachfragt. Sie ruft Ihren tatsächlichen Tarif-Verbrauch bei api.anthropic.com ab, höchstens einmal alle fünf Minuten.

Für Codex kam mit 1.0.22 der Schalter Live-Limits von Codex hinzu. Er liest die ChatGPT-Anmeldung von Codex aus ~/.codex/auth.json und sendet sie nur an chatgpt.com, um die aktuellen 5-Stunden- und Wochenfenster abzurufen.

Er ist nur zum Lesen dieser Datei gedacht. Bei einem abgelaufenen Token sendet er keine Anfrage und bittet Sie, codex auszuführen. Eine Anmeldung, die stattdessen in der System-Keychain liegt, wird gar nicht gelesen. Beide Schalter sind aus, bis Sie sie einschalten.

Codex ist der Agent, der auch bei ausgeschaltetem Schalter eine Zahl hat. Seine eigene CLI schreibt die Rate-Limit-Werte des Tarifs in die Sitzungsdateien, und der Meter liest sie aus denselben Zeilen, die er ohnehin durchsucht. Dieser Wert ist nur so aktuell wie Ihr letzter Codex-Turn. Deshalb gibt es den Live-Schalter.

Die Werte für 5 Stunden und 7 Tage sind Fenster, die vom aktuellen Moment aus zurückblicken. „In den letzten 5 Stunden verbraucht“ ist genau das, was die Zahl bedeutet. Sie sagt nichts darüber, was Ihr Tarif erlaubt.

Für wen er gedacht ist

Der Token Meter ist für den Parallelbetrieb von Claude Code und Codex gedacht, in geteilten Panes oder gemeinsam in einem Control Room (früher War Room). Er zeigt, welcher von beiden die Tokens verbraucht, ohne dass Sie in eine der beiden CLIs wechseln und nachfragen müssen. Wenn Sie nur gelegentlich einen einzelnen Agent nutzen, erfahren Sie daraus wenig. Siehe auch die Seite zum Token Meter und die Dokumentation zum Token Meter.