Cómo migrar de Claude Code a Codex sin perder contexto (2026)

El importador de Codex admite Claude Code como origen. En la CLI ejecutas /import; en la aplicación de escritorio vas a Settings → Import y sigues el flujo.

Según la documentación de Codex, la importación cubre:

• Archivos AGENTS.md
• settings.json y config.toml
• Archivos de instrucciones y configuraciones de servidores MCP
• Habilidades y plugins
• Carpetas de proyectos y memorias
• Sesiones de chat de los últimos 30 días
• Hooks y comandos de barra diagonal
• Subagentes

Los límites documentados importan tanto como la lista:

• Hasta 50 chats de los últimos 30 días.
• "Los datos de chat estándar de Claude no se pueden importar" — este es un importador de Claude Code, no un importador de Claude.
• El comando /import "no está disponible durante una tarea en ejecución, en una sesión remota o mientras se está conectado a un demonio de servidor de aplicaciones local."
• Es posible que los plugins importados requieran volver a autorizarse.

Dos datos más definen el resto del traslado.

Codex lee `AGENTS.md`, no `CLAUDE.md`. AGENTS.md es un formato abierto que también leen Cursor, Jules, Amp y Factory, por lo que la migración es principalmente un cambio de nombre en lugar de una reescritura: el contenido se transfiere sin cambios, solo difieren el nombre del archivo y la ruta de carga. Codex superpone estos archivos: uno global bajo tu directorio de inicio de Codex (~/.codex/AGENTS.md, o $CODEX_HOME/AGENTS.md si lo has configurado), luego la raíz del repositorio, y después los directorios entre la raíz y donde estés trabajando. Los archivos se concatenan desde la raíz hacia abajo, y el archivo más cercano a tu directorio actual prevalece en caso de conflictos.

Codex tiene su propia función de memoria, y está desactivada por defecto. Las memorias almacenan "resúmenes, entradas duraderas, entradas recientes y evidencia de respaldo de chats anteriores" como archivos locales en ~/.codex/memories/. Se activa con memories = true bajo [features] en config.toml, o en la aplicación de escritorio en Settings → Personalization → Enable memories. Es global en lugar de por proyecto, y persiste entre sesiones. Vale la pena leer las advertencias documentadas antes de confiar en ella: las memorias "pueden no actualizarse de inmediato cuando finaliza un chat", Codex "omite sesiones activas o de corta duración", la generación se pausa a medida que te acercas a los límites de tarifa, y la documentación es explícita en que no debes almacenar secretos en ellas y debes tratar los archivos como estado generado.

Así que Codex no es un lienzo en blanco. Simplemente no tiene la misma forma de memoria que el contexto de trabajo que construiste dentro de Claude Code.

Paso 1: Mueve y divide tus instrucciones

Si el importador no generó ya un archivo AGENTS.md, renombra CLAUDE.md a AGENTS.md. Si el contenido es genuinamente neutral respecto al proveedor, un enlace simbólico permite que ambas herramientas lean el mismo archivo mientras las ejecutas en paralelo. Si contiene marcas específicas de Claude —referencias a los propios comandos, hooks o convenciones de archivos de Claude Code—, cópialo y reescribe esas partes en lugar de crear un enlace simbólico a un archivo que confundirá a una de las dos.

Luego divídelo por alcance, ya que la estructura de capas de Codex recompensa esto:

• Las preferencias de toda la máquina (tu estilo de commit, tu idioma predeterminado, cómo quieres que se te hable) van en ~/.codex/AGENTS.md.
• Las reglas del repositorio (comandos de compilación, invocación de pruebas, convenciones de directorios, lo que nunca se debe tocar) van en el AGENTS.md de la raíz del repositorio.
• Los detalles específicos del subsistema (este paquete usa una configuración de linter diferente, este servicio tiene su propia ruta de despliegue) van en el AGENTS.md de ese directorio.

Un único archivo largo en la raíz funciona, pero significa que cada sesión en cada subdirectorio pagará el costo de procesar cada regla.

Paso 2: Reconstruye lo que el importador no puede alcanzar

Haz una revisión breve y deliberada de lo que queda fuera de la ventana de 30 días y 50 chats:

• Decisiones más antiguas. Revisa por encima las sesiones de Claude Code que recuerdes que fueron importantes y anota las conclusiones; no las transcripciones, sino las conclusiones. "El wrapper de reintento sigue siendo síncrono porque la versión asíncrona cobró doble en marzo" vale una línea y ahorra una tarde de trabajo.
• Los callejones sin salida. Los enfoques que ya descartaste son el conocimiento más costoso de perder, porque un agente nuevo te los sugerirá alegremente de nuevo y volverás a debatir una cuestión ya resuelta.
• Servidores MCP. La configuración se transfiere; la autorización puede que no. Vuelve a conectar y confirma que cada servidor responde realmente antes de confiar en una sesión que dependa de él.
• Hooks, comandos de barra diagonal y subagentes. Estos se transfieren, pero fueron escritos según la semántica de Claude Code. Ejecuta cada uno una vez en algo inofensivo.

Reserva una hora. Es la diferencia entre una migración que se siente como un cambio neutro y una que se siente como una degradación durante quince días.

