Mit Claude Code oder Codex sicher Speicherplatz auf dem Mac freigeben

EntwicklerVeröffentlicht 10 Min. Lesezeit

Immer mehr Leute öffnen Claude Code oder Codex und tippen „meine Festplatte ist voll, finde heraus, warum“. Dafür eignet sich ein Agent gut: Er kann hundert Ordner lesen, erkennen, dass ~/Library/Developer/Xcode/DerivedData Build-Ausgabe und ~/Library/Containers/com.tencent.xinWeChat ein Chatverlauf ist, und beides in einfachen Worten erklären. Riskant wird es einen Schritt später, wenn derselbe Agent aus seiner eigenen Lesart einer du-Liste ein rm -rf schreibt und es auf Ihren Benutzerordner loslässt. Ein Shell-Befehl hat keine Vorschau, keinen Papierkorb und kein Protokoll dessen, was er entfernt hat.

Diese Anleitung zeigt eine sicherere Aufteilung. Der Agent liest und erklärt, ein Bereinigungswerkzeug mit Vorschau entfernt, und Sie geben dazwischen frei. Das Werkzeug hier ist Mole CLI, die kostenlose Kommandozeilen-Ausgabe von Mole, zusammen mit seinem offiziellen Agent-Skill, der Claude Code, Codex, Cursor und anderen Agents beibringt, es zu benutzen. Dieselben Gewohnheiten funktionieren mit jedem Werkzeug, das einen Probelauf hat.

Warum ein Agent keine Dateien mit rm löschen sollte

Ein Agent ist stark in den unscharfen Teilen einer Bereinigung: einen großen Ordnerbaum durchgehen, Pfade den Apps zuordnen, denen sie gehören, und herausfinden, welche zwölf von viertausend Einträgen einen Blick wert sind. Zu entscheiden, dass ein Pfad gefahrlos gelöscht werden kann, ist ein Problem anderer Art. Es braucht jedes Mal dieselbe Antwort und eine Liste, die Sie prüfen können, und ein Modell liefert weder das eine noch das andere. Die ausführliche Begründung steht in KI-Mac-Cleaner: Was ein Modell entscheiden darf und was nicht.

In der Praxis fehlen vier Dinge, wenn ein Agent mit rohen Shell-Befehlen aufräumt:

  1. Eine Vorschau. rm handelt, sobald es läuft. Sie sehen den Befehl, nicht die 3.000 Pfade, zu denen er sich auflöst.
  2. Ein Weg zurück. Mit rm entfernte Dateien umgehen den Papierkorb. Ohne Backup sind sie weg.
  3. Ein Protokoll. Wenn eine App nächste Woche ihre Einstellungen vergessen hat, sagt Ihnen nichts, ob die Bereinigung sie angefasst hat.
  4. Eine Liste dessen, was nie angefasst wird. Ein Agent weiß womöglich nicht, dass ein Ordner, der wie ein Cache heißt, Sitzungen, Signaturschlüssel oder eine Datenbank enthält, in die eine andere App noch schreibt.

Ein Bereinigungswerkzeug, das dafür gebaut ist, bringt diese vier Teile schon mit. Die Aufgabe des Agenten wird dann, seine Ausgabe zu lesen und Sie zu fragen.

Einrichten

Installieren Sie Mole CLI mit Homebrew, danach den Skill:

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

Der zweite Befehl installiert den Skill in einem Schritt für Claude Code, Codex und Cursor; lassen Sie die Agents weg, die Sie nicht verwenden. Wenn Sie lieber das Plugin-System Ihres Agenten nutzen, führen Sie in Claude Code /plugin marketplace add tw93/Mole und dann /plugin install mole@mole aus, in Codex codex plugin marketplace add tw93/Mole und dann codex plugin add mole@mole. Später aktualisieren Sie den Skill mit npx skills update -g -y.

Mehr muss nicht eingerichtet werden. Wenn Sie das nächste Mal nach Speicherplatz fragen, nach einer App, die weg soll, oder danach, warum der Mac langsam ist, lädt der Agent den Skill und hält sich daran.

Die vier Regeln, die der Skill dem Agenten gibt

