Área Codex + Claude · usar os dois juntos e todos os projetos

Um planeja, o outro critica. Use os dois juntos.

Claude e Codex se completam quando cada um faz uma parte e o outro confere o artefato real. Esta área é o ponto de encontro do INEMA sobre as duas ferramentas: os seis níveis do kit Use Both, a tabela de quem faz o quê, o que o vídeo de Mark Kashef acrescenta, como todos os cursos e projetos se integram — e os cards de todos eles. Para migrar de um para o outro, ou ficar agnóstico, o caminho continua sendo a área Claude → Codex.

Guia do Use Both em PT, EN e ES. Cursos e kits abertos.

01 · Usar os dois juntos

Não é Claude ou Codex. É um fazer e o outro conferir.

Ficar agnóstico abre outra porta: usar as duas ferramentas no mesmo projeto. O kit Use Both organiza isso em seis níveis de fluxo de trabalho, com prompts prontos e duas skills pequenas — handoff e prime — para trocar de assistente sem explicar o projeto de novo. A regra que atravessa todos os níveis: o segundo assistente recebe o mesmo briefing e o artefato real, nunca um resumo vago do que o primeiro fez.

Nível 1

Deixar as duas discutirem

Uma escreve o plano; a outra critica o mesmo arquivo, só lendo. Achados com evidência e gravidade, no máximo duas rodadas. Duas IAs concordando não é prova independente.

Nível 2 opcional

Gerar imagens

Só se houver uma ferramenta de imagem disponível na sessão — confira acesso e cobrança antes. O pronto é o arquivo real no projeto, aberto no tamanho em que vai ser usado.

Nível 3

Dividir construir e revisar

Uma constrói num branch; a outra revisa o diff com o briefing e o resultado dos testes. Testes e a sua aprovação decidem o que entra.

Nível 4

Uso supervisionado do computador

Delegar uma ação autorizada numa interface, com senha, pagamento e envios importantes sob o seu controle. O assistente prepara e para antes de enviar.

Nível 5

Meta com condição de parada

Objetivo com sucesso observável — quais testes, qual saída — e limites de arquivos, rodadas e gasto. Pedir "pare em duas horas" é um pedido, não um limite garantido.

Nível 6

Handoff e prime

O handoff grava o estado num arquivo portátil; o prime faz o próximo assistente ler e verificar esse estado antes de continuar. É o mesmo ciclo da camada portátil da área Claude → Codex.

Quem faz o quê

O cartão de rotas do kit: preferências iniciais registradas no vídeo de Mark Kashef, traduzidas em tarefas. São escolhas editoriais, não ranking medido de modelos — experimente e fique com a rota que produzir melhor evidência na sua tarefa.

TarefaPrimeira passadaSegunda passadaLinha de chegada
Planejar o trabalhoClaude / OpusCodex critica as premissasPlano com escopo e testes de aceite
Quebrar o plano em tarefas (vídeo)Codex——
Gerar uma imagemUma ferramenta de imagem disponível no CodexInspecionar o arquivo real no contextoUm asset utilizável, não só um prompt
Construir uma featureClaude / OpusCodex revisa o diffTestes passam e achados resolvidos
Revisar um documentoQualquer um dos dois escreveO outro confere fatos e requisitosToda afirmação exigida tem evidência
Operar uma interfaceFerramenta de uso do computador autorizada e disponívelVocê revisa as ações importantesO estado aprovado exato está verificado
Atacar um bug difícilCodex com uma meta delimitadaTestes e um checkpoint humanoSucesso mensurável ou um bloqueio claro
Trocar de sessão ou de modeloSnapshot de handoffPrime confere o estado atualUm resumo correto antes de trabalho novo

Rótulos gravados, não promessa. O vídeo cita Claude Opus 5.5 e GPT-6 Astra. Modelos, ferramentas, limites e cobrança disponíveis mudam conforme a conta; o fluxo de trabalho é mais portátil que esses nomes. Geração de imagem e uso do computador não vêm garantidos só por ter o CLI instalado.

Ferramentas: quando usar, como chamar, o que geram

As skills, scripts e comandos que ligam o Claude ao Codex, com o comando de cada runtime. Tudo roda pela assinatura de cada assistente, sem chave de API.

