🍎 Instalando no Mac

O macOS moderno (Ventura, Sonoma, Sequoia) tem o zsh como shell padrão. Para instalar ferramentas de desenvolvimento, precisamos do Homebrew e das Xcode Command Line Tools.

# Instalar Homebrew (copie e cole no Terminal)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# O instalador pedirá sua senha de usuário
# e instalará as Xcode CLI Tools automaticamente

# Verificar instalação
brew --version
# Esperado: Homebrew 4.x.x

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

No macOS, você pode instalar Node.js via Homebrew ou via nvm. Para uso com Claude Code, ambos funcionam, mas o nvm é recomendado para desenvolvedores que gerenciam múltiplos projetos.

# Instalar Node.js via brew
brew install node

# Verificar
node -v
npm -v

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc

# Instalar Node LTS
nvm install --lts
node -v

# Verificar versões instaladas
node -v    # Deve ser v18 ou superior
npm -v     # Deve ser v9 ou superior

# Verificar onde está instalado
which node
# Via nvm: /Users/usuario/.nvm/versions/node/v20.x.x/bin/node
# Via brew: /opt/homebrew/bin/node (Apple Silicon)
#           /usr/local/bin/node (Intel)

Com Node.js instalado no macOS, o processo de instalação do Claude Code é idêntico ao Linux. Atenção às peculiaridades do Gatekeeper do macOS em primeiros usos.

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

# Verificar instalação
claude --version
which claude

# Se aparecer aviso do Gatekeeper:
# Vá em: Apple Menu → System Settings →
# Privacy & Security → "Allow Anyway"
# OU use xattr para remover o quarantine:
xattr -d com.apple.quarantine $(which claude)

O macOS usa zsh desde o Catalina (2019). O arquivo ~/.zshrc é carregado em cada sessão interativa e é onde configuramos as variáveis de ambiente permanentes.

# Abrir o .zshrc no editor padrão
open -e ~/.zshrc
# OU usar nano:
nano ~/.zshrc

# Adicionar ao FINAL do arquivo:

# === Homebrew (Apple Silicon) ===
eval "$(/opt/homebrew/bin/brew shellenv)"

# === nvm ===
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# === Claude Code ===
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="sk-or-v1-SUA-CHAVE"

# Salvar e aplicar:
source ~/.zshrc

# Verificar qual arquivo está sendo usado:
echo $ZDOTDIR
# Verificar se variáveis estão ativas:
env | grep ANTHROPIC

O macOS tem excelente integração com o Safari para autenticação OAuth. O processo de login é fluido e seguro, com opção de armazenar credenciais no Keychain.

# Configure no .zshrc e aplique:
source ~/.zshrc

# Teste:
claude -p "Olá do macOS!"

claude
# Safari abre → login → token salvo
# Não precisa configurar variável!

O Terminal.app nativo funciona bem com o Claude Code. Mas o iTerm2 oferece uma experiência significativamente melhor com recursos como divisão de painéis, melhor suporte a cores e integração com shells.

# Instalar iTerm2 via Homebrew
brew install --cask iterm2

# Ou baixar em: iterm2.com/downloads.html

# Configurações recomendadas para Claude Code:
# 1. Preferences → Profiles → Colors
#    → Color Presets → Solarized Dark (ou seu tema favorito)
# 2. Preferences → Profiles → Text
#    → Font: JetBrains Mono 13pt
# 3. Preferences → Profiles → Terminal
#    → Report Terminal Type: xterm-256color

# Instalar fonte JetBrains Mono:
brew tap homebrew/cask-fonts
brew install --cask font-jetbrains-mono