Guia de Configuracao - macOS

Idioma: Portugues (BR) | English | Espanol

Este guia cobre a configuracao completa de um ambiente de desenvolvimento no macOS. O Homebrew e a base de tudo -- praticamente todas as ferramentas serao instaladas por ele.

Dica: Este guia funciona tanto em Macs com Apple Silicon (M1/M2/M3/M4) quanto com Intel. Diferencas especificas serao indicadas quando necessario.

1. Pre-requisitos

Versao do macOS

Recomenda-se macOS Ventura (13) ou superior. Versoes anteriores podem funcionar, mas nao sao garantidas.

Xcode Command Line Tools

As ferramentas de linha de comando do Xcode sao necessarias para compilar pacotes e usar o Git:

xcode-select --install

Uma janela de dialogo vai aparecer pedindo confirmacao. Clique em Instalar e aguarde a conclusao.

Dica: Voce nao precisa instalar o Xcode completo (que ocupa ~12 GB). As Command Line Tools (~2 GB) sao suficientes.

Verificar Arquitetura

# Verificar se e Apple Silicon ou Intel
uname -m
# arm64 = Apple Silicon (M1/M2/M3/M4)
# x86_64 = Intel

2. Homebrew

O Homebrew e o gerenciador de pacotes essencial para macOS. Praticamente todas as ferramentas deste guia serao instaladas por ele.

2.1 Instalar o Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2.2 Adicionar ao PATH

Apos a instalacao, o Homebrew exibe instrucoes para adicionar ao PATH. Siga-as:

Apple Silicon (M1+):

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel:

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

2.3 Verificar

brew --version
brew doctor

Dica: Execute brew doctor periodicamente para verificar se seu Homebrew esta saudavel e se nao ha problemas de configuracao.

3. Terminal & Shell

3.1 Emulador de Terminal

O macOS vem com o Terminal.app, que funciona bem. Mas se voce quiser uma experiencia mais completa, considere o iTerm2:

brew install --cask iterm2

Caracteristica	Terminal.app	iTerm2
Split panes	Nao	Sim
Busca avancada	Basica	Completa
Perfis	Limitado	Avancado
Hotkey window	Nao	Sim
Ligatures	Nao	Sim
GPU rendering	Nao	Sim

3.2 Instalar o Fish Shell

brew install fish

3.3 Definir como Shell Padrao

# Adicionar o fish a lista de shells validos
echo $(which fish) | sudo tee -a /etc/shells

# Definir como shell padrao
chsh -s $(which fish)

Aviso: Feche e reabra o terminal para a mudanca ter efeito.

3.4 Instalar o Starship

brew install starship

3.5 Configurar o Fish

mkdir -p ~/.config/fish

Crie o arquivo ~/.config/fish/config.fish:

# ============================================================
# Fish Shell Configuration
# ============================================================

# --- Homebrew (necessario no macOS) ---
eval "$(/opt/homebrew/bin/brew shellenv)"  # Apple Silicon
# eval "$(/usr/local/bin/brew shellenv)"   # Intel (descomente se necessario)

# --- Prompt ---
starship init fish | source

# --- Version Manager ---
mise activate fish | source

# --- Smart Navigation ---
zoxide init fish | source

# --- Fuzzy Finder ---
fzf --fish | source

# --- Aliases (eza) ---
alias lz "eza --color=always --long --no-filesize --icons=always --no-time --no-user --no-permissions"
alias lsz "eza --color=always --long --no-filesize --icons=always --no-time --no-user -la"
alias lt "eza --tree --icons"

# --- PATH ---
export PATH="$HOME/.local/bin:$PATH"

Aviso: No macOS com Apple Silicon, e necessario adicionar a linha do brew shellenv antes das outras inicializacoes, pois as ferramentas instaladas pelo Homebrew ficam em /opt/homebrew/bin. No Intel, o caminho e /usr/local/bin e geralmente ja esta no PATH.

3.6 Configurar Fonte no Terminal

Terminal.app:

Abra Terminal > Preferencias (Cmd + ,)
Aba Perfis > selecione seu perfil
Clique em Alterar na secao de fonte
Selecione JetBrainsMono Nerd Font, tamanho 14

iTerm2:

Abra iTerm2 > Settings (Cmd + ,)
Profiles > Text
Em Font, selecione JetBrainsMono Nerd Font
Tamanho: 14
Marque Use ligatures se desejar

4. Docker Desktop

4.1 Instalar

