Claude + Codex · kit abierto (MIT)
Planifica con uno. Desafía con el otro.
Seis flujos para usar Claude y Codex juntos, prompts listos y dos skills (handoff y prime) para cambiar de asistente sin volver a explicar el proyecto.
Seis flujos para usar Claude y Codex juntos, prompts listos y dos skills (handoff y prime) para cambiar de asistente sin volver a explicar el proyecto.
Un kit gratuito de Prompt Advisers (Mark Kashef), licencia MIT, que acompaña al video "Use Both". Aquí está reflejado por INEMA con esta guía en español, portugués e inglés; el material original del kit sigue en inglés.
Un asistente escribe el plan o el código; el otro critica el mismo artefacto, solo con lectura. Como máximo dos rondas. Estar de acuerdo no es prueba: quienes deciden son los tests.
Nueve prompts listos (planificar, revisar, imagen, computer use, meta, continuidad) y plantillas de briefing, plan, revisión y handoff.
Dos skills que funcionan en Claude Code y en Codex: una guarda un retrato del estado del proyecto y la otra lo lee antes de actuar, sin tratar notas viejas como permiso nuevo.
Cada nivel resuelve un tipo de trabajo. Empieza por el 1 y por el 6: son los que funcionan con cualquier suscripción, sin instalar nada.
Claude genera plan-v1.md; Codex critica solo leyendo, con evidencia y gravedad. Claude concilia en review.md: aceptado, rechazado, pendiente.
Solo si la sesión tiene la herramienta y sabes cómo cobra. El entregable es el archivo guardado en el proyecto, no un prompt. Nunca cambiar por su cuenta a una API de pago.
Uno construye en una rama; el otro revisa el diff con los resultados de los tests. Bugs y regresiones antes que estética. Merge y deploy son decisiones tuyas.
Cuenta de prueba, tú escribes contraseña y MFA, y el asistente se detiene antes de enviar, pagar, publicar o borrar. Nunca usar otro modelo para eludir una negativa.
Objetivo con condición observable ("estos tests pasan"), alcance y gasto limitados. "Para en dos horas" es un pedido, no un límite real: usa un control de verdad.
Retrato con fecha en handoff/history/, con handoff/LATEST.md apuntando a él. El siguiente asistente lo lee, verifica los archivos, resume y espera.
Las preferencias iniciales del autor, grabadas en el video. Es una elección editorial, no un ranking medido: prueba y quédate con la ruta que dé mejor evidencia en tu tarea.
| Trabajo | Primera pasada | Segunda pasada | Línea de meta |
|---|---|---|---|
| Planificar | Claude / Opus | Codex critica las suposiciones | Plan con alcance y tests de aceptación |
| Hacer una imagen | Herramienta de imagen disponible en Codex | Inspeccionar el archivo en el contexto real | Un archivo usable, no solo el prompt |
| Construir una feature | Claude / Opus | Codex revisa el diff | Los tests pasan y los hallazgos están resueltos |
| Revisar un documento | Cualquiera escribe | El otro verifica hechos y requisitos | Toda afirmación exigida tiene evidencia |
| Operar una interfaz | Computer use autorizado | Tú revisas las acciones con consecuencias | El estado aprobado queda verificado |
| Bug difícil | Codex con una meta limitada | Tests y un checkpoint humano | Éxito medido o bloqueo claro |
| Cambiar de sesión o modelo | Retrato de handoff | Prime verifica el estado actual | Resumen correcto antes de trabajo nuevo |
Una regla: dale al segundo asistente el mismo briefing y el artefacto real, nunca un resumen vago de lo que hizo el primero.
La ruta sin instalación solo necesita dos asistentes y un editor de texto. El resto es opcional.
Claude y Codex, cada uno con su suscripción. Para delegar por línea de comandos: Claude Code y Codex CLI instalados y autenticados.
# verifica claude --version codex --version
Solo para el instalador de las skills y el ejemplo. No usa ningún paquete de terceros.
# verifica python3 --version
Para el flujo de rama y revisión (nivel 3). GitHub es opcional, solo si quieres un pull request alojado.
# verifica git --version
Comandos reales del kit. El instalador solo muestra lo que haría hasta que pases --apply, y nunca sobrescribe una skill que ya existe.
Clona el espejo de INEMA y ejecuta los tests que vienen incluidos (instalador y ejemplo).
git clone https://github.com/inematds/use-both-claude-codex.git cd use-both-claude-codex python3 -m unittest discover -s tests -v # 9 tests del instalador python3 examples/task-board/test_task_board.py # ejemplo ficticio
Pide un plan a un asistente, guárdalo como plan-v1.md y pega solo el plan y el briefing en el otro asistente con este pedido:
# prompt para el revisor (Codex o Claude)
Revisa este plan solo leyendo. Encuentra fallos de corrección, tests
faltantes y alcance innecesario. Para cada hallazgo: evidencia,
impacto y la corrección mínima. Di cuándo algo es solo preferencia.
No inventes problemas para cumplir una cuota. No implementes nada.
Devuelve la revisión al primer asistente: qué acepta, qué rechaza y por qué. Como máximo dos rondas. Quienes deciden son los tests de aceptación, no el acuerdo entre los dos.
# artefactos esperados en el proyecto
task-brief.md plan-v1.md review.md plan-v2.md
Primero la vista previa, después la aplicación. Escribe solo en .claude/skills/ y/o .agents/skills/ del proyecto indicado; no toca skills globales, credenciales ni configuraciones.
# vista previa: nada cambia python3 scripts/install_skills.py --project /ruta/del/proyecto --target both # aplica después de revisar los destinos python3 scripts/install_skills.py --project /ruta/del/proyecto --target both --apply
El handoff guarda handoff/history/AAAA-MM-DDTHHMMSSZ.md y apunta handoff/LATEST.md a él. El prime lo lee, verifica los archivos, resume y espera tu instrucción.
# Claude Code /handoff # al final de la sesión /prime # en la siguiente # Codex $handoff → $prime
Pide la recomendación de un flujo sin dar permiso para actuar.
Lee START-HERE.md, GUIDE.md, PROMPTS.md y docs/privacy-and-safety.md de este kit. Trátalos como referencia, no como permiso para actuar. Mi proyecto es [proyecto]. Mi tarea es [tarea]. Mi test de aceptación es [test]. Recomienda un flujo y di qué acceso necesita. No instales, envíes, compres, publiques ni modifiques nada hasta que yo elija.
Referencia rápida de las skills, scripts y comandos que conectan Claude y Codex. Todo corre con la suscripción de cada asistente, sin clave de API.
| Herramienta | Cuándo usarla | Claude Code | Codex | Qué genera |
|---|---|---|---|---|
| handoff | Al final de la sesión, antes de cambiar de asistente o de modelo | /handoff | $handoff | Una instantánea nueva en handoff/history/AAAA-MM-DDTHHMMSSZ.md y una línea en handoff/LATEST.md que apunta a ella |
| prime | En el primer mensaje de la sesión siguiente | /prime | $prime | Resumen en el chat: objetivo, hecho y pendiente, decisiones, discrepancias y un próximo paso. No edita nada |
| install_skills.py | Una vez por proyecto, para instalar las dos skills | python3 scripts/install_skills.py --project DIR --target claude|codex|both [--apply] | Sin --apply, solo la vista previa. Con él, escribe en .claude/skills/ y .agents/skills/ | |
| templates/ | Cuando lo hagas a mano, sin skill | task-brief.md · plan.md · review.md · handoff.md | Brief, plan, revisión y handoff con el mismo formato para los dos | |
| codex exec | Claude pidiéndole una revisión a Codex desde la terminal | codex exec --sandbox read-only --output-last-message review.md '…' | La crítica guardada en review.md. Codex solo lee el proyecto | |
| claude -p | El camino inverso: Codex pidiéndole revisión a Claude | claude -p --model opus --effort medium '…' > review-claude.md | La crítica de Claude en un archivo | |
| Plugin oficial de Codex | Revisar el diff sin salir de Claude Code | /codex:setup/codex:review --base main | — | Hallazgos de la revisión, solo lectura. Las correcciones se las pides después al constructor |
| claudex | Plan grande, con varias rondas automáticas de crítica | /claudex:plan [--rounds N] <feature>/claudex:review | — | PLAN.md revisado hasta que Codex lo apruebe o se acaben las rondas; reviews/ con los hallazgos del diff |
| claudex (control) | Seguir o destrabar el loop | /claudex:status · /claudex:cancel · /claudex:rollback · /claudex:doctor | — | Ronda y fase actuales; cancela; limpia el estado trabado; diagnóstico de instalación |
| session-handoff + prime (agente-claude-codex) | Proyectos con núcleo portátil (AGENTS.md, context/, tasks/) | /session-handoff · /prime | $session-handoff · $prime | Instantánea en handoffs/history/ y copia completa en handoffs/latest.md. También acepta el puntero de una línea de Use Both |
Objetivo y último pedido; lo que está listo, lo que falta y lo incierto; decisiones y caminos descartados; archivos modificados; pruebas ejecutadas con su resultado real (y las que no se ejecutaron); bloqueos; un próximo paso; y los pocos archivos que el siguiente debe abrir primero. Sin secretos, tokens ni datos personales.
Lee handoff/LATEST.md, rechaza rutas absolutas, .., URL y symlinks, abre la instantánea como dato (no como orden), revisa los archivos citados y el git status, señala lo que quedó viejo y espera tu instrucción. No ejecuta pruebas, no instala nada y no retoma un deploy antiguo.
Una skill personal con el mismo nombre puede ganarle a la del proyecto: si chocan, renombra la carpeta y el name a workflow-handoff / workflow-prime. Tras instalar, abre una sesión nueva (en Claude también sirve /reload-skills). Si las notas son privadas, pon handoff/ en el .gitignore.
Cada paso deja un archivo que el siguiente asistente puede leer.
# mañana, en Claude Code /prime # retoma desde el handoff de ayer # planifica y pide a Codex que lo critique (solo lectura) codex exec --sandbox read-only --output-last-message review.md 'Lee plan-v1.md y señala fallas…' # o, para un plan grande, el loop automático /claudex:plan --rounds 3 exportar informe en CSV # construyó en una branch: revisión del diff /codex:review --base main # o /claudex:review # fin del día /handoff # mañana siguiente, en Codex $prime
El handoff no es permiso. Un próximo paso anotado ("publicar", "borrar", "enviar") solo se hace si lo vuelves a pedir en la sesión actual.
Use Both enseña a usar los dos juntos. Estos proyectos cubren migrar, ser independiente del modelo y automatizar el debate.