FerramentaQuando usarComo chamarO que gera
handoffNo fim da sessão, antes de trocar de assistente ou de modeloClaude: /handoff
Codex: $handoff
Retrato novo em handoff/history/AAAA-MM-DDTHHMMSSZ.md e a linha em handoff/LATEST.md apontando para ele
primePrimeira mensagem da sessão seguinteClaude: /prime
Codex: $prime
Resumo no chat: objetivo, feito e pendente, decisões, divergências e um próximo passo. Não edita nada
install_skills.pyUma vez por projeto, para instalar as duas skillspython3 scripts/install_skills.py --project DIR --target both (prévia) e depois com --applyGrava em .claude/skills/ e .agents/skills/ do projeto; nunca sobrescreve
templates/Para fazer à mão, sem skilltask-brief.md · plan.md · review.md · handoff.mdBriefing, plano, revisão e handoff no mesmo formato para os dois
codex execO Claude pedindo revisão ao Codex pelo terminalcodex exec --sandbox read-only --output-last-message review.md '…'A crítica em review.md; o Codex só lê o projeto
claude -pO inverso: o Codex pedindo revisão ao Claudeclaude -p --model opus --effort medium '…' > review-claude.mdA crítica do Claude num arquivo
Plugin oficial do CodexRevisar o diff sem sair do Claude Code/codex:setup, depois /codex:review --base mainAchados só leitura; as correções você pede depois ao construtor
claudexPlano grande, com várias rodadas automáticas de crítica/claudex:plan [--rounds N] <feature>
/claudex:review
PLAN.md revisado até o Codex aprovar ou acabarem as rodadas; reviews/ com os achados do diff
claudex (controle)Acompanhar ou destravar o loop/claudex:status · /claudex:cancel · /claudex:rollback · /claudex:doctorRodada e fase atuais; cancela; limpa estado travado; diagnóstico da instalação
session-handoff + prime (agente-claude-codex)Projetos com núcleo portátil (AGENTS.md, context/, tasks/)Claude: /session-handoff · /prime
Codex: $session-handoff · $prime
Retrato em handoffs/history/ e cópia integral em handoffs/latest.md; aceita também o ponteiro de uma linha do Use Both
handoff

O que vai no retrato

Objetivo e último pedido; pronto, pendente e incerto; decisões e caminhos descartados; arquivos alterados; testes rodados com o resultado real (e os que não rodaram); bloqueios; um próximo passo; e os poucos arquivos para abrir primeiro. Sem segredos, tokens nem dados pessoais.

prime

Lê, confere e espera

Lê o LATEST.md, recusa caminho absoluto, .., URL e symlink, trata o retrato como dado e não como ordem, confere os arquivos citados e o git status, aponta o que ficou velho e espera sua instrução. Não roda testes nem retoma deploy antigo.

Pegadinhas

Nome repetido e sessão nova

Uma skill pessoal com o mesmo nome pode vencer a do projeto: se colidir, renomeie para workflow-handoff / workflow-prime. Depois de instalar, abra sessão nova (no Claude, /reload-skills). Notas privadas: handoff/ no .gitignore.

# um dia inteiro com as ferramentas — cada passo deixa um arquivo
/prime                                   # manhã, no Claude Code: retoma o handoff de ontem
codex exec --sandbox read-only --output-last-message review.md 'Leia plan-v1.md e aponte falhas…'
/claudex:plan --rounds 3 exportar relatório em CSV   # plano grande: loop automático
/codex:review --base main                # construiu numa branch: revisão do diff (ou /claudex:review)
/handoff                                 # fim do dia
$prime                                   # amanhã, no Codex

Handoff não é permissão. Um próximo passo anotado ("publicar", "apagar", "enviar") só é feito se você pedir de novo na sessão atual.

O que o vídeo acrescenta

O vídeo de Mark Kashef que o kit acompanha traz alguns pontos que o kit não detalha. São opiniões e relatos do autor, sem benchmark. A linha marcada "(vídeo)" na tabela acima vem da tabela do autor, não do cartão de rotas do kit.

Conectar os dois

