OpenAI facilita la migración de Claude Code a Codex

Introducción

En las herramientas de programación con IA, lo más difícil de reemplazar a menudo no es la tarifa de suscripción.

Sino todo lo que el desarrollador ha acumulado en torno a la herramienta: un CLAUDE.md cuidadosamente ajustado, docenas de pequeños trucos de flujo de trabajo, permisos de servidores MCP, comandos de barra diagonal, habilidades, memoria del proyecto y meses de historial de chat.

Estos archivos pueden estar guardados silenciosamente en el ordenador del desarrollador, pero juntos constituyen un manual operativo del flujo de trabajo de programación con IA. Migrar de Claude Code a otra herramienta, sin soporte de migración, significa que la mayor parte de esta configuración debe reconstruirse desde cero.

OpenAI ahora hace que este cambio sea mucho más fácil.

Según la documentación actual de OpenAI, la aplicación de escritorio de ChatGPT puede importar configuraciones compatibles y trabajo reciente desde Claude Code, Claude Cowork y Cursor. Codex CLI puede importar desde Claude Code y Cursor, conservando la configuración existente en lugar de eliminarla o reemplazarla.

Esto suena como una simple función de conveniencia. Pero en realidad, cambia el nivel de fricción que enfrentan los desarrolladores al cambiar entre diferentes herramientas de programación con IA.

OpenAI está empaquetando la configuración de los usuarios de Claude Code

OpenAI recientemente consolidó sus instrucciones de importación de agentes externos en un único flujo de trabajo.

En la aplicación de escritorio de ChatGPT, los usuarios pueden abrir Configuración → Importar y seleccionar agentes compatibles como Claude Code, Claude Cowork o Cursor. En Codex CLI, el punto de entrada correspondiente es:

/import

La documentación oficial actual indica que la aplicación de escritorio puede importar instrucciones, configuraciones, habilidades, complementos, proyectos y trabajo reciente. Codex CLI puede importar configuraciones compatibles, archivos de proyecto e historial de chat reciente desde Claude Code o Cursor.

El detalle importante es que la importación es una copia, no una migración destructiva.

La documentación de OpenAI señala explícitamente que la importación no modifica ni elimina la configuración del agente existente. En otras palabras, tu configuración de Claude Code o Cursor permanece en su lugar, mientras Codex recibe su propia versión importada.

Esto hace que todo el proceso no se sienta como reemplazar una herramienta, sino más bien como llevar tu entorno de desarrollo existente a una segunda herramienta.

Lo que se migra es más de lo que esperas

La documentación oficial de importación proporciona un mapeo bastante detallado de la configuración de origen al destino de Codex.

Por lo tanto, la conversión no es siempre una simple copia de archivos.

Los archivos de instrucciones de Claude Code, como CLAUDE.md, se convierten en AGENTS.md. El settings.json de Claude Code se transforma en el config.toml de Codex. Los comandos de barra diagonal se mapean a habilidades, y los subagentes se convierten en agentes de Codex.

Esta distinción es importante porque una importación exitosa no significa necesariamente que cada proyecto se comporte exactamente igual después.

Los nombres pueden cambiar,

los formatos de configuración pueden variar y el modelo de ejecución también cambiará.

Los proyectos se reutilizan, no se suben como copias nuevas

La migración de proyectos es otro detalle útil.

La documentación de OpenAI indica que las carpetas de proyectos existentes se importan como proyectos que usan las mismas carpetas. Por lo tanto, el flujo de trabajo no requiere copiar todo el repositorio para continuar usándolo en Codex.

La interfaz de importación también permite a los usuarios elegir qué contenido traer, en lugar de forzar una migración de todo o nada.

Esto significa que la configuración, las instrucciones, las habilidades, los complementos, los proyectos y el historial de chat pueden revisarse como partes independientes de la migración.

Puedes continuar conversaciones antiguas después de la importación

La migración tiene otro problema práctico: las conversaciones antiguas pueden ser demasiado grandes para que la herramienta de destino las procese de una sola vez.

Codex maneja esto mediante la gestión del contexto, en lugar de simplemente rechazar las conversaciones importadas.

La documentación actual de OpenAI indica que Codex CLI puede importar hasta 50 chats de los últimos 30 días. El flujo de importación de escritorio también admite chats recientes y permite a los usuarios continuar trabajando desde proyectos o conversaciones importados.

