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

DesarrolloPublicado 11 min de lectura

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.

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:

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.

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:

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 y Qué cachés del Mac puedes borrar y qué conviene conservar 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.

Lecturas relacionadas