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

El contenido de tu AGENTS.md se transfiere limpiamente. Ambas herramientas leen Markdown simple sin estructura obligatoria. La documentación de Amp describe la búsqueda en archivos AGENTS.md "para obtener orientación sobre la estructura del código base, comandos de compilación/prueba y convenciones"; la de Codex dice que "lee archivos AGENTS.md antes de realizar cualquier trabajo". No es necesario cambiar nada de la redacción.

La orientación a nivel de raíz se transfiere. Un único AGENTS.md en la raíz del repositorio es la única configuración que ambas herramientas manejan de manera idéntica.

Los archivos AGENTS.md anidados se transfieren, con tiempos diferentes. Amp incluye "archivos AGENTS.md de subárbol... cuando el agente lee un archivo en el subárbol", de forma diferida, activada por el acceso al archivo. Codex ensambla su cadena por adelantado: "construye una cadena de instrucciones cuando se inicia (una vez por ejecución; en la TUI esto generalmente significa una vez por sesión iniciada)", recorriendo desde la raíz del proyecto hacia abajo hasta tu directorio de trabajo actual. Mismos archivos, momento diferente, y en el caso de Codex, solo los directorios en la ruta desde la raíz hasta el directorio de trabajo actual.

La orientación por encima de tu repositorio no se transfiere. Esta es la primera ruptura real. Amp siempre incluye archivos AGENTS.md en "el directorio de trabajo actual (o raíces del espacio de trabajo del editor) y directorios principales (hasta $HOME)", además de $HOME/.config/amp/AGENTS.md, $HOME/.config/AGENTS.md y archivos de todo el sistema. El alcance del proyecto de Codex comienza en la raíz del proyecto — "normalmente la raíz de Git" — y desciende. Cualquier cosa que hayas guardado en una carpeta principal por encima del repositorio simplemente no está en la ruta de Codex. Codex tiene un alcance global, pero es una ubicación específica: AGENTS.override.md o AGENTS.md en tu directorio de inicio de Codex, y "utiliza solo el primer archivo no vacío en este nivel".

Tu alternativa CLAUDE.md no se transfiere por defecto. La regla de Amp es explícita: "Si no existe ningún AGENTS.md en un directorio, pero sí existe un archivo llamado AGENT.md (sin la S) o CLAUDE.md, ese archivo se incluirá". Codex no tiene tal alternativa implícita. Comprueba AGENTS.override.md, luego AGENTS.md, luego lo que sea que listes en project_doc_fallback_filenames, y la documentación es tajante sobre el resto: "Los nombres de archivo que no estén en esta lista se ignoran para el descubrimiento de instrucciones". Si un directorio en tu repositorio ha estado funcionando con un CLAUDE.md todo este tiempo, mudarte a Codex lo desactivará silenciosamente.

La orientación con alcance de glob no se transfiere. Esta es la brecha más grande, y el mecanismo de alcance documentado de Codex funciona en un eje completamente diferente. Amp permite que un AGENTS.md raíz mencione con @ otros archivos, y esos archivos mencionados pueden llevar globs en el front matter de YAML: "Los archivos mencionados con globs solo se incluirán si Amp ha leído un archivo que coincida con cualquiera de los globs", con los globs "prefijados implícitamente con **/ a menos que comiencen con ../ o ./". Eso te brinda una orientación condicional y siempre plana: docs/typescript-conventions.md se activa cuando se lee un archivo TypeScript y se mantiene al margen de lo contrario. Si has implementado esto, describimos el patrón en delimitar el alcance de las instrucciones de Amp a los archivos a los que se aplican.

Codex's el mecanismo de alcance documentado es el anidamiento de directorios. No existe un equivalente documentado para la inclusión condicional por glob. Por lo tanto, cada uno de esos archivos con alcance debe convertirse en un AGENTS.md anidado en el directorio que gobierna, o en texto incondicional en un archivo principal, y el texto incondicional cuenta para el límite, que es el siguiente problema.

El tamaño de tu AGENTS.md ahora puede importar. La documentación de archivos de agente de Amp no especifica un límite de tamaño combinado. La de Codex sí: "omite los archivos vacíos y deja de agregar archivos una vez que el tamaño combinado alcanza el límite definido por project_doc_max_bytes (32 KiB por defecto)". El fallo no es un error; simplemente es orientación que deja de incluirse. Colapsar un conjunto de archivos con alcance de glob en un solo archivo siempre activo es exactamente cómo una configuración cómoda cruza esa línea.

Lo que Amp no tiene y Codex sí. El mecanismo de persistencia documentado de Amp son los archivos AGENTS.md que escribes, además de los hilos. No existe un equivalente documentado en Amp para un almacén que se escribe a sí mismo a partir de sesiones anteriores. Codex tiene uno: "Memories permite que ChatGPT y Codex lleven contexto útil de trabajos anteriores a trabajos futuros". Vale la pena ser precisos sobre qué es eso antes de apoyarse en ello, lo cual cubre la siguiente sección.