brew install --cask docker

Ou baixe diretamente de https://www.docker.com/products/docker-desktop/.

Aviso: Selecione a versao correta para seu processador:

Apple Silicon (M1/M2/M3/M4): Docker Desktop for Mac with Apple Silicon

Intel: Docker Desktop for Mac with Intel chip

4.2 Configuracao Inicial

Abra o Docker Desktop (ele vai pedir permissoes de sistema)
Aceite os termos de uso
Aguarde a inicializacao do Docker Engine

4.3 Configurar Recursos

Va em Docker Desktop > Settings > Resources:

Recurso	Recomendacao
CPUs	Metade dos nucleos disponiveis
Memory	4-8 GB (dependendo da RAM total)
Swap	2-4 GB
Disk image size	64 GB ou mais

Dica: Em Macs com Apple Silicon, o Docker roda nativamente via virtualizacao Apple (Virtualization.framework), o que e significativamente mais rapido do que em Intel.

4.4 Verificar

Abra o terminal e teste:

docker --version
docker compose version
docker run hello-world

5. Visual Studio Code

5.1 Instalar

brew install --cask visual-studio-code

5.2 Adicionar ao PATH

Para usar o comando code no terminal:

Abra o VS Code
Pressione Cmd + Shift + P
Digite "Shell Command: Install 'code' command in PATH"
Selecione a opcao

5.3 Importar Configuracoes

Copie os arquivos de configuracao:

# Diretorio de configuracao do VS Code no macOS
mkdir -p ~/Library/Application\ Support/Code/User

# Copiar settings
cp config/vscode/settings.json ~/Library/Application\ Support/Code/User/settings.json

# Copiar keybindings
cp config/vscode/keybindings.json ~/Library/Application\ Support/Code/User/keybindings.json

5.4 Instalar Extensoes

code \
  --install-extension ms-python.python \
  --install-extension ms-python.vscode-pylance \
  --install-extension ms-python.debugpy \
  --install-extension ms-python.isort \
  --install-extension ms-python.pylint \
  --install-extension ms-python.mypy-type-checker \
  --install-extension ms-python.vscode-python-envs \
  --install-extension ms-vscode.vscode-typescript-next \
  --install-extension golang.go \
  --install-extension bmewburn.vscode-intelephense-client \
  --install-extension zobo.php-intellisense \
  --install-extension mehedidracula.php-constructor \
  --install-extension phproberto.vscode-php-getters-setters \
  --install-extension robberphex.php-debug \
  --install-extension vue.volar \
  --install-extension prisma.prisma \
  --install-extension batisteo.vscode-django \
  --install-extension bradlc.vscode-tailwindcss \
  --install-extension csstools.postcss \
  --install-extension digitalbrainstem.javascript-ejs-support \
  --install-extension zignd.html-css-class-completion \
  --install-extension william-voyek.vscode-nginx \
  --install-extension redhat.vscode-xml \
  --install-extension redhat.vscode-yaml \
  --install-extension mikestead.dotenv \
  --install-extension docker.docker \
  --install-extension ms-vscode-remote.remote-containers \
  --install-extension ms-vscode-remote.remote-ssh \
  --install-extension ms-vscode-remote.remote-ssh-edit \
  --install-extension ms-vscode-remote.vscode-remote-extensionpack \
  --install-extension ms-vscode.remote-explorer \
  --install-extension ms-vscode.remote-repositories \
  --install-extension ms-vscode.remote-server \
  --install-extension ms-kubernetes-tools.vscode-kubernetes-tools \
  --install-extension github.codespaces \
  --install-extension github.remotehub \
  --install-extension eamodio.gitlens \
  --install-extension donjayamanne.githistory \
  --install-extension mhutchie.git-graph \
  --install-extension github.vscode-pull-request-github \
  --install-extension github.vscode-github-actions \
  --install-extension github.copilot \
  --install-extension github.copilot-chat \
  --install-extension esbenp.prettier-vscode \
  --install-extension dbaeumer.vscode-eslint \
  --install-extension editorconfig.editorconfig \
  --install-extension firsttris.vscode-jest-runner \
  --install-extension orta.vscode-jest \
  --install-extension vitest.explorer \
  --install-extension antfu.vite \
  --install-extension github.github-vscode-theme \
  --install-extension dracula-theme.theme-dracula \
  --install-extension pkief.material-icon-theme \
  --install-extension naumovs.color-highlight \
  --install-extension oderwat.indent-rainbow \
  --install-extension alefragnani.bookmarks \
  --install-extension alefragnani.project-manager \
  --install-extension gruntfuggly.todo-tree \
  --install-extension humao.rest-client \
  --install-extension ritwickdey.liveserver \
  --install-extension formulahendry.code-runner \
  --install-extension streetsidesoftware.code-spell-checker \
  --install-extension streetsidesoftware.code-spell-checker-portuguese-brazilian \
  --install-extension ms-vsliveshare.vsliveshare \
  --install-extension vsls-contrib.gistfs \
  --install-extension mongodb.mongodb-vscode \
  --install-extension ms-ossdata.vscode-pgsql \
  --install-extension wakatime.vscode-wakatime \
  --install-extension leonardssh.vscord