Ahora, la observación incómoda: estás a punto de hacer esto de nuevo. El importador de Codex existe porque la gente se mueve entre agentes constantemente, y la industria no se está desacelerando. Si el conocimiento de tu proyecto vive dentro de cualquier agente que estés usando en ese momento, cada cambio te costará una reconstrucción manual, y cada cambio perderá lo que haya quedado fuera de la ventana de exportación de esa herramienta.

Codex Memories es real y vale la pena activarlo, pero ten clara su forma. Es una herramienta, en una máquina, opcional (opt-in), global en lugar de por proyecto, y es un estado generado en lugar de algo que tú creas. No será legible por Claude Code, por Cursor ni por tu compañero de equipo.

La alternativa es mantener el conocimiento fuera de ambas herramientas. MemoryLake es una capa de memoria a la que los agentes se conectan a través de MCP o una API, lo que significa que la ventana de 30 días deja de decidir qué puedes conservar, y ejecutar Claude Code y Codex en paralelo deja de significar mantener dos conjuntos de contexto.

Paso 1: Crea una clave API

Genera una clave y realiza tu primera solicitud en unos 30 segundos.

Paso 2: Sube tus primeras memorias

Introduce el material duradero: tus notas de arquitectura, el registro de decisiones que acabas de escribir en el Paso 2 anterior, los contratos de API, runbooks y los diagramas que la gente sigue explicando una y otra vez. Documentos, imágenes y otros archivos son todos válidos.

Paso 3: Conecta tu IA y agentes

Dale acceso a Codex, Claude, OpenClaw y otros agentes a través de MCP o la API. Ambos agentes leerán entonces de la misma memoria, y AGENTS.md volverá a ser lo que mejor sabe hacer —reglas— en lugar de duplicarse como un vertedero de conocimiento en constante crecimiento.

El efecto inmediato es que tus archivos AGENTS.md dejan de crecer. La mayoría de ellos están sobrecargados porque realizan dos tareas: instrucciones ("ejecutar siempre make lint antes de hacer commit") y conocimiento ("la verificación de la firma del webhook reside en verify.ts y la ruta heredada sigue activa para dos clientes"). Las instrucciones pertenecen al archivo. El conocimiento pertenece a una capa que puedes consultar, porque crece semanalmente y nadie quiere mantener a mano un preámbulo de prompt de 900 líneas.

El segundo efecto aparece en tu próximo cambio de herramienta. Una migración donde el conocimiento ya vive fuera de ambos agentes es una tarea de configuración, no un proyecto de arqueología: apunta el nuevo agente a la misma memoria y continúa.

Y si estás ejecutando ambos agentes, algo que mucha gente hace deliberadamente, una memoria compartida elimina por completo el problema de sincronización. De lo contrario, estarás manteniendo dos versiones de la misma verdad y descubriendo que divergieron en el peor momento. La misma dinámica aparece cada vez que múltiples agentes comparten trabajo sin una memoria compartida.

Separa las reglas del conocimiento, deliberadamente

Antes de copiar nada, lee tu CLAUDE.md haciéndote una pregunta: ¿es esto una instrucción que el agente siempre debe obedecer, o un hecho sobre el sistema? Las instrucciones van a AGENTS.md. Los hechos van a la capa de memoria. Esta única división hace más por la calidad del resultado que cualquier cantidad de ajuste de prompts.

Activa Codex Memories, pero no confíes solo en ello

Es genuinamente útil para el estilo de trabajo y la configuración repetida. Solo recuerda el comportamiento documentado: puede retrasarse con respecto al final de un chat, omite sesiones cortas y es local de una sola máquina. Trátalo como una comodidad, no como tu registro definitivo.

Verifica antes de eliminar

Mantén intacta tu configuración de Claude Code hasta que hayas trabajado una semana completa en Codex, incluyendo una sesión de depuración real. Los vacíos en una migración nunca aparecen en la primera hora; aparecen la primera vez que necesitas algo que asumiste que se había transferido. Vale la pena saber de antemano por qué Codex olvida el contexto de tu proyecto una vez que estás en él, y cómo funciona la ruta inversa de regreso a Claude Code si decides cambiar de nuevo.

La migración de Claude Code a Codex es una de las mejor soportadas actualmente. /import traslada tus instrucciones, configuración, servidores MCP, habilidades, hooks, comandos de barra diagonal, subagentes y un mes de chats, y el paso de CLAUDE.md a AGENTS.md es un cambio de nombre en lugar de una reescritura. Dedica el esfuerzo ahorrado a la parte que ningún importador toca: las decisiones, los callejones sin salida y las razones detrás de ellos.

Luego, asegúrate de tener que hacer eso solo una vez. Ambas herramientas son sin estado (stateless) en lo que importa, ambas mantienen su memoria dentro de sus propias paredes, y habrá otro agente que valga la pena probar en seis meses. Una capa de memoria que se sitúe fuera de cualquiera que estés usando es lo que convierte el próximo cambio en una modificación de configuración en lugar de una reconstrucción, y evita que tus archivos de instrucciones se conviertan lentamente en el lugar donde todo tu conocimiento va a ser olvidado. Si prefieres dejar de dar explicaciones repetitivas por completo, ese hábito tiene su propia solución.