Claude Code of Codex veilig gebruiken om ruimte vrij te maken in Windows

Als de C:-schijf rood kleurt, vragen steeds meer mensen Claude Code of Codex om uit te zoeken waarom. Daar is een agent goed in: hij kan honderd mappen opsommen, herkennen dat AppData\Local\npm-cache een pakketcache is en Documents\WeChat Files chatgeschiedenis, en beide in gewone woorden uitleggen. Het risico zit in de volgende stap, als dezelfde agent op basis van zijn eigen lezing van mapgroottes een Remove-Item -Recurse -Force of een del /s /q schrijft. Eén verkeerd aanhalingsteken of backslash in een gegenereerde opdracht kan hem op de verkeerde map richten, en geen van beide opdrachten vraagt eerst, gebruikt de Prullenbak of houdt bij wat er is verwijderd.

Deze handleiding laat een veiligere taakverdeling zien. De agent leest en legt uit, een opschoonhulpmiddel met een voorvertoning doet het verwijderen, en jij keurt tussendoor goed. Het hulpmiddel hier is Mole CLI for Windows, de gratis PowerShell-editie van Mole, samen met zijn officiële agent-skill, die Claude Code, Codex, Cursor en andere agents leert hoe ze het gebruiken. De gewoontes zijn over te nemen bij elk hulpmiddel dat een dry-run kan doen.

Waarom een agent niet met Remove-Item moet opruimen

Als een agent opruimt met kale PowerShell- of cmd-opdrachten, ontbreken er vier dingen:

1. Een voorvertoning. Remove-Item doet zijn werk zodra het draait. Je keurt één regel goed, niet de duizenden bestanden waarin die uitklapt. PowerShell heeft wel -WhatIf, maar niets dwingt de agent het te gebruiken.
2. Een weg terug. Bestanden die zo verwijderd worden, slaan de Prullenbak over.
3. Een logboek. Als een app volgende week zijn instellingen kwijt is, vertelt niets je of de opschoonbeurt eraan heeft gezeten.
4. Een lijst van wat nooit aangeraakt mag worden. Een map met de naam Cache kan de sessie van een browserprofiel bevatten, de opgeslagen spellen van een game of een database waar een draaiende app nog naar schrijft.

Een opschoonhulpmiddel dat hiervoor gebouwd is, heeft ze alle vier al. Het werk van de agent wordt dan de uitvoer lezen en het jou vragen. Wil je weten welke mappen ertoe doen, dan loopt Welke Windows-caches kun je verwijderen? ze een voor een door.

Instellen

Installeer Mole CLI for Windows met Scoop, en daarna de skill:

scoop install mole
npx skills add tw93/Mole -a claude-code codex cursor -g -y

De skill-opdracht heeft Node.js nodig en installeert de skill voor Claude Code, Codex en Cursor; laat de agents weg die je niet gebruikt. In Claude Code kun je ook /plugin marketplace add tw93/Mole en daarna /plugin install mole@mole uitvoeren, en in Codex codex plugin marketplace add tw93/Mole en daarna codex plugin add mole@mole. Gebruik versie 1.37.0 of later van de CLI: die voegde mo analyze --json en mo uninstall --list toe, de twee opdrachten die een agent het meest nodig heeft. mo --version laat zien welke versie je hebt.

De vier regels die de skill de agent meegeeft

