Hoe Claude Code tokengebruik te controleren: 4 manieren om te zien wat je agents uitgeven

Als je Claude Code meer dan een paar minuten per dag gebruikt, zijn tokens je echte valuta. Ze bepalen wanneer je een limiet bereikt, hoe snel je door een abonnement heen brandt, en of een lange agent-run de moeite waard was. Het probleem is dat Claude Code het aantal niet aan je roept. Je moet het zelf opzoeken.

Hier zijn vier manieren om het Claude Code-tokengebruik te controleren, van het snelste ingebouwde commando tot een live meter die elke agent in realtime laat zien. Kies degene die past bij hoe diep je wilt gaan.

1. De snelste manier: het /cost commando

Typ binnen een Claude Code-sessie:

/cost

Claude Code geeft de totale kosten en het aantal tokens voor de huidige sessie weer, plus hoe lang deze al draait. Het is het snelste antwoord op "wat heeft deze sessie tot nu toe uitgegeven", en er hoeft niets geïnstalleerd te worden.

Het nadeel: /cost is beperkt tot de sessie waarin je je bevindt. Het vertelt je niet wat je gisteren hebt uitgegeven, wat een ander project heeft gekost, of hoe een specifieke agent zich verhoudt tot een andere. Voor een snelle controle is het perfect. Voor alles wat historisch is, lees verder.

2. Lees de bron: de sessietranscripten

Claude Code schrijft elke sessie naar de schijf als een JSONL-transcript. Op macOS en Linux vind je ze hier:

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

Elke regel is een bericht, en de assistentberichten bevatten een usage object met de exacte tellingen: input_tokens, output_tokens, en de cachevelden (cache_creation_input_tokens, cache_read_input_tokens). Cachelezingen zijn het interessante deel: ze zijn veel goedkoper dan verse input, dus een sessie met een hoge cache-hit rate kost veel minder dan het ruwe aantal tokens suggereert.

Dit is de grondwaarheid. Elke andere tool, inclusief de twee hieronder, leest dezezelfde bestanden. Als je je eigen rapport wilt scripten, zal jq over de JSONL je daar brengen.

3. Een speciale CLI: ccusage

Als je liever je eigen parser niet schrijft, leest de communitytool ccusage die transcripten en rolt ze op in dagelijkse, maandelijkse en per-sessie totalen:

npx ccusage@latest

Het is een goed middenweg: meer geschiedenis dan /cost, minder werk dan handmatig jq rollen. Het blijft echter in de terminal, dus het beantwoordt "wat heb ik uitgegeven" maar niet "welke agent, op dit moment, geeft het uit".

4. Een live meter: gebruik per sessie in AgentsRoom

De drie bovenstaande methoden delen allemaal één blinde vlek: ze zijn achteraf en enkelvoudig. Op het moment dat je meerdere agents parallel uitvoert, wil je het gebruik per agent live zien, zonder een commando in elke terminal te typen.

Dat is wat de Claude Code-tokengebruiks meter in AgentsRoom doet. Het leest dezelfde JSONL-transcripten, per sessie, en toont:

• input-, output- en cachetokens per agent, die worden bijgewerkt terwijl de sessie loopt
• de cache-hit rate, zodat je kunt zien wanneer context wordt hergebruikt in plaats van opnieuw verzonden
• een waarschuwing voordat een sessie naar een limiet afdrijft

Omdat het gebruik per sessie wordt toegeschreven, blijft het correct, zelfs wanneer je meerdere Claude Code-accounts naast elkaar uitvoert: elk account houdt zijn eigen totalen bij, wat herfacturering per klant eenvoudig maakt.

Welke moet je gebruiken

• Heb je alleen het nummer van deze sessie nodig? /cost.
• Wil je een aangepast rapport scripten? Lees de JSONL-transcripten direct.
• Wil je dagelijkse en maandelijkse totalen in de terminal? ccusage.
• Voer je meerdere agents uit en wil je het gebruik live bekijken, per agent en per account? Gebruik de meter in AgentsRoom.

Het controleren van gebruik is stap één. Als de cijfers je doen schrikken, is de volgende stap om ze naar beneden te brengen: zie hoe Claude Code-tokenkosten te verlagen voor de hefbomen die echt belangrijk zijn, te beginnen met cache-hergebruik.