# Como usar o Claude Code ou o Codex para liberar espaço no Windows com segurança

Quando o disco C: fica vermelho, cada vez mais gente pede ao Claude Code ou ao Codex que descubra por quê. Um agente é bom nessa parte: ele consegue listar cem pastas, reconhecer que `AppData\Local\npm-cache` é um cache de pacotes e que `Documents\WeChat Files` é histórico de conversas, e explicar as duas coisas em palavras simples. O risco é o passo seguinte, quando o mesmo agente escreve um `Remove-Item -Recurse -Force` ou um `del /s /q` com base na própria leitura dos tamanhos das pastas. Uma aspa ou uma barra invertida errada num comando gerado pode apontá-lo para a pasta errada, e nenhum dos dois comandos pergunta antes, usa a Lixeira ou guarda registro do que fez.

Este guia mostra uma divisão mais segura. O agente lê e explica, uma ferramenta de limpeza com prévia faz a remoção, e você aprova no meio. A ferramenta aqui é o Mole CLI for Windows, a edição gratuita para PowerShell do Mole, junto com a skill oficial para agentes, que ensina o Claude Code, o Codex, o Cursor e outros agentes a usá-lo. Os hábitos valem para qualquer ferramenta com modo de simulação.

## Por que um agente não deve limpar com Remove-Item

Quatro coisas ficam faltando quando um agente limpa com comandos crus do PowerShell ou do cmd:

1. **Uma prévia.** `Remove-Item` age quando roda. Você aprova uma linha, não os milhares de arquivos em que ela se expande. O PowerShell tem `-WhatIf`, mas nada obriga o agente a usá-lo.
2. **Um caminho de volta.** Arquivos removidos assim não passam pela Lixeira.
3. **Um registro.** Quando um app perder as configurações na semana seguinte, nada vai dizer se a limpeza mexeu nelas.
4. **Uma lista do que nunca tocar.** Uma pasta chamada `Cache` pode guardar a sessão de um perfil do navegador, o progresso salvo de um jogo ou um banco de dados em que um app aberto ainda escreve.

Uma ferramenta de limpeza feita para isso já tem as quatro. O trabalho do agente passa a ser ler a saída dela e perguntar a você. Se quiser entender quais pastas importam, [Quais caches do Windows você pode remover?](/pt-br/windows/blog/windows-cache-cleanup) passa por elas uma a uma.

## Configuração

Instale o Mole CLI for Windows com o Scoop e depois a skill:

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

O comando da skill precisa do Node.js e instala a skill para o Claude Code, o Codex e o Cursor; tire os agentes que você não usa. No Claude Code você também pode rodar `/plugin marketplace add tw93/Mole` e depois `/plugin install mole@mole`, e no Codex `codex plugin marketplace add tw93/Mole` e depois `codex plugin add mole@mole`. Use a versão 1.37.0 ou mais recente da CLI: ela trouxe `mo analyze --json` e `mo uninstall --list`, os dois comandos de que um agente mais precisa. `mo --version` mostra qual você tem.

## As quatro regras que a skill dá ao agente

1. **Ler antes de mudar qualquer coisa.** O agente começa com comandos somente leitura: `mo analyze --json` para o uso do disco, `mo status --json` para CPU, memória e discos, `mo history --json` para limpezas anteriores, `mo uninstall --list` para apps instalados e `mo clean --dry-run`. Esses podem rodar sem perguntar.
2. **Mostrar a prévia de toda remoção.** O agente roda a limpeza primeiro com `--dry-run` e a resume: o total, os maiores grupos e se cada um é apagado de vez, vai para a Lixeira ou precisa de um download para ser recriado.
3. **Perguntar antes de digitar um comando que remove.** Executado por um agente, `mo clean` começa na hora, sem confirmação, então o seu sim precisa vir na conversa, depois da prévia.
4. **Deixar alguns passos com você.** Desinstalar apps, listas de seleção e tudo que precisa de um PowerShell de administrador ficam no seu próprio console. O agente passa o comando exato e para. Ele nunca tenta elevar privilégios.

