Setup Mac M1

Instalação do ambiente de desenvolvimento. Clica em "COPIAR" em cada comando, depois cola no Terminal (Cmd+V) e aperta Enter.

Como usar: cada bloco abaixo tem um botão "COPIAR". Clica, vai no Terminal do Mac, cola com Cmd+V e aperta Enter. Quando o comando terminar, volta aqui e faz o próximo. Não pula etapas.

⚡ MEMÓRIA · BAIXAR E INSTALAR

Baixar memória fresca do Claude (bypass OneDrive)

Baixa a memória direto desta página e instala em ~/.claude/projects/C--Users-Maca/memory — independe de sincronização do OneDrive. 60 arquivos, 290KB. Instantâneo.

mkdir -p ~/.claude/projects/C--Users-Maca && curl -fsSL https://mac-setup-maca.pages.dev/claude-memory.tar -o /tmp/claude-memory.tar && cd ~/.claude/projects/C--Users-Maca && rm -rf memory && tar -xf /tmp/claude-memory.tar && mv Claude-Memory-Maca memory && ls memory | wc -l && echo "OK memoria instalada"

Esperado: sai um número (deve ser 60) e a mensagem OK memoria instalada.

ETAPA 01 · TROCAR PARA ZSH

Trocar shell padrão para zsh

O Mac abriu com bash antigo. Precisamos trocar para zsh antes de instalar o Homebrew.

chsh -s /bin/zsh

Vai pedir senha. Digita a senha da conta maca e Enter. A senha não aparece na tela — é normal.

Depois: fecha a janela do Terminal (Cmd+Q) e abre de novo (Cmd+Espaço → Terminal). Agora o prompt muda de $ para %.

ETAPA 02 · INSTALAR HOMEBREW

Instalar Homebrew (gerenciador de pacotes)

Comando oficial do Homebrew. Vai pedir senha, vai baixar Xcode Command Line Tools (5-10 min), depois instala Homebrew.

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

Atenção: durante a instalação vai aparecer vários prompts pedindo Enter ou senha. Aceita tudo. Se aparecer pop-up pedindo para instalar "Command Line Tools" → clica em Install.

Quando terminar, o Homebrew vai imprimir 2 linhas pra adicionar ao PATH. São os comandos 2a e 2b abaixo.

ETAPA 02a · ADICIONAR HOMEBREW AO PATH

Adicionar Homebrew ao PATH (Apple Silicon M1)

Esses dois comandos fazem o shell encontrar o comando brew.

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

Teste se funcionou: digita brew --version no Terminal. Deve mostrar algo como "Homebrew 4.x.x".

ETAPA 03 · INSTALAR FERRAMENTAS BASE

Instalar Git, Node, Python e GitHub CLI

Tudo de uma vez em um único comando. Vai levar 5-10 minutos dependendo da velocidade da internet.

brew install git node python@3.12 gh

Durante a instalação: vão rolar muitas linhas de texto. Normal. Espera terminar (quando o prompt voltar a aparecer).

ETAPA 04 · INSTALAR CLAUDE CODE

Instalar Claude Code via npm

Claude Code é o CLI que a gente usa para conversar aqui.

npm install -g @anthropic-ai/claude-code

Se der "permission denied": roda o comando 4a abaixo e depois volta e roda o 4 de novo.

ETAPA 04a · FIX PERMISSION (SÓ SE PRECISAR)

Corrigir permissão do npm

Só roda se o comando 4 deu erro de "permission denied" ou "EACCES".

sudo chown -R $(whoami) ~/.npm

Vai pedir senha da conta maca. Depois volta e roda o comando 4 de novo.

ETAPA 05 · CONFIGURAR GIT

Configurar identidade do Git

Define nome e email que vão aparecer nos commits.

git config --global user.name "Fabio Macarroni"
git config --global user.email "f_macarroni@hotmail.com"
git config --global init.defaultBranch main

ETAPA 06 · DETECTAR ONEDRIVE

