Usare Claude Code o Codex per liberare spazio sul Mac in sicurezza

SviluppatoriPubblicato 10 min di lettura

Sempre più persone aprono Claude Code o Codex e scrivono "il disco è pieno, scopri perché". È un buon uso di un agente: può leggere cento cartelle, riconoscere che ~/Library/Developer/Xcode/DerivedData è output di compilazione e che ~/Library/Containers/com.tencent.xinWeChat è la cronologia delle chat, e spiegare entrambe le cose con parole semplici. La parte rischiosa arriva un passo dopo, quando lo stesso agente scrive un rm -rf basandosi sulla propria lettura di un elenco di du e lo esegue sulla tua cartella Inizio. Un comando di shell non ha anteprima, non ha Cestino e non tiene traccia di ciò che ha rimosso.

Questa guida mostra una divisione dei compiti più sicura. L’agente legge e spiega, uno strumento di pulizia con un’anteprima si occupa della rimozione, e in mezzo approvi tu. Lo strumento qui è Mole CLI, l’edizione gratuita a riga di comando di Mole, con la sua skill ufficiale per agenti, che insegna a Claude Code, Codex, Cursor e ad altri agenti come usarlo. Le stesse abitudini valgono con qualsiasi strumento che abbia una modalità di simulazione.

Perché un agente non dovrebbe cancellare file con rm

Un agente è bravo nelle parti sfumate di una pulizia: percorrere un grande albero di cartelle, attribuire i percorsi alle app a cui appartengono e stabilire quali dodici elementi su quattromila meritano un’occhiata. Decidere che un percorso si può eliminare senza rischi è un problema di altro tipo. Richiede la stessa risposta ogni volta e un elenco che puoi controllare, e un modello non dà né l’una né l’altro. Il ragionamento completo è in Cleaner Mac con AI: cosa un modello dovrebbe e non dovrebbe decidere.

In pratica, quando un agente pulisce con comandi di shell diretti mancano quattro cose:

  1. Un’anteprima. rm agisce appena viene eseguito. Vedi il comando, non i 3.000 percorsi in cui si espande.
  2. Una via di ritorno. I file rimossi con rm non passano dal Cestino. Se non hai un backup, sono persi.
  3. Una traccia. La settimana dopo, quando un’app dimentica le sue impostazioni, niente ti dice se la pulizia le ha toccate.
  4. Un elenco di ciò che non va mai toccato. Un agente può non sapere che una cartella con il nome di una cache contiene sessioni, chiavi di firma o un database su cui un’altra app sta ancora scrivendo.

Uno strumento di pulizia pensato per questo ha già queste quattro parti. Il compito dell’agente diventa leggere il suo output e chiedere a te.

Configurazione

Installa Mole CLI con Homebrew, poi la skill:

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

Il secondo comando installa la skill per Claude Code, Codex e Cursor in un colpo solo; togli gli agenti che non usi. Se preferisci il sistema di plugin del tuo agente, esegui /plugin marketplace add tw93/Mole e poi /plugin install mole@mole in Claude Code, oppure codex plugin marketplace add tw93/Mole e poi codex plugin add mole@mole in Codex. Per aggiornare la skill in seguito usa npx skills update -g -y.

Non serve configurare altro. La prossima volta che chiedi dello spazio su disco, di un’app da rimuovere o del perché il Mac è lento, l’agente carica la skill e la segue.

Le quattro regole che la skill dà all’agente

