Escolher uma versão

Windows x64Intel ou AMD Windows Arm64Arm / Snapdragon

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

DesenvolvimentoPublicado 10 min de leitura

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? passa por elas uma a uma.

Configuração

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

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.

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:

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.

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.

Leitura relacionada