MÓDULO 1.4

⚖️ Por que Claude + Codex juntos

Forças complementares, dinâmica adversarial, custo vs. valor. Por que dois cérebros de IA rendem mais do que um — desde que cada um esteja no papel certo.

6
Tópicos
~6
Minutos
Iniciante
Nível
Conceito
Tipo
1

🟢 Forças do Claude — planejar e estruturar

Claude brilha em organizar pensamento técnico: transformar uma ideia solta em sequência de etapas, escolher uma abordagem coerente, explicar o raciocínio. É um excelente arquiteto — desde que alguém revise depois.

🎯 O que Claude faz bem

  • Estruturar PLAN.md: divide em seções (objetivo, etapas, riscos), nomeia arquivos, esboça contratos
  • Propor abordagem: "vou usar fila assíncrona porque a API parceira é lenta"
  • Explicar o raciocínio: escreve em prosa, não só em listas
  • Integrar feedback: recebe críticas e reescreve com cuidado
2

🔴 Forças do Codex — criticar e questionar

Codex é direto, cético, e olha pelo lado adversarial. Quando lê um plano, procura o que pode dar errado, não o que pode dar certo. Esse tom crítico é exatamente o que o Claude (autor) não consegue ter sobre o próprio trabalho.

🔍 Como Codex lê um plano

  • • "Onde isso falha sob carga?"
  • • "E se o usuário fizer X duas vezes?"
  • • "Como é o rollback?"
  • • "Quem vê quando isso quebra?"
  • • "Que premissa está implícita?"

❌ Como Claude lê o próprio plano

  • • "Talvez seja útil considerar..."
  • • "Em alguns casos, vale revisar..."
  • • "Pode-se também adicionar..."
  • • "Em geral, parece estar bom."
  • • "Se quiser, posso elaborar."

💡 Insight

A diferença não é qualidade do modelo — é papel. Coloque o Claude no lugar do crítico e ele faz crítica fraca. Coloque o Codex no lugar do autor e ele faz plano cru. O Claudex existe pra fixar cada um no papel onde brilha.

3

⚔️ A dinâmica adversarial

O ciclo Claudex é tensão produtiva entre dois cérebros: um defende, o outro ataca. Essa tensão gera melhorias que nenhum dos dois consegue sozinho — assim como advogado vs. juiz produz veredito melhor que advogado sozinho.

1

Claude defende a primeira versão

Escreve com confiança. "Esta é a abordagem." Ele acabou de decidir, então acredita.

2

Codex ataca sem cerimônia

Não sabe que o plano "é do Claude". Trata como qualquer outro plano. Procura furos como missão.

3

Claude vê os achados, não as críticas

Não tem ego envolvido — recebe findings.md como input técnico. Decide o que integrar de forma fria.

4

O plano sai endurecido

Após N rodadas, o plano resistiu a 3 perspectivas adversariais. Não é mais o rascunho confiante — é uma versão testada.

4

💬 Por que insights bastam — Codex sem código

Codex podia escrever código também — mas o Claudex deliberadamente proíbe. Codex só aponta, Claude só autora. A separação não é técnica, é arquitetural — e tem 3 razões.

📐 Por que essa divisão é proposital

  • 1. Coerência do plano: dois autores escrevendo no mesmo PLAN.md geram conflitos de estilo, terminologia e decisões. Um só autor mantém o plano lendo como um documento único.
  • 2. Custo: Codex revisar o plano (texto curto) custa frações do que Codex escrever código (saída longa). O Claudex extrai o sinal mais valioso pelo menor custo.
  • 3. Foco do crítico: se Codex pudesse escrever, ele teria tendência a "consertar" em vez de "apontar". Quando ele só aponta, é forçado a explicar o problema — o que é mais útil pro Claude integrar.

📌 Analogia: revisor de paper

Revisor de paper acadêmico não reescreve o paper. Aponta problemas, sugere referências, questiona método. O autor decide o que mudar. Esse é o modelo do Claudex. Se o revisor virasse co-autor, perderia o ponto de vista externo.

5

💰 Custo vs. valor — vale o investimento?

Cada rodada do Claudex custa tokens — tipicamente 25-30k tokens por rodada. Três rodadas saem em ~80-100k tokens. Pode parecer muito, mas o cálculo de ROI é simples.

🧮 Conta simples

Custo médio de 3 rodadas Claudex:

Tokens:        ~100k (input + output)
Tempo:         ~8-10 minutos
Custo USD:     ~$0.50 a $1.00 (varia por provider)

Custo médio de 1 hora de engenheiro corrigindo retrabalho em produção:

Hora-engenheiro:  ~$50 a $200 (mercado)
Hora de incidente: 5-10× (urgência, oncall)
Custo de bug em prod: incalculável (perda de confiança)

Equivalência: 1 hora de retrabalho evitado paga 50 a 200 ciclos Claudex.

✓ Vale Claudex

  • • Risco de dados
  • • Migração de auth
  • • Feature multi-time
  • • Escopo vago
  • • Cliente sensível

✗ Não vale

  • • Mudar texto
  • • Trocar cor
  • • Renomear arquivo
  • • Ajuste óbvio
  • • Bug pontual
6

🏠 A analogia da planta da casa

Quando você quer construir uma casa, ninguém chama os pedreiros depois do primeiro rabisco. Engenheiros revisam a planta primeiro. O Claudex aplica essa lógica óbvia da construção civil ao desenvolvimento de software — que, por algum motivo, costuma pular o passo.

🔄 Mapeamento direto

Construção civil Software com Claudex
Arquiteto desenha plantaClaude escreve PLAN.md
Engenheiro estrutural revisaCodex (R1 — Engenheiro Sênior)
Especialista em segurança vêCodex (R2 — Segurança)
Responsável de obra validaCodex (R3 — Ops/SRE)
Planta aprovadaPlano travado
Pedreiros constroemClaude executa o plano

💡 Use essa analogia

Quando alguém perguntar "por que tantas rodadas se a IA já gerou o código?", responda com a planta da casa. Em segundos, a pessoa entende — porque ninguém constrói casa em cima de rabisco.

📌 Resumo do Módulo

Claude estrutura, Codex critica — papéis fixos por design.
Modelo único revisa o próprio com viés — dois modelos quebram o viés do autor.
Tensão adversarial gera melhoria — assim como advogado vs. juiz produz melhor decisão.
Codex sem código é proposital — coerência, custo e foco do crítico.
ROI é favorável — 1 hora de retrabalho evitado paga 50-200 ciclos.
Analogia da casa — ninguém constrói prédio em cima de rabisco. Software também não.

Próximo Módulo:

1.5 — 🎯 Quando usar e quando não usar