La skill è un breve file Markdown, e per la maggior parte contiene regole più che comandi. Queste sono quelle che contano per i tuoi file:

  1. Leggere prima di cambiare qualsiasi cosa. L’agente risponde prima con comandi di sola lettura: mo analyze --json per l’uso del disco, mo status --json per memoria e CPU, mo history --json per le pulizie passate, mo uninstall --list per le app installate, e ogni --dry-run. Questi si possono eseguire senza chiedere.
  2. Mostrare in anteprima ogni rimozione. Prima di una pulizia, l’agente la esegue con --dry-run e ne riassume il risultato: il totale, i gruppi più grandi e, per ciascun gruppo, se viene eliminato definitivamente, finisce nel Cestino o richiede un download per essere ricostruito.
  3. Chiedere prima di scrivere un comando che rimuove. Lanciato da un agente, mo clean parte nel momento in cui viene invocato, senza conferma, quindi l’accordo deve arrivare prima, nella conversazione. "Perché il disco è pieno?" è una domanda, non un consenso. "Vai pure, pulisci quelli" dopo l’anteprima lo è.
  4. Lasciare alcuni passaggi a te. Disinstallare un’app, scegliere voci da un elenco e tutto ciò che richiede una password da amministratore restano nel tuo Terminale. L’agente ti dà il comando esatto e si ferma. Non esegue mai sudo e non ti chiede mai la password.

Due regole minori chiudono le solite vie di fuga. L’agente può usare solo i comandi e le opzioni elencati nella skill, quindi non può inventarsi un --force. E quando Mole salta o protegge un percorso, l’agente non può ripiegare su rm per rimuoverlo comunque: il salto è la risposta di Mole.

Com’è una sessione

Supponiamo che tu scriva: "Il Mac dice che il disco è quasi pieno. Cosa lo sta occupando?"

L’agente esegue mo --version per verificare di avere a che fare con l’edizione per macOS, poi mo analyze --json. Il comando restituisce le posizioni più grandi della tua cartella Inizio con le dimensioni in byte, uno scan_status che vale complete, partial o unavailable, e indicatori come cleanable: true per le cartelle che Mole riconosce come cache. Può eseguire di nuovo mo analyze --json sulle due o tre voci più grandi per vederne il contenuto.

Poi associa ciò che ha trovato a chi può occuparsene:

Trovato Dove va
Cache delle app, log, residui di app già eliminate mo clean
Output di compilazione e cartelle delle dipendenze nei progetti mo purge
Un’app installata che non usi più mo uninstall, eseguito da te
Programmi di installazione in Download mo installer, eseguito da te
Documenti, foto, musica, macchine virtuali, backup dell’iPhone Decidi tu; nessun comando di Mole li rimuove

L’ultima riga conta quanto le altre. Una buona risposta dice che 40 GB di quello spazio sono una macchina virtuale Parallels e lascia a te la decisione, invece di cercare un comando che la elimini.

Se vuoi recuperare spazio, l’agente esegue mo clean --dry-run. Il riepilogo compare nella chat, e ogni percorso candidato viene scritto in ~/.config/mole/clean-list.txt, che l’agente può leggere per rispondere a "c’è dentro la mia cronologia di Slack?" prima che succeda qualcosa. Ti dirà anche che mo clean svuota il Cestino per impostazione predefinita, perché spesso le persone ci tengono delle cose di proposito. Solo dopo il tuo sì esegue mo clean.

Cosa resta a te, e perché

Passaggi da amministratore. Alcune cache di sistema richiedono una password da amministratore. Da un agente, mo clean pulisce la parte a livello utente, salta la parte di sistema e lo dice. Quando vuoi entrambe, l’agente ti chiede di eseguire mo clean nel tuo Terminale, dove Mole chiede la password da solo e fa tutto in un unico passaggio. Non farà metà adesso e metà dopo, perché la seconda esecuzione ripeterebbe la scansione e rifarebbe la prima.

Disinstallare app. L’agente può trovare l’app con mo uninstall --list e mostrarti esattamente cosa verrebbe rimosso con mo uninstall --dry-run <name>: l’app, le sue cache e un elenco "Personal data kept" di impostazioni e dati che restano, a meno che tu non scelga diversamente. La disinstallazione vera si rifiuta di partire senza un terminale, quindi mo uninstall <name> lo esegui tu. I file rimossi vanno nel Cestino. Se un’app che hai rimosso in passato ha lasciato ancora qualcosa, vedi Rimuovere i file residui dopo la disinstallazione di app Mac.

Cartelle dei progetti. mo purge --dry-run elenca l’output di compilazione, che si ricostruisce offline, e le cartelle delle dipendenze come node_modules, che richiedono un download per essere ripristinate. Se vuoi pulire solo alcuni progetti, l’agente ti passa mo purge, il cui elenco di selezione ti lascia scegliere.