5.5 Instalar Fonte JetBrains Mono

brew install --cask font-jetbrains-mono-nerd-font

A fonte sera instalada automaticamente no sistema. O VS Code ja esta configurado para usa-la no settings.json.

6. Neovim

6.1 Instalar

brew install neovim

6.2 Verificar

nvim --version

6.3 Distribuicoes (Opcional)

Para uma experiencia de IDE completa no terminal, considere:

Distribuicao	Descricao
LazyVim	Configuracao moderna e rapida
NvChad	Interface bonita e minimalista
AstroNvim	IDE completa e estetica

Dica: Para iniciantes em Neovim, o LazyVim oferece a melhor experiencia inicial com o minimo de configuracao.

7. Ferramentas Essenciais

Para detalhes completos sobre cada ferramenta, consulte o Guia de Ferramentas Essenciais.

7.1 mise

brew install mise

Configurar ferramentas:

mkdir -p ~/.config/mise

Crie ~/.config/mise/config.toml:

[tools]
eza = "latest"
node = "lts"

mise install

7.2 eza

brew install eza

7.3 zoxide

brew install zoxide

7.4 fzf

brew install fzf

7.5 Verificar

mise --version
eza --version
zoxide --version
fzf --version

Dica: No macOS, praticamente tudo pode ser instalado via brew. Use brew search <nome> para encontrar qualquer pacote.

8. AI no Terminal

8.1 Claude Code CLI

# Garantir Node.js via mise
mise install node@lts

# Instalar Claude Code
npm install -g @anthropic-ai/claude-code

# Verificar
claude --version

8.2 Gemini CLI

# Instalar Gemini CLI
npm install -g @google/gemini-cli

# Verificar
gemini --version

Dica: Na primeira execucao, cada ferramenta vai solicitar autenticacao com sua respectiva chave de API.

9. Git

9.1 Configuracao

O Git ja vem com o Xcode Command Line Tools. Configure-o:

git config --global user.name "seu-usuario"
git config --global user.email "seu-email@exemplo.com"
git config --global init.defaultBranch main
git config --global core.editor nvim
git config --global core.autocrlf input
git config --global pull.rebase true

Ou copie o .gitconfig deste repositorio:

cp config/git/.gitconfig ~/.gitconfig
git config --global user.name "seu-usuario"
git config --global user.email "seu-email@exemplo.com"

Os aliases incluidos:

git st     # git status
git co     # git checkout
git br     # git branch
git cm     # git commit
git lg     # git log bonito com grafico

9.2 Chave SSH

# Gerar chave SSH
ssh-keygen -t ed25519 -C "seu-email@exemplo.com"

# Adicionar ao Apple Keychain
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

# Configurar o SSH para usar o Keychain automaticamente
cat >> ~/.ssh/config << 'EOF'
Host github.com
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519
EOF

# Copiar chave publica para a area de transferencia
pbcopy < ~/.ssh/id_ed25519.pub

Acesse GitHub > Settings > SSH Keys e cole a chave.

# Testar conexao
ssh -T git@github.com

Dica: O macOS tem integracao nativa com o Keychain, entao voce so precisa digitar a senha da chave SSH uma vez. O --apple-use-keychain cuida do resto.

Checklist Final

Verifique se tudo esta funcionando:

# Homebrew
brew --version

# Shell
fish --version
starship --version

# Docker
docker --version
docker compose version

# Editores
code --version
nvim --version

# Ferramentas
mise --version
eza --version
zoxide --version
fzf --version

# AI
claude --version
gemini --version

# Git
git --version
ssh -T git@github.com

Voltar ao Inicio | Ferramentas Essenciais

FilesExpand file tree

mac.md

Latest commit

History