💻 Codex App (Desktop) — Onde Você Vai Morar
App nativo Mac/Windows com sessões paralelas, browser embutido, image gen integrado, anotação visual e plugins. É onde você passa 80% do tempo construindo produtos do zero. Recursos exclusivos como anotação visual no browser embutido só existem aqui.
🗺️ Anatomia do App em uma tela
📌 Por que isso importa
No App você roda 4 sessões em paralelo com modelos diferentes, anota direto no browser embutido ("o botão tá desalinhado, conserta") e gera imagem sem sair da tela. Quem só usa CLI ou IDE perde recursos que o App entrega de graça — e que destravam workflows multiagente desde o primeiro projeto.
🖥️ Codex CLI — Agentes em Scripts e CI
Cliente de linha de comando para invocar agentes a partir de scripts shell, hooks de Git, pipelines de CI ou cron jobs. Headless e scriptável. É o que transforma agentes em automações recorrentes — relatórios diários, triagem de issues, geração de changelog.
💡 Quando o CLI vira ouro
Toda tarefa que você faria 2x ou mais pode virar uma linha de CLI. Triagem semanal de PRs, geração de changelog, detecção de TODOs antigos, screenshot regression test. Cada cron de CLI é R$ 200–800 que você não precisa cobrar de hora — o agente trabalha enquanto você dorme.
🧩 Codex IDE Extension — Edição Contextual
Extensão que traz o agente para dentro do editor que você já usa (VS Code, Cursor), com acesso ao buffer aberto, seleção, terminal integrado e file tree. Para edição contextual e refactor — quando você precisa do agente atuando exatamente no que está olhando, sem trocar de janela.
✅ Use a Extensão IDE quando
- ✓Refactor pontual numa função selecionada
- ✓Adicionar testes pra arquivo aberto
- ✓Explicar bloco de código desconhecido
- ✓Renomear variável em todo o projeto
- ✓Já está editando código, só precisa de assistência
✗ Prefira o App quando
- ✗Construir feature do zero (vários arquivos)
- ✗Precisar de browser embutido + screenshot
- ✗Rodar 3+ agentes paralelos no mesmo repo
- ✗Anotação visual em UI
- ✗Image gen integrado ao fluxo
🎯 Regra de bolso
A extensão IDE é cirúrgica; o App é obra completa. Quando você está com um arquivo aberto pensando "preciso só ajustar isso aqui", IDE. Quando o pedido é "constrói uma tela nova", App. Misturar bem economiza 30–40% de troca de contexto.
☁️ Codex Cloud — Agentes Remotos com PR Automático
Você delega a tarefa para um ambiente cloud isolado conectado ao seu repositório GitHub. O agente roda lá, abre PR, e te avisa quando termina. É o que permite multiagente real em escala — você não precisa do laptop ligado, e tarefas longas não bloqueiam seu ambiente local.
🔄 Fluxo Cloud em 4 etapas
Cria task no Codex Cloud apontando pro repo + branch base + descrição.
Sandbox cloud isolado clona, instala, edita, testa. Você fecha o laptop.
Agente abre Pull Request com Summary + Test plan estruturados.
Push notification + email quando termina. Você só revisa e merge.
💡 O multiplicador real
Com Cloud, um diretor consegue 8 tarefas rodando em paralelo enquanto faz outra coisa. Tarefa que demora 40 minutos não bloqueia mais nada. Combinado com @codex review, vira pipeline contínuo: você abre 5 tasks de manhã, no fim do dia tem 5 PRs revisadas esperando merge.
🧠 Modelos: Fast, Standard, High, Extra-High
GPT 5.5 Codex tem quatro níveis de intensidade. Usar Extra-High pra tudo queima usage. Usar Fast pra tarefas complexas dá resultado ruim. Calibrar é otimização direta de custo e qualidade.
| Nível | Velocidade | Custo | Use quando |
|---|---|---|---|
| Fast | ⚡⚡⚡ instantâneo | baixíssimo | 80% das tarefas: edição, refactor, CRUD, testes |
| Standard | ⚡⚡ rápido | médio-baixo | Tarefas com lógica média, debugging guiado |
| High | ⚡ moderado | alto | Arquitetura, integração complexa, bugs sutis |
| Extra-High | 🐢 lento | muito alto | Raciocínio pesado, plano de sistema inteiro, decisão crítica |
📊 Heurística do diretor
Comece sempre em Fast. Se a resposta for fraca, escala pra Standard ou High. Pra plan mode ou decisão de arquitetura no início do projeto, vale ir direto em High. Extra-High é raro: reserve pra problemas que vale a pena pagar 10x mais por 5% de qualidade extra — geralmente não vale.
💰 Plano Ideal: Free, Plus $20, Pro $200
Escolher mal o plano custa caro: ou você fica travado em limite no meio de um projeto, ou paga $200 sem precisar. Casar perfil + plano evita os dois extremos.
Free
- • Modelos Fast/Standard limitados
- • Sem Cloud
- • Cap diário baixo
Plus
- • Fast/Standard ilimitado prático
- • High limitado mas usável
- • Cloud disponível
- • Image gen + browser
Pro
- • Tudo praticamente ilimitado
- • High e Extra-High liberados
- • Cloud sem fila
- • Multiagente sério
💡 A matemática que ninguém faz
Se você cobra R$ 8.000 por um projeto que entrega em 2 semanas, $200/mês de Pro é 2% do faturamento. Brigar com limite do Plus em projeto pago é perder 1 dia de produtividade — mais caro que 1 ano de Pro. Migra pro Pro assim que fechar o segundo cliente.
✅ O que Aprendemos
Próximo Módulo:
1.3 — Setup Completo do Ambiente: conta, GitHub, sandbox, worktrees, banco de dados gratuito e o "hello agentic" que valida tudo de ponta a ponta.