Auditar antes de tocar
Inventario de solo lectura de los dos runtimes con doctor.sh y audit.sh: cada skill sale como reutilizable, adaptador, nativo o sin resolver.
El problema
El lock-in no está en el modelo. Está en lo que quedó dentro del runtime.
Quien usa un asistente de código desde hace algunos meses ha acumulado instrucciones, memoria, skills, hooks y miles de sesiones en un formato que solo ese runtime lee. La factura llega el día del cambio.
- El CLAUDE.md creció, mezcla reglas con residuos de plugins y ningún otro agente sabe qué hacer con él.
- La memoria nativa y las sesiones en JSONL guardan decisiones que nadie anotó en otro lugar.
- Las skills se copiaron a mano entre runtimes y las copias ya divergen.
- El CLI de Codex no tiene import nativo: cambiar de ejecutor se convierte en reconstruir desde cero.
- Una sesión nueva repite errores antiguos y contradice lo que ya se había resuelto.
Después de la formación
Al final de las 3 rutas, podrás:
Separar lo portátil del residuo
Dividir el CLAUDE.md: las reglas portátiles van al AGENTS.md, lo que depende de un plugin o hook se queda en el archivo específico.
Instalar el núcleo portátil
AGENTS.md, context/, tasks/current.md y handoffs/latest.md en el proyecto, sin sobrescribir nada de lo que ya existe.
Mantener una sola fuente por skill
Skills canónicas con polyskill: una fuente, copias generadas por runtime y un comando de drift que muestra lo que divergió.
Probar la continuidad
Readback en una sesión nueva en los dos runtimes, con las cinco preguntas de continuidad, y el ciclo diario de handoff y prime.
Poner un tercer ejecutor
Modelo local en contenedor, MCP y hooks entre Claude y Codex, y workspace de cliente con alcance explícito.
1 curso · 3 rutas · 18 módulos + el kit
Tres rutas y el kit, del porqué a tu proyecto real.
La ruta 1 define cada término la primera vez que aparece. La ruta 2 ejecuta el kit comando por comando. La ruta 3 lo aplica todo en seis proyectos sobre un sistema real. El kit cierra el camino: lo ejecutas en tu proyecto, en modo audit.
- 1
Fundamentos
Ruta 1 · Por qué y qué
Por qué separar el cerebro del modelo, el vocabulario (runtime, harness, skill, MCP, hook, handoff), los tres niveles de migración y la anatomía de un workspace portátil.
- 2
Manos a la obra
Ruta 2 · El kit, comando por comando
doctor.sh y audit.sh, CLAUDE.md → AGENTS.md, el núcleo instalado sin sobrescribir, skills con polyskill y el readback probado en los dos runtimes.
- 3
Proyectos
Ruta 3 · Seis proyectos sobre un sistema real
Migrar el primer proyecto real, MCP y hooks entre Claude y Codex, memoria curada con tu aprobación, modelo local en contenedor y workspace de cliente.
- 4
Kit
Kit agente-claude-codex
Scripts de diagnóstico, adaptación, prueba y drift, la plantilla del núcleo portátil y los mega-prompts A y B, todos empezando en MODE: audit.
Para quién es
Hecha para ti si
- Usas Claude Code desde hace meses y necesitas usar Codex por costo, acceso o política.
- Ya cambiaste de herramienta una vez y no quieres reconstruirlo todo de nuevo.
- Quieres ejecutar dos ejecutores en el mismo proyecto, incluido un modelo local.
- Atiendes a clientes y necesitas alcance y aislamiento explícitos por proyecto.
Todavía no es para ti si
- Quieres usar Claude y Codex juntos, uno hace y el otro revisa: el área Codex + Claude cubre eso.
- Buscas un botón que copie todo de un runtime al otro sin auditar.
Incluido en la formación
El curso parte de un kit que ejecutas hoy.
El kit agente-claude-codex es bash y Markdown, abierto en GitHub. Nada en ~/.claude o ~/.codex se copia en masa ni se borra, e instalar una skill hace un backup al lado.
Proyectos y kits
Modelo: un contexto, varias plataformasKit agente-claude-codexagente-claude-codex · GitHubMapa del temaÁrea Codex + Claude
Videos
Por qué esta formación
Qué cambia respecto a copiar el CLAUDE.md.
Audit antes de implement
Todo script y todo mega-prompt empieza analizando, planificando y simulando. Lees el plan antes de cambiar un archivo.
Prueba por lectura, no por archivo
Que un archivo exista no prueba nada. El readback abre una sesión nueva en cada runtime y comprueba si el agente leyó y usó.
Se ejecutó en una máquina real
La auditoría encontró 89 skills solo en Claude: 71 reutilizables, 15 adaptador, 2 nativo y 1 sin SKILL.md. El registro está en el repositorio.
Tres idiomas, el mismo contenido
Las versiones en inglés y español son espejos completos, con progreso separado por idioma.
Preguntas
Antes de empezar.
¿Tengo que hacerlos en orden?
El orden sugerido es ruta 1 → 2 → 3 y después el kit en tu proyecto. Quien ya conoce runtime, harness y handoff puede empezar por la ruta 2.
¿Migrar o ser agnóstico?
Migrar es llegar al nivel 1 o 2: importar en la app o ejecutar el kit. Ser agnóstico es el nivel 3, el único que sobrevive al próximo cambio de modelo. La ruta 1 ayuda a elegir.
¿Voy a dejar de usar Claude?
No. Ser agnóstico no es abandonar Claude: sigues eligiendo el ejecutor por tarea, con el conocimiento en el proyecto.
¿Qué herramientas necesito?
Terminal, git y Claude Code o Codex instalados. El kit es bash y Markdown, sin interfaz. El módulo 3.4 añade un modelo local en contenedor.
¿Cuánto contenido hay?
Son 3 rutas con 6 módulos cada una, 18 en total, y 108 temas. La ruta 3 tiene seis proyectos con objetivo, comandos, criterio de aceptación y riesgos.
Los modelos cambian. Tu estructura permanece.
Empieza por la ruta 1 y elige un proyecto que conozcas bien. En una sesión en modo audit ya sabes qué es portátil, qué necesita un adaptador y qué depende de un hook.