Der Skill ist eine kurze Markdown-Datei, und der größte Teil davon sind Regeln, nicht Befehle. Diese sind für Ihre Dateien entscheidend:

  1. Lesen, bevor etwas geändert wird. Der Agent antwortet zuerst mit Befehlen, die nur lesen: mo analyze --json für die Speicherbelegung, mo status --json für Arbeitsspeicher und CPU, mo history --json für frühere Bereinigungen, mo uninstall --list für installierte Apps und jedes --dry-run. Diese darf er ohne Nachfrage ausführen.
  2. Jedes Entfernen vorab anzeigen. Vor einer Bereinigung führt der Agent sie mit --dry-run aus und fasst das Ergebnis zusammen: die Gesamtgröße, die größten Gruppen und für jede Gruppe, ob sie endgültig gelöscht wird, in den Papierkorb kommt oder für den Neuaufbau einen Download braucht.
  3. Fragen, bevor ein entfernender Befehl getippt wird. Von einem Agenten aufgerufen, startet mo clean sofort und ohne Bestätigung, also muss die Zustimmung vorher im Gespräch passieren. „Warum ist meine Festplatte voll?“ ist eine Frage, keine Einwilligung. „Dann räum das auf“ nach der Vorschau ist eine.
  4. Manche Schritte Ihnen überlassen. Eine App deinstallieren, Einträge aus einer Liste auswählen und alles, was ein Administratorpasswort braucht, bleibt in Ihrem eigenen Terminal. Der Agent gibt Ihnen den genauen Befehl und hört auf. Er führt nie sudo aus und fragt nie nach Ihrem Passwort.

Zwei kleinere Regeln schließen die üblichen Schlupflöcher. Der Agent darf nur die Befehle und Optionen verwenden, die der Skill aufführt, er kann also kein --force erfinden. Und wenn Mole einen Pfad überspringt oder schützt, darf der Agent nicht auf rm ausweichen, um ihn trotzdem zu entfernen: Ein übersprungener Pfad ist Moles Antwort.

Wie eine Sitzung aussieht

Angenommen, Sie tippen: „Mein Mac meldet, dass die Festplatte fast voll ist. Was belegt den Platz?“

Der Agent führt mo --version aus, um zu prüfen, dass er mit der macOS-Ausgabe spricht, dann mo analyze --json. Das liefert die großen Orte in Ihrem Benutzerordner mit Größen in Byte, einen scan_status mit complete, partial oder unavailable und Kennzeichen wie cleanable: true für Ordner, die Mole als Caches erkennt. Für die zwei oder drei größten Einträge kann er mo analyze --json noch einmal ausführen, um hineinzusehen.

Dann ordnet er zu, wer sich um das Gefundene kümmern kann:

Gefunden Wohin damit
App-Caches, Protokolle, Reste bereits gelöschter Apps mo clean
Build-Ausgabe und Abhängigkeitsordner in Projekten mo purge
Eine installierte App, die Sie nicht mehr verwenden mo uninstall, von Ihnen ausgeführt
Installationsprogramme in Downloads mo installer, von Ihnen ausgeführt
Dokumente, Fotos, Musik, virtuelle Maschinen, iPhone-Backups Ihre Entscheidung; kein Mole-Befehl entfernt sie

Die letzte Zeile zählt so viel wie die anderen. Eine gute Antwort sagt, dass 40 GB davon eine virtuelle Parallels-Maschine sind, und überlässt Ihnen die Entscheidung, statt nach einem Befehl zu suchen, der sie löschen würde.

Wenn Sie Platz zurückwollen, führt der Agent mo clean --dry-run aus. Die Zusammenfassung erscheint im Chat, und jeder Kandidatenpfad wird in ~/.config/mole/clean-list.txt geschrieben, die der Agent lesen kann, um „Ist mein Slack-Verlauf dabei?“ zu beantworten, bevor irgendetwas passiert. Er sagt Ihnen auch, dass mo clean standardmäßig den Papierkorb leert, weil viele dort absichtlich Dinge aufbewahren. Erst nach Ihrem Ja führt er mo clean aus.

Was bei Ihnen bleibt, und warum

Administratorschritte. Manche Systemcaches brauchen ein Administratorpasswort. Von einem Agenten aus bereinigt mo clean den Benutzerteil, überspringt den Systemteil und sagt das auch. Wenn Sie beides wollen, bittet der Agent Sie, mo clean in Ihrem eigenen Terminal auszuführen, wo Mole selbst nach dem Passwort fragt und alles in einem Durchgang erledigt. Er macht nicht jetzt die eine Hälfte und später die andere, weil der zweite Lauf neu scannen und den ersten wiederholen würde.

Apps deinstallieren. Der Agent kann die App mit mo uninstall --list finden und Ihnen mit mo uninstall --dry-run <name> genau zeigen, was mitginge: die App, ihre Caches und eine Liste „Personal data kept“ mit Einstellungen und Daten, die bleiben, sofern Sie nichts anderes wählen. Die echte Deinstallation verweigert den Lauf ohne Terminal, also führen Sie mo uninstall <name> selbst aus. Entfernte Dateien kommen in den Papierkorb. Wenn eine früher entfernte App trotzdem Reste hinterlassen hat, lesen Sie Reste nach dem Deinstallieren von Mac-Apps entfernen.

Projektordner. mo purge --dry-run listet Build-Ausgabe, die sich offline neu erzeugen lässt, und Abhängigkeitsordner wie node_modules, die zum Wiederherstellen einen Download brauchen. Wenn nur einige Projekte bereinigt werden sollen, gibt der Agent Ihnen mo purge, in dessen Auswahlliste Sie selbst wählen.