Controllare dopo

Dopo un’esecuzione reale, l’agente legge il riepilogo del comando e mo history --json --limit 1, poi ti dice cosa è stato rimosso e cosa è stato saltato. Non riprova le voci saltate: Mole salta di proposito i file in uso o protetti.

Il registro risponde anche alla domanda che di solito arriva una settimana dopo: "la pulizia ha eliminato il mio file?" Chiedilo all’agente proprio così. Cerca in mo history --json --limit 200 il percorso e tutto ciò che contiene, e se la data è più vecchia legge il registro completo delle eliminazioni. Nessuna corrispondenza significa che Mole non ha traccia di averlo rimosso, il che non equivale a una prova che niente l’abbia rimosso, e l’agente dovrebbe dirlo così.

Per tenere una cartella fuori da tutte le pulizie future, chiedi all’agente di proteggerla. Aggiunge il percorso a ~/.config/mole/whitelist dopo il tuo consenso, poi esegue un nuovo mo clean --dry-run per confermare che il percorso non compare più.

Se usi un altro strumento

La skill è specifica di Mole, ma le sue regole no. Se chiedi a un agente di pulire con qualcos’altro, incolla qualcosa di simile all’inizio della sessione:

Prima di rimuovere qualsiasi cosa: mostrami prima l'elenco e dimmi quali voci vanno nel
Cestino e quali vengono eliminate definitivamente. Usa la modalità dry-run o di anteprima
dello strumento, mai rm o find -delete. Non eseguire sudo. Aspetta il mio sì prima di
qualsiasi comando che rimuove file, e dopo dimmi cosa è stato rimosso e cosa è stato saltato.

Non darà all’agente un elenco di percorsi protetti né un registro che non esiste, ma rimette l’anteprima e la decisione al loro posto. Per sapere cosa conservare con qualsiasi strumento, Cosa i cleaner Mac non devono mai cancellare e Quali cache del Mac si possono eliminare? passano in rassegna le cartelle una per una.

Domande frequenti

Quali agenti AI possono usare la skill di Mole?

Claude Code, Codex e Cursor sono indicati nel comando di installazione, e npx skills può installarla per altri agenti che leggono i file delle skill. Claude Code e Codex possono installarla anche dai loro marketplace di plugin. L’agente ha bisogno di una shell sul tuo Mac, quindi gli assistenti solo chat senza terminale non possono eseguire Mole.

L’agente può eliminare i miei file senza chiedere?

La skill gli dice di non farlo: i comandi che rimuovono arrivano solo dopo un’anteprima e il tuo sì nella conversazione. È un’istruzione all’agente, non un blocco, quindi lascia attive le richieste di approvazione del tuo agente per i comandi di shell e non preapprovare rm o mo clean nelle sue impostazioni dei permessi. Disinstallazioni e passaggi da amministratore non possono proprio partire dall’agente; richiedono il tuo Terminale.

Pulire tramite un agente rimuove più dell’app Mole o della sola CLI?

No. L’agente esegue gli stessi comandi della CLI che potresti digitare tu, con gli stessi percorsi protetti e la stessa anteprima. Ciò che aggiunge è leggere e spiegare: quale cartella appartiene a quale app, e quale comando, se ce n’è uno, se ne occupa.

Mole CLI è gratuito?

Sì. Mole CLI è open source con licenza GPL-3.0 e la skill fa parte dello stesso repository. Mole for Mac è un’app separata a pagamento per chi preferisce fare clic anziché digitare; l’agente la nomina al massimo una volta, e solo quando un passaggio si fa meglio in una finestra, come scegliere le app da disinstallare.

Funziona anche su Windows?

Sì, con Mole CLI for Windows, che ha comandi propri e regole proprie sul Cestino e sui passaggi da amministratore. La skill legge mo --version e passa automaticamente al riferimento per Windows. La versione Windows di questa guida è Usare Claude Code o Codex per liberare spazio su Windows in sicurezza.

Letture correlate