🔑 Conta ChatGPT e Pagamento Internacional
Criação da conta, ativação de método de pagamento internacional, escolha do plano e download do app Codex. A maioria dos brasileiros trava aqui — método de pagamento, validação de telefone. Resolver de uma vez por todas elimina fricção pelo curso inteiro.
📋 Checklist de criação — passo a passo
⚠️ Armadilhas comuns no BR
Cartão Nubank gold/black geralmente passa, mas alguns bancos travam compras OpenAI por padrão. Se rejeitar 2x, abre uma Wise (R$ 0 abertura) e cria um cartão virtual — resolve em 10 minutos. Não vale perder 1 hora brigando com gerente.
🐙 Conectando GitHub e Permissões
Autorização do Codex no seu GitHub via OAuth, escolha de quais repositórios o agente acessa, e configuração de escopos. Configurar permissões corretas evita acidentes e destrava recursos como Codex Cloud e @codex review.
🔐 Modelo mental de escopos
📌 Princípio do menor privilégio
Nunca conceda acesso a "all repositories". Selecione 1 ou 2 repos pra começar. Se o agente precisar mexer em outro, você adiciona em 30 segundos. Repo de cliente em produção: nunca conecte direto — use fork ou repo de staging. Acidente em repo cliente é dano de reputação que não se desfaz.
🔒 Modos de Sandbox: read-only, edit, full-access
Codex permite restringir o que o agente pode fazer no seu sistema. Calibrar por contexto é segurança operacional: full-access em código novo é seguro e mais rápido; em código de produção ou cliente, edit ou read-only protege você de surpresas.
read-only
- ✓ Lê arquivos
- ✗ Não edita
- ✗ Não roda comandos
edit
- ✓ Lê arquivos
- ✓ Edita arquivos
- ⚠️ Pede permissão pra rodar shell
full-access
- ✓ Tudo do edit
- ✓ Roda shell sem pedir
- ✓ Instala pacotes, rede
💡 A regra da pasta nova
Em pasta vazia ou projeto novo do zero, full-access economiza 30% do tempo (sem 50 popups de "posso rodar npm install?"). Em pasta com código antigo, cliente ou produção, fica em edit. Em código que você nunca leu, começa em read-only pro agente explicar, depois sobe.
🌳 Worktrees — 4 Agentes no Mesmo Repo Sem Conflito
Git worktree permite ter múltiplas branches do mesmo repo checadas em pastas diferentes ao mesmo tempo. Cada agente trabalha numa worktree própria, sem pisar no outro. É a base técnica do trabalho multiagente real.
📊 Por que não só "branches separadas"?
Branches normais exigem checkout — você só tem uma checada de cada vez. Com worktrees, 3 agentes editam 3 features simultâneas porque cada uma tem pasta física própria com seu node_modules e build state. Sem isso, é uma fila: você espera o agente A terminar pra começar o B. Com worktrees, é paralelo de verdade.
🗄️ Convex (ou Supabase) — Banco Gratuito
Criação de conta gratuita no Convex (ou Supabase), instalação da CLI, link com seu projeto local e validação. Configurar agora elimina fricção depois — quando o InboxAI da Trilha 4 precisar de banco, é só plugar.
| Critério | Convex | Supabase |
|---|---|---|
| Modelo | Reativo (functions) | Postgres clássico |
| Free tier | 1M function calls/mês | 500MB DB + 2GB transfer |
| Setup com Codex | Excelente | Excelente |
| Realtime nativo | ✓ default | ✓ via channels |
| Auth integrado | via Clerk | ✓ embutido |
| Curva de aprendizado | Suave | Suave (se conhece SQL) |
| Recomendado pro curso | ✓ default | alternativa válida |
💡 Por que Convex como default
Convex foi feito pra agentic dev: schema declarado em TypeScript, function calls que o Codex entende sem doc, e zero config de migrations. Você gasta 8 minutos pra ter um banco funcionando contra 25–30 do Supabase com auth e RLS. Pra o InboxAI funcionar até o fim do curso, Convex é menor caminho.
✅ "Hello Agentic" — Smoke Test End-to-End
Mini-exercício de validação: pedir ao Codex pra criar um arquivo, fazer commit no GitHub e abrir uma PR. Confirma que conta, repo, sandbox e GitHub estão conversando. Se algo está mal configurado, descobre aqui em 5 minutos, não no meio do projeto real.
🧪 Roteiro do smoke test
✅ Definition of Done do Setup
- ✓App Codex abre e loga sem erro
- ✓GitHub aparece nas integrações conectadas
- ✓Worktree criada com sucesso e listada em
git worktree list - ✓Convex CLI instalada e
npx convex devsobe sem erro - ✓PR do hello-agentic aberta no GitHub
- ✓Você sabe alternar entre modo edit e full-access
✅ O que Aprendemos
Próximo Módulo:
1.4 — Seu Primeiro Fluxo Agentic: app de notas com IA, do prompt ao plan mode até a PR revisada por outro Codex. O fluxo profissional inteiro em 60 minutos.