Instalação e configuração

Antes de instalar, verifique se você tem acesso a:

• Conta na organização swl-informatica no GitHub
• Credencial pessoal do banco de dados do CRM — usuário e senha próprios (peça ao Hugo; ver Conectar o banco)
• Acesso ao Google Drive compartilhado swl-clientes
• Token da API Cloudflare (peça ao Hugo ou ao time de infra)
• Assinatura do Claude Code (Pro ou Team — claude.ai/code)

Escolha seu sistema operacional. As ferramentas são as mesmas; muda só a forma de instalar.

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

brew install node git gh
node --version   # deve mostrar v20 ou superior
gh auth login    # GitHub.com → HTTPS → Login with a web browser

ssh-keygen -t ed25519 -C "seu-email@baselabs.com.br"
pbcopy < ~/.ssh/id_ed25519.pub   # copia a chave pública
ssh -T git@github.com            # testa após colar em github.com/settings/keys

npm install -g wrangler @anthropic-ai/claude-code
claude   # na primeira execução, autentica no browser

wsl --install

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs gh
ssh-keygen -t ed25519 -C "seu-email@baselabs.com.br"
cat ~/.ssh/id_ed25519.pub   # copie e cole em github.com/settings/keys
gh auth login

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

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

O swl-crm é o projeto base que todos do time devem ter na máquina — é dele que vêm os comandos /swl-* e a engine de propostas. Clone para ~/src/swl-crm (caminho padrão do time):

git clone git@github.com:swl-informatica/swl-crm.git ~/src/swl-crm

O coração do CRM é o banco de dados. O acesso é feito via psql — o Claude monta as queries em SQL e executa via Bash usando a sua credencial pessoal. Cada pessoa tem usuário próprio, para o banco registrar quem fez cada alteração.

4.1Pegar sua credencial

Peça ao Hugo — ele entrega por canal seguro. Você vai receber:

• Usuário — no formato crm_seu_nome.qeocffkayfgstlyoeltr (o sufixo identifica o projeto no pooler e é obrigatório)
• Senha

Os demais dados de conexão são iguais para todos:

4.2Configurar a variável CRM_PG_URL

Exporte a connection string no seu ~/.zshrc (ou ~/.bashrc), substituindo USUARIO e SENHA:

export CRM_PG_URL="postgresql://USUARIO.qeocffkayfgstlyoeltr:SENHA@aws-1-us-east-2.pooler.supabase.com:5432/postgres?sslmode=require"

Depois recarregue o shell:

source ~/.zshrc

4.3Testar

Confirme que o psql conecta:

psql "$CRM_PG_URL" -c "SELECT count(*) FROM companies;"

Depois abra o Claude e peça algo simples — por exemplo, "quantas empresas temos no CRM?". O uso do dia a dia está na página CRM.

Os comandos /swl-* ficam em ~/src/swl-crm/.claude/commands. Para o Claude reconhecê-los de qualquer diretório, crie um link simbólico para o diretório global do Claude.

mkdir -p ~/.claude
ln -s ~/src/swl-crm/.claude/commands ~/.claude/commands

ls -la ~/.claude/commands   # deve mostrar um link -> .../swl-crm/.claude/commands

Para publicar propostas (não para o CRM), o fluxo usa mais algumas integrações, configuradas uma única vez:

6.1Token Cloudflare

Necessário para publicar. Adicione ao ambiente — no Mac edite ~/.zshrc, no Windows/WSL edite ~/.bashrc:

export CLOUDFLARE_API_TOKEN="seu-token-aqui"
# depois: source ~/.zshrc  (ou ~/.bashrc) e teste com echo $CLOUDFLARE_API_TOKEN

6.2Google Drive e Gmail (Workspace)

O acesso ao Google Workspace (Drive, Gmail, etc.) é feito via MCP servers oficiais — conectores da Anthropic que você habilita uma vez na sua conta Claude. Não é preciso instalar o Google Drive Desktop nem nenhum app local: o Claude manipula o Workspace direto pela API. A instalação tem três passos:

/mcp   # selecione "claude.ai Google Drive" → Authenticate

claude mcp list   # "claude.ai Google Drive: … - ✔ Connected"