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

Cuando la unidad C: se pone en rojo, cada vez más gente pide a Claude Code o Codex que averigüe por qué. Un agente es bueno en esa parte: puede listar cien carpetas, reconocer que `AppData\Local\npm-cache` es una caché de paquetes y `Documents\WeChat Files` es un historial de chat, y explicar ambas cosas con palabras sencillas. El riesgo es el paso siguiente, cuando ese mismo agente escribe un `Remove-Item -Recurse -Force` o un `del /s /q` a partir de su propia lectura de los tamaños de carpeta. Una comilla o una barra invertida equivocada en un comando generado puede apuntarlo a la carpeta equivocada, y ninguno de los dos comandos pregunta antes, usa la Papelera de reciclaje ni guarda un registro.

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 for Windows, la edición gratuita de Mole para PowerShell, junto con su skill de agente oficial, que enseña a Claude Code, Codex, Cursor y otros agentes a usarla. Los hábitos sirven con cualquier herramienta que tenga un modo de simulación.

## Por qué un agente no debería limpiar con Remove-Item

Faltan cuatro cosas cuando un agente limpia con comandos de PowerShell o cmd sin más:

1. **Una vista previa.** `Remove-Item` actúa en cuanto se ejecuta. Apruebas una línea, no los miles de archivos en los que se expande. PowerShell tiene `-WhatIf`, pero nada obliga al agente a usarlo.
2. **Una vuelta atrás.** Los archivos eliminados así no pasan por la Papelera de reciclaje.
3. **Un registro.** Cuando una app pierda sus ajustes la semana siguiente, nada te dirá si la limpieza los tocó.
4. **Una lista de lo que nunca se toca.** Una carpeta llamada `Cache` puede guardar la sesión de un perfil de navegador, las partidas guardadas de un juego o una base de datos en la que una app en ejecución sigue escribiendo.

Una herramienta de limpieza hecha para esto ya tiene las cuatro. El trabajo del agente pasa a ser leer su salida y preguntarte. Si quieres el contexto de qué carpetas importan, [¿Qué cachés de Windows se pueden quitar?](/es/windows/blog/windows-cache-cleanup) las repasa una por una.

## Configuración

Instala Mole CLI for Windows con Scoop y después el skill:

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

El comando del skill necesita Node.js e instala el skill para Claude Code, Codex y Cursor; quita los agentes que no uses. En Claude Code también puedes ejecutar `/plugin marketplace add tw93/Mole` y luego `/plugin install mole@mole`, y en Codex `codex plugin marketplace add tw93/Mole` y luego `codex plugin add mole@mole`. Usa la versión 1.37.0 o posterior de la CLI: añadió `mo analyze --json` y `mo uninstall --list`, los dos comandos que más necesita un agente. `mo --version` muestra cuál tienes.

## Las cuatro reglas que el skill da al agente

1. **Leer antes de cambiar nada.** El agente empieza con comandos de solo lectura: `mo analyze --json` para el uso del disco, `mo status --json` para CPU, memoria y discos, `mo history --json` para limpiezas anteriores, `mo uninstall --list` para las apps instaladas, y `mo clean --dry-run`. Se pueden ejecutar sin preguntar.
2. **Previsualizar cada eliminación.** El agente ejecuta primero la limpieza con `--dry-run` y la resume: el total, los grupos más grandes y si cada uno se borra para siempre, va a la Papelera de reciclaje o necesita una descarga para regenerarse.
3. **Preguntar antes de escribir un comando que elimina.** Ejecutado desde un agente, `mo clean` empieza al instante y sin confirmación, así que tu sí tiene que llegar en la conversación, después de la vista previa.
4. **Dejarte algunos pasos a ti.** Desinstalar apps, las listas de selección y todo lo que necesite un PowerShell de administrador se quedan en tu propia consola. El agente te da el comando exacto y se detiene. Nunca intenta elevar privilegios.

El skill también prohíbe inventarse opciones (Mole CLI for Windows no tiene `--yes` ni `--force`) y recurrir a `Remove-Item` para cualquier cosa que Mole haya omitido o protegido.

## Cómo es una sesión

Imagina que escribes: "Mi unidad C está casi llena. ¿Qué la está ocupando?"

