Claude Code of Codex veilig gebruiken om ruimte vrij te maken op je Mac

Steeds meer mensen openen Claude Code of Codex en typen "mijn schijf is vol, zoek uit waarom". Daar is een agent goed voor: hij kan honderd mappen doorlezen, herkennen dat ~/Library/Developer/Xcode/DerivedData build-uitvoer is en ~/Library/Containers/com.tencent.xinWeChat chatgeschiedenis, en beide in gewone woorden uitleggen. Het riskante deel komt een stap later, als dezelfde agent op basis van zijn eigen lezing van een overzicht van du een rm -rf schrijft en die op je thuismap loslaat. Een shellopdracht heeft geen voorvertoning, geen Prullenmand en geen overzicht van wat hij heeft 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, de gratis opdrachtregeleditie van Mole, met zijn officiële agent-skill, die Claude Code, Codex, Cursor en andere agents leert hoe ze het gebruiken. Dezelfde gewoontes werken met elk hulpmiddel dat een dry-run kan doen.

Waarom een agent geen bestanden met rm moet verwijderen

Een agent is sterk in de vage delen van een opschoonbeurt: een grote mappenstructuur doorlopen, paden toeschrijven aan de apps waar ze bij horen, en bepalen welke twaalf van de vierduizend onderdelen een blik waard zijn. Beslissen dat een pad veilig verwijderd kan worden, is een ander soort probleem. Daarvoor is elke keer hetzelfde antwoord nodig en een lijst die je kunt controleren, en een model geeft geen van beide. Het uitgebreide betoog staat in AI Mac-opschoners: wat een model wel en niet mag beslissen.

In de praktijk ontbreken er vier dingen als een agent opruimt met kale shellopdrachten:

1. Een voorvertoning. rm doet zijn werk zodra het draait. Je ziet de opdracht, niet de 3.000 paden waarin die uitklapt.
2. Een weg terug. Bestanden die je met rm verwijdert, slaan de Prullenmand over. Zonder back-up zijn ze weg.
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 agent weet misschien niet dat een map met een cache-achtige naam sessies, ondertekeningssleutels of een database bevat waar een andere app nog naar schrijft.

Een opschoonhulpmiddel dat hiervoor gebouwd is, heeft die vier onderdelen al. De taak van de agent wordt dan de uitvoer lezen en het jou vragen.

Instellen

Installeer Mole CLI met Homebrew, en daarna de skill:

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

De tweede opdracht installeert de skill in één keer voor Claude Code, Codex en Cursor; laat de agents weg die je niet gebruikt. Werk je liever met het pluginsysteem van je agent, voer dan in Claude Code /plugin marketplace add tw93/Mole en daarna /plugin install mole@mole uit, of in Codex codex plugin marketplace add tw93/Mole en daarna codex plugin add mole@mole. Later werk je de skill bij met npx skills update -g -y.

Verder hoef je niets in te stellen. De volgende keer dat je vraagt naar schijfruimte, een app die weg moet of waarom de Mac traag is, laadt de agent de skill en volgt hij die.

De vier regels die de skill de agent meegeeft

De skill is een kort Markdown-bestand, en het grootste deel bestaat uit regels in plaats van opdrachten. Dit zijn de regels die voor je bestanden tellen:

1. Eerst lezen, dan pas iets veranderen. De agent antwoordt eerst met alleen-lezen-opdrachten: mo analyze --json voor schijfgebruik, mo status --json voor geheugen en CPU, mo history --json voor eerdere opschoonbeurten, mo uninstall --list voor geïnstalleerde apps, en elke --dry-run. Die mag hij zonder te vragen uitvoeren.
2. Elke verwijdering eerst bekijken. Voor een opschoonbeurt voert de agent die uit met --dry-run en vat hij het resultaat samen: het totaal, de grootste groepen, en per groep of die definitief verwijderd wordt, naar de Prullenmand gaat of een download nodig heeft om opnieuw opgebouwd te worden.
3. Vragen voordat hij een verwijderopdracht typt. Vanuit een agent begint mo clean op het moment dat het wordt aangeroepen, zonder bevestiging, dus de afspraak moet eerst in het gesprek gemaakt worden. "Waarom is mijn schijf vol?" is een vraag, geen toestemming. "Ruim die maar op" na de voorvertoning is dat wel.
4. Sommige stappen aan jou overlaten. Een app verwijderen, onderdelen uit een lijst kiezen en alles waarvoor een beheerderswachtwoord nodig is, blijven in je eigen Terminal. De agent geeft je de exacte opdracht en stopt. Hij voert nooit sudo uit en vraagt nooit om je wachtwoord.