Paso 1: Reconstruir el árbol de descubrimiento para un recorrido descendente

Primero ejecuta agents-md list desde la paleta de comandos de Amp. Eso te dará el conjunto real de archivos que Amp está usando en este momento, que casi siempre es más grande que el conjunto que recuerdas haber escrito.

Luego clasifica esa lista en cuatro grupos.

Los archivos en la raíz de tu repositorio o por debajo de ella, en directorios en la ruta desde la que trabajas normalmente, no necesitan cambios. Codex los encontrará.

Los archivos en directorios principales por encima del repositorio requieren una decisión. Si el contenido es personal (comandos específicos del dispositivo, preferencias que estás probando), pertenece a ~/.codex/AGENTS.md, el alcance global de Codex. Si es contenido del proyecto que por casualidad vivía por encima del repositorio, muévelo dentro del repositorio. No será descubierto donde está.

Los archivos CLAUDE.md y AGENT.md que Amp ha estado promoviendo silenciosamente deben hacerse explícitos. Puedes renombrarlos a AGENTS.md, que es el resultado más limpio y el que explicamos paso a paso en migrar CLAUDE.md a AGENTS.md, o agregarlos a project_doc_fallback_filenames en ~/.codex/config.toml para que Codex los trate como archivos de instrucciones. Renombrar es mejor si has dejado Amp; la lista de alternativas es mejor si algunos compañeros de equipo todavía están en Amp y esperan los nombres antiguos.

Los archivos mencionados con @ con alcance de glob deben reubicarse en los directorios que gobiernan. Un archivo cuyos globs son src/components/** y **/*.tsx se convierte en src/components/AGENTS.md. Uno cuyos globs abarcan árboles no relacionados tiene que dividirse, o promoverse a siempre activo y presupuestarse contra el límite.

Dos comportamientos de Codex a tener en cuenta mientras haces esto. Solo se utiliza un archivo por directorio — "Codex incluye como máximo un archivo por directorio" — y AGENTS.override.md supera a AGENTS.md en el mismo directorio, ignorando por completo al hermano. Y el orden de fusión es de la raíz hacia abajo: "Los archivos más cercanos a tu directorio actual anulan la orientación anterior porque aparecen más tarde en el prompt combinado". Por lo tanto, la especificidad proviene de la profundidad, no de un tipo de regla.

Verifícalo iniciando Codex desde un directorio anidado y pidiéndole que enumere las fuentes de instrucciones que cargó. Si falta un archivo que esperabas, las causas habituales son que está por encima de la raíz del proyecto, que una anulación hermana lo suprimió o que la cadena alcanzó el límite de bytes. Los fallos de descubrimiento relacionados se cubren en por qué Codex omite tus reglas de AGENTS.md, y el mismo modelo de descubrimiento se aplica si vienes de Copilot en lugar de Amp.

Paso 2: Decidir de qué se le permite ser responsable a Codex Memories

La capa de memoria de Codex está desactivada por defecto; la activas en Settings > Personalization. Una vez activada, "Codex puede convertir el contexto útil de chats anteriores elegibles en archivos de memoria locales". "Omite sesiones activas o de corta duración, redacta secretos de los campos de memoria generados y actualiza las memorias en segundo plano en lugar de inmediatamente al final de cada chat". Los archivos viven bajo ~/.codex/memories/ e "incluyen resúmenes, entradas duraderas, entradas recientes y evidencia de respaldo de chats anteriores". Por chat, /memories controla si la conversación actual puede leer memorias existentes o alimentar futuras, y "las elecciones a nivel de chat no cambian tu configuración de memoria global".

Lee la propia guía de OpenAI antes de decidir cuánto peso poner en esto: "Mantén la orientación requerida del equipo en AGENTS.md o en la documentación registrada. Trata las memorias como una capa de recuerdo útil, no como la única fuente de reglas que siempre deben aplicarse".

Ese es el límite correcto y vale la pena reafirmarlo en tus propios términos. Codex Memories es una capa de recuerdo generada, local y por instalación. La documentación dice que se debe "tratar estos archivos como estado generado" y no "depender de editarlos a mano como tu superficie de control principal". No se comparte con los compañeros de equipo, está vinculada a un directorio de inicio de Codex y la generación se puede omitir cuando estás cerca de un límite de tarifa. Es genuinamente útil para reducir la repetición en tu propia máquina. No es donde va una decisión de equipo.

Lo que deja la misma brecha que tenías en Amp, ahora con una forma más clara: las cosas que tu equipo estableció mientras trabajaba —por qué dejaron de usar el analizador de streaming, qué dos correcciones ya fallaron en la prueba inestable, el nombre exigido por el cliente— no pertenecen ni a un archivo de instrucciones ni a un almacén generado por laptop. Es la misma brecha que hace que compartir el contexto entre sesiones sea un problema sin resolver en cada una de estas herramientas.

