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

DesenvolvimentoPublicado 11 min de leitura

Cada vez mais gente abre o Claude Code ou o Codex e digita "meu disco está cheio, descubra por quê". É um bom uso para um agente: ele consegue ler cem pastas, reconhecer que ~/Library/Developer/Xcode/DerivedData é saída de compilação e que ~/Library/Containers/com.tencent.xinWeChat é histórico de conversas, e explicar as duas coisas em palavras simples. A parte arriscada vem um passo depois, quando o mesmo agente escreve um rm -rf com base na própria leitura de uma listagem do du e o executa na sua pasta pessoal. Um comando de shell não tem prévia, não tem Lixeira e não guarda registro do que removeu.

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, a edição gratuita de linha de comando 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 mesmos hábitos funcionam com qualquer ferramenta que tenha um modo de simulação.

Por que um agente não deve apagar arquivos com rm

Um agente é forte nas partes nebulosas de uma limpeza: percorrer uma árvore grande de pastas, atribuir caminhos aos apps a que pertencem e ordenar quais doze de quatro mil itens merecem um olhar. Decidir que um caminho pode ser apagado com segurança é outro tipo de problema. Exige a mesma resposta todas as vezes e uma lista que você possa conferir, e um modelo não oferece nenhuma das duas coisas. O argumento completo está em Limpadores de Mac com IA: o que um modelo deve e não deve decidir.

Na prática, quatro coisas ficam faltando quando um agente limpa com comandos de shell crus:

  1. Uma prévia. rm age assim que roda. Você vê o comando, não os 3.000 caminhos em que ele se expande.
  2. Um caminho de volta. Arquivos removidos com rm não passam pela Lixeira. Se você não tiver backup, eles se foram.
  3. Um registro. Na semana seguinte, quando um app esquecer as configurações, nada vai dizer se a limpeza mexeu nelas.
  4. Uma lista do que nunca tocar. Um agente pode não saber que uma pasta com nome de cache guarda sessões, chaves de assinatura ou um banco de dados em que outro app ainda escreve.

Uma ferramenta de limpeza feita para isso já tem essas quatro partes. O trabalho do agente passa a ser ler a saída dela e perguntar a você.

Configuração

Instale o Mole CLI com o Homebrew e depois a skill:

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

O segundo comando instala a skill para o Claude Code, o Codex e o Cursor de uma vez; tire os agentes que você não usa. Se preferir o sistema de plugins do seu agente, rode /plugin marketplace add tw93/Mole e depois /plugin install mole@mole no Claude Code, ou codex plugin marketplace add tw93/Mole e depois codex plugin add mole@mole no Codex. Para atualizar a skill mais tarde, use npx skills update -g -y.

Não é preciso configurar mais nada. Na próxima vez que você perguntar sobre espaço em disco, um app para remover ou por que o Mac está lento, o agente carrega a skill e segue o que ela diz.

As quatro regras que a skill dá ao agente

A skill é um arquivo Markdown curto, e a maior parte dele são regras, não comandos. Estas são as que importam para os seus arquivos:

  1. Ler antes de mudar qualquer coisa. O agente responde primeiro com comandos somente leitura: mo analyze --json para o uso do disco, mo status --json para memória e CPU, mo history --json para limpezas anteriores, mo uninstall --list para apps instalados, e qualquer --dry-run. Esses podem rodar sem perguntar.
  2. Mostrar a prévia de toda remoção. Antes de uma limpeza, o agente a executa com --dry-run e resume o resultado: o total, os maiores grupos e, para cada grupo, se ele é 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 no momento em que é chamado, sem confirmação, então o acordo precisa acontecer antes, na conversa. "Por que meu disco está cheio?" é uma pergunta, não um consentimento. "Pode limpar esses" depois da prévia é.
  4. Deixar alguns passos com você. Desinstalar um app, escolher itens de uma lista e tudo que precisa da senha de administrador ficam no seu próprio Terminal. O agente passa o comando exato e para. Ele nunca roda sudo e nunca pede a sua senha.

Duas regras menores fecham as rotas de fuga de sempre. O agente só pode usar os comandos e as opções que a skill lista, então não pode inventar um --force. E quando o Mole pula ou protege um caminho, o agente não pode recorrer ao rm para removê-lo mesmo assim: o pulo é a resposta do Mole.

Como é uma sessão

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

O agente roda mo --version para confirmar que está falando com a edição para macOS e depois mo analyze --json. Isso devolve os locais grandes da sua pasta pessoal com tamanhos em bytes, um scan_status com valor complete, partial ou unavailable, e indicadores como cleanable: true para pastas que o Mole reconhece como caches. Ele pode rodar mo analyze --json de novo nas duas ou três maiores entradas para ver o que há dentro.

Depois, relaciona o que encontrou com quem pode cuidar disso:

Encontrado Para onde vai
Caches de apps, logs, sobras de apps que você já apagou mo clean
Saída de compilação e pastas de dependências dentro de projetos mo purge
Um app instalado que você não usa mais mo uninstall, executado por você
Instaladores em Downloads mo installer, executado por você
Documentos, fotos, músicas, máquinas virtuais, backups do iPhone Decisão sua; nenhum comando do Mole remove isso

A última linha importa tanto quanto as outras. Uma boa resposta diz que 40 GB disso são uma máquina virtual do Parallels e deixa a decisão com você, em vez de procurar um comando que a apague.