Descobrir onde o OneDrive está instalado

Esse comando descobre o caminho do OneDrive no teu Mac e salva como variável de ambiente.

if [ -d ~/Library/CloudStorage ]; then
  ONEDRIVE=$(ls -d ~/Library/CloudStorage/OneDrive* 2>/dev/null | head -1)
elif [ -d ~/OneDrive ]; then
  ONEDRIVE=~/OneDrive
fi
echo "ONEDRIVE=$ONEDRIVE"
ls "$ONEDRIVE" | grep -i peritopro
echo "export ONEDRIVE=\"$ONEDRIVE\"" >> ~/.zprofile
source ~/.zprofile

O que esperar: deve listar algo como PeritoPro-Git e Claude-Memory-Maca.

Se não aparecer nada: significa que o OneDrive ainda não baixou as pastas. Volta no app OneDrive, deixa sincronizar mais um pouco e roda esse comando de novo.

ETAPA 07 · CLONE DO PROJETO

Clonar PERITOPRO do bare repo

Baixa o código do projeto do OneDrive para o Desktop.

mkdir -p ~/Desktop/PROJETO\ CLAUDE
cd ~/Desktop/PROJETO\ CLAUDE
git clone "$ONEDRIVE/PeritoPro-Git/peritopro.git" PERITOPRO
cd PERITOPRO
git log --oneline | head -5

O que esperar: vai mostrar uma lista curta de commits. Significa que clonou.

ETAPA 08 · INSTALAR CLAUDE NO MEMORY

Rodar Claude uma vez para criar a pasta de memória

Antes de criar o symlink da memória, o Claude precisa ter criado a própria pasta. Esse comando só abre, digita "oi" e sai.

claude

Dentro do Claude: ele vai pedir para fazer login. Segue o fluxo (pode abrir navegador). Depois digita "oi" e pressiona Enter. Depois digita /exit ou aperta Ctrl+C para sair.

ETAPA 09 · CRIAR OS 3 SYMLINKS

Conectar pastas do OneDrive ao projeto e à memória do Claude

Esse é o passo mágico que faz o projeto funcionar. Conecta 3 pastas do OneDrive aos lugares certos.

cd ~/Desktop/PROJETO\ CLAUDE/PERITOPRO
ln -s "$ONEDRIVE/PeritoPro-Assets/dropbox-import" dropbox-import 2>/dev/null || echo "dropbox-import: OneDrive ainda não baixou (ok, opcional)"
mkdir -p rag-pipeline
ln -s "$ONEDRIVE/PeritoPro-Outputs/rag-pipeline-output" rag-pipeline/output 2>/dev/null || echo "rag-pipeline/output: OneDrive ainda não baixou (ok, opcional)"
CLAUDE_DIR=$(find ~/.claude/projects -maxdepth 1 -type d -name "*maca*" 2>/dev/null | head -1)
echo "Claude dir: $CLAUDE_DIR"
if [ -n "$CLAUDE_DIR" ] && [ -d "$CLAUDE_DIR/memory" ]; then
  mv "$CLAUDE_DIR/memory" "$CLAUDE_DIR/memory.backup-$(date +%Y%m%d)"
fi
if [ -n "$CLAUDE_DIR" ]; then
  ln -s "$ONEDRIVE/Claude-Memory-Maca" "$CLAUDE_DIR/memory"
  echo "Memory symlink criado: $CLAUDE_DIR/memory"
  ls "$CLAUDE_DIR/memory" | head -5
fi

O que esperar: no final deve aparecer "Memory symlink criado" e uma lista com arquivos MEMORY.md, feedback_*.md, etc.

ETAPA 10 · TESTE FINAL

Teste: abrir Claude e retomar projeto

Teste final para ver se tudo funcionou.

cd ~/Desktop/PROJETO\ CLAUDE/PERITOPRO
claude

Dentro do Claude, digita: vingadores retomar ou peritopro retomar. Se o Claude responder com contexto do projeto, funcionou tudo. 🎉