1. Eerst lezen, dan pas iets veranderen. De agent begint met alleen-lezen-opdrachten: mo analyze --json voor schijfgebruik, mo status --json voor CPU, geheugen en schijven, mo history --json voor eerdere opschoonbeurten, mo uninstall --list voor geïnstalleerde apps, en mo clean --dry-run. Die mag hij zonder te vragen uitvoeren.
2. Elke verwijdering eerst bekijken. De agent voert de opschoonbeurt eerst uit met --dry-run en vat die samen: het totaal, de grootste groepen, en of elke groep definitief verwijderd wordt, naar de Prullenbak gaat of een download nodig heeft om opnieuw opgebouwd te worden.
3. Vragen voordat hij een verwijderopdracht typt. Vanuit een agent begint mo clean meteen, zonder bevestiging, dus jouw ja moet in het gesprek komen, na de voorvertoning.
4. Sommige stappen aan jou overlaten. Apps verwijderen, selectielijsten en alles waarvoor PowerShell als administrator nodig is, blijven in je eigen console. De agent geeft je de exacte opdracht en stopt. Hij probeert nooit verhoogde rechten te krijgen.

De skill verbiedt ook om opties te verzinnen (Mole CLI for Windows heeft geen --yes of --force) en om terug te vallen op Remove-Item voor iets wat Mole heeft overgeslagen of beschermd.

Hoe een sessie eruitziet

Stel dat je typt: "Mijn C-schijf is bijna vol. Wat neemt de ruimte in?"

De agent voert mo --version uit, ziet Windows: op de tweede regel en schakelt over naar de Windows-regels. Daarna geeft mo analyze --json een overzicht van je gebruikersmappen en stations, met groottes in bytes, een scan_status van complete, partial of unavailable, en insight: true bij bekende zware plekken zoals oude Downloads, Temp en caches van pakketbeheerders. Om beter te kijken voert hij mo analyze --json D:\ uit of het pad van de grootste map.

Daarna sorteert hij wat hij vond:

Wil je daarna ruimte terug, dan voert hij mo clean --dry-run uit. Elk kandidaatpad komt in %USERPROFILE%\.config\mole\clean-list.txt, dat de agent kan lezen om "zitten mijn Chrome-wachtwoorden erbij?" te beantwoorden voordat er iets gebeurt. Pas na jouw ja voert hij mo clean uit. In Windows maakt mo clean de Prullenbak niet leeg. Game-replays en shadercaches van de GPU blijven erbuiten tenzij je om --game-media of --gpu-shaders vraagt, omdat games shaders bij de volgende start traag opnieuw opbouwen.

Wat bij jou blijft, en waarom

Beheerdersstappen. Vanuit een agent dekt mo clean alleen je eigen gebruikersaccount. Voor systeembrede caches open je PowerShell met "Als administrator uitvoeren" en voer je mo clean --system --dry-run uit, daarna mo clean --system. Is je beheerdersaccount een andere Windows-gebruiker, dan heeft die shell een eigen profielmap, zodat de whitelist en logboeken daar los staan van de jouwe.

Apps verwijderen. De agent kan de app vinden in mo uninstall --list, dat per app de naam, bron (register of Microsoft Store), uitgever, versie en grootte toont. Het verwijderen zelf is een selectielijst, dus je voert eerst mo uninstall --dry-run uit om te zien welk verwijderprogramma elke app zou gebruiken, daarna mo uninstall, en typt om de app te zoeken. Mole start het eigen verwijderprogramma van de leverancier, dat bepaalt wat het binnen zijn map verwijdert, en verplaatst daarna een gecontroleerde achtergebleven installatiemap naar de Prullenbak. Sommige verwijderprogramma's tonen een eigen UAC-melding of wizard. Wat er meestal achterblijft, lees je in Wat Windows-apps achterlaten na het verwijderen.

Projectmappen en Systeembestandscontrole. mo purge opent een selectielijst, dus die draait in je eigen console. mo optimize eindigt met een vraag over het uitvoeren van Systeembestandscontrole, wat enkele minuten duurt; dat antwoord is ook aan jou.

Achteraf controleren

Na een echte run leest de agent de samenvatting van de opdracht en mo history --json --limit 1, en meldt dan wat er verwijderd en wat er overgeslagen is, zonder de overgeslagen onderdelen opnieuw te proberen. De geschiedenis wordt bewaard in %USERPROFILE%\.config\mole\operations.log. Voorvertoningen worden niet gelogd, dus daar staan alleen echte verwijderingen.

