# Cómo usar Claude Code o Codex para liberar espacio en Mac de forma segura

> Deja que Claude Code, Codex o Cursor encuentren qué llena tu Mac sin dejarles ejecutar rm: instala el skill de Mole, previsualiza con --dry-run, aprueba y luego revisa el registro.

Published: 2026-10-21

Cada vez más gente abre Claude Code o Codex y escribe "mi disco está lleno, averigua por qué". Es un buen uso para un agente: puede leer cien carpetas, reconocer que `~/Library/Developer/Xcode/DerivedData` es resultado de compilación y `~/Library/Containers/com.tencent.xinWeChat` es un historial de chat, y explicar ambas cosas con palabras sencillas. El riesgo llega un paso después, cuando ese mismo agente escribe un `rm -rf` a partir de su propia lectura de un listado de `du` y lo ejecuta sobre tu carpeta de inicio. Un comando de shell no tiene vista previa, ni Papelera, ni registro de lo que eliminó.

Esta guía propone un reparto más seguro. El agente lee y explica, una herramienta de limpieza con vista previa elimina, y tú apruebas entre medias. La herramienta aquí es Mole CLI, la edición gratuita de línea de comandos de Mole, junto con su skill de agente oficial, que enseña a Claude Code, Codex, Cursor y otros agentes a usarla. Los mismos hábitos sirven con cualquier herramienta que tenga un modo de simulación.

## Por qué un agente no debería borrar archivos con rm

