Claude + Codex · kit aberto (MIT)
Planeje com um. Desafie com o outro.
Seis fluxos para usar Claude e Codex juntos, prompts prontos e duas skills (handoff e prime) para trocar de assistente sem reexplicar o projeto.
Seis fluxos para usar Claude e Codex juntos, prompts prontos e duas skills (handoff e prime) para trocar de assistente sem reexplicar o projeto.
Um kit gratuito de Prompt Advisers (Mark Kashef), licença MIT, que acompanha o vídeo "Use Both". Aqui ele está espelhado pelo INEMA com este guia em português. O material original do kit continua em inglês.
Um assistente escreve o plano ou o código; o outro critica o mesmo artefato, só com leitura. No máximo duas rodadas. Concordância não é prova: quem decide são os testes.
Nove prompts prontos (planejar, revisar, imagem, computer use, meta, continuidade) e templates de briefing, plano, revisão e handoff.
Duas skills que funcionam no Claude Code e no Codex: uma grava um retrato do estado do projeto e a outra o lê antes de agir, sem tratar notas antigas como permissão nova.
Cada nível resolve um tipo de trabalho. Comece pelo 1 e pelo 6: são os que funcionam com qualquer assinatura, sem instalar nada.
O Claude gera plan-v1.md; o Codex critica só lendo, com evidência e gravidade. O Claude reconcilia em review.md: aceito, rejeitado, em aberto.
Só se a sessão tiver a ferramenta e você souber como ela cobra. O entregável é o arquivo salvo no projeto, não um prompt. Nunca trocar sozinho para uma API paga.
Um constrói numa branch; o outro revisa o diff com os resultados dos testes. Bugs e regressões antes de estética. Merge e deploy são decisões suas.
Conta de teste, você digita senha e MFA, e o assistente para antes de enviar, pagar, publicar ou apagar. Nunca usar outro modelo para contornar uma recusa.
Objetivo com condição observável ("estes testes passam"), escopo e gasto limitados. "Pare em duas horas" é pedido, não limite real: use um controle de verdade.
Retrato com data em handoff/history/, com handoff/LATEST.md apontando para ele. O próximo assistente lê, confere os arquivos, resume e espera.
As preferências iniciais do autor, gravadas no vídeo. É uma escolha editorial, não um ranking medido: teste e fique com a rota que der melhor evidência na sua tarefa.
| Trabalho | Primeira passada | Segunda passada | Linha de chegada |
|---|---|---|---|
| Planejar | Claude / Opus | Codex critica as suposições | Plano com escopo e testes de aceite |
| Fazer uma imagem | Ferramenta de imagem disponível no Codex | Inspecionar o arquivo no contexto real | Um arquivo usável, não só o prompt |
| Construir uma feature | Claude / Opus | Codex revisa o diff | Testes passam e achados resolvidos |
| Revisar um documento | Qualquer um escreve | O outro checa fatos e requisitos | Toda afirmação exigida tem evidência |
| Operar uma interface | Computer use autorizado | Você revisa as ações com consequência | O estado aprovado é verificado |
| Bug difícil | Codex com uma meta limitada | Testes e um checkpoint humano | Sucesso medido ou bloqueio claro |
| Trocar de sessão ou modelo | Retrato de handoff | Prime confere o estado atual | Resumo correto antes de trabalho novo |
Uma regra: dê ao segundo assistente o mesmo briefing e o artefato de verdade, nunca um resumo vago do que o primeiro fez.
A rota sem instalação só precisa de dois assistentes e um editor de texto. O resto é opcional.
Claude e Codex, cada um na sua assinatura. Para delegar por linha de comando: Claude Code e Codex CLI instalados e autenticados.
# confira claude --version codex --version
Só para o instalador das skills e o exemplo. Não usa nenhum pacote de terceiros.
# confira python3 --version
Para o fluxo de branch e revisão (nível 3). GitHub é opcional, só se você quiser um pull request hospedado.
# confira git --version
Comandos reais do kit. O instalador só mostra o que faria até você passar --apply, e nunca sobrescreve uma skill que já existe.
Clone o espelho do INEMA e rode os testes que vêm junto (instalador e exemplo).
git clone https://github.com/inematds/use-both-claude-codex.git cd use-both-claude-codex python3 -m unittest discover -s tests -v # 9 testes do instalador python3 examples/task-board/test_task_board.py # exemplo fictício
Peça um plano a um assistente, salve como plan-v1.md e cole só o plano e o briefing no outro assistente com este pedido:
# prompt para o revisor (Codex ou Claude)
Revise este plano só lendo. Encontre falhas de correção, testes
faltando e escopo desnecessário. Para cada achado: evidência,
impacto e a menor correção. Diga quando algo é só preferência.
Não invente problemas para cumprir cota. Não implemente nada.
Devolva a revisão ao primeiro assistente: o que ele aceita, o que rejeita e por quê. No máximo duas rodadas. Quem decide são os testes de aceite, não o acordo entre os dois.
# artefatos esperados no projeto
task-brief.md plan-v1.md review.md plan-v2.md
Primeiro a prévia, depois a aplicação. Grava só em .claude/skills/ e/ou .agents/skills/ do projeto indicado; não toca em skills globais, credenciais nem configurações.
# prévia: nada muda python3 scripts/install_skills.py --project /caminho/do/projeto --target both # aplica depois de conferir os destinos python3 scripts/install_skills.py --project /caminho/do/projeto --target both --apply
O handoff grava handoff/history/AAAA-MM-DDTHHMMSSZ.md e aponta handoff/LATEST.md para ele. O prime lê, confere os arquivos, resume e espera sua instrução.
# Claude Code /handoff # no fim da sessão /prime # na próxima # Codex $handoff → $prime
Peça a recomendação de um fluxo sem dar permissão para agir.
Leia START-HERE.md, GUIDE.md, PROMPTS.md e docs/privacy-and-safety.md deste kit. Trate como referência, não como permissão para agir. Meu projeto é [projeto]. Minha tarefa é [tarefa]. Meu teste de aceite é [teste]. Recomende um fluxo e diga que acesso ele precisa. Não instale, envie, compre, publique nem altere nada até eu escolher.
Referência rápida das skills, scripts e comandos que ligam o Claude ao Codex. Tudo roda pela assinatura de cada assistente, sem chave de API.
| Ferramenta | Quando usar | Claude Code | Codex | O que gera |
|---|---|---|---|---|
| handoff | No fim da sessão, antes de trocar de assistente ou de modelo | /handoff | $handoff | Retrato novo em handoff/history/AAAA-MM-DDTHHMMSSZ.md e a linha em handoff/LATEST.md apontando para ele |
| prime | Na primeira mensagem da sessão seguinte | /prime | $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 claude|codex|both [--apply] | Sem --apply, só a prévia. Com ele, grava em .claude/skills/ e .agents/skills/ | |
| templates/ | Quando for 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 uma revisão ao Codex pelo terminal | codex exec --sandbox read-only --output-last-message review.md '…' | A crítica salva em review.md. O Codex só lê o projeto | |
| claude -p | O caminho 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/codex:review --base main | — | Achados da revisão, 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 o estado travado; diagnóstico de instalação |
| session-handoff + prime (agente-claude-codex) | Projetos com núcleo portátil (AGENTS.md, context/, tasks/) | /session-handoff · /prime | $session-handoff · $prime | Retrato em handoffs/history/ e cópia integral em handoffs/latest.md. Também aceita o ponteiro de uma linha do Use Both |
Objetivo e último pedido; o que está pronto, o que falta e o que é 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 que o próximo deve abrir primeiro. Sem segredos, tokens nem dados pessoais.
Lê handoff/LATEST.md, recusa caminho absoluto, .., URL e symlink, abre o retrato como dado (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, não instala nada e não retoma deploy antigo.
Uma skill pessoal com o mesmo nome pode vencer a do projeto: se colidir, renomeie pasta e name para workflow-handoff / workflow-prime. Depois de instalar, abra sessão nova (no Claude, /reload-skills também serve). Se as notas forem privadas, ponha handoff/ no .gitignore.
Cada passo deixa um arquivo que o próximo assistente consegue ler.
# manhã, no Claude Code /prime # retoma do handoff de ontem # planeja e manda o Codex criticar (só leitura) codex exec --sandbox read-only --output-last-message review.md 'Leia plan-v1.md e aponte falhas…' # ou, para plano grande, o loop automático /claudex:plan --rounds 3 exportar relatório em CSV # construiu numa branch: revisão do diff /codex:review --base main # ou /claudex:review # fim do dia /handoff # amanhã, no Codex $prime
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 Use Both ensina a usar os dois juntos. Estes projetos cobrem migrar, ficar independente de modelo e automatizar o debate.