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

> Lascia che Claude Code, Codex o Cursor trovino cosa riempie il Mac senza fargli eseguire rm: installa la skill di Mole, controlla con --dry-run, approva e leggi il registro.

Published: 2026-10-21

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](https://mole.fit/it/blog/ai-mac-cleaner-tools).

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:

```bash
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](https://mole.fit/it/blog/how-to-remove-leftover-files-after-uninstalling-mac-apps).

**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:

```prompt
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](https://mole.fit/it/blog/what-mac-cleaners-should-never-delete) e [Quali cache del Mac si possono eliminare?](https://mole.fit/it/blog/which-mac-caches-are-safe-to-delete) 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](https://mole.fit/windows/blog/use-claude-code-to-clean-up-windows).

## Letture correlate

- [Cleaner Mac con AI: cosa un modello dovrebbe e non dovrebbe decidere](https://mole.fit/it/blog/ai-mac-cleaner-tools), per capire dove un modello aiuta una pulizia e dove no.
- [Come fare pulizia dopo gli strumenti AI per programmare sul Mac](https://mole.fit/it/blog/how-to-clean-up-ai-coding-tools-mac), per le cache e le sessioni che Claude Code, Codex e Cursor lasciano sul Mac.
- [Mole CLI o l’app Mole per Mac](https://mole.fit/it/blog/mole-cli-vs-mac-app), per scegliere tra la riga di comando e l’app.

---

Canonical HTML page: https://mole.fit/it/blog/use-claude-code-to-clean-up-mac
Blog index for agents: https://mole.fit/it/blog/llms.txt
Site index for agents: https://mole.fit/llms.txt