Dat logboek beantwoordt weken later ook de vraag "heeft Mole mijn bestand verwijderd?". De agent doorzoekt mo history --json --limit 200 op het pad. Geen treffer betekent dat Mole niet heeft vastgelegd dat het iets heeft verwijderd, geen bewijs dat niets anders het deed.

Om een map buiten alle toekomstige opschoonbeurten te houden, vraag je de agent hem te beschermen. Met jouw akkoord voegt hij het pad toe aan %USERPROFILE%\.config\mole\whitelist.txt, opgeslagen als UTF-8 met een byte order mark zodat Windows PowerShell 5.1 niet-Engelse paden goed leest, en bevestigt hij het met een nieuwe mo clean --dry-run.

Als je een ander hulpmiddel gebruikt

De regels zijn niet specifiek voor Mole. Begin bij elk ander hulpmiddel de sessie met zoiets als:

Voordat je iets verwijdert: laat me eerst de lijst zien en vertel welke onderdelen naar de
Prullenbak gaan en welke definitief verwijderd worden. Gebruik de voorvertonings- of
-WhatIf-modus van het hulpmiddel, nooit Remove-Item -Recurse -Force of del /s. Verhoog je
rechten niet en vraag niet om een shell als administrator. Wacht op mijn ja voor elke
opdracht die bestanden verwijdert, en vertel me daarna wat er verwijderd en wat er
overgeslagen is.

Veelgestelde vragen

Welke AI-agents kunnen de Mole-skill op Windows gebruiken?

Claude Code, Codex en Cursor staan in de installatieopdracht, en npx skills kan de skill ook installeren voor andere agents die skill-bestanden lezen. De agent heeft een shell op je pc nodig; Windows PowerShell 5.1 en PowerShell 7 werken allebei.

Kan de agent bestanden verwijderen zonder te vragen?

De skill zegt hem eerst een voorvertoning te tonen en op jouw ja te wachten, maar dat is een instructie, geen slot. Laat de goedkeuringsvragen van je agent voor shellopdrachten aanstaan en keur mo clean of Remove-Item niet vooraf goed in zijn instellingen. Apps verwijderen en opschonen als administrator kunnen helemaal niet vanuit de agent draaien.

Maakt hij mijn Prullenbak leeg of verwijdert hij mijn opgeslagen spellen?

In Windows maakt mo clean de Prullenbak niet leeg, en het slaat gamemedia en shadercaches over tenzij je erom vraagt. Opgeslagen spellen en gamebibliotheken zijn gebruikersgegevens die geen enkele Mole-opdracht verwijdert. Het eigen verwijderprogramma van een app kan wel gegevens in zijn map verwijderen, en daarom laat de agent het verwijderen van apps aan jou over.

Is Mole CLI for Windows gratis?

Ja, het is open source onder GPL-3.0, en de skill staat in dezelfde opslagplaats. Mole for Windows is een aparte betaalde app met een venster; de verschillen staan in Mole CLI for Windows en Mole for Windows: wat elk ervan doet.

Werkt dezelfde opzet ook op een Mac?

Ja. De skill leest mo --version en gebruikt daar de macOS-opdrachten, waar verwijderde apps naar de Prullenmand gaan en mo clean die standaard leegmaakt. De Mac-versie van deze handleiding is Claude Code of Codex veilig gebruiken om ruimte vrij te maken op je Mac.

Verder lezen

• C-schijf vol in Windows: kies opschonen, verplaatsen of verwijderen, over waar de ruimte meestal heen gaat.
• Ontwikkelaarscaches in Windows: wat npm, pip en Gradle bewaren, over npm, pip, Gradle en de andere opslagplekken die ontwikkeltools vullen.
• Zoek wat je Windows-schijf vult, om dezelfde zoektocht met de hand te doen.