Ir para o conteúdo

Tradução automática

Este artigo foi traduzido automaticamente a partir da versão original em inglês.

Configuração de MacBook para Engenharia de IA: ferramentas macOS, Python, Docker e fluxo de trabalho no terminal

Esta é a minha checklist para transformar uma instalação limpa de macOS numa workstation para engenharia de IA: ferramentas de linha de comandos, Homebrew, Python, Docker, predefinições de terminal e configuração do editor.

1. Instalar as Xcode Command Line Tools

xcode-select --install

Isto abre uma caixa de diálogo que o orienta ao longo da instalação.

2. Instalar o Homebrew

Homebrew é o gestor de pacotes que uso para tudo o resto nesta lista:

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

O instalador pede a sua palavra-passe e adiciona-se ao seu PATH.

3. Instalar as ferramentas base

brew install openssl readline sqlite3 xz zlib pyenv uv htop gitmoji pandoc ncdu tmux

Agrupadas, aproximadamente, por finalidade:

Ambiente Python

  • pyenv — gerir várias versões de Python em paralelo
  • uv — gestor de pacotes Python rápido e gestor de ambientes

Bibliotecas de sistema

  • openssl — suporte de criptografia SSL/TLS
  • readline — edição de texto em linha de comandos
  • sqlite3 — base de dados embebida leve
  • xz — compressão de dados
  • zlib — biblioteca de compressão

Ferramentas de produtividade

  • htop — monitor visual do sistema e visualizador de processos
  • tmux — gerir várias sessões de terminal
  • ncdu — analisar utilização de disco de forma interativa
  • gitmoji — adicionar emojis às mensagens de commit
  • pandoc — converter documentos entre formatos

Para mais sobre o próprio uv, veja o meu guia rápido sobre como gerir Python no macOS com uv.

4. Escolher um terminal

O Terminal predefinido do macOS é suficiente. Usei iTerm2 durante anos e, recentemente, mudei para Warp, um terminal baseado em Rust com funcionalidades de IA integradas. Pode obter o Warp no respetivo site.

Opcional: configuração do iTerm2

Se ficar pelo iTerm2, estas são as duas definições que altero sempre:

Ativar edição de texto natural

  1. Preferences → Profiles → Keys → Key Mappings
  2. Clique no menu suspenso Presets…
  3. Selecione "Natural Text Editing"

Escolher um tema de cores

  1. Veja temas em iTerm2-Color-Schemes
  2. Preferences → Profiles → Colors → Color Presets…
  3. Clique em Import e selecione o tema que descarregou

5. Configurar o Zsh com Oh My Zsh

O macOS usa Zsh por predefinição. Oh My Zsh adiciona boas predefinições e um sistema de plugins por cima:

brew install zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

O instalador faz uma cópia de segurança da sua configuração Zsh atual antes de a substituir pela nova.

6. Adicionar plugins ao Zsh

Edite o seu ~/.zshrc para carregar estes plugins:

plugins=(
    aws bgnotify brew docker docker-compose
    emoji forklift gcloud git history iterm2
    keychain kubectl macos pre-commit
    pyenv pylint python screen themes
    tmux virtualenv vscode
    zsh-autosuggestions zsh-syntax-highlighting
)

As descrições de todos eles estão na wiki de plugins do Oh My Zsh.

Os últimos dois precisam de uma instalação separada:

Siga as instruções de instalação em cada repositório.

7. Aplicar um tema com Powerlevel10k

Powerlevel10k é o tema Zsh que uso. Mostra a diretoria de trabalho, o estado do git e o ambiente Python ativo no prompt, e tem um assistente interativo para ajustar o aspeto. As instruções de instalação estão na página GitHub.

Tipos de letra noutros editores

Se usar VSCode ou outro editor com terminal integrado, defina o tipo de letra do terminal para que os ícones do Powerlevel10k sejam apresentados corretamente:

  1. Abra as definições do seu editor
  2. Procure terminal.integrated.fontFamily
  3. Defina-o como MesloLGS NF (instalado juntamente com o Powerlevel10k)

A configuração completa dos tipos de letra está no guia de tipos de letra do Powerlevel10k.

8. Editor e assistentes de IA

Acabo sempre por ter um IDE aberto e uma ou duas ferramentas de IA a correr ao lado.

IDEs

  • Cursor — um fork de VSCode com programação em par com IA integrada
  • VSCode — o que tem o enorme catálogo de extensões

Assistentes de IA

  • OpenAI Codex — geração e conclusão de código da OpenAI
  • Claude — assistente da Anthropic; o que escolho para tarefas mais difíceis

Hoje em dia é Cursor com Codex e Claude Code a correr em paralelo.

9. O resto

Alguns extras que instalo em todas as máquinas:

10. Esta é a configuração

É isto que instalo em todos os novos MacBook antes de começar trabalho a sério. Ajuste ao seu gosto.