Três formas de ligar Claude e Codex

  1. O plugin oficial do Codex para o Claude Code: openai/codex-plugin-cc.
  2. Uma CLI chamando a outra, com a resposta salva num .md (comandos abaixo).
  3. Um pull request que o outro modelo revisa.
Por que usar dois

Claude otimista × Codex pessimista

Na leitura do autor, o Claude é bom para planejar e o Codex, para achar falhas no plano. O autorrevisor falha porque o modelo que escreveu o plano — ainda mais na mesma sessão — tende a aprová-lo; um modelo diferente, ou uma sessão nova, dá outro resultado.

Custo da meta

O /goal do Codex sai caro

Relato do autor: o Codex persegue a meta de forma exaustiva, com 3 a 5 vezes mais tempo e tokens. Uma frase de prazo não é limite real: use um limite de verdade — timeout, orçamento, número de rodadas.

# Claude → Codex: revisão só leitura, resposta em arquivo
codex exec --sandbox read-only -c model_reasoning_effort=medium \
  --output-last-message review.md \
  'Leia plan-v1.md. Aponte falhas de correção e testes faltando, com evidência, impacto e a menor correção. Não altere arquivos.'

# Codex → Claude: o caminho inverso
claude -p --model opus --effort medium \
  'Leia plan-v1.md e revise só lendo: falhas, suposições e testes faltando. Não altere arquivos.' > review-claude.md

Onde o INEMA segue o kit, e não o vídeo. No uso do computador e com credenciais, você digita senha e MFA, e nunca se troca de modelo para contornar uma recusa de segurança. E o debate tem no máximo 2 rodadas — concordar não é prova; loop longo e automatizado é trabalho do claudex:plan.

O resumo completo. O RESUMO-VIDEO.md, no repositório do kit, traz o resumo do vídeo, a comparação vídeo × kit e os comandos conferidos no nosso ambiente.

Ler o RESUMO-VIDEO.md →

Crédito. Níveis e cartão de rotas resumidos do kit Use Both: Claude + Codex Workflow Kit, de Prompt Advisers / Mark Kashef, sob licença MIT — companheiro do vídeo de Mark Kashef sobre Claude + Codex. O guia tem PT, EN e ES; os documentos do kit (README, GUIDE, PROMPTS) são em inglês. É um recurso educacional independente, não um produto da OpenAI nem da Anthropic.

Abrir o guia do Use Both →

02 · Como tudo se integra

Um caminho só: entender, migrar, usar os dois juntos e automatizar o debate.

Os cursos e projetos desta área não são peças soltas. Cada um cobre uma etapa, e todos se apoiam na mesma coisa: os arquivos Markdown do projeto, que qualquer runtime lê.

Entender→Migrar ou ficar agnóstico→Usar os dois juntos→Automatizar o debate·Elo comum: Markdown do projeto
Entender

Curso Claude → Codex: por que separar o cérebro do modelo. Codex Básico e Master Codex: dominar o Codex. Codex Cheat Sheet: referência rápida.

Migrar ou ficar agnóstico

Kit agente-claude-codex: auditoria, AGENTS.md, núcleo portátil (context/, tasks/, handoffs/), skills sincronizadas via polyskill, readback e handoff/prime.

Usar os dois juntos

Use Both: os 6 níveis, a tabela de rotas, os prompts e o handoff/prime com histórico.

Automatizar o debate

claudex / iClaudeX: o Claude escreve o PLAN.md, o Codex critica de 3 ângulos, em loop até LGTM ou N rodadas. MakeClaudeX: construir plugins assim. DeepClaudeX: multi-modelo 70/20/10.

Elo comum

Os arquivos Markdown do projeto — AGENTS.md, tasks, handoffs — que qualquer runtime lê. O handoff/prime do agente-claude-codex e o do Use Both são o mesmo padrão; o nosso foi endurecido com as regras do kit: caminho validado, histórico que não sobrescreve e prime só de leitura.

claudex × Use Both

Os dois fazem Claude e Codex trabalharem juntos, mas em camadas diferentes: um é software que automatiza o debate de um plano; o outro é método para todo o resto.