Danach prüfen

Nach einem echten Lauf liest der Agent die Zusammenfassung des Befehls und mo history --json --limit 1 und sagt Ihnen dann, was entfernt und was übersprungen wurde. Übersprungene Einträge versucht er nicht erneut: Mole überspringt Dateien, die in Benutzung oder absichtlich geschützt sind.

Das Protokoll beantwortet auch die Frage, die meist eine Woche später kommt: „Hat die Bereinigung meine Datei gelöscht?“ Fragen Sie den Agenten genau das. Er durchsucht mo history --json --limit 200 nach dem Pfad und allem darunter und liest das vollständige Löschprotokoll, wenn das Datum weiter zurückliegt. Kein Treffer heißt, dass Mole keinen Eintrag über das Entfernen hat, was kein Beweis dafür ist, dass nichts anderes es getan hat, und genau so sollte der Agent es sagen.

Um einen Ordner aus allen künftigen Bereinigungen herauszuhalten, bitten Sie den Agenten, ihn zu schützen. Er trägt den Pfad nach Ihrer Zustimmung in ~/.config/mole/whitelist ein und führt dann ein neues mo clean --dry-run aus, um zu bestätigen, dass der Pfad nicht mehr aufgeführt wird.

Wenn Sie ein anderes Werkzeug verwenden

Der Skill ist auf Mole zugeschnitten, seine Regeln sind es nicht. Wenn Sie einen Agenten mit etwas anderem aufräumen lassen, fügen Sie zu Beginn der Sitzung etwa Folgendes ein:

Bevor du etwas entfernst: Zeig mir zuerst die Liste und sag mir, welche Einträge in den
Papierkorb kommen und welche endgültig gelöscht werden. Nutze den Probelauf- oder
Vorschaumodus des Werkzeugs, nie rm oder find -delete. Führe kein sudo aus. Warte vor jedem
Befehl, der Dateien entfernt, auf mein Ja, und sag mir danach, was entfernt und was
übersprungen wurde.

Das gibt dem Agenten weder eine Liste geschützter Pfade noch ein Protokoll, das es nicht gibt, aber Vorschau und Entscheidung kommen wieder dorthin, wo sie hingehören. Was Sie unabhängig vom Werkzeug behalten sollten, gehen Was Mac-Cleaner niemals löschen sollten und Welche Mac-Caches lassen sich sicher löschen? Ordner für Ordner durch.

Häufige Fragen

Welche KI-Agents können den Mole-Skill nutzen?

Claude Code, Codex und Cursor sind im Installationsbefehl genannt, und npx skills kann ihn auch für andere Agents installieren, die Skill-Dateien lesen. Claude Code und Codex können ihn außerdem aus ihren Plugin-Marktplätzen installieren. Der Agent braucht eine Shell auf Ihrem Mac, reine Chat-Assistenten ohne Terminal können Mole also nicht ausführen.

Kann der Agent meine Dateien löschen, ohne zu fragen?

Der Skill sagt ihm, das nicht zu tun: Entfernende Befehle kommen erst nach einer Vorschau und Ihrem Ja im Gespräch. Das ist eine Anweisung an den Agenten, keine Sperre, also lassen Sie die Freigabeabfragen Ihres Agenten für Shell-Befehle eingeschaltet und geben Sie rm oder mo clean in seinen Berechtigungseinstellungen nicht vorab frei. Deinstallationen und Administratorschritte lassen sich vom Agenten aus gar nicht ausführen; sie brauchen Ihr Terminal.

Entfernt das Aufräumen über einen Agenten mehr als die Mole-App oder die CLI allein?

Nein. Der Agent führt dieselben CLI-Befehle aus, die Sie auch tippen könnten, mit denselben geschützten Pfaden und derselben Vorschau. Was er hinzufügt, ist Lesen und Erklären: welcher Ordner zu welcher App gehört und welcher Befehl, falls überhaupt einer, sich darum kümmert.

Ist Mole CLI kostenlos?

Ja. Mole CLI ist Open Source unter GPL-3.0, und der Skill gehört zum selben Repository. Mole für Mac ist eine separate kostenpflichtige App für alle, die lieber klicken als tippen; der Agent erwähnt sie höchstens einmal und nur, wenn ein Schritt besser in ein Fenster passt, etwa die Auswahl der Apps zum Deinstallieren.

Funktioniert das auch unter Windows?

Ja, mit Mole CLI for Windows, das eigene Befehle und eigene Regeln für den Papierkorb und Administratorschritte hat. Der Skill liest mo --version und wechselt automatisch zur Windows-Referenz. Die Windows-Fassung dieser Anleitung ist Mit Claude Code oder Codex sicher Speicherplatz unter Windows freigeben.

Weiterlesen