RecPro · Manual de Migração · Série Nº 01

Levar o CCOS pra outra máquina

Toda a operação (inteligência, skills e acessos) reinstalada no computador novo, na ordem certa. O que está no ar continua no ar. Você migra a capacidade de editar, não de manter vivo.

// 00

Onde cada coisa mora

Antes de copiar nada, entenda a divisão. Metade da operação vive na nuvem e não precisa de você. A outra metade só existe no seu disco e precisa viajar.

☁️ Na nuvem, vivo sozinho

nada a copiar, só logar

  • SDRs de WhatsApp (Cloudflare Workers)
  • Dashboards e propostas (*.pages.dev)
  • CRM Supabase (Splash) e Twenty (RecPro)
  • Coletores de formulário (Apps Script → Sheets)
  • WhatsApp pareado na Z-API

💾 No disco, só aqui

tem que copiar

  • A pasta do projeto inteira
  • As skills globais (~/.claude/skills)
  • A memória (~/.claude/.../memory)
  • Os arquivos de segredo (.env, contas.yaml)
Regra de ouro

Git não transporta esta operação. O .gitignore deixa de fora as pastas de trabalho, os .env e o contas.yaml. Um git clone traz só o esqueleto. Migração de verdade é copiar pastas (robocopy, pendrive, nuvem privada).

// 01

No PC antigo: reúna o que viaja

A

A pasta do projeto inteira

Já inclui ccos-ratos/ com clientes, agentes, skills, os .env e o contas.yaml. Copiando a pasta toda, os segredos viajam junto e você pula a recriação manual.

B

As skills globais

C:\Users\Usuario\.claude\skills\ traz ads-ratos, carrossel e nanobanana-ratos. Ficam fora da pasta do projeto e são usadas o tempo todo.

C

A memória

A pasta memory em ~/.claude/projects/c--Users-Usuario-Documents-Thiago-Code/: 55+ arquivos .md + o MEMORY.md. É o cérebro de longo prazo.

D

(Opcional) O histórico de conversas

Os *.jsonl na mesma pasta projects. Só se quiser reabrir conversas antigas. O CLAUDE.md e a memória já resumem o essencial.

Comando pronto no PowerShell do PC antigo (ajuste E:\ pro seu destino):

$dst = "E:\backup-ccos"
robocopy "C:\Users\Usuario\Documents\Thiago Code" "$dst\Thiago Code" /E
robocopy "C:\Users\Usuario\.claude\skills" "$dst\claude-skills" /E
robocopy "C:\Users\Usuario\.claude\projects\c--Users-Usuario-Documents-Thiago-Code\memory" "$dst\memory" /E
// 02

No PC novo: software base

SoftwarePra quêOnde
Claude Coderodar tudoclaude.com/claude-code
Python 3.12skills meta-ads e vídeopython.org (marcar "Add to PATH")
Node.js LTSwrangler (deploy)nodejs.org
ffmpegskill de vídeo (opcional)winget install Gyan.FFmpeg
pip install facebook-business requests faster-whisper
npm install -g wrangler
npx playwright install chromium   # só pra skill de carrossel
// 03

No PC novo: pastas nos lugares

robocopy "E:\backup-ccos\Thiago Code" "C:\Users\SEU_USUARIO\Documents\Thiago Code" /E
robocopy "E:\backup-ccos\claude-skills" "C:\Users\SEU_USUARIO\.claude\skills" /E
robocopy "E:\backup-ccos\memory" "C:\Users\SEU_USUARIO\.claude\projects\c--Users-SEU_USUARIO-Documents-Thiago-Code\memory" /E
Alerta do slug da memória

O nome da pasta c--Users-...-Documents-Thiago-Code é derivado do caminho absoluto. Se você mantiver o mesmo usuário do Windows e o mesmo caminho, a memória carrega sozinha. Se o usuário for diferente, o slug muda: troque Usuario pelo seu usuário no caminho acima. Na dúvida, abra o Claude Code na pasta, veja qual pasta projects\... ele cria e mova a memory pra lá.

// 04

No PC novo: rode o setup guiado

Abra o Claude Code na pasta do projeto e chame:

/setup-ccos

Ele conduz linear e sequencial: roda o diagnóstico, passa acesso por acesso dizendo pra que serve e onde pegar, grava cada chave no .env certo (você só cola quando ele pedir) e valida o Meta Ads ao vivo no fim.

Se você copiou a pasta inteira, os .env já vieram junto e o setup vira uma conferência rápida. Estes são os acessos que ele percorre:

AcessoVai emOnde pegar
arquivo Cloudflareccos-ratos/.envdash.cloudflare.com → API Tokens
arquivo Twenty CRMccos-ratos/.envapp.twenty.com → Developers
arquivo Meta Adsmeta-ads-ratos/.envbusiness.facebook.com → Usuários do sistema
arquivo contas.yamlmeta-ads-ratos/copiar do PC antigo (git-ignored)
nuvem Anthropicsecret do Workerconsole.anthropic.com (só p/ re-deploy)
nuvem Z-APIsecret do Workerapp.z-api.io (só p/ re-deploy)
nuvem Supabasesecret do Workersupabase.com → Settings → API
uso Geminicolada no usoaistudio.google.com/apikey
MCP Gmail / Drive / AgendaClaude Codereconectar no /mcp
// 05

Valide e resolva o gotcha

python ccos-ratos\.claude\skills\setup-ccos\scripts\checar-ambiente.py
python ccos-ratos\.claude\skills\meta-ads-ratos\scripts\setup.py

O primeiro tem que ter tudo obrigatório em [ OK ]. O segundo tem que terminar em "TUDO PRONTO!" listando as contas de anúncio.

Gotcha do deploy (wrangler)

Se npx wrangler falhar em silêncio ou der 'node' não é reconhecido, prefixe o Node no PATH da sessão e chame o binário direto:

$env:PATH = "C:\Program Files\nodejs;$env:APPDATA\npm;" + $env:PATH
& "C:\Program Files\nodejs\npm.cmd" install -g wrangler
& "$env:APPDATA\npm\wrangler.cmd" pages deploy PASTA --project-name=NOME
// 06

Checklist final

Pendência boa de resolver agora

A operação já pedia rotacionar a chave da Anthropic. A troca de PC é o momento ideal: gera uma nova e refaz wrangler secret put ANTHROPIC_API_KEY nos dois Workers de SDR.