Wie man die Token-Nutzung von Claude Code überprüft: 4 Möglichkeiten, um zu sehen, was Ihre Agenten ausgeben

Wenn Sie Claude Code mehr als ein paar Minuten am Tag ausführen, sind Tokens Ihre echte Währung. Sie entscheiden, wann Sie ein Limit erreichen, wie schnell Sie ein Abonnement verbrauchen und ob ein langer Agentenlauf es wert war. Das Problem ist, dass Claude Code Ihnen die Zahl nicht einfach mitteilt. Sie müssen selbst nachsehen.

Hier sind vier Möglichkeiten, um die Token-Nutzung von Claude Code zu überprüfen, vom schnellsten integrierten Befehl bis zu einem Live-Meter, das jeden Agenten in Echtzeit anzeigt. Wählen Sie die aus, die am besten zu Ihrem Bedarf passt.

1. Der schnellste Weg: /usage, /context und die Statuszeile

Geben Sie in einer beliebigen Claude Code-Sitzung ein:

/usage

Claude Code zeigt die Token-Nutzung der aktuellen Sitzung an und, bei einem Claude.ai-Tarif, was von Ihrem Kontingent übrig ist: die 5-Stunden- und 7-Tage-Limits, plus den Anteil des Kontextfensters, den Sie bereits belegen. /cost und /stats funktionieren weiterhin, sie sind Aliase desselben Befehls. Sie können ihn ausführen, während Claude antwortet, die Zahlen erscheinen, ohne die Antwort zu unterbrechen (vor v2.1.234 wartete der Befehl auf das Ende des Zugs).

Sie möchten das Kontextfenster im Detail statt einer einzigen Prozentzahl? Geben Sie /context ein: Das Fenster wird als farbiges Raster gezeichnet, und was es füllt, wird markiert, ein Tool mit zu schwerer Ausgabe, eine aufgeblähte Memory-Datei, eine Sitzung nahe der Kapazitätsgrenze.

Beide Befehle haben denselben Haken: Sie müssen sie eingeben, und sie sehen nur die Sitzung, in der Sie sich befinden. Nichts sagt Ihnen, was Sie gestern ausgegeben haben oder was ein anderes Projekt gekostet hat. Wenn Sie eine Zahl wollen, die auf dem Bildschirm bleibt, nutzen Sie die Statuszeile. Bitten Sie Claude Code, sie für Sie zu schreiben:

/statusline show model name and context percentage with a progress bar

Es erzeugt ein Skript in ~/.claude/ und bindet es in Ihre Einstellungen ein. Wenn Sie es lieber selbst schreiben, fügen Sie einen Eintrag statusLine in ~/.claude/settings.json hinzu. Das Skript erhält auf stdin ein JSON-Objekt mit context_window.used_percentage, cost.total_cost_usd und, für Pro- und Max-Abonnenten, rate_limits.five_hour.used_percentage. Eine Zeile genügt:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'"
  }
}

Die Statuszeile aktualisiert sich nach jeder API-Antwort, die Prozentzahl bewegt sich also, während die Sitzung läuft. Es bleibt eine Sitzung pro Terminal: für alles Historische, oder für mehrere Agenten gleichzeitig, lesen Sie weiter.

2. Die Quelle lesen: die Sitzungsprotokolle

Claude Code schreibt jede Sitzung als JSONL-Protokoll auf die Festplatte. Auf macOS und Linux finden Sie sie hier:

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

Jede Zeile ist eine Nachricht, und die Nachrichten des Assistenten enthalten ein usage-Objekt mit den genauen Zählungen: input_tokens, output_tokens und den Cache-Feldern (cache_creation_input_tokens, cache_read_input_tokens). Cache-Lesungen sind der interessante Teil: sie sind viel günstiger als frische Eingaben, sodass eine Sitzung mit einer hohen Cache-Trefferquote viel weniger kostet, als die rohe Token-Anzahl vermuten lässt.

Dies ist die Wahrheit. Jedes andere Tool, einschließlich der beiden unten, liest diese gleichen Dateien. Wenn Sie Ihren eigenen Bericht skripten möchten, bringt Sie jq über das JSONL dorthin.

3. Ein dediziertes CLI: ccusage

Wenn Sie lieber keinen eigenen Parser schreiben möchten, liest das Community-Tool ccusage diese Protokolle und fasst sie in täglichen, monatlichen und pro Sitzung Gesamtsummen zusammen:

npx ccusage@latest

Es ist ein guter Mittelweg: mehr Historie als /usage, weniger Arbeit als das manuelle Erstellen mit jq. Es bleibt jedoch im Terminal, sodass es beantwortet, "Was habe ich ausgegeben?", aber nicht "Welcher Agent gibt gerade aus?".

4. Ein Live-Meter: die Nutzung pro Sitzung in AgentsRoom

Die drei oben genannten Methoden haben alle einen blinden Fleck: Sie sind nachträglich und einsträngig. In dem Moment, in dem Sie mehrere Agenten parallel ausführen, möchten Sie die Nutzung pro Agenten in Echtzeit sehen, ohne in jedem Terminal einen Befehl eingeben zu müssen.

Das ist es, was das Claude Code Token-Nutzungsmeter in AgentsRoom tut. Es liest die gleichen JSONL-Protokolle, pro Sitzung, und zeigt:

• Eingabe-, Ausgabe- und Cache-Token pro Agent, die sich während der Sitzung aktualisieren
• die Cache-Trefferquote, sodass Sie sehen können, wann der Kontext wiederverwendet wird, anstatt erneut gesendet zu werden
• eine Warnung, bevor eine Sitzung sich einem Limit nähert

Da es die Nutzung pro Sitzung zuordnet, bleibt es korrekt, selbst wenn Sie mehrere Claude Code-Konten nebeneinander ausführen: jedes Konto behält seine eigenen Gesamtsummen, was die Abrechnung pro Kunde unkompliziert macht.

Welches sollten Sie verwenden

• Brauchen Sie nur die Zahl dieser Sitzung, oder was von Ihrem Kontingent übrig ist? /usage, und die Statuszeile, wenn Sie sie immer sichtbar haben wollen.
• Möchten Sie einen benutzerdefinierten Bericht skripten? Lesen Sie die JSONL-Protokolle direkt.
• Möchten Sie tägliche und monatliche Gesamtsummen im Terminal? ccusage.
• Führen Sie mehrere Agenten aus und möchten die Nutzung live, pro Agent und pro Konto beobachten? Verwenden Sie das Meter in AgentsRoom.

Die Überprüfung der Nutzung ist Schritt eins. Wenn die Zahlen Sie zusammenzucken lassen, ist der nächste Schritt, sie zu senken: siehe wie man die Token-Kosten von Claude Code reduziert für die Hebel, die wirklich wichtig sind, beginnend mit der Wiederverwendung des Caches.