Flujo de trabajo
Pasa una tarea de Claude Code a Codex sin perder el contexto
Te has quedado sin uso de Claude a mitad de un refactor, o quieres una segunda opinión. Esto es lo que tiene que llegar al siguiente agente, y tres formas de hacérselo llegar.
Respuesta rápida
Ningún agente carga la transcripción del otro, así que la tarea se traslada con un resumen: el objetivo y tu última instrucción, el plan, los archivos modificados y el estado de git, con el código en disco. Guarda las reglas comunes en AGENTS.md, haz commit o git stash create de tu trabajo en curso y luego escribe el resumen tú mismo, genéralo con una herramienta como hop o deja que una app como Maude lo prepare al cambiar.
Puedes pasar de Claude Code a Codex en mitad de una tarea sin empezar de cero, pero ningún agente retomará por sí solo la conversación del otro. Lo que traslada una tarea es un resumen breve: el objetivo, el plan, los archivos modificados, el estado de git y tu última instrucción, además del código en disco. Puedes escribir ese resumen a mano, generarlo con una pequeña herramienta o usar una app que lo prepare por ti cuando cambias.
Por qué pasar una tarea de un agente de código a otro
- Has llegado a un límite. Es el motivo más habitual. Tu plan de Claude se queda sin uso en mitad de un refactor y a tu plan de ChatGPT aún le queda margen. Esperar al reinicio cuesta horas, y empezar de cero en Codex cuesta el contexto.
- Una segunda opinión. Un agente se ha quedado dando vueltas con un bug. Otro modelo que lea el mismo código con un contexto limpio suele ver lo que el primero había dejado de ver. Pedirle a un agente que revise el diff de otro antes de hacer commit también sale barato.
- Puntos fuertes distintos. Hay quien usa un agente para planificar y otro para ediciones mecánicas largas, o reserva uno para un lenguaje o framework que le funciona bien. Qué hace mejor cada uno cambia con cada versión de los modelos, así que tómalo como criterio propio, no como regla.
¿Puede Codex leer la sesión de Claude Code?
No por sí solo. Los dos agentes guardan las transcripciones completas como archivos JSONL en disco. Claude Code las escribe en ~/.claude/projects/<project>/<session>.jsonl (documentación de Claude Code), y Codex en archivos rollout-*.jsonl con fecha dentro de ~/.codex/sessions/. Cada uno reanuda sus propias sesiones (claude --resume, codex resume), pero ninguno documenta cómo cargar las del otro. El comando /import de Claude Code trae la configuración de otro agente, como archivos de instrucciones, servidores MCP y skills. No trae la conversación.
Podrías indicarle al nuevo agente el archivo de transcripción en bruto. En la práctica es un mal resumen: es largo, está lleno de salida de herramientas y entierra lo único que el nuevo agente necesita, que es en qué punto estás y qué viene después.
Qué contexto tiene que viajar
| Contexto | Por qué importa | De dónde sale |
|---|---|---|
| Objetivo y última instrucción | El nuevo agente tiene que saber qué significa "terminado" y qué le pediste lo último | Tu último prompt, palabra por palabra |
| Plan / lista de tareas | Evita que el agente vuelva a planificar trabajo ya definido | La lista de tareas del agente saliente |
| Archivos modificados | Le dice al agente dónde leer antes de editar | Las ediciones de la transcripción, más git status |
| Estado de git | Rama, HEAD y cambios sin commit. Sin ellos, el nuevo agente puede rehacer trabajo o hacer commit encima | git status, git diff --stat |
| Decisiones y callejones sin salida | Para que el nuevo agente no repita un enfoque que ya falló | La conversación reciente, o un resumen escrito |
Las convenciones del proyecto, como los comandos de build y el estilo de código, no deberían ir en el resumen. Su sitio son los archivos de instrucciones que ambos agentes ya leen.
Por tu cuenta: instrucciones compartidas con AGENTS.md y CLAUDE.md
Codex construye sus instrucciones a partir de archivos AGENTS.md, desde ~/.codex/ y desde la raíz de git hasta tu directorio de trabajo (documentación de AGENTS.md de Codex). Desde la v2.1.277, Claude Code también lee AGENTS.md, pero por defecto solo cuando no existe un CLAUDE.md o CLAUDE.local.md en tu directorio de trabajo o por encima (documentación de memoria de Claude Code). La configuración más sencilla que leen los dos agentes: guarda las reglas comunes en AGENTS.md y, si necesitas reglas solo para Claude, empieza tu CLAUDE.md con un import:
@AGENTS.md
## Claude Code
Use plan mode for changes under src/billing/.En la otra dirección también funciona. El ajuste project_doc_fallback_filenames de Codex en ~/.codex/config.toml le permite leer otros nombres de archivo cuando no hay un AGENTS.md.
Por tu cuenta: un documento de traspaso y git
Antes de cambiar, pídele al agente saliente que escriba el resumen mientras todavía tiene el contexto, si le queda algo de uso:
Write HANDOFF.md for another coding agent taking over this task:
the goal, what is done, what is in progress or broken, decisions
and dead ends, files touched, and the exact next steps.
Don't change any other file.Después deja el estado del código sin ambigüedades. Hacer commit del trabajo en curso en una rama es la opción más clara. Si prefieres no hacer commit, git stash create guarda los cambios sin commit de los archivos versionados como un objeto commit sin tocar tu árbol de trabajo, lo que te da un punto fijo con el que comparar si el siguiente agente se equivoca. Arranca el otro agente en el mismo directorio y dile que lea HANDOFF.md y vuelva a leer los archivos antes de editar.
Herramientas que lo automatizan
hop (MIT) lo hace con un solo comando: hop codex para pasar de Claude Code a Codex y hop cc para lo contrario. Lee directamente los archivos de sesión del agente de origen, así que funciona aunque ese agente se haya quedado sin cuota. Puedes ejecutar ! hop codex desde dentro de una sesión de Claude Code bloqueada. Escribe un documento de traspaso con tus instrucciones, la rama de git y la conversación reciente, dentro de un límite de tamaño (48 KB por defecto), y abre el otro agente en una nueva pestaña de la terminal. Proyectos similares son cli-handoff y session-handoff.
| Enfoque | Funciona sin cuota | Esfuerzo por cambio | Traslada la conversación |
|---|---|---|---|
| Solo un AGENTS.md compartido | Sí | Ninguno, pero traslada convenciones, no el estado de la tarea | No |
| HANDOFF.md escrito por el agente + git | Solo si el agente saliente aún responde | Un prompt y un commit | Como resumen |
| hop y CLI similares | Sí | Un comando | Los turnos recientes, con límite |
| Una app con cambio de agente integrado | Sí | Un toque | Depende de la app |
Cómo funciona el traspaso en Maude
Maude ejecuta tus agentes en tu propio servidor, y una sesión no está atada a un solo agente. Mientras la sesión está inactiva, puedes cambiarla desde el móvil de, por ejemplo, Claude Code a Codex (u OpenCode, Grok Build o Antigravity). El daemon del servidor construye el resumen a partir del propio registro de la sesión, no de un resumen escrito con prisas:
- un encabezado que le dice al nuevo agente que toma el relevo, que los archivos en disco son la fuente de verdad y que debe volver a leerlos antes de editar
- tu última instrucción, fijada
- el plan o la lista de tareas actual
- los archivos modificados, a partir de las ediciones del agente más los archivos que git marca como cambiados
- el estado de git: rama, HEAD, estado abreviado y diff stat. El trabajo sin commit también se guarda con
git stash createy se conserva bajo una ref, sin tocar tu árbol de trabajo - la conversación reciente, literal, hasta unos 120.000 caracteres
- un enlace a la transcripción completa, exportada en markdown a
.maude/handoff/dentro del proyecto y excluida degit status
El resumen se antepone a tu siguiente mensaje al nuevo agente, y el chat muestra un separador que puedes desplegar para leer exactamente lo que se envió. Como el resumen se construye a partir del registro de la sesión, no depende de que el agente saliente pueda responder, que es justo lo que más importa cuando acaba de llegar a su límite.
Volver atrás funciona de otra forma. Si el agente al que vuelves ya trabajó en esta sesión y admite reanudar, Maude reanuda la conversación propia de ese agente y solo le envía lo que pasó mientras no estaba. No recibe un segundo resumen completo.
Maude no es la única app que hace esto. Happier te permite cambiar de motor a mitad de conversación y da al nuevo agente herramientas para leer la transcripción anterior. AgentsRoom genera un resumen de traspaso con los archivos modificados, la actividad de la sesión y la última respuesta cuando cambias de proveedor. Comparamos las ventajas y desventajas en Maude vs Happier. Para elegir qué agentes combinar, consulta Claude Code vs Codex vs OpenCode.
Preguntas frecuentes
¿Puede Codex leer la sesión de Claude Code?
~/.claude/projects/, y Codex no las carga. La tarea se traslada con un resumen: lo escribes tú, lo generas con una herramienta como hop o usas una app que lo prepare al cambiar.¿Entran en conflicto AGENTS.md y CLAUDE.md?
AGENTS.md cuando no hay un CLAUDE.md. Para compartir un único archivo, guarda tus reglas en AGENTS.md y pon @AGENTS.md al principio de CLAUDE.md. Codex lee AGENTS.md de forma nativa.¿Qué hago si llego al límite de Claude a mitad de una tarea?
¿Cambiar de agente hace que pierda mis cambios sin commit?
git stash create antes te da un punto fijo con el que comparar si el siguiente agente se equivoca.