El artículo fuente describe la experiencia de la siguiente manera: cuando una conversación de Claude Code migrada es demasiado larga, Codex puede comprimir el contenido anterior cuando el usuario continúa por primera vez con esa conversación importada, liberando contexto para la siguiente ronda.

El objetivo real es simple: la migración no debería terminar con un registro de importación enorme que se vuelva inmediatamente inutilizable.

Este flujo de importación ha estado en constante expansión

El artículo fuente rastrea la evolución de esta función en múltiples versiones de Codex.

El artículo informa que /import apareció por primera vez en Codex CLI 0.140.0, con soporte para un rango más limitado de importaciones de Claude Code. Las versiones posteriores ampliaron el flujo de trabajo, agregando áreas de migración adicionales, luego soporte para habilidades de Cursor y sincronización de sesiones importadas.

El historial de versiones específico ayuda a comprender la velocidad de evolución de la función, pero para el soporte actual, la documentación oficial existente es una mejor referencia. Confirma que el flujo de importación ahora cubre un rango más amplio de configuraciones de agentes y trabajo reciente que las versiones anteriores.

En la práctica, sigue siendo una migración unidireccional

El artículo fuente hace una observación más aguda: la documentación de migración se centra en importar a Codex, no en exportar la configuración de Codex de vuelta a Claude Code.

Aquí hay una distinción importante.

La documentación actual de OpenAI admite actualizaciones automáticas desde el agente original a la configuración importada en la aplicación de escritorio de ChatGPT. Los usuarios pueden habilitar las actualizaciones automáticas en Configuración → Importar y ver el historial de importación allí.

Esto no significa que las ediciones realizadas en Codex se escriban automáticamente de vuelta en Claude Code o Cursor.

La dirección sigue siendo importante: el entorno original puede continuar suministrando actualizaciones a la copia importada, pero la copia importada no se presenta como una capa de sincronización bidireccional.

Para los desarrolladores, esto significa que, antes de habilitar las actualizaciones automáticas, vale la pena decidir qué entorno es la fuente autoritativa.

OpenAI y Anthropic están manejando la migración de manera diferente

La competencia más amplia

no se limita solo a OpenAI.

El artículo fuente señala que Anthropic también ha estado desarrollando herramientas de migración destinadas a traer el contexto del usuario a Claude. La documentación de ayuda actual de Anthropic también ofrece procesos oficiales de exportación de datos para sus usuarios de Claude, incluido el historial de conversaciones y los datos de la cuenta.

Esto crea una diferencia filosófica significativa.

Si una plataforma admite tanto la importación como la exportación, los usuarios pueden migrar más libremente el contexto que han acumulado. Si la migración fluye principalmente en una sola dirección, entonces esa función también puede convertirse en una herramienta poderosa para reducir la fricción de que los usuarios se cambien a la plataforma de destino.

Los detalles técnicos difieren, pero la cuestión estratégica es la misma: ¿A quién pertenecen los flujos de trabajo de IA que los desarrolladores han acumulado, y qué tan portátiles son?

OpenAI también ha puesto Codex dentro de Claude Code

Antes de expandir su flujo de importación, OpenAI ya había actuado en la dirección opuesta.

Su proyecto de código abierto codex-plugin-cc permite a los desarrolladores utilizar Codex dentro de Claude Code para revisiones de código y delegación de tareas. El complemento incluye comandos como /codex:review y /codex:transfer, donde este último puede crear un hilo persistente de Codex desde una sesión de Claude Code.

El repositorio se publica bajo la licencia Apache-2.0 y es mantenido por OpenAI.

El flujo de trabajo de /codex:transfer es especialmente relevante para la historia de la migración.

La documentación del complemento indica que puede tomar la sesión actual de Claude Code y crear un hilo persistente de Codex, permitiendo que el trabajo continúe directamente en Codex. Esa transferencia utiliza Codex

El importador de sesiones de agentes externos, y sigue las mismas reglas de conversión que el historial de importación de Claude.

Esto es diferente de simplemente iniciar una nueva experiencia de conversación con Codex.

Su objetivo es transportar el contexto de trabajo en sí mismo a través de las fronteras.