claudexUse Both
O que éPlugin do Claude Code (software)Kit de método: guia, prompts, templates e 2 skills
CoberturaSó plano e revisão (nível 1)6 fluxos: plano, imagem, construir e revisar diff, uso do computador, meta com parada, handoff
Como rodaAutomático: o Claude escreve o PLAN.md, o Codex critica de 3 ângulos, em loop até LGTM ou N rodadasManual ou semiautomático: você passa o artefato, ou um chama o outro pela CLI
LimiteN rodadas, configurávelRecomenda no máximo 2; concordância não é prova, os testes decidem
Comandosclaudex:plan, review, status, rollback, cancel, doctor/handoff e /prime (Claude), $handoff e $prime (Codex)
EstadoEstado do loop, status e rollbackRetrato com data em handoff/history/ + LATEST.md
Pré-requisitoClaude Code + Codex CLINenhum no teste de 5 minutos; Python só para o instalador
São complementares. Plano grande: claudex. O resto — revisar diff, meta com condição de parada, trocar de sessão: Use Both.

Imagem com o Codex: como fazemos hoje × o que o kit propõe

Um caso real: quem tem assinatura do Codex e usa o gerador de imagem dele — o image_gen, que no INEMA chamamos de "imagem 2.5".

Hoje no INEMA · integração por script, sem conversa

  • O Claude Code chama codex exec em modo não interativo, pedindo ao image_gen um arquivo PNG numa pasta.
  • Onde é usado: capa do catálogo (gerador de capas com --gerador auto|codex|flux), banner da landing e do guia de projetos (texto em português correto, que o modelo local erra), cenas dos cursos v6 e miniaturas das áreas deste próprio Eventos.
  • Se o Codex falhar ou não houver crédito, cai sozinho para o modelo local FLUX.2 klein (inemaimg).
  • Cada geração consome crédito da assinatura do Codex, por isso roda só quando autorizada; sem autorização, o padrão é o FLUX local.
  • Depois de gerar, a imagem é conferida: o texto das bordas pode vir inventado.

O que o kit propõe · nível 2, peça a peça

  • Confirmar antes que a sessão tem a ferramenta de imagem e como ela cobra.
  • Nunca trocar sozinho para uma API paga.
  • Gerar um rascunho e salvar o arquivo real no projeto — nunca aceitar só uma URL ou uma descrição.
  • Abrir no tamanho em que vai ser usado e checar texto, marcas e recorte.
  • Guardar o original e salvar revisões como arquivos irmãos, registrando qual versão o projeto usa.
  • Na rota do autor: o Codex gera, o Claude usa o arquivo.

A diferença: o nosso é em lote e automático, com fallback local; o do kit é manual e peça a peça, com mais checagem de custo e de revisão.

Levamos do kit

Checar antes, inspecionar depois

  • Checar a ferramenta e o custo antes de gerar
  • Inspecionar no tamanho real de uso
  • Versões irmãs em vez de sobrescrever
Mantemos do nosso

Fallback e reprodutibilidade

  • Fallback local para o FLUX.2 klein
  • Script reprodutível, que roda em lote

03 · Todos os projetos Codex + Claude

Cursos, kits e referências do INEMA sobre Claude + Codex, num só lugar.

Tudo o que o INEMA publicou sobre as duas ferramentas: do primeiro comando no Codex CLI até orquestrar vários modelos, passando por migrar, ficar agnóstico e usar os dois juntos. Tudo aberto.

Cursos

Projetos e kits

04 · Comece agora

O melhor primeiro passo: um plano seu, revisado pelo outro.

Escolha uma tarefa pequena, escreva o briefing e o critério de aceite, peça o plano a um e a crítica ao outro, sobre o mesmo arquivo — no máximo duas rodadas. Depois, handoff antes de fechar a sessão.

Kit · aberto

Use Both

Os seis níveis, os prompts prontos e as skills handoff e prime, com instalador em modo prévia.

Abrir o guia →
CLI · aberto

claudex

Quando o plano é grande: o Claude escreve, o Codex critica de 3 ângulos, em loop até LGTM ou N rodadas.

Abrir no GitHub →
Área irmã

Claude → Codex

Antes de usar os dois, separe o cérebro do modelo: curso, kit e método para migrar ou ficar agnóstico.

Abrir a área →

Dúvida sobre por onde começar? Fale com a gente no Telegram.