Claude Code /doctor: setup-diagnose die problemen zelf oplost

In het kort

• Wat: Het /doctor-commando in Claude Code (vanaf versie 2.1.205) is niet langer een leesbaar rapport dat alleen problemen toont. Het diagnosticeert je installatie én kan de gevonden problemen daadwerkelijk voor je oplossen.
• Waarom relevant: Veel MKB'ers haken af bij een nieuwe tool zodra er iets misgaat met installatie of instellingen. Één commando dat zowel de oorzaak aanwijst als de reparatie voorstelt, verlaagt die drempel flink.
• Wat je ermee kunt: Na een verse installatie of update typ je /doctor, bekijk je de bevindingen en geef je akkoord voordat er iets verandert. Zo start je zonder technisch gedoe — en houd je zelf de controle.

Wat er precies is veranderd

Claude Code is de opdrachtregel-tool van Anthropic waarmee je Claude direct in je project laat werken. Zo'n tool heeft een gezonde installatie en nette instellingen nodig, en juist daar liep het voor niet-technische gebruikers vaak vast: een verkeerd pad, een dubbele installatie, of een instelling die niet klopt met de werkelijkheid.

Het /doctor-commando bestond al als controle, maar deed weinig meer dan een lijstje afdrukken. In versie 2.1.205 is dat veranderd. In de woorden van de changelog: "/doctor now diagnoses issues and can fix them, instead of printing a read-only report." Oftewel: het stelt een diagnose én kan repareren, in plaats van alleen een rapport te tonen dat je zelf moet ontcijferen.

Belangrijk detail: /doctor verandert nooit zomaar iets. Het meldt eerst wat het vindt en vraagt om je bevestiging voordat er ook maar iets wordt aangepast. Jij blijft dus aan het stuur — de tool doet het voorwerk, jij zet de knoop door.

Wat /doctor allemaal nakijkt

De checkup gaat verder dan alleen "draait het wel". Volgens de changelog controleert /doctor onder meer:

• De gezondheid van je installatie. Gebruik je een globale, lokale of native installatie? Staan er per ongeluk meerdere naast elkaar? Dat is een klassieke oorzaak van vage problemen, en /doctor benoemt het.
• Ongebruikte skills, MCP-servers en plugins, afgezet tegen hun "context-kosten". Elke toevoeging vraagt aandacht van Claude; wat je niet gebruikt, kost onnodig ruimte. /doctor maakt dat zichtbaar.
• Dubbele CLAUDE.md-bestanden. Dit is het instructiebestand waarin je Claude vertelt hoe jouw project in elkaar zit. Lokale kopieën die botsen met de vastgelegde versie worden ontdubbeld.
• Te uitgebreide documentatie. /doctor stelt voor om stukken uit CLAUDE.md te schrappen die Claude gewoon zelf uit je code kan afleiden. Korter is hier vaak beter.
• Trage hooks — automatische stappen die je workflow onnodig vertragen — worden gemarkeerd.

Ook praktische struikelblokken komen voorbij: een MCP-configuratie met een ontbrekende komma of een verkeerd pad, of een ontbrekende zoekcomponent (ripgrep) waardoor zoeken helemaal niet werkt. Precies het soort fout waar je normaal een half uur op een forum naar zoekt.

Hoe je het gebruikt

Je hebt geen technische achtergrond nodig. Er zijn twee manieren:

• In Claude Code zelf: typ /doctor en druk op enter.
• Vanuit je terminal: draai claude doctor. Handig als Claude Code helemaal niet meer wil starten.

Je krijgt een overzicht met kleurcodes — groen voor "in orde", geel voor een waarschuwing, rood voor een fout — en per punt een uitleg. Wil je iets laten repareren, dan geef je akkoord en pakt /doctor het op.

Eén nuance om te weten: /doctor start MCP-servers op om ze te testen en slaat daarbij de gebruikelijke vertrouwensvraag over. Draai het daarom alleen in mappen en projecten die je vertrouwt — niet in een onbekende map die je net van internet hebt geplukt.

Wat dit concreet betekent voor het Nederlandse MKB

Voor een ondernemer telt vooral: kan ik hiermee aan de slag zonder een IT'er te bellen? Het antwoord wordt met deze update een stuk vaker "ja". De momenten waarop mensen afhaken — vlak na de installatie, of na een update wanneer "het ineens niet meer werkt" — zijn precies de momenten waarop /doctor z'n werk doet.

Drie praktische winstpunten:

• Minder verloren tijd. In plaats van foutmeldingen googelen, krijg je een concrete oorzaak en een voorstel. Dat scheelt een middag frustratie.
• Een opgeruimde opzet. Door ongebruikte skills, plugins en verouderde instructies te ontdekken, blijft je omgeving overzichtelijk. Zeker als je met meerdere skills en connectoren werkt — zoals in Claude Desktop bundelt skills, plugins en connectoren in 'Customize' — voorkomt dat rommel.
• Meer zelfvertrouwen. Omdat /doctor eerst toont en pas na jouw akkoord aanpast, hoef je niet bang te zijn dat er iets kapotgaat. Je leert er meteen van hoe je opzet in elkaar zit.

Wil je de eerste installatie of een MCP-koppeling zonder omwegen goed neerzetten, dan helpt het om iemand mee te laten kijken die dit vaker heeft gedaan. Je kunt op Santa Claude eenvoudig een Claude-specialist vinden die met je meedenkt over een schone, werkbare opzet voor jouw bedrijf.

Kort samengevat

Het vernieuwde /doctor maakt Claude Code toegankelijker: het spoort installatie- en configuratieproblemen op, legt ze in gewone taal uit en repareert ze pas nadat jij akkoord geeft. Voor MKB'ers zonder technische achtergrond betekent dat een lagere drempel om te starten en minder gedoe onderweg.

Benieuwd of Claude past bij jouw manier van werken, of loop je vast bij de opstart? Plan gerust een gratis kennismaking via [email protected] — dan kijken we samen waar je het snelst waarde haalt.

Santa Claude is een onafhankelijke Nederlandse community en niet gelieerd aan Anthropic.