La razón por la que esta migración es complicada es que ambas herramientas están resolviendo "qué debe saber siempre el agente", y ninguna está resolviendo "qué aprendimos". Los archivos de instrucciones se vuelven a enviar en cada ejecución por diseño. Un almacén local generado es por máquina por diseño. El conocimiento del equipo no es ninguna de las dos cosas.

MemoryLake se sitúa fuera de ambos. Almacena los hechos descubiertos, los expone a través de MCP y una API, y no le importa si el cliente de esta semana es Amp, Codex o algo que aún no has adoptado. Eso también hace que la próxima migración sea aburrida, que es el objetivo real.

Paso 1: Crear una clave API

Genera una clave y realiza tu primera solicitud en unos treinta segundos. Una sola clave, legible desde cada superficie que usa tu equipo, es lo que evita que el conocimiento se convierta en propiedad del directorio de configuración de un solo editor.

Paso 2: Subir tus primeras memorias

Arrastra los documentos, imágenes y archivos que ya contienen tus decisiones establecidas: notas de arquitectura, el informe del incidente detrás de la política de reintentos actual, la revisión de diseño que nadie quiere repetir. Comienza con aquello que estás cansado de volver a explicar.

Paso 3: Conectar tu IA y agentes

Dale acceso a Claude, Codex, OpenClaw y otros agentes a través de MCP o la API. En la práctica, lee las memorias relevantes al inicio de una tarea y registra las correcciones que realices durante la misma, para que la corrección sobreviva a la sesión en la que ocurrió.

La migración deja de ser riesgosa. Una vez que se reconstruye tu árbol de descubrimiento y el conocimiento de tu equipo está fuera de ambas herramientas, lo único que afectará un futuro cambio de herramienta es la sintaxis del archivo de instrucciones: una tarde de trabajo, no un proyecto de redescubrimiento.

Tus archivos AGENTS.md se vuelven más pequeños y mejores. La mayoría de los archivos de instrucciones inflados lo están porque acumularon hechos descubiertos que no tenían otro lugar a donde ir. Moverlos fuera te coloca cómodamente por debajo del límite de 32 KiB y, lo que es más útil, hace que el contenido restante trate realmente sobre cómo trabajar en el repositorio.

Activar Codex Memories se vuelve seguro. Una vez que las reglas requeridas viven en archivos registrados y el conocimiento del equipo vive en un almacén compartido, una capa de recuerdo local es una pura conveniencia sin un rol de soporte de carga. Esa es exactamente la postura que recomienda la documentación de OpenAI.

Y las cosas que solían ser tribales dejan de serlo. El Codex de un nuevo ingeniero lee las mismas decisiones establecidas que el de todos los demás en la primera tarea, en lugar de después de tres meses de absorberlas a base de ser corregido.

Reconstruye el árbol antes de confiar en él. Inicia Codex desde tu directorio de trabajo más profundo y pregunta qué cargó. La profundidad cambia la respuesta, lo cual no ocurre en Amp.

Prefiere renombrar en lugar de usar la lista de alternativas. project_doc_fallback_filenames funciona, pero es un archivo de configuración local. Un AGENTS.md renombrado está en el repositorio y funciona para todos.

Coloca las anulaciones cerca del trabajo. El propio consejo de Codex: "coloca las anulaciones lo más cerca posible del trabajo especializado", ya que el recorrido se detiene en tu directorio actual.

Vigila el límite al aplanar globs. Cada archivo de Amp con alcance de glob que se convierte en texto siempre activo ahora compite por los 32 KiB. El anidamiento es más barato que aumentar el límite.

Mantén delimitado el alcance de ## Code Review Rules. Codex lee esa sección del AGENTS.md más cercano al código que gobierna, por lo que las comprobaciones a nivel de raíz van en la raíz y las específicas del servicio en archivos anidados.

No pongas secretos en las memorias. Codex redacta secretos de los campos generados, y su documentación aún te indica que revises los archivos antes de compartir tu directorio de inicio de Codex. Ambas cosas son ciertas; trata la redacción como un respaldo de seguridad, no como un permiso.

Amp y Codex leen el mismo formato de archivo y no están de acuerdo en casi todo lo demás sobre dónde buscarlo. Amp busca hacia arriba e incluye generosamente; Codex ensambla una cadena hacia abajo, toma un archivo por directorio y se detiene en un límite de bytes. Ninguno de los dos enfoques es incorrecto, y las herramientas documentan su propio comportamiento con la suficiente claridad como para que la migración sea mecánica una vez que dejas de asumir que la compatibilidad de archivos significa compatibilidad de comportamiento.

La parte que no es mecánica es la parte que ninguna herramienta reclama. La propia documentación de Codex traza el límite por ti: las memorias son "una capa de recuerdo útil, no... la única fuente de reglas que siempre deben aplicarse", y el corolario es que existe una tercera categoría: lo que tu equipo descubrió, que es demasiado específico para un archivo de instrucciones y demasiado compartido para un almacén por laptop. Pon eso en algún lugar que ambas herramientas puedan leer, reconstruye el árbol de descubrimiento para un recorrido descendente, y la mudanza tomará una tarde y quedará resuelta definitivamente.