MemoryLake
Volver a todos los artículos
Tutorial29 de julio de 2026·6 min de lectura

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

Muchos desarrolladores pasaron el mes de julio reconsiderando Codex. El contexto de entrada predeterminado para GPT-5.6 en Codex se redujo silenciosamente (de aproximadamente 372k tokens a 272k, un recorte de alrededor del 27%, detectado a través de un cambio de configuración en GitHub en lugar de un anuncio oficial), y en tareas de agentes largas esto significa que la compactación llega antes y se lleva tus requisitos con ella. Si te estás mudando a Claude Code, verás que la migración es principalmente manual, y la parte que más extrañarás no se exporta en absoluto.

La respuesta corta: no hay un importador de Codex a Claude Code. Tu `AGENTS.md` se traduce a `CLAUDE.md` a mano, pero la comprensión a nivel de sesión (las decisiones, las correcciones, la arquitectura que el agente resolvió contigo) no tiene exportación, por lo que Claude Code comienza haciendo un grep en tu repositorio desde cero.

Esta guía cubre cómo mover una configuración de Codex a Claude Code, qué no sobrevivirá y cómo hacer el cambio sin tener que volver a enseñar tu base de código a un segundo agente.

Por qué tu contexto de Codex no te sigue a Claude Code

Qué almacena cada herramienta

Codex lee AGENTS.md al inicio y mantiene todo lo demás (archivos que abrió, decisiones que tomaste, el plan en progreso) en su ventana de contexto, compactándolo a medida que esa ventana se llena. Claude Code funciona de la misma manera: CLAUDE.md al inicio, todo lo demás en el contexto de la sesión. Los archivos de instrucciones estáticas tienen equivalentes directos. La comprensión dinámica no tiene un hogar en ninguno de los dos, por lo que ninguno puede entregársela al otro.

La razón técnica por la que no se transfiere

AGENTS.md y CLAUDE.md son solo Markdown, por lo que esa parte es copiar y ajustar. Pero el estado de la sesión es efímero por diseño: Codex lo compacta durante las tareas largas y lo descarta al final de la sesión, por lo que no hay nada que exportar incluso si Claude Code tuviera un importador. No estás migrando la memoria de un agente; estás migrando un archivo de configuración y luego reconstruyendo la memoria a mano.

Lo que esto te cuesta

Vuelves a incorporar a un segundo agente en una base de código que el primero ya entendía: las mismas convenciones, el mismo recorrido por la arquitectura, las mismas correcciones. Todo lo que Codex aprendió y que nunca se escribió en AGENTS.md simplemente desaparece. Y terminas en el mismo lugar que dejaste: Claude Code también es sin estado (stateless) entre sesiones, por lo que mañana también comenzará de cero; cambiaste de herramienta sin cambiar el problema subyacente.

Paso a paso: Cómo migrar de Codex a Claude Code a mano

La ruta nativa es manual, pero permite trasladar lo esencial.

Paso 1: Extrae lo que Codex retiene

  1. Copia tu AGENTS.md: las convenciones, comandos y restricciones que el agente estaba siguiendo.
  2. Revisa las sesiones recientes de Codex y anota las decisiones y restricciones que nunca llegaron al archivo: enfoques rechazados, elecciones de arquitectura, trampas conocidas.
  3. Toma nota de los servidores MCP y las herramientas en las que se basaba tu configuración de Codex.

Paso 2: Configura Claude Code

  1. Crea o actualiza CLAUDE.md en la raíz del repositorio con tus convenciones, adaptadas de AGENTS.md.
  2. Agrega las decisiones y restricciones rescatadas en CLAUDE.md o en un archivo de documentación que Claude Code lea al inicio.
  3. Vuelve a agregar tus servidores MCP a la configuración de MCP de Claude Code.

Lo que obtienes es una línea base traducida: un archivo de configuración más el contexto que te acordaste de rescatar. No hay transferencia del historial de sesiones, y nada de esto se mantendrá sincronizado si sigues usando Codex para algunos trabajos.

Qué no sobrevive a la migración

La comprensión del proyecto a nivel de sesión que nunca llegó a un archivo. El razonamiento detrás de las correcciones pasadas. Y el problema de la durabilidad en sí: ambos agentes compactan y descartan, por lo que un archivo mantenido a mano es lo único con lo que ambos comienzan de manera confiable, hasta que agregues una capa que sobreviva a las sesiones en ambos.

La mejor manera: Una capa de memoria, cualquier agente

La migración solo es dolorosa porque el conocimiento de cada agente muere dentro de él. Coloca el conocimiento del proyecto en una capa neutral y el cambio se convertirá en una simple conexión. MemoryLake almacena tu arquitectura, decisiones y convenciones una sola vez (con capacidad de búsqueda, versionado al estilo Git y cifrado de extremo a extremo) y las sirve tanto a Claude Code como a Codex a través de MCP, de modo que ninguno comienza en blanco y el costo de cambiar es nulo.

DimensiónCodex → Claude Code manualCapa de MemoryLake
Pasos requeridosTraducir configuración + rescatar a mano3 (una sola vez)
Comprensión a nivel de sesiónMayormente perdidaRetenida y con opción de búsqueda
Sobrevive a la compactaciónNoSí (recuperada bajo demanda)
Se mantiene sincronizada durante un cambio gradualNo
Historial de decisionesNingunoSí (estilo Git)
Cambiar o agregar un agente más tardeTraducir de nuevoConectarlo

