Codex CLI + Cursor + Claude Code. O ecossistema dev agent.

Por que vale ter os 3 instalados. Setup completo. System prompts que funcionam em produção. Workflow real do brief ao PR.

01 Os 3 dev agents que importam

02 Codex CLI · setup completo

Instalação

# 1. Instala (Mac/Linux)
npm install -g @openai/codex

# 2. Loga com ChatGPT Plus ou API key
codex login

# 3. Verifica
codex --version

Primeiro comando

# Dentro do seu repo
codex "adiciona testes pra src/agents/sdr.py
       cobertura mínima 80%"

# Ele lê o repo inteiro, propõe plano, executa.
# Aprova ou rejeita ação por ação.

Modos de operação

• Suggest (default): mostra proposta, espera você aprovar cada ação.
• Auto-edit: edita arquivos sem confirmar, mas pede aprovação pra rodar comandos.
• Full-auto: roda tudo (perigoso, use em sandbox/branch dedicado).

codex --approval-mode auto-edit \
      "refatora src/lib/ pra usar TypeScript estrito"

03 Cursor · setup pra produtividade

Configurações que importam

1. Modelo padrão: GPT-5 ou Claude Sonnet 4 — Settings → Cursor → Models.
2. Cursor Tab: autocompletar avançado, lê 100+ linhas de contexto.
3. Composer: Cmd+I · modo multi-arquivo. Onde a mágica acontece.
4. Agent mode: Cmd+L + selecionar "Agent" · roda autônomo.
5. .cursorrules: arquivo no repo com regras permanentes pra IA.

Exemplo de .cursorrules

# Padrões deste repo
- TypeScript estrito sempre. Sem `any` sem comentário.
- Imports absolutos: @/lib/..., @/components/...
- Tests em Vitest, não Jest.
- Tailwind v4. Sem CSS-in-JS.
- Cada novo endpoint precisa de test integration.

# Estilo de código
- Funções < 50 linhas.
- Nada de classes a menos que React Component.
- Erros sempre via Result<T, E>, não throw.

# Quando me responder
- Português brasileiro, conciso, sem floreio.
- Mostra diff antes de aplicar mudanças grandes.
- Pergunta antes de adicionar nova dependência.

04 Prompts que funcionam (testados em produção)

Pattern 1 · Feature completa

Adiciona um endpoint POST /api/leads que:

REQUISITOS
- Recebe { nome, email, telefone, fonte }
- Valida com Zod (email regex, telefone E.164)
- Salva em postgres (tabela leads — verifica
  se migration existe)
- Dispara webhook pro Slack #vendas
- Devolve { id, status: "queued" }
- Idempotente: se telefone já existe nos últimos
  7 dias, retorna o id existente sem duplicar

TESTS
- Unit: validação Zod
- Integration: fluxo completo com testcontainers
- E2E: 1 happy path

DOCUMENTAÇÃO
- Atualiza README na seção API.

ESTILO
- Segue o padrão dos endpoints em src/api/.
- Erros via Result<T, E>, não throw.

Pattern 2 · Bug fix com investigação

Há um bug: clientes do tipo "premium" não recebem
o lembrete 24h antes da consulta.

Investiga primeiro — NÃO fica no sintoma.
Identifica a causa raiz.

Quando achar:
1. Mostra a linha exata onde o bug está.
2. Explica por quê.
3. Propõe a correção.
4. Espera minha aprovação.
5. Depois de aprovado, implementa + test que
   cobre esse cenário.

NÃO mexe em mais nada do que o necessário pra
corrigir.

Pattern 3 · Migração

Migra src/ inteira de JavaScript pra TypeScript
estrito.

REGRAS
- 1 PR por subpasta de src/.
- Não muda lógica — só types.
- Erros de type warning ficam em TODO inline
  comentado se forem complexos demais.
- Tests continuam passando 100%.

ANTES DE COMEÇAR
- Lista as subpastas e a ordem que vai migrar.
- Estima esforço por subpasta (linhas).
- Espera minha aprovação da ordem.

Pattern 4 · Code review

Revisa o PR #142.

Procura:
- Bug óbvio
- Regression em performance (queries N+1, loops)
- Inconsistência com padrão do repo
- Test gaps (cobertura caiu?)
- Security: SQL injection, XSS, secrets vazando
- Documentação: README atualizado? CHANGELOG?

Output em formato Markdown, agrupado por severidade.
Cada item: arquivo:linha + sugestão concreta.

05 Workflow real · do brief ao PR em 30 min

1. Brief no GitHub Issue (Markdown, com critério de aceitação claro).
2. Você abre Cursor / Claude Code / Codex no repo.
3. Cola o conteúdo da issue + "executa isso".
4. Agent propõe plano (15-30s). Você revisa.
5. Agent executa em paralelo: escreve código + tests + docs.
6. Roda CI local. Se quebra, agent corrige até passar.
7. Você revisa o diff (5 min).
8. Agent abre PR com descrição auto-gerada.
9. Você dá merge.

Tempo real: 30-60 min por feature média. Você não está codando — está revisando e dirigindo.

06 Comparativo · Claude Code vs Cursor vs Codex

07 Repos pra clonar e adaptar

• openai/codex · CLI oficial. Bom pra ler como funciona por baixo.
• All-Hands-AI/OpenHands · Agent open source. Self-hostable. ★38k+
• aider-AI/aider · Pair programming CLI. Ótimo pra dev solo. ★25k+
• cline/cline · Extension VS Code. Aprova/rejeita ação por ação. ★28k+
• microsoft/vscode-copilot-chat · Chat oficial do Copilot. Bom pra entender a integração.

08 Checklist

• Cursor instalado + .cursorrules no repo principal
• Claude Code testado (1 sessão real, não tutorial)
• Codex CLI logado e rodou 1 task
• 4 prompts patterns acima salvos em snippet manager
• GitHub Issue template criado com formato de brief
• 1 PR de produção mergeado escrito por agent (não só copiar/colar)