Laatst bijgewerkt: 18 juli 2026
Ik draaide de Claude Code doctor skill op mijn echte productiesetup — vier merken, tientallen skills, meerdere CLAUDE.md-bestanden — en het vond 21.000 tokens aan altijd-aan skills die ik nooit aanroep, vijf skills zonder beschrijving, een mislukte auto-update, en drie launcher-duplicaten. Dit is wat het vond, wat ik veranderde, en waarom je het deze week zou moeten draaien.
Er Zijn Twee Doctors, en Slechts Één Auditeert Iets
Verwarrend maar belangrijk: er zijn twee verschillende "doctor"-functies in Claude Code.
claude doctor (in de terminal, buiten Claude Code): dit is een systeemdiagnosetool. Het controleert of je Node-versie klopt, of je authenticatie werkt, of je netwerk bereikbaar is. Het is nuttig voor installatieproblemen maar het auditeert je skills, CLAUDE.md of tokenverbruik niet.
/doctor (binnen een Claude Code sessie): dit is de skill die ik hier bespreek. Het is een ingebouwde audit die je hele setup doorloopt — skills, CLAUDE.md-bestanden, agentdefinities, launch-configuratie — en rapporteert wat tokens verspilt, wat kapot is, en wat verbeterd kan worden.
De meeste mensen kennen alleen claude doctor en missen /doctor volledig. De audit-tool is de waardevolle.
Waarom de Claude Code Doctor Skill Nu Is Verscheept
Anthropic verscheepte /doctor als reactie op een specifiek probleem: hun eigen teams ontdekten dat de Claude Code systeemprompt te groot was geworden. Ze verwijderden 80% ervan — en ontdekten daarbij dat veel gebruikers hetzelfde probleem hadden maar dan in hun eigen setups. Altijd-aan skills, opgeblazen CLAUDE.md-bestanden, kapotte configuraties — allemaal stilletjes tokens verslindend zonder dat iemand het merkte.
/doctor is het hulpmiddel om dat probleem te vinden voordat het je rekening verpest.
Wat de Auditcategorieën Zijn
/doctor controleert vijf gebieden:
- Launchers: Hoe Claude Code wordt gestart. Duplicaten, verouderde binaries, verkeerde paden.
- CLAUDE.md-bestanden: Grootte, structuur, en of ze nuttige instructies bevatten of alleen rommel.
- Skills: Welke altijd-aan zijn (tokens kosten bij elke sessie), welke beschrijvingen missen, welke kapot zijn.
- Agentdefinities: De configuratie die het gedrag van de agent stuurt.
- Auto-updates: Of je Claude Code correct bijwerkt of vastzit op een oude versie.
Wat de Claude Code Doctor Skill Vond in Mijn Setup
Bevinding 1: Drie launchers, één binary
Ik had drie manieren om Claude Code te starten geconfigureerd — twee verouderd. Eén wees naar een pad dat niet meer bestond. Geen van deze veroorzaakte fouten, maar ze voegden verwarring toe aan mijn configuratie.
Bevinding 2: Mijn CLAUDE.md-bestanden waren niet het probleem
Verrassing: mijn CLAUDE.md-bestanden waren redelijk geoptimaliseerd — ruwweg 1.200 tokens totaal over alle niveaus. /doctor markeerde ze als "acceptabel." Dit is het tegenovergestelde van wat ik verwachtte — ik had aangenomen dat ze het grootste probleem zouden zijn.
Bevinding 3: 21.000 tokens aan skills die ik nooit aanroep
Dit was de grote. Ik had skills geïnstalleerd die als "altijd-aan" waren geconfigureerd — wat betekent dat hun volledige beschrijving en instructies bij elke sessie worden meegeladen, of ik ze gebruik of niet. Elf skills, totaal ruwweg 21.000 tokens, bij elke sessie meegeladen.
Op Opus 5 tarieven ($15/$75 per miljoen tokens) is 21K tokens invoer bij elke sessie-start ruwweg $0.32 per sessie. Bij tien sessies per dag is dat $3.20 per dag, ~$96 per maand. Alleen aan skills die ik niet eens aanroep.
Bevinding 4: Vijf skills zonder beschrijving
Vijf geïnstalleerde skills hadden geen beschrijving. Dat betekent dat Claude Code ze niet kan matchen aan relevante taken — ze zitten in je setup maar worden nooit getriggered. Dood gewicht.
Bevinding 5: De agentdefinitie die niemand auditeerde
/doctor vond dat mijn agentdefinitie een verouderde referentie bevatte naar een model-ID die niet meer bestond. Het veroorzaakte geen zichtbare fout maar het betekende dat bepaalde configuratie-opties stilletjes werden genegeerd.
Wat Ik Daadwerkelijk Veranderde
-
Elf altijd-aan skills naar on-demand gezet. Besparing: ~21K tokens per sessie. De skills zijn er nog — ze worden alleen geladen wanneer ik ze specifiek aanroep.
-
Twee verouderde launchers verwijderd. Opgeschoond, geen kostenverschil maar minder verwarring.
-
Vijf skills beschrijvingen gegeven. Nu kunnen ze werkelijk worden getriggerd wanneer ze relevant zijn.
-
Agentdefinitie bijgewerkt. Verouderde model-ID vervangen door de huidige.
-
Auto-update gefixt. Bleek dat mijn install via een package manager de auto-update blokkeerde. Hersteld.
Wat Ik Niet Kon Verifiëren
/doctor vertelt je wat het vindt, maar het kan niet alles verifiëren. Specifiek: het kan niet meten of je skills daadwerkelijk de outputkwaliteit verbeteren. Het kan je vertellen dat een skill 3.000 tokens kost per sessie, maar niet of die 3.000 tokens het waard zijn. Dat blijft je eigen oordeel — en de Skill Creator A/B-test is het hulpmiddel om dat te meten.
Wat Dit Je Kost Als Je Het Overslaat
De directe kosten: als je altijd-aan skills hebt die je niet gebruikt, betaal je tokens voor niets bij elke sessie. Bij frontier-modelprijzen telt dat op.
De indirecte kosten: kapotte skills, ontbrekende beschrijvingen, en verouderde configuraties produceren subtiel slechtere output. Het model navigeert op een verouderde kaart — hetzelfde probleem dat ik beschreef in mijn OKF second brain en Fable 5 second brain posts.
De Regel Die Ertoe Deed
De ene les van /doctor die me het meest bijblijft: je .claude map is een productieomgeving, en productieomgevingen moeten worden geauditeerd.
Het verzamelen van skills zonder ze te auditen is hetzelfde als het installeren van packages zonder ze bij te werken — het werkt totdat het stilletjes alles duurder en langzamer maakt. /doctor is het auditgereedschap. Draai het minstens maandelijks.
Als je hulp nodig hebt bij het optimaliseren van je Claude Code setup — fiverr.com/s/EgxYmWD.
Veelgestelde Vragen
Wat doet /doctor in Claude Code?
/doctor is een ingebouwde audit-skill die je hele Claude Code setup doorloopt — launchers, CLAUDE.md-bestanden, skills, agentdefinities, auto-updates — en rapporteert wat tokens verspilt, wat kapot is, en wat verbeterd kan worden.
Is claude doctor hetzelfde als /doctor?
Nee. claude doctor (terminal) controleert systeemvereisten — Node-versie, authenticatie, netwerk. /doctor (binnen een sessie) auditeert je skills, configuratie en tokenverbruik. Twee verschillende tools.
Hoeveel tokens gebruiken Claude Code skills?
Altijd-aan skills worden bij elke sessie geladen. In mijn setup: 21.000 tokens aan skills die ik nooit aanriep. Bij frontier-tarieven: ~$96/maand aan verspilde tokens.
Moet ik mijn CLAUDE.md-bestand inkorten?
Niet noodzakelijk. /doctor beoordeelt of je CLAUDE.md proportioneel is aan je behoeften. In mijn geval waren de skills het probleem, niet de CLAUDE.md.
Waarom verwijderde Anthropic 80% van Claude Code's systeemprompt?
Omdat het te groot was geworden en tokens verspilde bij elke sessie. Dezelfde logica geldt voor je eigen setup — hoe meer altijd-aan content, hoe meer tokens je brandt voordat je werkelijke taak begint.
Laten We Samenwerken
- Fiverr: fiverr.com/s/EgxYmWD
- Portfolio: mejba.me
- Ramlit Limited: ramlit.com
- ColorPark: colorpark.io
- xCyberSecurity: xcybersecurity.io