Paso 1: Crea una clave de API

Inicia sesión en MemoryLake, genera una clave y realiza tu primera solicitud; toma unos 30 segundos.

Crear una clave de API de MemoryLake
Crear una clave de API de MemoryLake

Paso 2: Sube tus primeras memorias

Sube el conocimiento del proyecto que ambos agentes necesitan: notas de arquitectura, registros de decisiones, convenciones y documentación de API (funcionan documentos, imágenes y otros archivos) en lugar de atraparlos en el archivo de configuración de una sola herramienta.

Subir tus primeras memorias a MemoryLake
Subir tus primeras memorias a MemoryLake

Paso 3: Conecta tu IA y tus agentes

Ambos agentes hablan MCP: agrega MemoryLake a la configuración de MCP de Claude Code y a la de Codex con tu clave de API. Durante un cambio gradual, ninguno se queda atrás, y la misma memoria llega a OpenClaw y a otros agentes compatibles con MCP, de modo que tu próxima herramienta se conecta en lugar de tener que reiniciar.

Conectar tu IA y agentes a través de MCP
Conectar tu IA y agentes a través de MCP

Lo que realmente cuesta volver a incorporar a un agente

El impuesto por cambiar, pagado dos veces

Mover agentes significa volver a enseñar una base de código que el anterior ya conocía, y luego pagar la versión diaria de ese costo, porque el nuevo agente también redescubre tu repositorio en cada sesión. En herramientas con facturación por uso, ese redescubrimiento se traduce en tokens gastados antes de que se realice cualquier trabajo.

Recuperación en lugar de reincorporación

Con una capa compartida, Claude Code extrae tus convenciones y decisiones bajo demanda en lugar de tener que reconstruirlas, por lo que está informado desde el primer día y se mantiene informado después de la compactación. Inicios más rápidos, menos correcciones repetidas, menor gasto: la calculadora de ahorro de tokens de MemoryLake proyecta el efecto según tu uso.

Buenas prácticas para una memoria entre agentes

Rescata antes de cambiar

El conocimiento de la sesión que retiene Codex es la parte que desaparece en la transición. Captúralo primero en la capa compartida y la migración no perderá nada.

Mantén las convenciones en el repositorio, las decisiones en la capa

CLAUDE.md y AGENTS.md son buenos hogares para convenciones estables que cada herramienta lee al inicio. Las decisiones fechadas, los enfoques rechazados y los problemas resueltos pertenecen a la memoria recuperable, donde la compactación no puede eliminarlos.

Delimita el alcance por repositorio

Un alcance de memoria por repositorio mantiene preciso el contexto de ambos agentes y evita que las convenciones de un proyecto se filtren en otro.

Conclusión

Cambiar de Codex a Claude Code es una traducción de configuración más una memoria que reconstruyes a mano; y si te detienes ahí, habrás trasladado el problema en lugar de resolverlo, porque el nuevo agente olvida entre sesiones exactamente igual que el antiguo. Coloca el conocimiento de tu proyecto en una capa que ambos agentes lean, y el cambio será una simple conexión: sesiones informadas desde el primer día, decisiones que sobreviven a la compactación y sin tener que volver a enseñar la próxima vez que cambies de herramienta. Migra la configuración; conserva la memoria.

Preguntas frecuentes

¿Puedo importar mi configuración de Codex a Claude Code?

No. AGENTS.md se puede traducir a CLAUDE.md a mano, pero el estado de la sesión es efímero en ambas herramientas: no hay nada que exportar y Claude Code no tiene un importador para el contexto de Codex.

¿Es suficiente con traducir AGENTS.md a CLAUDE.md?

Traslada las convenciones estáticas, que es la parte fácil. Las decisiones, los enfoques rechazados y la comprensión del proyecto construida durante las sesiones nunca vivieron en ese archivo, por lo que necesitan ser rescatados o contar con una capa de memoria compartida.

¿Por qué empeoró mi contexto de Codex en julio de 2026?

Los desarrolladores documentaron una reducción en el contexto de entrada configurado de forma predeterminada para GPT-5.6 en Codex (de aproximadamente 372k a 272k tokens), que se dio a conocer a través de un cambio de configuración en GitHub. Menos espacio significa que la compactación se activa antes en tareas largas, descartando requisitos y decisiones más pronto.

¿Recordará Claude Code mi proyecto después de que cambie?

No por sí solo. Lee CLAUDE.md al inicio y reconstruye el resto desde tu repositorio en cada sesión; consulta por qué Claude Code olvida el contexto del proyecto. Una capa persistente es lo que hace que las sesiones comiencen informadas.

¿Puedo ejecutar Codex y Claude Code en paralelo?

Sí, y es el camino más fluido. Con una memoria compartida a través de MCP, ambos se mantienen actualizados, por lo que puedes trasladar el trabajo gradualmente en lugar de hacer una transición brusca, y compararlos en igualdad de condiciones. Relacionado: añadir memoria a Claude Code.