Twee kleinere regels sluiten de gebruikelijke uitwegen af. De agent mag alleen de opdrachten en opties gebruiken die de skill noemt, dus hij kan geen --force verzinnen. En als Mole een pad overslaat of beschermt, mag de agent niet terugvallen op rm om het toch te verwijderen: overslaan is het antwoord van Mole.

Hoe een sessie eruitziet

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

De agent voert mo --version uit om te controleren dat hij met de macOS-editie praat, en daarna mo analyze --json. Dat geeft de grote locaties in je thuismap met groottes in bytes, een scan_status van complete, partial of unavailable, en vlaggen zoals cleanable: true voor mappen die Mole als cache herkent. Hij kan mo analyze --json nog eens draaien op de twee of drie grootste onderdelen om erin te kijken.

Daarna koppelt hij wat hij vond aan wie het kan afhandelen:

De laatste rij telt net zo zwaar als de rest. Een goed antwoord zegt dat 40 GB daarvan een virtuele machine van Parallels is en laat de beslissing bij jou, in plaats van te zoeken naar een opdracht die hem zou verwijderen.

Wil je ruimte terug, dan voert de agent mo clean --dry-run uit. De samenvatting verschijnt in de chat, en elk kandidaatpad wordt weggeschreven naar ~/.config/mole/clean-list.txt, dat de agent kan lezen om "zit mijn Slack-geschiedenis erbij?" te beantwoorden voordat er iets gebeurt. Hij vertelt je ook dat mo clean standaard de Prullenmand leegmaakt, omdat mensen daar vaak bewust dingen bewaren. Pas nadat je ja zegt, voert hij mo clean uit.

Wat bij jou blijft, en waarom

Beheerdersstappen. Sommige systeemcaches vereisen een beheerderswachtwoord. Vanuit een agent ruimt mo clean het gebruikersdeel op, slaat het systeemdeel over en zegt dat ook. Wil je beide, dan vraagt de agent je mo clean in je eigen Terminal uit te voeren, waar Mole zelf om het wachtwoord vraagt en alles in één keer doet. Hij doet niet de helft nu en de helft later, omdat de tweede run opnieuw zou scannen en de eerste zou herhalen.

Apps verwijderen. De agent kan de app vinden met mo uninstall --list en je met mo uninstall --dry-run <name> precies laten zien wat er mee zou gaan: de app, zijn caches, en een lijst "Personal data kept" met instellingen en gegevens die blijven, tenzij je anders kiest. Het echte verwijderen weigert te draaien zonder terminal, dus mo uninstall <name> voer je zelf uit. Verwijderde bestanden gaan naar de Prullenmand. Heeft een app die je eerder verwijderde toch nog iets achtergelaten, zie dan Bibliotheekresten vinden na het verwijderen van Mac-apps.

Projectmappen. mo purge --dry-run toont build-uitvoer, die offline opnieuw wordt opgebouwd, en afhankelijkheidsmappen zoals node_modules, die een download nodig hebben om terug te komen. Wil je maar een paar projecten opruimen, dan geeft de agent je mo purge, waarvan je in de selectielijst zelf kiest.

Achteraf controleren

Na een echte run leest de agent de eigen samenvatting van de opdracht en mo history --json --limit 1, en vertelt je daarna wat er verwijderd en wat er overgeslagen is. Overgeslagen onderdelen probeert hij niet opnieuw: Mole slaat bewust bestanden over die in gebruik of beschermd zijn.