Aún hay cuatro cosas que no se pueden migrar sin problemas

Un botón de migración puede eliminar mucha fricción, pero no puede hacer que dos agentes de codificación diferentes se vuelvan idénticos.

El artículo fuente destaca cuatro áreas en las que los desarrolladores deben esperar tener que intervenir manualmente.

1. Permisos

Claude Code puede incluir reglas de permisos cuidadosamente ajustadas en torno a archivos, comandos, herramientas y flujos de trabajo específicos.

Codex tiene su propio modelo de permisos y sandbox. Por lo tanto, los ajustes relacionados con permisos importados deben revisarse, y no se debe asumir que son equivalentes.

La documentación de OpenAI recomienda específicamente revisar las restricciones de herramientas y permisos en las habilidades y agentes importados después de la migración.

Un punto importante es que la migración de permisos se trata de preservar la intención original, no solo de renombrar ajustes.

1. Ganchos

Los ganchos son otra área donde el comportamiento puede diferir.

La documentación de importación de OpenAI advierte explícitamente que los ganchos importados pueden comportarse de manera diferente después de la migración y deben ser revisados.

Los ganchos simples pueden transferirse sin problemas. Las cadenas más complejas, con condiciones, suposiciones de entorno o comportamiento asíncrono, pueden necesitar ser rediseñadas para la herramienta de destino.

Así que no siempre es un problema de conversión. A veces es un problema de rediseño del flujo de trabajo.

1. El modelo también cambia

Esta puede ser la diferencia más obvia, pero también una de las más fáciles de pasar por alto.

Puedes mover tus instrucciones, habilidades, configuración de MCP, archivos de proyecto y memoria se pueden importar a Codex, pero el modelo que ejecuta estas instrucciones sigue siendo diferente.

Los prompts o archivos CLAUDE.md ajustados para el comportamiento de Claude pueden no producir exactamente los mismos resultados cuando los ejecuta un modelo de OpenAI.

La configuración puede haberse migrado con éxito, pero el comportamiento detrás de ella ha cambiado.

El artículo original señala que Codex está diseñado en torno a los propios modelos de OpenAI y los flujos de trabajo basados en Responses. Los desarrolladores que deseen enrutar Codex a un proveedor personalizado deben tratarlo como una tarea de configuración independiente, y no asumir que la configuración del modelo de Claude importada continuará automáticamente.

1. El historial de chat tiene límites

No todas las conversaciones son elegibles para la migración.

La documentación actual de OpenAI muestra que Codex CLI importa un máximo de 50 chats de los últimos 30 días. El comando /import también tiene limitaciones operativas: no está disponible durante la ejecución de una tarea, en sesiones remotas, ni cuando está conectado al demonio del servidor de aplicaciones local.

La documentación actual también distingue entre ajustes locales y ajustes a nivel de proyecto, lo que significa que los desarrolladores deben verificar exactamente dónde se encuentran los archivos y la configuración antes de comenzar la importación.

El resultado es una regla práctica útil:

La importación con un clic no significa que no se requiera revisión.

El activo realmente valioso no es la suscripción al modelo

Los benchmarks de los modelos cambian rápidamente.

Un modelo puede liderar en un mes y luego ser reemplazado por otra versión. Lo que cambia mucho más lentamente son los flujos de trabajo del desarrollador circundante.

CLAUDE.md, AGENTS.md, habilidades, servidores MCP, permisos, memoria del proyecto, comandos y conversaciones acumuladas se vuelven más valiosos con el tiempo porque codifican la forma real de trabajar del desarrollador.

Esto convierte a la portabilidad en un problema competitivo.

Cuanto más reutilizables sean estas configuraciones, menor será la dependencia del desarrollador de una plataforma de programación de IA en particular.

Y esta espada de doble filo también funciona en ambas direcciones.

Los estándares abiertos como SKILL.md, AGENTS.md y las definiciones MCP estandarizadas facilitan la migración de flujos de trabajo de una herramienta a otra. La interoperabilidad que ayuda a OpenAI a atraer usuarios de Claude Code también puede facilitar que esos usuarios se vayan de Codex.

Para los desarrolladores, la estrategia práctica es directa:

Conserva los activos de flujo de trabajo importantes en un formato portátil siempre que sea posible y evita que todo el proceso de desarrollo dependa de una herramienta propietaria.

Preguntas frecuentes

¿Qué puede importar Codex desde Claude Code?

Codex puede importar instrucciones compatibles, ajustes, habilidades, plugins, archivos de proyecto, chats recientes, configuración de MCP, ganchos, comandos de barra y subagentes. La documentación de OpenAI también asigna la memoria del proyecto de Claude Code a la memoria de Codex.

¿Cómo importo Claude Code a Codex CLI?

Inicia una sesión local de Codex CLI y ejecuta /import. Luego selecciona Claude Code, elige los ajustes compatibles o archivos de proyecto y chats recientes que deseas traer, y revisa la configuración importada.

¿Se puede importar Cursor a Codex?

Sí. La documentación actual de OpenAI muestra que Codex CLI puede importar desde Cursor, y la aplicación de escritorio de ChatGPT puede importar desde Claude Code, Claude Cowork y Cursor.

¿Importar a Codex eliminará mi configuración de Claude Code?

No. OpenAI declara explícitamente que la importación no cambia ni elimina la configuración de agentes existente. La configuración importada se incorpora por separado al entorno de destino.

¿Cuántos chats de Claude Code puede importar Codex?

Codex CLI puede importar hasta 50 conversaciones de los últimos 30 días. El comando /import también tiene ciertas limitaciones en cuanto a cuándo puede usarse, por lo que es mejor ejecutarlo en una sesión CLI local normal.

¿Las habilidades de Claude Code se comportarán exactamente igual en Codex?

No necesariamente. Las habilidades, ganchos, permisos, plugins y plantillas de comandos pueden depender del comportamiento de la herramienta original, por lo que OpenAI recomienda revisarlos antes de depender de la configuración importada.

¿Puedo transferir directamente una sesión de Claude Code a Codex?

El codex-plugin-cc de OpenAI proporciona el comando /codex:transfer, que puede crear un hilo persistente de Codex desde una sesión de Claude Code. Este plugin está diseñado específicamente para continuar el trabajo de Claude Code en Codex.

Herramientas relacionadas

• OpenAI Codex: El agente de programación de OpenAI para flujos de trabajo de desarrollo de software.
• Codex CLI: La interfaz de línea de comandos para usar Codex localmente.
• Claude Code: El agente de programación de Anthropic y el entorno fuente principal discutido en esta guía de migración.
• Cursor: Un editor de código impulsado por IA compatible con el flujo de trabajo de importación de Codex.
• OpenAI Codex Plugin for Claude Code: El plugin oficial de OpenAI para usar Codex dentro de Claude Code.

Enlaces relacionados

• Documentación de importación de OpenAI: Guía oficial para importar ajustes y trabajo reciente desde otros agentes de IA.
• Documentación de Codex CLI: Documentación oficial para instalar y usar Codex CLI.
• OpenAI Codex Plugin for Claude Code: Repositorio oficial de OpenAI para la integración con Claude Code.
• README del plugin Codex: Instrucciones de instalación y uso del plugin para Claude Code.
• Exportación de datos de Claude: Guía oficial de Anthropic para exportar datos de Claude.

Guía sobre los datos de cuentas y conversaciones.

• OpenAI Developers: El principal centro de documentación para desarrolladores de OpenAI.
• OpenAI Devs en X: La publicación de desarrolladores de OpenAI citada en el artículo fuente.

Resumen

El flujo de importación que ofrece actualmente OpenAI elimina una gran barrera de migración para los desarrolladores que han acumulado meses de configuración y contexto en Claude Code o Cursor. Las instrucciones, habilidades, complementos, proyectos, configuraciones de MCP, memoria y registros de chat recientes ahora pueden transferirse a Codex mediante procesos de importación compatibles.

La limitación importante es que la migración no equivale a una compatibilidad perfecta. Los permisos, enlaces (hooks), indicaciones, complementos y comportamientos del modelo pueden cambiar después de la migración, por lo que las configuraciones importadas deben revisarse antes de su uso.

Se convierten en parte de los flujos de trabajo de producción.

La configuración de IA para codificación más portátil es aquella que mantiene las instrucciones, habilidades y conocimientos del proyecto valiosos e independientes de cualquier agente único.