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: /usage, /context en de statusregel

Typ binnen een Claude Code-sessie:

/usage

Claude Code toont het tokengebruik van de huidige sessie en, op een Claude.ai-abonnement, wat er van je quotum over is: de gebruikslimieten over 5 uur en over 7 dagen, plus welk deel van het contextvenster je al gebruikt. /cost en /stats werken nog steeds, het zijn aliassen van hetzelfde commando. Je kunt het uitvoeren terwijl Claude antwoordt, de cijfers verschijnen zonder het antwoord te onderbreken (voor v2.1.234 wachtte het commando tot het einde van de beurt).

Wil je het contextvenster in detail zien in plaats van een enkel percentage? Typ /context: het venster wordt getekend als een gekleurd raster, en wat het opvult wordt aangewezen, een tool met te zware uitvoer, een opgeblazen geheugenbestand, een sessie die bijna vol zit.

Beide commando's hebben hetzelfde nadeel: je moet ze typen, en ze zien alleen de sessie waarin je zit. Niets vertelt je wat je gisteren hebt uitgegeven of wat een ander project heeft gekost. Wil je een cijfer dat op het scherm blijft staan, gebruik dan de statusregel. Vraag Claude Code om die voor je te schrijven:

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

Het genereert een script in ~/.claude/ en koppelt het aan je instellingen. Schrijf je het liever zelf, voeg dan een statusLine item toe aan ~/.claude/settings.json. Het script ontvangt op stdin een JSON-object met context_window.used_percentage, cost.total_cost_usd en, voor Pro- en Max-abonnees, rate_limits.five_hour.used_percentage. Een regel is genoeg:

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

De statusregel ververst na elk API-antwoord, dus het percentage beweegt terwijl de sessie draait. Het blijft een sessie per terminal: voor geschiedenis, of voor meerdere agents tegelijk, 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 /usage, 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 cijfer van deze sessie nodig, of wil je weten hoeveel van je quotum over is? /usage, en de statusregel als je het altijd in beeld wilt.
• 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.