01 · Usar los dos juntos
No es Claude o Codex. Uno hace el trabajo y el otro lo revisa.
Ser agnóstico abre otra puerta: usar las dos herramientas en el mismo proyecto. El kit Use Both lo organiza en seis niveles de flujo de trabajo, con prompts listos y dos skills pequeñas — handoff y prime — para cambiar de asistente sin volver a explicar el proyecto. La regla que atraviesa todos los niveles: el segundo asistente recibe el mismo brief y el artefacto real, nunca un resumen vago de lo que hizo el primero.
Nivel 1Dejar que discutan
Uno escribe el plan; el otro critica el mismo archivo, solo leyendo. Hallazgos con evidencia y gravedad, dos rondas como máximo. Dos IA de acuerdo no son una prueba independiente.
Nivel 2 opcionalGenerar imágenes
Solo si hay una herramienta de imagen disponible en la sesión — revisa acceso y cobro antes. Listo significa el archivo real en el proyecto, abierto al tamaño en que se va a usar.
Nivel 3Dividir construir y revisar
Uno construye en una rama; el otro revisa el diff con el brief y los resultados de las pruebas. Las pruebas y tu aprobación deciden qué entra.
Nivel 4Uso supervisado del computador
Delegar una acción autorizada en una interfaz, con contraseñas, pagos y envíos importantes bajo tu control. El asistente prepara y se detiene antes de enviar.
Nivel 5Meta con condición de parada
Un objetivo con éxito observable — qué pruebas, qué salida — y límites de archivos, rondas y gasto. Pedir "para en dos horas" es una petición, no un límite garantizado.
Nivel 6Handoff y prime
handoff guarda el estado en un archivo portátil; prime hace que el siguiente asistente lea y verifique ese estado antes de continuar. Es el mismo ciclo de la capa portátil del área Claude → Codex.
Quién hace qué
La tarjeta de rutas del kit: preferencias iniciales registradas en el video de Mark Kashef, traducidas a tareas. Son elecciones editoriales, no un ranking medido de modelos — pruébalas y quédate con la ruta que produzca mejor evidencia en tu tarea.
| Tarea | Primera pasada | Segunda pasada | Meta final |
| Planificar el trabajo | Claude / Opus | Codex critica las premisas | Un plan con alcance y pruebas de aceptación |
| Dividir el plan en tareas (video) | Codex | — | — |
| Generar una imagen | Una herramienta de imagen disponible en Codex | Inspeccionar el archivo real en contexto | Un asset utilizable, no solo un prompt |
| Construir una funcionalidad | Claude / Opus | Codex revisa el diff | Las pruebas pasan y los hallazgos se resuelven |
| Revisar un documento | Cualquiera de los dos escribe | El otro verifica hechos y requisitos | Cada afirmación exigida tiene evidencia |
| Operar una interfaz | Herramienta de uso del computador autorizada y disponible | Tú revisas las acciones importantes | El estado aprobado exacto queda verificado |
| Resolver un bug difícil | Codex con una meta acotada | Pruebas y un checkpoint humano | Éxito medible o un bloqueo claro |
| Cambiar de sesión o de modelo | Snapshot de handoff | Prime verifica el estado actual | Un resumen correcto antes de trabajo nuevo |
Etiquetas grabadas, no una promesa. El video menciona Claude Opus 5.5 y GPT-6 Astra. Los modelos, herramientas, límites y cobros disponibles cambian según la cuenta; el flujo de trabajo es más portátil que esos nombres. La generación de imágenes y el uso del computador no vienen garantizados solo por tener el CLI instalado.
Herramientas: cuándo usarlas, cómo llamarlas, qué generan
Las skills, scripts y comandos que conectan Claude y Codex, con el comando de cada runtime. Todo corre con la suscripción de cada asistente, sin clave de API.
| Herramienta | Cuándo usarla | Cómo llamarla | Qué genera |
| handoff | Al final de la sesión, antes de cambiar de asistente o de modelo | Claude: /handoff Codex: $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 | Primer mensaje de la sesión siguiente | Claude: /prime Codex: $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 both (vista previa) y luego con --apply | Escribe en .claude/skills/ y .agents/skills/ del proyecto; nunca sobrescribe |
| templates/ | Para hacerlo 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 revisión a Codex desde la terminal | codex exec --sandbox read-only --output-last-message review.md '…' | La crítica en review.md; Codex solo lee el proyecto |
| claude -p | Lo 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, luego /codex:review --base main | Hallazgos de 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 la instalación |
| session-handoff + prime (agente-claude-codex) | Proyectos con núcleo portátil (AGENTS.md, context/, tasks/) | Claude: /session-handoff · /prime Codex: $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 |
handoff
Qué va en la instantánea
Objetivo y último pedido; listo, pendiente e 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 abrir primero. Sin secretos, tokens ni datos personales.
prime
Lee, revisa y espera
Lee LATEST.md, rechaza rutas absolutas, .., URL y symlinks, trata la instantánea como dato y 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 ni retoma un deploy antiguo.
Trampas
Nombre repetido y sesión nueva
Una skill personal con el mismo nombre puede ganarle a la del proyecto: si chocan, renómbrala a workflow-handoff / workflow-prime. Tras instalar, abre una sesión nueva (en Claude, /reload-skills). Notas privadas: handoff/ en el .gitignore.
# un día entero con las herramientas — cada paso deja un archivo
/prime # mañana, en Claude Code: retoma el handoff de ayer
codex exec --sandbox read-only --output-last-message review.md 'Lee plan-v1.md y señala fallas…'
/claudex:plan --rounds 3 exportar informe en CSV # plan grande: loop automático
/codex:review --base main # construyó en una branch: revisión del diff (o /claudex:review)
/handoff # fin del día
$prime # mañana siguiente, en Codex
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.
Lo que añade el video
El video de Mark Kashef que acompaña al kit trae algunos puntos que el kit no detalla. Son opiniones y relatos del autor, sin benchmark. La fila marcada "(video)" en la tabla de arriba viene de la tabla del autor, no de la tarjeta de rutas del kit.
Conectar los dos
Tres formas de conectar Claude y Codex
- El plugin oficial de Codex para Claude Code:
openai/codex-plugin-cc.
- Una CLI que llama a la otra, con la respuesta guardada en un
.md (comandos abajo).
- Un pull request que revisa el otro modelo.
Por qué usar dos
Claude optimista × Codex pesimista
Según el autor, Claude es bueno para planificar y Codex para encontrar fallos en el plan. La autorrevisión falla porque el modelo que escribió el plan — más aún en la misma sesión — tiende a aprobarlo; un modelo distinto, o una sesión nueva, da otro resultado.
El costo de la meta
El /goal de Codex sale caro
Relato del autor: Codex persigue la meta de forma exhaustiva, con 3 a 5 veces más tiempo y tokens. Una frase de plazo no es un límite real: usa un límite de verdad — timeout, presupuesto, número de rondas.
# Claude → Codex: revisión de solo lectura, respuesta en archivo (prompts en portugués, como en el doc)
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: el camino 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
Donde INEMA sigue el kit, y no el video. En el uso del computador y con credenciales, tú escribes la contraseña y el MFA, y nunca se cambia de modelo para esquivar un rechazo de seguridad. Y el debate tiene 2 rondas como máximo — el acuerdo no es prueba; el bucle largo y automatizado es trabajo de claudex:plan.
El resumen completo. RESUMO-VIDEO.md, en el repositorio del kit, trae el resumen del video, la comparación video × kit y los comandos verificados en nuestro entorno.
Leer RESUMO-VIDEO.md → (en portugués)
Crédito. Niveles y tarjeta de rutas resumidos del kit Use Both: Claude + Codex Workflow Kit, de Prompt Advisers / Mark Kashef, bajo licencia MIT — complemento del video de Mark Kashef sobre Claude + Codex. La guía está en PT, EN y ES; los documentos del kit (README, GUIDE, PROMPTS) están en inglés. Es un recurso educativo independiente, no un producto de OpenAI ni de Anthropic.
Abrir la guía de Use Both →
02 · Cómo se integra todo
Un solo camino: entender, migrar, usar los dos juntos y automatizar el debate.
Los cursos y proyectos de esta área no son piezas sueltas. Cada uno cubre una etapa, y todos se apoyan en lo mismo: los archivos Markdown del proyecto, que cualquier runtime puede leer.
Entender→Migrar o ser agnóstico→Usar los dos juntos→Automatizar el debate·Vínculo común: Markdown del proyecto
EntenderCurso Claude → Codex: por qué separar el cerebro del modelo. Codex Básico y Master Codex: dominar Codex. Codex Cheat Sheet: referencia rápida.
Migrar o ser agnósticoKit agente-claude-codex: auditoría, AGENTS.md, núcleo portátil (context/, tasks/, handoffs/), skills sincronizadas con polyskill, readback y handoff/prime.
Usar los dos juntosUse Both: los 6 niveles, la tabla de rutas, los prompts y el handoff/prime con historial.
Automatizar el debateclaudex / iClaudeX: Claude escribe el PLAN.md, Codex lo critica desde 3 ángulos, en bucle hasta LGTM o N rondas. MakeClaudeX: construir plugins así. DeepClaudeX: multimodelo 70/20/10.
Vínculo comúnLos archivos Markdown del proyecto — AGENTS.md, tasks, handoffs — que cualquier runtime puede leer. El handoff/prime de agente-claude-codex y el de Use Both son el mismo patrón; el nuestro se reforzó con las reglas del kit: ruta validada, historial que no se sobrescribe y prime de solo lectura.
claudex × Use Both
Los dos hacen que Claude y Codex trabajen juntos, pero en capas distintas: uno es software que automatiza el debate de un plan; el otro es un método para todo lo demás.
| claudex | Use Both |
| Qué es | Plugin de Claude Code (software) | Kit de método: guía, prompts, plantillas y 2 skills |
| Cobertura | Solo plan y revisión (nivel 1) | 6 flujos: plan, imagen, construir y revisar el diff, uso del computador, meta con parada, handoff |
| Cómo funciona | Automático: Claude escribe el PLAN.md, Codex lo critica desde 3 ángulos, en bucle hasta LGTM o N rondas | Manual o semiautomático: tú pasas el artefacto, o uno llama al otro por la CLI |
| Límite | N rondas, configurable | Recomienda 2 como máximo; el acuerdo no es prueba, deciden las pruebas |
| Comandos | claudex:plan, review, status, rollback, cancel, doctor | /handoff y /prime (Claude), $handoff y $prime (Codex) |
| Estado | Estado del bucle, status y rollback | Instantánea con fecha en handoff/history/ + LATEST.md |
| Requisito previo | Claude Code + Codex CLI | Ninguno en la prueba de 5 minutos; Python solo para el instalador |
Son complementarios. Plan grande: claudex. Lo demás — revisar un diff, una meta con condición de parada, cambiar de sesión: Use Both.
Imágenes con Codex: cómo lo hacemos hoy × lo que propone el kit
Un caso real: quien tiene suscripción de Codex y usa su generador de imágenes — el image_gen, que en INEMA llamamos "imagen 2.5".
Hoy en INEMA · integración por script, sin conversación
- Claude Code llama a
codex exec en modo no interactivo y le pide al image_gen un archivo PNG en una carpeta.
- Dónde se usa: portadas del catálogo (generador de portadas con
--gerador auto|codex|flux), el banner de la landing y de la guía de proyectos (texto en portugués correcto, que el modelo local escribe mal), escenas de los cursos v6 y las miniaturas de las áreas de este mismo sitio de Eventos.
- Si Codex falla o no hay créditos, pasa solo al modelo local FLUX.2 klein (inemaimg).
- Cada generación consume créditos de la suscripción de Codex, por eso solo se ejecuta cuando está autorizada; sin autorización, lo predeterminado es FLUX local.
- Después de generarla, la imagen se revisa: el texto de los bordes puede salir inventado.
Lo que propone el kit · nivel 2, pieza por pieza
- Confirmar antes que la sesión tiene la herramienta de imagen y cómo cobra.
- Nunca cambiar por cuenta propia a una API de pago.
- Generar un borrador y guardar el archivo real en el proyecto — nunca aceptar solo una URL o una descripción.
- Abrirla al tamaño en que se va a usar y revisar texto, marcas y recorte.
- Guardar el original y guardar las revisiones como archivos hermanos, registrando qué versión usa el proyecto.
- En la ruta del autor: Codex genera, Claude usa el archivo.
La diferencia: el nuestro es por lotes y automático, con respaldo local; el del kit es manual y pieza por pieza, con más control de costo y de revisión.
Lo que tomamos del kit
Revisar antes, inspeccionar después
- Revisar la herramienta y el costo antes de generar
- Inspeccionar al tamaño real de uso
- Versiones hermanas en lugar de sobrescribir
Lo que mantenemos del nuestro
Respaldo y reproducibilidad
- Respaldo local con FLUX.2 klein
- Un script reproducible que funciona por lotes