A skill também proíbe inventar opções (o Mole CLI for Windows não tem `--yes` nem `--force`) e proíbe recorrer ao `Remove-Item` para qualquer coisa que o Mole pulou ou protegeu.

## Como é uma sessão

Digamos que você digite: "Meu disco C está quase cheio. O que está ocupando espaço?"

O agente roda `mo --version`, vê `Windows:` na segunda linha e passa para as regras do Windows. Depois, `mo analyze --json` devolve uma visão geral das suas pastas de usuário e das unidades, com tamanhos em bytes, um `scan_status` com valor `complete`, `partial` ou `unavailable`, e `insight: true` em lugares conhecidos por ocupar muito, como Downloads antigos, Temp e caches de gerenciadores de pacotes. Para olhar mais de perto, ele roda `mo analyze --json D:\` ou o caminho da maior pasta.

Em seguida, organiza o que encontrou:

| Encontrado | Para onde vai |
| --- | --- |
| Arquivos temporários, caches de apps e navegadores, logs | `mo clean` |
| Temp do Windows, logs do sistema, relatórios de erros e despejos de memória | `mo clean --system`, executado por você como administrador |
| Saída de compilação e `node_modules` dentro de projetos | `mo purge`, executado por você |
| Um app instalado que você não usa mais | `mo uninstall`, executado por você |
| Documentos, fotos, vídeos, bibliotecas de jogos, máquinas virtuais | Decisão sua; nenhum comando do Mole remove isso |

Então, se você quiser espaço de volta, ele roda `mo clean --dry-run`. Cada caminho candidato vai para `%USERPROFILE%\.config\mole\clean-list.txt`, que o agente pode ler para responder "minhas senhas do Chrome estão aí?" antes de qualquer coisa acontecer. Só depois do seu sim ele roda `mo clean`. No Windows, `mo clean` não esvazia a Lixeira. Replays de jogos e caches de shaders da GPU ficam de fora, a menos que você peça `--game-media` ou `--gpu-shaders`, porque os jogos recriam shaders devagar na próxima vez que abrem.

## O que fica com você, e por quê

**Passos de administrador.** A partir de um agente, `mo clean` cobre só a sua conta de usuário. Para caches do sistema inteiro, abra o PowerShell com "Executar como administrador" e rode `mo clean --system --dry-run`, depois `mo clean --system`. Se a sua conta de administrador for outro usuário do Windows, esse shell tem a própria pasta de perfil, então a whitelist e os logs dele ficam separados dos seus.

**Desinstalar apps.** O agente pode encontrar o app em `mo uninstall --list`, que informa nome, origem (Registro ou Microsoft Store), editor, versão e tamanho de cada app. A desinstalação em si é uma lista de seleção, então você roda primeiro `mo uninstall --dry-run` para ver qual desinstalador cada app usaria, depois `mo uninstall`, e digita para buscar o app. O Mole roda o desinstalador do próprio fabricante, que decide o que remove dentro da pasta dele, e depois move para a Lixeira uma pasta de instalação que sobrou e foi verificada. Alguns desinstaladores mostram o próprio aviso do UAC ou um assistente. Para o que costuma ficar para trás, veja [O que os apps do Windows deixam depois da desinstalação](/pt-br/windows/blog/what-apps-leave-after-uninstall).

**Pastas de projeto e Verificador de Arquivos do Sistema.** `mo purge` abre uma lista de seleção, então roda no seu console. `mo optimize` termina com uma pergunta sobre rodar o Verificador de Arquivos do Sistema, que leva vários minutos; essa resposta também é sua.

## Confira depois

Depois de uma execução real, o agente lê o resumo do comando e `mo history --json --limit 1`, e então conta o que foi removido e o que foi pulado, sem tentar de novo os itens pulados. O histórico fica em `%USERPROFILE%\.config\mole\operations.log`. Prévias não são registradas, então só remoções reais aparecem lá.

Esse log também responde, semanas depois, a "o Mole apagou meu arquivo?". O agente procura o caminho em `mo history --json --limit 200`. Nenhum resultado significa que o Mole não tem registro de ter removido o arquivo, não que nada mais o removeu.

Para deixar uma pasta fora de todas as limpezas futuras, peça ao agente que a proteja. Com a sua concordância, ele adiciona o caminho a `%USERPROFILE%\.config\mole\whitelist.txt`, salvo como UTF-8 com marca de ordem de bytes para que o Windows PowerShell 5.1 leia corretamente caminhos com nomes que não estão em inglês, e confirma com um novo `mo clean --dry-run`.

## Se você usa outra ferramenta

As regras não são específicas do Mole. Com qualquer outra ferramenta, comece a sessão com algo assim:

```prompt
Antes de remover qualquer coisa: me mostre a lista primeiro e diga quais itens vão para a
Lixeira e quais são apagados permanentemente. Use o modo de prévia ou -WhatIf da
ferramenta, nunca Remove-Item -Recurse -Force ou del /s. Não eleve privilégios nem peça
um shell de administrador. Espere o meu sim antes de qualquer comando que remova
arquivos e, depois, me diga o que foi removido e o que foi pulado.
```

## Perguntas frequentes

### Quais agentes de IA podem usar a skill do Mole no Windows?

Claude Code, Codex e Cursor aparecem no comando de instalação, e `npx skills` pode instalar a skill para outros agentes que leem arquivos de skill. O agente precisa de um shell no seu PC; o Windows PowerShell 5.1 e o PowerShell 7 funcionam.

### O agente pode apagar arquivos sem perguntar?

A skill diz para ele mostrar a prévia primeiro e esperar o seu sim, mas isso é uma instrução, não uma trava. Mantenha ativados os pedidos de aprovação do agente para comandos de shell e não pré-aprove `mo clean` ou `Remove-Item` nas configurações dele. Desinstalações e limpeza como administrador não rodam a partir do agente de jeito nenhum.

### Ele vai esvaziar minha Lixeira ou apagar meus jogos salvos?

No Windows, `mo clean` não esvazia a Lixeira e pula mídia de jogos e caches de shaders, a menos que você peça. Jogos salvos e bibliotecas de jogos são dados do usuário que nenhum comando do Mole remove. O desinstalador de um app ainda pode apagar dados dentro da pasta dele, e é por isso que o agente deixa as desinstalações com você.

### O Mole CLI for Windows é gratuito?

Sim, é de código aberto sob a GPL-3.0, e a skill fica no mesmo repositório. O Mole for Windows é um app pago separado, com janela; as diferenças estão em [Mole CLI for Windows vs. Mole for Windows: o que cada um faz](/pt-br/windows/blog/mole-cli-vs-windows-app).

### A mesma configuração funciona num Mac?

Sim. A skill lê `mo --version` e lá usa os comandos do macOS, onde apps desinstalados vão para a Lixeira e `mo clean` a esvazia por padrão. A versão para Mac deste guia é [Como usar o Claude Code ou o Codex para liberar espaço no Mac com segurança](/blog/use-claude-code-to-clean-up-mac).

## Leitura relacionada

- [Disco C cheio no Windows: escolha limpeza, migração ou desinstalação](/pt-br/windows/blog/windows-c-drive-full), sobre para onde o espaço costuma ir.
- [Caches de desenvolvedor no Windows: o que npm, pip e Gradle guardam](/pt-br/windows/blog/windows-developer-caches), sobre npm, pip, Gradle e os outros armazenamentos que ferramentas de programação enchem.
- [Ache o que está enchendo o disco do Windows](/pt-br/windows/blog/find-large-files-on-windows), para fazer a mesma busca à mão.


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