Se você quiser espaço de volta, o agente roda mo clean --dry-run. O resumo aparece no chat, e cada caminho candidato é gravado em ~/.config/mole/clean-list.txt, que o agente pode ler para responder "meu histórico do Slack está aí?" antes de qualquer coisa acontecer. Ele também avisa que mo clean esvazia a Lixeira por padrão, já que muita gente guarda coisas lá de propósito. Só depois do seu sim ele roda mo clean.

O que fica com você, e por quê

Passos de administrador. Alguns caches do sistema precisam da senha de administrador. A partir de um agente, mo clean limpa a parte do usuário, pula a parte do sistema e avisa. Quando você quiser as duas, o agente pede que você rode mo clean no seu próprio Terminal, onde o próprio Mole pede a senha e faz tudo de uma vez. Ele não vai fazer metade agora e metade depois, porque a segunda execução repetiria a varredura e refaria a primeira.

Desinstalar apps. O agente pode encontrar o app com mo uninstall --list e mostrar exatamente o que sairia com mo uninstall --dry-run <name>: o app, os caches dele e uma lista "Personal data kept" com configurações e dados que ficam, a menos que você escolha outra coisa. A desinstalação de verdade se recusa a rodar sem um terminal, então quem roda mo uninstall <name> é você. Os arquivos removidos vão para a Lixeira. Se um app que você removeu antes ainda deixou coisas para trás, veja Achar sobras na Library depois de desinstalar apps no Mac.

Pastas de projeto. mo purge --dry-run lista a saída de compilação, que se recria offline, e pastas de dependências como node_modules, que precisam de download para voltar. Se você quiser limpar só alguns projetos, o agente passa para você o mo purge, cuja lista de seleção permite escolher.

Confira depois

Depois de uma execução real, o agente lê o resumo do próprio comando e mo history --json --limit 1, e então conta o que foi removido e o que foi pulado. Ele não tenta de novo os itens pulados: o Mole pula de propósito arquivos em uso ou protegidos.

O log também responde à pergunta que costuma aparecer uma semana depois: "a limpeza apagou meu arquivo?" Pergunte exatamente isso ao agente. Ele procura o caminho e tudo que está abaixo dele em mo history --json --limit 200, e lê o log completo de exclusões se a data for mais antiga. Nenhum resultado significa que o Mole não tem registro de ter removido o arquivo, o que não é a mesma coisa que prova de que nada o removeu, e o agente deve dizer isso dessa forma.

Para deixar uma pasta fora de todas as limpezas futuras, peça ao agente que a proteja. Depois que você concordar, ele adiciona o caminho a ~/.config/mole/whitelist e roda um novo mo clean --dry-run para confirmar que o caminho não aparece mais na lista.

Se você usa outra ferramenta

A skill é específica do Mole, mas as regras dela não são. Se pedir a um agente que limpe com qualquer outra coisa, cole algo assim no começo da sessão:

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 dry-run ou de prévia da
ferramenta, nunca rm ou find -delete. Não rode sudo. Espere o meu sim antes de qualquer
comando que remova arquivos e, depois, me diga o que foi removido e o que foi pulado.

Isso não dá ao agente uma lista de caminhos protegidos nem um log que não existe, mas coloca a prévia e a decisão de volta onde devem estar. Para saber o que manter com qualquer ferramenta, O que limpadores de Mac nunca deveriam apagar e Quais caches do Mac dá para apagar com segurança? passam pelas pastas uma a uma.

Perguntas frequentes

Quais agentes de IA podem usar a skill do Mole?

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 Claude Code e o Codex também podem instalá-la pelos seus marketplaces de plugins. O agente precisa de um shell no seu Mac, então assistentes só de chat, sem terminal, não conseguem rodar o Mole.

O agente pode apagar meus arquivos sem perguntar?

A skill diz para ele não fazer isso: comandos que removem só vêm depois de uma prévia e do seu sim na conversa. Isso é uma instrução para o agente, não uma trava, então mantenha ativados os pedidos de aprovação do próprio agente para comandos de shell e não pré-aprove rm ou mo clean nas configurações de permissão dele. Desinstalações e passos de administrador não rodam a partir do agente de jeito nenhum; eles precisam do seu Terminal.

Limpar por meio de um agente remove mais do que o app Mole ou a CLI sozinha?

Não. O agente roda os mesmos comandos da CLI que você poderia digitar, com os mesmos caminhos protegidos e a mesma prévia. O que ele acrescenta é ler e explicar: qual pasta pertence a qual app e qual comando, se houver, cuida dela.

O Mole CLI é gratuito?

Sim. O Mole CLI é de código aberto sob a GPL-3.0, e a skill faz parte do mesmo repositório. O Mole para Mac é um app pago separado para quem prefere clicar a digitar; o agente o menciona no máximo uma vez, e só quando um passo combina mais com uma janela, como escolher apps para desinstalar.

Funciona no Windows?

Sim, com o Mole CLI for Windows, que tem comandos próprios e regras próprias sobre a Lixeira e os passos de administrador. A skill lê mo --version e muda para a referência do Windows automaticamente. A versão para Windows deste guia é Como usar o Claude Code ou o Codex para liberar espaço no Windows com segurança.

Leitura relacionada