# Limpeza do Homebrew: como liberar o espaço que o brew ocupa no Mac > O que o brew cleanup remove e mantém, como limpar o cache de downloads, remover dependências órfãs e versões antigas e medir o espaço do Homebrew. - URL: https://moreroom.app/pt/learn/homebrew-cleanup - Published: 2026-10-17 - Updated: 2026-10-17 - Publisher: MoreRoom (Yando Pte. Ltd.) — https://moreroom.app ## TL;DR - Por padrão, o brew cleanup remove versões antigas das fórmulas instaladas, arquivos de bloqueio obsoletos e downloads com mais de 120 dias. - O brew cleanup --prune=all também remove todos os downloads em cache, seja qual for a idade; execute antes brew cleanup -n para pré-visualizar. - O brew autoremove desinstala as dependências de que nenhuma fórmula instalada precisa mais. - O Homebrew fica em /opt/homebrew nos Macs com Apple silicon e em /usr/local nos Macs Intel; o cache de downloads fica em ~/Library/Caches/Homebrew. - O brew uninstall --zap remove um app instalado como cask junto com os ajustes e arquivos de suporte, que podem incluir arquivos compartilhados com outros apps. O Homebrew guarda as versões antigas do que você atualiza e um cache do que baixa, então vai crescendo aos poucos. **O `brew cleanup` remove versões antigas e downloads com mais de 120 dias; o `brew cleanup --prune=all` esvazia por completo o cache de downloads; o `brew autoremove` desinstala as dependências de que mais nada precisa.** Os três são comandos oficiais, e nenhum deles toca na versão atual de algo que você usa. Os comandos e valores padrão abaixo vêm do [manual do Homebrew](https://docs.brew.sh/Manpage), em outubro de 2026 (Homebrew 7). ## Onde o Homebrew guarda seus arquivos | O quê | Apple silicon | Intel | |---|---|---| | Prefixo (`brew --prefix`) | `/opt/homebrew` | `/usr/local` | | Fórmulas instaladas (`brew --cellar`) | `/opt/homebrew/Cellar` | `/usr/local/Cellar` | | Casks (`brew --caskroom`) | `/opt/homebrew/Caskroom` | `/usr/local/Caskroom` | | Cache de downloads (`brew --cache`) | `~/Library/Caches/Homebrew` | `~/Library/Caches/Homebrew` | O macOS 27 Golden Gate só roda em Apple silicon, então as instalações novas usam `/opt/homebrew`. Os Macs Intel, que ficam no macOS 26 Tahoe ou anterior, continuam usando `/usr/local`. Um Mac migrado de um modelo Intel pode ter os dois; o `brew --prefix` mostra qual está ativo. Os apps instalados como cask ficam em `/Applications`, como qualquer outro app. ![Como o cache de downloads, o Cellar e os casks do Homebrew correspondem aos comandos de limpeza](https://moreroom.app/learn/img/homebrew-cleanup-anatomy.svg) ## Meça antes de limpar ```sh du -sh "$(brew --cache)" du -sh "$(brew --cellar)" du -sh "$(brew --cellar)"/* | sort -h | tail -20 ``` As duas primeiras linhas mostram o tamanho do cache de downloads e de todas as fórmulas instaladas. A terceira lista as 20 maiores fórmulas. Cada pasta dentro do Cellar contém uma subpasta por versão instalada, então o `brew list --versions` mostra quais fórmulas têm mais de uma. ## brew cleanup: o que remove e o que mantém ```sh brew cleanup -n brew cleanup ``` O `brew cleanup -n` (ou `--dry-run`) lista cada arquivo que seria removido e termina com uma estimativa do espaço que seria liberado. Nada é apagado. Depois, o `brew cleanup` simples: - remove as **versões antigas** das fórmulas instaladas, mantendo a atual; - remove **arquivos de bloqueio obsoletos** e **downloads desatualizados** de fórmulas e casks; - remove **qualquer download com mais de 120 dias**. A variável `HOMEBREW_CLEANUP_MAX_AGE_DAYS` muda esse número. Por padrão, ele também remove as dependências que não são mais necessárias, como o `brew autoremove`, a menos que você defina `HOMEBREW_NO_AUTOREMOVE`. Para limpar uma única fórmula ou cask, informe o nome: `brew cleanup node`. ### Indo além com --prune ```sh brew cleanup --prune=all ``` O `--prune` recebe um número de dias e remove todos os arquivos de cache mais antigos que isso; o `--prune=all` os remove seja qual for a idade. O `-s` (`--scrub`) também remove os downloads das versões mais recentes, mas ainda mantém os downloads das fórmulas e casks instalados no momento. A própria ajuda do Homebrew observa que `rm -rf "$(brew --cache)"` remove até esses. O cache só guarda downloads, então qualquer uma dessas opções é segura; o Homebrew baixa de novo o que precisar. Todas essas exclusões são definitivas: nada vai para o Lixo. ### Limpeza automática O Homebrew já faz uma certa limpeza por conta própria. Depois de `brew install`, `brew upgrade` e `brew reinstall`, ele limpa as fórmulas envolvidas e, a cada 30 dias (`HOMEBREW_CLEANUP_PERIODIC_FULL_DAYS`), limpa tudo. Se você definir `HOMEBREW_NO_INSTALL_CLEANUP` no perfil do shell, isso nunca acontece, o que explica um Cellar cheio de versões antigas. Remova a variável ou execute `brew cleanup` de vez em quando. Para proteger fórmulas específicas, liste-as em `HOMEBREW_NO_CLEANUP_FORMULAE`. ## Remova as dependências de que nada precisa Quando você desinstala uma fórmula, as bibliotecas que ela trouxe podem ficar para trás. ```sh brew autoremove -n brew autoremove ``` O `brew autoremove` desinstala as fórmulas que foram instaladas só como dependências e de que mais nada precisa. A versão com `-n` mostra a lista antes. ## Desinstale o que você não usa mais ```sh brew leaves --installed-on-request brew uninstall ``` O `brew leaves` lista as fórmulas das quais nada mais depende, e o `--installed-on-request` (`-r`) restringe a lista às que você mesmo instalou. Normalmente é a lista mais curta para revisar. Desinstalar uma fórmula a remove do Cellar de vez; reinstalá-la exige baixá-la de novo. ### Casks e --zap ```sh brew uninstall --cask brew uninstall --zap ``` Uma desinstalação normal remove o app. O `--zap` também remove os arquivos que a definição do cask lista como pertencentes ao app, como preferências, caches e pastas de suporte em `~/Library`. O manual do Homebrew avisa que ele **pode remover arquivos compartilhados entre aplicativos**, então use-o só para apps que você tem certeza de que quer eliminar junto com os ajustes. Para apps que não foram instalados pelo Homebrew, veja [como desinstalar apps do Mac por completo](https://moreroom.app/learn/uninstall-mac-apps-completely). ### Antes de desinstalar, veja o que depende da fórmula ```sh brew uses --installed ``` Esse comando lista as fórmulas e os casks instalados que precisam daquela que você vai remover. Se a lista não estiver vazia, o Homebrew se recusa a desinstalá-la, a menos que você acrescente `--ignore-dependencies`, o que pode quebrar esses pacotes. Em geral, é melhor deixar as bibliotecas compartilhadas em paz e deixar o `brew autoremove` recolhê-las quando nada mais precisar delas. ## Por que o Homebrew pode continuar grande depois da limpeza A limpeza remove sobras, e não os pacotes que você usa. Toolchains, compiladores e frameworks grandes são pesados por natureza, e cada um pode trazer dezenas de dependências. Se o Cellar continuar grande, o terceiro comando `du` acima mostra quais fórmulas dominam. Desinstale as que você não usa mais e depois execute `brew autoremove` para que as dependências delas também saiam. ## Confira o resultado ```sh brew doctor ``` O `brew doctor` verifica se há possíveis problemas na instalação e termina com um erro se encontrar algum. A maioria dos avisos é só informativa, mas é um bom passo final depois de uma limpeza ou de uma migração para um Mac novo. ## Como o MoreRoom ajuda A versão gratuita do MoreRoom reconhece o cache de downloads e o Cellar do Homebrew e mostra o tamanho de cada um. O cache de downloads é marcado como “Seguro remover” e o Cellar como “Revisar antes”. Quando você limpa qualquer um deles, o MoreRoom executa o próprio comando do Homebrew, `brew cleanup --prune=all`, que remove versões antigas e downloads em cache, mas nunca os pacotes que você usa. Esse comando é definitivo e está sinalizado como tal. O MoreRoom não desinstala fórmulas nem casks por você; para isso, use `brew uninstall`. O Pro acrescenta o Coletor, para limpar vários itens de uma vez, e o modo meta, que escolhe a seleção mais segura para o espaço de que você precisa. ## FAQ ### O brew cleanup é seguro? Sim. Ele só remove versões antigas de fórmulas que já têm uma versão mais nova instalada, arquivos de bloqueio obsoletos e downloads antigos em cache. As versões atuais de tudo o que você instalou continuam no lugar e funcionando. ### O Homebrew faz a limpeza sozinho? Em parte. Depois de brew install, upgrade ou reinstall, ele limpa as fórmulas envolvidas, e a cada 30 dias faz uma limpeza completa. Definir HOMEBREW_NO_INSTALL_CLEANUP desativa isso. ### Posso apagar ~/Library/Caches/Homebrew? Sim. Essa pasta só guarda downloads, e o Homebrew os baixa de novo se precisar. O brew cleanup --prune=all é a forma organizada; a própria ajuda do Homebrew menciona rm -rf "$(brew --cache)" para remover até os downloads dos pacotes instalados. ### Qual é a diferença entre brew autoremove e brew cleanup? O brew cleanup remove versões antigas e downloads em cache do que você ainda usa. O brew autoremove desinstala fórmulas inteiras que foram instaladas só como dependências e de que mais nada precisa. ### Onde o Homebrew está instalado no meu Mac? Em /opt/homebrew nos Macs com Apple silicon e em /usr/local nos Macs Intel. Execute brew --prefix para ver o seu.