Het logboek beantwoordt ook de vraag die meestal een week later komt: "heeft de opschoonbeurt mijn bestand verwijderd?" Vraag de agent precies dat. Hij doorzoekt mo history --json --limit 200 op het pad en alles daaronder, en leest het volledige verwijderlogboek als de datum verder terug ligt. Geen treffer betekent dat Mole niet heeft vastgelegd dat het iets heeft verwijderd, wat niet hetzelfde is als bewijs dat niets het verwijderd heeft, en zo hoort de agent het ook te zeggen.

Om een map buiten alle toekomstige opschoonbeurten te houden, vraag je de agent hem te beschermen. Na je akkoord voegt hij het pad toe aan ~/.config/mole/whitelist en voert hij een nieuwe mo clean --dry-run uit om te bevestigen dat het pad niet meer in de lijst staat.

Als je een ander hulpmiddel gebruikt

De skill is specifiek voor Mole, de regels zijn dat niet. Vraag je een agent om met iets anders op te ruimen, plak dan zoiets aan het begin van de sessie:

Voordat je iets verwijdert: laat me eerst de lijst zien en vertel welke onderdelen naar de
Prullenmand gaan en welke definitief verwijderd worden. Gebruik de dry-run- of
voorvertoningsmodus van het hulpmiddel, nooit rm of find -delete. Voer geen sudo uit.
Wacht op mijn ja voor elke opdracht die bestanden verwijdert, en vertel me daarna wat er
verwijderd en wat er overgeslagen is.

Het geeft de agent geen lijst met beschermde paden of een logboek dat niet bestaat, maar het legt de voorvertoning en de beslissing terug waar ze horen. Wat je met elk hulpmiddel moet bewaren, lees je in Wat Mac-opschoonapps nooit mogen verwijderen en Welke caches op de Mac kun je veilig verwijderen?, die de mappen een voor een doorlopen.

Veelgestelde vragen

Welke AI-agents kunnen de Mole-skill 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. Claude Code en Codex kunnen hem ook installeren vanuit hun pluginmarktplaatsen. De agent heeft een shell op je Mac nodig, dus assistenten die alleen chatten en geen terminal hebben, kunnen Mole niet uitvoeren.

Kan de agent mijn bestanden verwijderen zonder te vragen?

De skill zegt hem dat niet te doen: verwijderopdrachten komen pas na een voorvertoning en jouw ja in het gesprek. Dat is een instructie aan de agent, geen slot, dus laat de goedkeuringsvragen van je agent voor shellopdrachten aanstaan en keur rm of mo clean niet vooraf goed in zijn rechteninstellingen. Apps verwijderen en beheerdersstappen kunnen helemaal niet vanuit de agent draaien; daarvoor is je Terminal nodig.

Verwijdert opschonen via een agent meer dan de Mole-app of de CLI alleen?

Nee. De agent voert dezelfde CLI-opdrachten uit die jij zou kunnen typen, met dezelfde beschermde paden en dezelfde voorvertoning. Wat hij toevoegt is lezen en uitleggen: welke map bij welke app hoort, en welke opdracht, als die er is, het afhandelt.

Is Mole CLI gratis?

Ja. Mole CLI is open source onder GPL-3.0 en de skill zit in dezelfde opslagplaats. Mole voor Mac is een aparte betaalde app voor mensen die liever klikken dan typen; de agent noemt hem hooguit één keer, en alleen als een stap beter in een venster past, zoals apps kiezen om te verwijderen.

Werkt dit ook op Windows?

Ja, met Mole CLI for Windows, dat eigen opdrachten heeft en eigen regels voor de Prullenbak en beheerdersstappen. De skill leest mo --version en schakelt automatisch over naar de Windows-referentie. De Windows-versie van deze handleiding is Claude Code of Codex veilig gebruiken om ruimte vrij te maken in Windows.

Verder lezen

• AI Mac-opschoners: wat een model wel en niet mag beslissen, over waar een model helpt bij het opruimen en waar niet.
• AI-codingtools op de Mac opruimen: caches, CLI's, transcripten, over de caches en sessies die Claude Code, Codex en Cursor op je Mac achterlaten.
• Mole CLI tegenover de Mac-app: gratis terminal of betaalde GUI, om te kiezen tussen de opdrachtregel en de app.