El agente ejecuta `mo --version`, ve `Windows:` en la segunda línea y cambia a las reglas de Windows. Después, `mo analyze --json` devuelve una vista general de tus carpetas de usuario y unidades, con tamaños en bytes, un `scan_status` con valor `complete`, `partial` o `unavailable`, e `insight: true` en lugares que se sabe que pesan mucho, como Descargas antiguas, Temp y las cachés de gestores de paquetes. Para mirar más de cerca, ejecuta `mo analyze --json D:\` o la ruta de la carpeta más grande.

Luego clasifica lo que encontró:

| Encontrado | Adónde va |
| --- | --- |
| Archivos temporales, cachés de apps y navegadores, registros | `mo clean` |
| Temp de Windows, registros del sistema, informes de errores y volcados de memoria | `mo clean --system`, ejecutado por ti como administrador |
| Resultados de compilación y `node_modules` dentro de proyectos | `mo purge`, ejecutado por ti |
| Una app instalada que ya no usas | `mo uninstall`, ejecutado por ti |
| Documentos, fotos, vídeos, bibliotecas de juegos, máquinas virtuales | Decides tú; ningún comando de Mole los elimina |

Después, si quieres recuperar espacio, ejecuta `mo clean --dry-run`. Cada ruta candidata va a `%USERPROFILE%\.config\mole\clean-list.txt`, que el agente puede leer para responder "¿están ahí mis contraseñas de Chrome?" antes de que pase nada. Solo después de tu sí ejecuta `mo clean`. En Windows, `mo clean` no vacía la Papelera de reciclaje. Las repeticiones de juegos y las cachés de sombreadores de la GPU se quedan fuera salvo que pidas `--game-media` o `--gpu-shaders`, porque los juegos vuelven a generar los sombreadores despacio en el siguiente inicio.

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

**Pasos de administrador.** Desde un agente, `mo clean` solo cubre tu cuenta de usuario. Para las cachés de todo el sistema, abre PowerShell con "Ejecutar como administrador" y ejecuta `mo clean --system --dry-run`, y luego `mo clean --system`. Si tu cuenta de administrador es otro usuario de Windows, esa shell tiene su propia carpeta de perfil, así que su lista blanca y sus registros son distintos de los tuyos.

**Desinstalar apps.** El agente puede encontrar la app en `mo uninstall --list`, que indica de cada app el nombre, el origen (Registro o Microsoft Store), el editor, la versión y el tamaño. La desinstalación en sí es una lista de selección, así que primero ejecutas `mo uninstall --dry-run` para ver qué desinstalador usaría cada app, y luego `mo uninstall` y escribes para buscar la app. Mole ejecuta el desinstalador del propio fabricante, que decide qué elimina dentro de su carpeta, y después mueve a la Papelera de reciclaje una carpeta de instalación sobrante ya verificada. Algunos desinstaladores muestran su propio aviso de UAC o su propio asistente. Para saber qué suele quedarse atrás, consulta [Qué dejan las aplicaciones de Windows después de desinstalar](/es/windows/blog/what-apps-leave-after-uninstall).

**Carpetas de proyecto y Comprobador de archivos de sistema.** `mo purge` abre una lista de selección, así que se ejecuta en tu consola. `mo optimize` termina con una pregunta sobre ejecutar el Comprobador de archivos de sistema, que tarda varios minutos; esa respuesta también es tuya.

## Comprueba después

Tras una ejecución real, el agente lee el resumen del comando y `mo history --json --limit 1`, y luego informa de qué se eliminó y qué se omitió, sin reintentar lo omitido. El historial se guarda en `%USERPROFILE%\.config\mole\operations.log`. Las vistas previas no se registran, así que ahí solo aparecen eliminaciones reales.

Ese registro también responde, semanas después, a "¿Mole borró mi archivo?". El agente busca la ruta en `mo history --json --limit 200`. Que no haya coincidencias significa que Mole no tiene constancia de haberlo eliminado, no que esté probado que nada más lo hiciera.

Para dejar una carpeta fuera de todas las limpiezas futuras, pide al agente que la proteja. Con tu acuerdo, añade la ruta a `%USERPROFILE%\.config\mole\whitelist.txt`, guardado como UTF-8 con marca de orden de bytes para que Windows PowerShell 5.1 lea bien las rutas que no están en inglés, y lo confirma con un `mo clean --dry-run` nuevo.

## Si usas otra herramienta

Las reglas no son específicas de Mole. Con cualquier otra herramienta, empieza la sesión con algo así:

```prompt
Antes de eliminar nada: enséñame primero la lista y dime qué elementos van a la Papelera
de reciclaje y cuáles se borran de forma permanente. Usa el modo de vista previa o -WhatIf
de la herramienta, nunca Remove-Item -Recurse -Force ni del /s. No eleves privilegios ni me
pidas una shell de administrador. 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ó.
```

## Preguntas frecuentes

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

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. El agente necesita una shell en tu PC; funcionan tanto Windows PowerShell 5.1 como PowerShell 7.

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

El skill le dice que muestre primero la vista previa y espere tu sí, pero eso es una instrucción, no un candado. Mantén activadas las solicitudes de aprobación de tu agente para los comandos de shell, y no apruebes de antemano `mo clean` ni `Remove-Item` en sus ajustes. Las desinstalaciones y la limpieza como administrador no pueden ejecutarse desde el agente en absoluto.

### ¿Vaciará mi Papelera de reciclaje o borrará mis partidas guardadas?

`mo clean` no vacía la Papelera de reciclaje en Windows, y omite los archivos multimedia de juegos y las cachés de sombreadores salvo que lo pidas. Las partidas guardadas y las bibliotecas de juegos son datos de usuario que ningún comando de Mole elimina. El desinstalador propio de una app sí puede borrar datos dentro de su carpeta, y por eso el agente te deja a ti las desinstalaciones.

### ¿Mole CLI for Windows es gratis?

Sí, es de código abierto con licencia GPL-3.0, y el skill está en el mismo repositorio. Mole for Windows es una aplicación de pago aparte, con ventana; las diferencias están en [Mole CLI for Windows frente a Mole for Windows: qué hace cada uno](/es/windows/blog/mole-cli-vs-windows-app).

### ¿La misma configuración funciona en un Mac?

Sí. El skill lee `mo --version` y allí usa los comandos de macOS, donde las apps desinstaladas van a la Papelera y `mo clean` la vacía de forma predeterminada. La versión para Mac de esta guía es [Cómo usar Claude Code o Codex para liberar espacio en Mac de forma segura](/blog/use-claude-code-to-clean-up-mac).

## Lecturas relacionadas

- [Unidad C llena en Windows: limpieza, traslado o desinstalación](/es/windows/blog/windows-c-drive-full) para ver adónde suele ir el espacio.
- [Cachés de desarrollo en Windows: npm, pip y Gradle](/es/windows/blog/windows-developer-caches) para npm, pip, Gradle y los demás almacenes que llenan las herramientas de programación.
- [Encuentra qué está llenando tu unidad de Windows](/es/windows/blog/find-large-files-on-windows) para hacer la misma búsqueda a mano.


Canonical: https://mole.fit/es/windows/blog/use-claude-code-to-clean-up-windows