Aula 8.1 · Workspace Remoto: sua equipe num servidor na nuvem

Você vai conseguir: abrir um workspace que roda num VPS (servidor na nuvem) em vez da sua máquina — e reconectar a qualquer hora, mesmo depois de fechar o Overclock, sem perder nada.

Por que usar um servidor em vez do seu computador?

Quando você roda um squad de 4 agentes na sua máquina, eles consomem CPU, RAM e energia. Se fechar o computador, o trabalho para.

Com um workspace remoto:

O trabalho acontece num servidor que fica ligado 24/7
Você fecha o Overclock, vai dormir — os agentes continuam
Quando voltar, o Overclock reanexa à sessão exatamente onde ela estava (usa tmux por baixo dos panos — um gerenciador de sessão clássico de servidores Linux)
A sua máquina mal sente a carga — ela só exibe o que está acontecendo lá

Pré-requisitos

Antes de começar, você precisa:

Um servidor Linux com acesso SSH (um VPS barato da Hetzner, DigitalOcean, AWS EC2, etc. é suficiente)
Acesso SSH por chave (sem digitar senha — o Overclock exige BatchMode=yes)
tmux instalado no servidor (sudo apt install tmux no Ubuntu/Debian)
O CLI desejado instalado no servidor (ex.: claude — o mesmo que você usa localmente)

💡 Se você nunca configurou acesso SSH por chave, o resumo é: gerar um par de chaves na sua máquina (ssh-keygen), copiar a chave pública pro servidor (ssh-copy-id usuario@ip-do-servidor). Peça a um assistente no Overclock para te guiar — basta descrever o que você quer fazer.

Passo a passo

Passo 1 — Criar um apelido de host no seu Mac

O Overclock usa apelidos do arquivo ~/.ssh/config para identificar servidores. Você precisa criar uma entrada lá.

Abra um pane de shell no Overclock e peça:

PROMPT

Adicione uma entrada no meu ~/.ssh/config para o servidor [SEU-IP-AQUI], 
com usuário [SEU-USUÁRIO], porta 22, e o apelido "meuservidor".
Use a chave em ~/.ssh/id_rsa (ou o caminho correto da minha chave).

O assistente vai criar (ou editar) o ~/.ssh/config com algo como:

PROMPT

Host meuservidor
    HostName 111.222.333.444
    User ubuntu
    Port 22
    IdentityFile ~/.ssh/id_rsa
    ServerAliveInterval 15
    ServerAliveCountMax 3

Por que ServerAlive*? Para detectar conexões mortas por NAT/firewall em ~45 segundos em vez de ficar travado pra sempre. O Overclock já configura isso automaticamente nos seus tuneís, mas ter no ~/.ssh/config também garante que outros usos do SSH funcione bem.

Teste a conexão antes de avançar:

PROMPT

Teste a conexão SSH com o apelido "meuservidor" e me mostre se consigo conectar.

Passo 2 — Preparar o servidor

Peça ao assistente:

PROMPT

Conecte ao servidor "meuservidor" via SSH e verifique se tmux está instalado. 
Se não estiver, instale. Também verifique se o comando "claude" está disponível — 
se não estiver, mostre como instalar.

O assistente vai:

Verificar which tmux e which claude (ou o CLI que você usa)
Instalar o que faltar
Fazer um teste rápido de login do CLI no servidor (ex.: claude --version)

⚠️ O CLI no servidor precisa estar autenticado de forma independente da sua máquina. Cada servidor tem sua própria sessão de login.

Passo 3 — Abrir o workspace remoto no Overclock

Agora vem a parte diferente: em vez de selecionar uma pasta local quando você cria um workspace ou pane, você digita um endereço no formato:

PROMPT

ssh://meuservidor/home/ubuntu/meu-projeto

O formato é sempre: ssh:// + o apelido do host + o caminho absoluto no servidor.

tela de seleção de workspace com campo mostrando o endereço ssh://

— verificar onde exatamente no Overclock você digita esse caminho ao criar um pane ou workspace remoto (pode ser no campo de pasta do workspace, ou em Nova Missão).

Quando o Overclock aceita o endereço:

Ele abre uma conexão SSH com o servidor usando o apelido meuservidor
Cria (ou reanexa a) uma sessão tmux no servidor
Lança o CLI nessa sessão
Você vê o output na grade de panes — como se fosse local

pane aberto mostrando o CLI rodando no servidor, com prompt normal

A mágica: fechar e reconectar

Feche o Overclock. O assistente no servidor continua rodando na sessão tmux — ele não sabe que você fechou o app.

Abra o Overclock de volta, vá ao mesmo workspace remoto, abra um pane: o Overclock detecta a sessão tmux existente e reanexa automaticamente. Você vê o output acumulado e pode retomar.

Mini-vitória 8.1: você fechou o computador, voltou horas depois, e o agente ainda estava lá — esperando você, com o trabalho salvo. Isso é continuidade real. 🎉

Boas práticas de custo e segurança no remoto

Custo:

Servidores básicos (2 vCPU, 4 GB RAM) custam ~$6–10/mês em provedores como Hetzner
Para rodar CLIs de IA, o custo real é o uso da API (tokens) — o servidor em si consome pouco
Desligue o servidor quando não usar (a maioria dos provedores cobra por hora)
Monitore o uso de tokens com o Token Meter antes de lançar squads grandes

Segurança:

Nunca use senha SSH — sempre chave
Não exponha o servidor diretamente à internet sem firewall: limite as portas abertas ao SSH (22) e ao necessário para o projeto
Não deixe credenciais de API em variáveis de ambiente sem proteção — use arquivos de configuração com permissões restritas (chmod 600)
Se o servidor for comprometido, revogue as chaves de API dos CLIs imediatamente