Un agente es bueno en las partes difusas de una limpieza: recorrer un árbol de carpetas grande, atribuir rutas a las apps que las poseen y ordenar cuáles doce de cuatro mil elementos merecen una mirada. Decidir que una ruta se puede borrar sin riesgo es otro tipo de problema. Necesita la misma respuesta cada vez y una lista que puedas comprobar, y un modelo no da ninguna de las dos. El argumento completo está en [Limpiadores de Mac con IA: qué debería decidir un modelo y qué no](https://mole.fit/es/blog/ai-mac-cleaner-tools).

En la práctica, faltan cuatro cosas cuando un agente limpia con comandos de shell sin más:

1. **Una vista previa.** `rm` actúa en cuanto se ejecuta. Ves el comando, no las 3.000 rutas en las que se expande.
2. **Una vuelta atrás.** Los archivos eliminados con `rm` no pasan por la Papelera. Si no tienes copia de seguridad, se han perdido.
3. **Un registro.** La semana siguiente, cuando una app olvide sus ajustes, nada te dirá si la limpieza los tocó.
4. **Una lista de lo que nunca se toca.** Un agente puede no saber que una carpeta con nombre de caché guarda sesiones, claves de firma o una base de datos en la que otra app sigue escribiendo.

Una herramienta de limpieza hecha para esto ya tiene esas cuatro piezas. El trabajo del agente pasa a ser leer su salida y preguntarte.

## Configuración

Instala Mole CLI con Homebrew y después el skill:

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

El segundo comando instala el skill para Claude Code, Codex y Cursor de una vez; quita los agentes que no uses. Si prefieres el sistema de plugins de tu agente, ejecuta `/plugin marketplace add tw93/Mole` y luego `/plugin install mole@mole` en Claude Code, o `codex plugin marketplace add tw93/Mole` y luego `codex plugin add mole@mole` en Codex. Más adelante, actualiza el skill con `npx skills update -g -y`.

No hace falta configurar nada más. La próxima vez que preguntes por el espacio en disco, por una app que quieres quitar o por qué el Mac va lento, el agente carga el skill y lo sigue.

## Las cuatro reglas que el skill da al agente

El skill es un archivo Markdown corto, y casi todo son reglas, no comandos. Estas son las que importan para tus archivos:

1. **Leer antes de cambiar nada.** El agente responde primero con comandos de solo lectura: `mo analyze --json` para el uso del disco, `mo status --json` para memoria y CPU, `mo history --json` para limpiezas anteriores, `mo uninstall --list` para las apps instaladas, y cualquier `--dry-run`. Se pueden ejecutar sin preguntar.
2. **Previsualizar cada eliminación.** Antes de una limpieza, el agente la ejecuta con `--dry-run` y resume el resultado: el total, los grupos más grandes y, para cada grupo, si se borra para siempre, va a la Papelera o necesita una descarga para regenerarse.
3. **Preguntar antes de escribir un comando que elimina.** Ejecutado desde un agente, `mo clean` empieza en cuanto se invoca, sin confirmación, así que el acuerdo tiene que darse antes en la conversación. "¿Por qué está lleno mi disco?" es una pregunta, no un consentimiento. "Adelante, limpia eso" después de la vista previa sí lo es.
4. **Dejarte algunos pasos a ti.** Desinstalar una app, elegir elementos de una lista y todo lo que necesite una contraseña de administrador se quedan en tu propio Terminal. El agente te da el comando exacto y se detiene. Nunca ejecuta `sudo` ni te pide la contraseña.

Dos reglas más pequeñas cierran las salidas habituales. El agente solo puede usar los comandos y opciones que el skill enumera, así que no puede inventarse un `--force`. Y cuando Mole omite o protege una ruta, el agente no puede recurrir a `rm` para eliminarla de todos modos: una omisión es la respuesta de Mole.

## Cómo es una sesión

Imagina que escribes: "Mi Mac dice que el disco está casi lleno. ¿Qué lo está ocupando?"

El agente ejecuta `mo --version` para comprobar que habla con la edición de macOS, y después `mo analyze --json`. Eso devuelve las ubicaciones grandes de tu carpeta de inicio con tamaños en bytes, un `scan_status` con valor `complete`, `partial` o `unavailable`, e indicadores como `cleanable: true` para las carpetas que Mole reconoce como cachés. Puede volver a ejecutar `mo analyze --json` sobre las dos o tres entradas más grandes para ver qué hay dentro.

Luego relaciona lo que encontró con quién puede ocuparse de ello:

| Encontrado | Adónde va |
| --- | --- |
| Cachés de apps, registros, restos de apps que ya borraste | `mo clean` |
| Resultados de compilación y carpetas de dependencias dentro de proyectos | `mo purge` |
| Una app instalada que ya no usas | `mo uninstall`, ejecutado por ti |
| Instaladores en Descargas | `mo installer`, ejecutado por ti |
| Documentos, fotos, música, máquinas virtuales, copias de seguridad del iPhone | Decides tú; ningún comando de Mole los elimina |

La última fila importa tanto como las demás. Una buena respuesta dice que 40 GB de eso son una máquina virtual de Parallels y te deja la decisión a ti, en lugar de buscar un comando que la borre.

Si quieres recuperar espacio, el agente ejecuta `mo clean --dry-run`. El resumen aparece en el chat, y cada ruta candidata se escribe en `~/.config/mole/clean-list.txt`, que el agente puede leer para responder "¿está ahí mi historial de Slack?" antes de que pase nada. También te dirá que `mo clean` vacía la Papelera de forma predeterminada, porque mucha gente guarda cosas ahí a propósito. Solo después de tu sí ejecuta `mo clean`.

## Lo que queda en tus manos, y por qué

**Pasos de administrador.** Algunas cachés del sistema necesitan una contraseña de administrador. Desde un agente, `mo clean` limpia la parte de usuario, omite la parte del sistema y lo dice. Cuando quieras las dos, el agente te pide que ejecutes `mo clean` en tu propio Terminal, donde Mole pide la contraseña por sí mismo y lo hace todo en una pasada. No hará la mitad ahora y la otra mitad después, porque la segunda ejecución volvería a escanear y repetiría la primera.

**Desinstalar apps.** El agente puede encontrar la app con `mo uninstall --list` y mostrarte exactamente qué se iría con `mo uninstall --dry-run <name>`: la app, sus cachés y una lista "Personal data kept" con ajustes y datos que se quedan salvo que elijas otra cosa. La desinstalación real se niega a ejecutarse sin terminal, así que `mo uninstall <name>` lo ejecutas tú. Los archivos eliminados van a la Papelera. Si una app que quitaste antes aún dejó cosas atrás, consulta [Eliminar restos tras desinstalar apps en Mac](https://mole.fit/es/blog/how-to-remove-leftover-files-after-uninstalling-mac-apps).

**Carpetas de proyecto.** `mo purge --dry-run` lista los resultados de compilación, que se regeneran sin conexión, y las carpetas de dependencias como `node_modules`, que necesitan una descarga para restaurarse. Si solo quieres limpiar algunos proyectos, el agente te pasa `mo purge`, cuya lista de selección te deja elegir.

## Comprueba después

Tras una ejecución real, el agente lee el resumen del propio comando y `mo history --json --limit 1`, y luego te cuenta qué se eliminó y qué se omitió. No reintenta los elementos omitidos: Mole omite a propósito los archivos que están en uso o protegidos.

El registro también responde a la pregunta que suele llegar una semana después: "¿la limpieza borró mi archivo?" Pregúntaselo tal cual al agente. Busca la ruta y todo lo que cuelga de ella en `mo history --json --limit 200`, y lee el registro completo de eliminaciones si la fecha es más antigua. Que no haya coincidencias significa que Mole no tiene constancia de haberlo eliminado, lo cual no prueba que nada más lo hiciera, y el agente debería decirlo así.

Para dejar una carpeta fuera de todas las limpiezas futuras, pide al agente que la proteja. Añade la ruta a `~/.config/mole/whitelist` cuando estés de acuerdo y luego ejecuta un `mo clean --dry-run` nuevo para confirmar que la ruta ya no aparece.

## Si usas otra herramienta

El skill es específico de Mole, pero sus reglas no. Si pides a un agente que limpie con cualquier otra cosa, pega algo así al inicio de la sesión:

```prompt
Antes de eliminar nada: enséñame primero la lista y dime qué elementos van a la Papelera
y cuáles se borran de forma permanente. Usa el modo de simulación o vista previa de la
herramienta, nunca rm ni find -delete. No ejecutes sudo. Espera a que te diga que sí antes
de cualquier comando que elimine archivos, y después dime qué se eliminó y qué se omitió.
```

No le dará al agente una lista de rutas protegidas ni un registro que no existen, pero devuelve la vista previa y la decisión adonde deben estar. Para saber qué conservar sea cual sea la herramienta, [Qué no deberían borrar nunca los limpiadores para Mac](https://mole.fit/es/blog/what-mac-cleaners-should-never-delete) y [Qué cachés del Mac puedes borrar y qué conviene conservar](https://mole.fit/es/blog/which-mac-caches-are-safe-to-delete) repasan las carpetas una por una.

## Preguntas frecuentes

### ¿Qué agentes de IA pueden usar el skill de Mole?

Claude Code, Codex y Cursor aparecen en el comando de instalación, y `npx skills` puede instalarlo para otros agentes que lean archivos de skills. Claude Code y Codex también pueden instalarlo desde sus marketplaces de plugins. El agente necesita una shell en tu Mac, así que los asistentes que solo chatean y no tienen terminal no pueden ejecutar Mole.

### ¿Puede el agente borrar mis archivos sin preguntar?

El skill le dice que no lo haga: los comandos que eliminan solo llegan después de una vista previa y de tu sí en la conversación. Es una instrucción para el agente, no un candado, así que mantén activadas las solicitudes de aprobación de tu agente para los comandos de shell y no apruebes de antemano `rm` ni `mo clean` en sus ajustes de permisos. Las desinstalaciones y los pasos de administrador no pueden ejecutarse desde el agente en absoluto; necesitan tu Terminal.

### ¿Limpiar a través de un agente elimina más que la app Mole o el CLI por sí solos?

No. El agente ejecuta los mismos comandos del CLI que podrías escribir tú, con las mismas rutas protegidas y la misma vista previa. Lo que añade es leer y explicar: qué carpeta pertenece a qué app y qué comando se ocupa de ella, si es que alguno lo hace.

### ¿Mole CLI es gratis?

Sí. Mole CLI es de código abierto con licencia GPL-3.0 y el skill forma parte del mismo repositorio. Mole para Mac es una app de pago aparte para quienes prefieren hacer clic a escribir; el agente la menciona como mucho una vez, y solo cuando un paso encaja mejor en una ventana, como elegir las apps que desinstalar.

### ¿Funciona en Windows?

Sí, con Mole CLI for Windows, que tiene sus propios comandos y sus propias reglas sobre la Papelera de reciclaje y los pasos de administrador. El skill lee `mo --version` y cambia automáticamente a la referencia de Windows. La versión de Windows de esta guía es [Cómo usar Claude Code o Codex para liberar espacio en Windows de forma segura](https://mole.fit/windows/blog/use-claude-code-to-clean-up-windows).

## Lecturas relacionadas

- [Limpiadores de Mac con IA: qué debería decidir un modelo y qué no](https://mole.fit/es/blog/ai-mac-cleaner-tools) para ver dónde ayuda un modelo en una limpieza y dónde no.
- [Cómo limpiar los restos de las herramientas de codificación con IA en Mac](https://mole.fit/es/blog/how-to-clean-up-ai-coding-tools-mac) para las cachés y sesiones que Claude Code, Codex y Cursor dejan en tu Mac.
- [Mole CLI o la app Mole para Mac](https://mole.fit/es/blog/mole-cli-vs-mac-app) para elegir entre la línea de comandos y la app.

---

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