Se você usa o terminal no Mac e ainda não conhece o Homebrew, está perdendo o recurso que vai mudar sua relação com o macOS. O Homebrew é o gerenciador de pacotes não oficial do Mac — ele permite instalar, atualizar e remover programas e ferramentas de linha de comando com um único comando no terminal, sem precisar ficar procurando instaladores na internet. Este tutorial mostra como instalar, usar e aproveitar ao máximo o Homebrew.
O que é o Homebrew?
O Homebrew é um gerenciador de pacotes open source para macOS (e Linux). Ele funciona de forma parecida com o apt do Ubuntu ou o winget do Windows — você digita o nome do programa, ele baixa, instala e configura tudo automaticamente.
Por que usar o Homebrew:
- Instala ferramentas de linha de comando que não vêm no macOS
- Instala aplicativos gráficos (.app) sem precisar do site do fabricante
- Mantém todos os programas atualizados com um único comando
- Remove programas completamente, sem deixar arquivos residuais
- Gerencia dependências automaticamente
- Tudo em um só lugar — sem precisar de vários sites e instaladores
Requisitos
Antes de instalar o Homebrew, você precisa de:
- macOS Monterey (12) ou superior — versões mais antigas funcionam mas podem ter limitações
- Xcode Command Line Tools — o Homebrew instala automaticamente se não encontrar
- Conexão com a internet
- Espaço em disco — pelo menos 1 GB livre
Para verificar sua versão do macOS: menu Apple → Sobre este Mac.
Parte 1 — Instalando o Homebrew
Passo 1 — Abra o Terminal
Pressione ⌘ + Espaço, digite Terminal e pressione Enter. Ou acesse Finder → Aplicativos → Utilitários → Terminal.
Passo 2 — Execute o comando de instalação
Cole o comando abaixo no terminal e pressione Enter:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Este é o comando oficial do site brew.sh. Nunca use comandos de instalação de fontes desconhecidas.
Passo 3 — Siga o processo de instalação
O instalador vai:
- Mostrar o que será instalado e onde
- Pedir sua senha de administrador — os caracteres não aparecem na tela, isso é normal
- Instalar as Xcode Command Line Tools se necessário (pode demorar alguns minutos)
- Baixar e instalar o Homebrew
Passo 4 — Configurar o PATH (Macs com Apple Silicon)
Se você tem um Mac com chip M1, M2, M3 ou M4, o Homebrew é instalado em /opt/homebrew/ em vez de /usr/local/. Você precisa adicionar o Homebrew ao PATH do seu shell.
O instalador já mostra os comandos necessários ao final — procure a seção “Next steps”. Execute os dois comandos mostrados, que serão parecidos com:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
Em Macs com Intel o PATH já é configurado automaticamente.
Passo 5 — Verificar a instalação
brew --version
Se aparecer algo como Homebrew 4.x.x, a instalação foi bem-sucedida.
Execute também o diagnóstico:
brew doctor
Se aparecer Your system is ready to brew., está tudo certo.
Parte 2 — Conceitos fundamentais
Antes de usar o Homebrew, é importante entender dois conceitos centrais:
Formulae (fórmulas)
São pacotes de ferramentas de linha de comando — programas que rodam no terminal sem interface gráfica. Exemplos: git, node, python, wget, ffmpeg.
brew install git # instala uma formula
Casks
São aplicativos com interface gráfica — os programas .app que você usa normalmente no Mac. Exemplos: Google Chrome, VS Code, Spotify, VLC.
brew install --cask google-chrome # instala um cask
A distinção principal: formula = ferramenta de terminal. cask = aplicativo gráfico com ícone no Launchpad.
Taps
São repositórios externos que estendem a coleção padrão do Homebrew. Empresas e desenvolvedores usam taps para distribuir seus programas via Homebrew.
brew tap hashicorp/tap # adiciona o repositório da HashiCorp
brew install hashicorp/tap/terraform # instala o Terraform do repositório oficial
Parte 3 — Comandos essenciais
Instalar pacotes
brew install nome-do-pacote # instala uma formula
brew install --cask nome-do-app # instala um aplicativo gráfico
brew install git node python wget # instala vários de uma vez
Buscar pacotes
brew search firefox # busca por nome
brew search /^node/ # busca com regex (começa com "node")
Ver informações de um pacote
brew info git # versão, dependências, onde é instalado
brew info --cask visual-studio-code # informações de um cask
Atualizar
brew update # atualiza a lista de pacotes disponíveis
brew upgrade # atualiza todos os pacotes instalados
brew upgrade git # atualiza apenas um pacote específico
brew upgrade --cask # atualiza todos os aplicativos gráficos
Remover pacotes
brew uninstall git # remove uma formula
brew uninstall --cask spotify # remove um aplicativo gráfico
brew autoremove # remove dependências não usadas
brew cleanup # remove versões antigas e cache
Listar o que está instalado
brew list # lista todas as formulas instaladas
brew list --cask # lista todos os casks instalados
brew list --versions # mostra as versões instaladas
Verificar atualizações disponíveis
brew outdated # mostra o que tem atualização disponível
brew outdated --cask # verifica apps gráficos desatualizados
Parte 4 — Ferramentas essenciais para instalar
Ferramentas de desenvolvimento
# Controle de versão
brew install git
# Linguagens de programação
brew install python
brew install node
brew install ruby
brew install go
brew install rust
# Gerenciadores de versão
brew install nvm # gerencia versões do Node
brew install pyenv # gerencia versões do Python
# Banco de dados
brew install postgresql
brew install mysql
brew install redis
brew install sqlite
# Containers e DevOps
brew install docker
brew install kubectl
brew install terraform
brew install awscli
Ferramentas de terminal
# Shell melhorado
brew install zsh
brew install fish
# Terminal mais poderoso
brew install --cask iterm2
# Utilitários essenciais
brew install wget
brew install curl
brew install htop
brew install tree # mostra estrutura de pastas em árvore
brew install jq # processa JSON no terminal
brew install tldr # manuais simplificados de comandos
brew install fzf # busca fuzzy no terminal
brew install ripgrep # busca em arquivos (mais rápido que grep)
brew install bat # substituto do cat com syntax highlighting
brew install eza # substituto moderno do ls
brew install neofetch # informações do sistema com visual bonito
Aplicativos gráficos populares
# Navegadores
brew install --cask google-chrome
brew install --cask firefox
brew install --cask brave-browser
# Editores e IDEs
brew install --cask visual-studio-code
brew install --cask sublime-text
brew install --cask jetbrains-toolbox
# Produtividade
brew install --cask notion
brew install --cask obsidian
brew install --cask rectangle # gerenciador de janelas
brew install --cask alfred # launcher avançado (alternativa ao Spotlight)
brew install --cask raycast # launcher moderno e gratuito
# Comunicação
brew install --cask slack
brew install --cask discord
brew install --cask zoom
# Mídia
brew install --cask vlc
brew install --cask spotify
brew install --cask iina # melhor player de vídeo para Mac
# Utilitários do sistema
brew install --cask appcleaner # desinstala apps sem deixar resíduos
brew install --cask imageoptim # comprime imagens sem perda de qualidade
brew install --cask the-unarchiver # abre qualquer tipo de arquivo compactado
brew install --cask stats # monitora CPU, RAM e rede na barra de menu
Parte 5 — Gerenciando versões com o Homebrew
O Homebrew permite instalar e alternar entre versões diferentes de uma mesma ferramenta.
Instalar versão específica
brew install node@18 # instala o Node.js versão 18
brew install python@3.11 # instala Python 3.11
Alternar entre versões
brew unlink node # desativa a versão atual
brew link node@18 # ativa a versão 18
Fixar uma versão para não atualizar
brew pin node # impede que o Node seja atualizado
brew unpin node # volta a permitir atualizações
Parte 6 — Brewfile — salvando e restaurando seu ambiente
O Brewfile é um arquivo de texto que lista todos os pacotes e apps que você quer instalar. É como um requirements.txt do Python, mas para o seu Mac inteiro. Extremamente útil para configurar um Mac novo rapidamente.
Gerar um Brewfile com tudo que está instalado
brew bundle dump --file=~/Brewfile
Exemplo de Brewfile
# Repositórios adicionais
tap "homebrew/bundle"
tap "homebrew/cask-fonts"
# Ferramentas de terminal
brew "git"
brew "node"
brew "python"
brew "wget"
brew "htop"
brew "tree"
brew "bat"
# Aplicativos gráficos
cask "google-chrome"
cask "visual-studio-code"
cask "spotify"
cask "slack"
cask "rectangle"
cask "appcleaner"
# Fontes
cask "font-fira-code"
cask "font-jetbrains-mono"
Instalar tudo do Brewfile de uma vez
brew bundle install --file=~/Brewfile
Guarde seu Brewfile no iCloud ou em um repositório Git. Quando trocar de Mac, basta rodar um comando e tudo estará instalado.
Parte 7 — Homebrew e fontes tipográficas
O Homebrew também permite instalar fontes de programação — muito úteis para desenvolvimento.
# Instalar fontes populares para desenvolvimento
brew install --cask font-fira-code
brew install --cask font-jetbrains-mono
brew install --cask font-source-code-pro
brew install --cask font-hack-nerd-font # inclui ícones para o terminal
brew install --cask font-meslo-lg-nerd-font # usada no Oh My Zsh
Após instalar, as fontes ficam disponíveis em todos os aplicativos do Mac — incluindo VS Code, iTerm2 e editores de texto.
Parte 8 — Manutenção e boas práticas
Rotina de atualização recomendada
Execute estes comandos periodicamente (semanal ou quinzenal):
brew update && brew upgrade && brew upgrade --cask && brew cleanup && brew doctor
Ou um por um para ver melhor o que está sendo feito:
brew update # atualiza a lista de pacotes
brew upgrade # atualiza ferramentas de terminal
brew upgrade --cask # atualiza aplicativos gráficos
brew cleanup # remove versões antigas e libera espaço
brew doctor # verifica problemas na instalação
Verificar espaço usado pelo Homebrew
brew info --analytics # desativa telemetria se quiser
du -sh $(brew --cellar) # espaço usado pelas formulas
du -sh $(brew --caskroom) # espaço usado pelos casks
Liberar espaço em disco
brew cleanup --prune=all # remove todos os arquivos antigos e cache
Parte 9 — Desinstalando o Homebrew
Se precisar remover o Homebrew completamente:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
O script remove o Homebrew e todos os arquivos instalados por ele. Os aplicativos instalados via --cask ficam na pasta /Applications e precisam ser removidos manualmente ou com o AppCleaner.
Problemas comuns e soluções
brew: command not found após a instalação O PATH não foi configurado corretamente. Execute:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
source ~/.zprofile
Erro de permissão em /usr/local
sudo chown -R $(whoami) /usr/local/share/zsh /usr/local/share/zsh/site-functions
brew doctor mostra avisos Leia cada aviso com atenção — o Homebrew geralmente já sugere o comando para corrigir. A maioria dos avisos é inofensiva.
App instalado via cask não abre — “desenvolvedor não verificado” Vá em Configurações do Sistema → Privacidade e Segurança e clique em Abrir assim mesmo para o app bloqueado.
Atualização travada ou com erro
brew update --force
brew upgrade --force
Resumo — Comandos de referência rápida
| Comando | O que faz |
|---|---|
brew install pacote | Instala uma ferramenta |
brew install --cask app | Instala um app gráfico |
brew uninstall pacote | Remove um pacote |
brew update | Atualiza a lista de pacotes |
brew upgrade | Atualiza tudo instalado |
brew search termo | Busca um pacote |
brew info pacote | Informações do pacote |
brew list | Lista o que está instalado |
brew outdated | Mostra o que tem atualização |
brew cleanup | Remove versões antigas |
brew doctor | Verifica a saúde do Homebrew |
brew bundle dump | Gera o Brewfile |
brew bundle install | Instala tudo do Brewfile |
brew pin pacote | Fixa versão atual |
Dica final: Crie um Brewfile logo após configurar seu Mac com tudo que você usa. Suba para o GitHub ou iCloud. Da próxima vez que trocar de Mac ou precisar formatar, um único comando —
brew bundle install— vai restaurar todos os seus programas em minutos. É uma das melhores práticas que qualquer usuário de Mac pode adotar.