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 1Deixar 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 opcionalGerar 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 3Dividir 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 4Uso 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 5Meta 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 6Handoff 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.
| Tarefa | Primeira passada | Segunda passada | Linha de chegada |
| Planejar o trabalho | Claude / Opus | Codex critica as premissas | Plano com escopo e testes de aceite |
| Quebrar o plano em tarefas (vídeo) | Codex | — | — |
| Gerar uma imagem | Uma ferramenta de imagem disponível no Codex | Inspecionar o arquivo real no contexto | Um asset utilizável, não só um prompt |
| Construir uma feature | Claude / Opus | Codex revisa o diff | Testes passam e achados resolvidos |
| Revisar um documento | Qualquer um dos dois escreve | O outro confere fatos e requisitos | Toda afirmação exigida tem evidência |
| Operar uma interface | Ferramenta de uso do computador autorizada e disponível | Você revisa as ações importantes | O estado aprovado exato está verificado |
| Atacar um bug difícil | Codex com uma meta delimitada | Testes e um checkpoint humano | Sucesso mensurável ou um bloqueio claro |
| Trocar de sessão ou de modelo | Snapshot de handoff | Prime confere o estado atual | Um 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.
| Ferramenta | Quando usar | Como chamar | O que gera |
| handoff | No fim da sessão, antes de trocar de assistente ou de modelo | Claude: /handoff Codex: $handoff | Retrato novo em handoff/history/AAAA-MM-DDTHHMMSSZ.md e a linha em handoff/LATEST.md apontando para ele |
| prime | Primeira mensagem da sessão seguinte | Claude: /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.py | Uma vez por projeto, para instalar as duas skills | python3 scripts/install_skills.py --project DIR --target both (prévia) e depois com --apply | Grava em .claude/skills/ e .agents/skills/ do projeto; nunca sobrescreve |
| templates/ | Para fazer à mão, sem skill | task-brief.md · plan.md · review.md · handoff.md | Briefing, plano, revisão e handoff no mesmo formato para os dois |
| codex exec | O Claude pedindo revisão ao Codex pelo terminal | codex exec --sandbox read-only --output-last-message review.md '…' | A crítica em review.md; o Codex só lê o projeto |
| claude -p | O inverso: o Codex pedindo revisão ao Claude | claude -p --model opus --effort medium '…' > review-claude.md | A crítica do Claude num arquivo |
| Plugin oficial do Codex | Revisar o diff sem sair do Claude Code | /codex:setup, depois /codex:review --base main | Achados só leitura; as correções você pede depois ao construtor |
| claudex | Plano 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:doctor | Rodada 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
- O plugin oficial do Codex para o Claude Code:
openai/codex-plugin-cc.
- Uma CLI chamando a outra, com a resposta salva num
.md (comandos abaixo).
- 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
EntenderCurso 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ósticoKit agente-claude-codex: auditoria, AGENTS.md, núcleo portátil (context/, tasks/, handoffs/), skills sincronizadas via polyskill, readback e handoff/prime.
Usar os dois juntosUse Both: os 6 níveis, a tabela de rotas, os prompts e o handoff/prime com histórico.
Automatizar o debateclaudex / 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 comumOs 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.
| claudex | Use Both |
| O que é | Plugin do Claude Code (software) | Kit de método: guia, prompts, templates e 2 skills |
| Cobertura | Só plano e revisão (nível 1) | 6 fluxos: plano, imagem, construir e revisar diff, uso do computador, meta com parada, handoff |
| Como roda | Automático: o Claude escreve o PLAN.md, o Codex critica de 3 ângulos, em loop até LGTM ou N rodadas | Manual ou semiautomático: você passa o artefato, ou um chama o outro pela CLI |
| Limite | N rodadas, configurável | Recomenda no máximo 2; concordância não é prova, os testes decidem |
| Comandos | claudex:plan, review, status, rollback, cancel, doctor | /handoff e /prime (Claude), $handoff e $prime (Codex) |
| Estado | Estado do loop, status e rollback | Retrato com data em handoff/history/ + LATEST.md |
| Pré-requisito | Claude Code + Codex CLI | Nenhum 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