MemoryLake
Volver a todos los artículos
Tutorial16 de noviembre de 2026·10 min de lectura

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

En pocos meses, su configuración de Claude Code ha desarrollado un conjunto de plugins: uno del marketplace oficial de Anthropic, un marketplace de equipo que mantiene su empresa y un par que instaló para un proyecto específico. Cada uno agrupa habilidades, hooks, agentes o servidores MCP en los que ahora confía sin pensarlo. Ahora quiere trabajar en Codex, al menos parte del tiempo, y preferiría no reconstruir esa configuración a mano.

No tiene que empezar de cero. La documentación de importación de OpenAI indica que Codex puede traer los plugins junto con el resto de su configuración, y explica cómo Codex los encuentra: lee su archivo de configuración de Claude Code para ver qué plugins tiene habilitados y de qué marketplaces provienen.

Pero un plugin es más que un nombre en un archivo de configuración. Algunos guardan datos en su propia carpeta, otros necesitan inicio de sesión y algunos ejecutan hooks que Codex no ejecutará hasta que usted los haya revisado. Esta guía cubre lo que contiene un plugin de Claude Code, lo que la importación de Codex detecta y transfiere, los formatos de plugins que Codex puede leer, lo que necesita seguimiento después de la importación, cómo se comportan los hooks de los plugins en Codex, una migración paso a paso y cómo mantener el contexto del que dependen sus plugins en un solo lugar.

Qué contiene un plugin de Claude Code

La documentación de plugins de Anthropic lo describe de esta manera: "Un plugin de Claude Code es un directorio de habilidades, agentes, hooks, servidores MCP u otros componentes que Claude Code instala y carga como una unidad".

El manifiesto del plugin reside en .claude-plugin/plugin.json. La mayoría de los plugins provienen de un marketplace, que es un catálogo que enumera los plugins y dónde obtener cada uno.

Cuando instala un plugin, Claude Code lo registra en su configuración. Cada plugin tiene un ID de instalación con el formato <entry-name>@<marketplace>, que Anthropic describe como la clave que Claude Code escribe bajo enabledPlugins en su archivo de configuración. Para un plugin instalado a nivel de usuario, esa entrada va en ~/.claude/settings.json. Los marketplaces que usted o su organización registraron pueden aparecer bajo extraKnownMarketplaces.

Otras dos ubicaciones son importantes para una migración:

  • Los archivos instalados del plugin. Claude Code los expone como CLAUDE_PLUGIN_ROOT. La documentación advierte que esta ruta "cambia cuando el plugin se actualiza, así que no escriba estados allí".
  • El directorio de datos del plugin. Claude Code lo expone como CLAUDE_PLUGIN_DATA, ubicado en ~/.claude/plugins/data/<id>/. Se "crea en la primera referencia y se mantiene a través de las actualizaciones del plugin", y Anthropic enumera las dependencias instaladas, el código generado y las cachés como contenidos típicos.

Los plugins también pueden solicitarle valores de configuración. Un valor marcado como sensible se almacena "en almacenamiento seguro en lugar de en settings.json", según la referencia del manifiesto.

Qué transfiere la importación de Codex

El flujo de importación de OpenAI es el punto de partida. Está disponible en dos lugares:

  • La aplicación de escritorio de ChatGPT, que puede importar desde Claude Code, Claude Cowork o Cursor, en Settings, luego Import.
  • La CLI de Codex, que puede importar desde Claude Code o Cursor con /import en una sesión inactiva.

La documentación de OpenAI enumera lo que cubre la importación. Los plugins están en la lista, junto con los archivos de instrucciones, que se convierten en AGENTS.md, su settings.json, que se mapea a config.toml, habilidades, configuración de servidores MCP, hooks, comandos de barra (slash commands), que se convierten en habilidades, y subagentes. Las memorias de proyecto de Claude Code pasan a ser memorias de Codex, y los chats de los últimos 30 días se convierten en chats de ChatGPT.

Una garantía inicial: "Importar no cambia ni elimina su configuración de agente existente". Sus plugins de Claude Code permanecen instalados y funcionando donde están.

Si planea seguir usando ambas herramientas por un tiempo, la aplicación de escritorio también puede mantener sincronizado el trabajo importado. OpenAI dice que puede activar las actualizaciones automáticas en Settings, luego Import, "para mantener el trabajo importado sincronizado con el agente original", y revisar su historial de importación en el mismo lugar. Esto es importante para los plugins que sigue actualizando en Claude Code, ya que de lo contrario una importación única quedaría desactualizada.

Cómo encuentra Codex sus plugins

Para los plugins específicamente, la documentación explica el paso de detección: "Al detectar plugins desde .claude/settings.json, Codex lee las fuentes de marketplace configuradas en extraKnownMarketplaces".

También hay una alternativa para el marketplace oficial. Si su lista de enabledPlugins incluye plugins de claude-plugins-official pero la fuente del marketplace no aparece en la lista, Codex infiere anthropics/claude-plugins-official como la fuente.

La referencia del servidor de aplicaciones añade que, para los elementos de plugin, Codex enumera cada nombre de marketplace y los nombres de los plugins que "puede intentar migrar". Vale la pena notar esa redacción. La detección le indica lo que Codex intentará, no que cada plugin funcionará sin cambios.

La detección también es incremental. OpenAI señala que "devuelve solo los elementos que aún tienen trabajo por hacer". Por ejemplo, Codex omite el paso del archivo de instrucciones cuando AGENTS.md ya existe y no está vacío, y las importaciones de habilidades no sobrescriben los directorios de habilidades existentes. Si ya ha configurado parte de Codex a mano, la importación no lo reemplazará.

Los formatos de plugins que Codex puede leer

Codex tiene su propio formato de plugin, con un manifiesto en .codex-plugin/plugin.json. También puede leer plugins y marketplaces en formato Claude.

La declaración más clara se encuentra en la guía de OpenAI para administradores de espacios de trabajo que importan plugins desde GitHub. Un repositorio de marketplace debe contener uno de estos archivos:

  • .agents/plugins/marketplace.json, un marketplace de Codex
  • .claude-plugin/marketplace.json, descrito como "Un marketplace compatible con Claude con un array de plugins"
  • .claude-plugin/plugin.json, "Un plugin de Claude independiente, cuando no hay un manifiesto de marketplace presente"

La misma guía señala que las entradas del marketplace "pueden hacer referencia a plugins nativos con .codex-plugin/plugin.json, plugins compatibles con Claude, paquetes de Agent Plugins 1.0 o paquetes de habilidades compatibles".

Esa importación de espacio de trabajo es una función de administrador para espacios de trabajo de ChatGPT, y actualmente solo admite repositorios de GitHub. Si su equipo ya mantiene un marketplace de Claude Code en GitHub, un administrador puede apuntar el espacio de trabajo hacia él en lugar de convertir cada plugin.

Qué necesita seguimiento después de la importación

La importación es un primer paso. La documentación de OpenAI enumera lo que se debe revisar antes de confiar en la configuración importada, y los plugins están incluidos. La lista incluye:

  • Restricciones de herramientas o permisos en habilidades y agentes importados
  • Configuración de servidores MCP con autenticación personalizada, encabezados, variables de entorno o transportes, donde "Es posible que deba iniciar sesión nuevamente"
  • "Hooks cuyo comportamiento puede diferir después de la importación"
  • "Plugins, marketplaces u otra configuración que necesite seguimiento manual"

En la aplicación de escritorio, la importación "Comprueba si los plugins o conexiones importados aún necesitan configuración" y muestra una tarjeta de estado cuando necesita finalizar la configuración. Al seleccionar Finish, se le guiará a través de lo que queda pendiente.

Para las importaciones de espacios de trabajo, hay otro paso. La configuración de instalación y autenticación no se toma del repositorio, e "Importar un plugin no otorga acceso a la aplicación a los miembros ni conecta sus cuentas". Cada persona sigue conectando sus propias cuentas.

Cómo se comportan los hooks de los plugins en Codex

Los hooks necesitan la mayor atención en esta migración, porque Codex no los ejecutará hasta que usted los haya revisado.

Cuando un plugin está habilitado, Codex puede cargar sus hooks de ciclo de vida junto con los hooks de usuario, de proyecto y gestionados. Por defecto, busca hooks/hooks.json dentro de la raíz del plugin.

Para mayor compatibilidad, Codex otorga a los comandos de hook de los plugins las mismas variables de entorno que utiliza Claude Code. La documentación de hooks de OpenAI dice: "Codex también establece CLAUDE_PLUGIN_ROOT y CLAUDE_PLUGIN_DATA para la compatibilidad con los hooks de plugins existentes". Los equivalentes propios de Codex, PLUGIN_ROOT y PLUGIN_DATA, apuntan a la raíz del plugin instalado y al directorio de datos escribibles del plugin.

Observe lo que esto significa para los datos almacenados. Codex establece esa variable por sí mismo, junto con su propio PLUGIN_DATA. La lista de lo que se transfiere en la documentación de importación no incluye los directorios de datos de los plugins. Si un plugin acumuló algo útil en ~/.claude/plugins/data/<id>/ en el lado de Claude Code, verifique si el plugin lo necesita antes de asumir que estará allí en Codex.

La otra diferencia es la revisión. "Los hooks de los plugins utilizan el mismo esquema de eventos que otros hooks. Revíselos y confíe en ellos antes de que se ejecuten". En la CLI, los revisa con /hooks. En la aplicación de escritorio, selecciona Review hooks en el compositor o abre Settings, luego Hooks. Y "Si una actualización de plugin cambia un script incluido, Codex requiere una nueva revisión incluso si la definición del hook sigue siendo la misma". Cubrimos el ciclo de revisión en nuestra guía sobre por qué los hooks de Codex necesitan revisión.

Qué verificar antes de comenzar

  • Haga una lista de lo que tiene. Observe enabledPlugins y extraKnownMarketplaces en sus archivos de configuración de Claude Code, a nivel de usuario y de proyecto.
  • Anote la configuración sensible. Los valores que un plugin almacenó en el almacenamiento seguro no están en settings.json, así que planee ingresarlos de nuevo.
  • Busque plugins que guarden datos. Revise ~/.claude/plugins/data/ para ver si hay directorios con contenido del que dependa un plugin.
  • Identifique los hooks. Note qué plugins ejecutan hooks, para saber qué revisar en Codex.
  • Separe los plugins de equipo de los personales. Los marketplaces de equipo pueden ser mejor manejados una sola vez por un administrador.

Lo que la gente intenta primero

Esperar que cada plugin funcione sin cambios. Codex enumera los plugins que puede intentar migrar. Algunos necesitan seguimiento manual.

Asumir que los hooks se ejecutan de inmediato. Codex requiere que revise y confíe en los hooks de los plugins antes de que se ejecuten.

Olvidar los secretos. Los valores sensibles viven en el almacenamiento seguro, no en el archivo de configuración que lee Codex.

Reinstalar un marketplace de equipo plugin por plugin. Un administrador de espacio de trabajo puede importar todo el marketplace desde GitHub.

Esperar que la importación afecte a Claude Code. No cambia ni elimina su configuración existente.

La migración manual

Paso 1: Inventario de plugins y marketplaces

Registre cada plugin habilitado, su marketplace, si tiene hooks y si guarda datos o configuraciones sensibles.

Paso 2: Ejecutar la importación

Use Settings, luego Import, en la aplicación de escritorio de ChatGPT, o /import en una sesión inactiva de la CLI de Codex. Seleccione su configuración de Claude Code y elija los plugins que desee.

Paso 3: Finalizar la configuración e iniciar sesión

Siga la tarjeta de estado en la aplicación de escritorio, inicie sesión en los servidores MCP que lo necesiten y vuelva a ingresar los valores sensibles.

Paso 4: Revisar y confiar en los hooks

Abra /hooks en la CLI, o Review hooks en la aplicación de escritorio, lea cada hook de plugin y confíe en los que desee ejecutar.

Paso 5: Probar cada plugin con una tarea familiar

Ejecute una tarea que conozca bien con cada plugin migrado y compare el resultado con lo que produce Claude Code.

La mejor manera: Mantenga el contexto del que dependen sus plugins en un solo lugar

Los plugins llevan procedimientos: habilidades, hooks y herramientas. Sobre lo que actúan es el contexto de su proyecto, como convenciones, decisiones y restricciones, y eso es lo que tiene que ser igual en ambas herramientas.

MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, convenciones y las razones detrás de ellas, mantenida en un solo lugar y disponible para los asistentes que conecte, como ChatGPT, Claude Code y Codex.

Usted mismo escribe las entradas, con sus propias palabras. No se lee nada, ni se escribe ni se elimina de sus plugins de Claude Code, sus directorios de datos, sus archivos de configuración, sus plugins o hooks de Codex, sus archivos AGENTS.md ni de la tienda de ningún proveedor. La importación de plugins y la revisión de hooks funcionan de la manera que describen OpenAI y Anthropic.

Paso 1: Crear una clave API

Inicie sesión y genere una clave desde el panel de control. Manténgala fuera de los archivos de configuración de plugins y de los repositorios.

La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente
La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente

Paso 2: Subir sus primeras memorias

Comience con lo que sus plugins asumen: las convenciones que sus habilidades imponen, las razones detrás de sus hooks y las decisiones del proyecto de las que dependen. Una convención o decisión por entrada.

El espacio de trabajo de MemoryLake con los primeros documentos subidos, enumerando cada archivo a medida que se convierte en memoria buscable
El espacio de trabajo de MemoryLake con los primeros documentos subidos, enumerando cada archivo a medida que se convierte en memoria buscable

Paso 3: Conectar su IA y agentes

Conecte Claude Code y Codex, además de ChatGPT u otros asistentes que utilice. Ambas herramientas de codificación pueden recurrir a las mismas entradas mientras las ejecuta en paralelo.

La pantalla de integraciones de MemoryLake que enumera los clientes de IA y los marcos de agentes que se pueden conectar a la capa de memoria
La pantalla de integraciones de MemoryLake que enumera los clientes de IA y los marcos de agentes que se pueden conectar a la capa de memoria

Qué cambia esto en la práctica

La primera diferencia es una migración que no depende de que cada plugin se mueva limpiamente. El contexto detrás de su configuración ya está escrito.

La segunda es la consistencia mientras usa ambas herramientas. Una convención que actualice se aplica en Claude Code y Codex a la vez, no solo en la herramienta que editó.

La tercera es una revisión más clara. Cuando lee los hooks de un plugin en Codex, puede verificarlos contra las razones que registró para tenerlos.

Mejores prácticas para mover plugins de Claude Code a Codex

Inventario primero. Sepa qué plugins, marketplaces, hooks y datos almacenados tiene.

Use la importación. Detecta plugins de su configuración y no cambiará su configuración de Claude Code.

Trate la detección como una lista para verificar. Codex enumera los plugins que puede intentar migrar.

Revise los hooks deliberadamente. Confíe solo en los que comprenda y espere una nueva revisión después de las actualizaciones de los plugins.

Vuelva a ingresar los secretos. Las configuraciones sensibles no están en el archivo que lee la importación.

Deje que los administradores manejen los marketplaces de equipo. Un marketplace compatible con Claude en GitHub puede importarse a un espacio de trabajo.

Mantenga el contexto compartido fuera de ambas herramientas. Los plugins se mueven; las razones detrás de ellos deben permanecer en un solo lugar.

Conclusión

Codex puede transferir sus plugins de Claude Code. Su importación lee enabledPlugins y extraKnownMarketplaces de su configuración de Claude Code, puede inferir el marketplace oficial y enumera los plugins que puede intentar migrar. Codex lee plugins y marketplaces en formato Claude, y establece CLAUDE_PLUGIN_ROOT y CLAUDE_PLUGIN_DATA para que los hooks de plugins existentes puedan ejecutarse.

Lo que aún depende de usted: los hooks deben ser revisados y aceptados antes de ejecutarse, las configuraciones sensibles y los inicios de sesión deben rehacerse, y los directorios de datos de los plugins no están en la lista de lo que cubre la importación. Verifique cada uno de esos puntos, pruebe cada plugin en una tarea familiar y mantenga el contexto del proyecto sobre el que actúan sus plugins en algún lugar que ambas herramientas puedan usar.

Preguntas frecuentes

¿Puede Codex importar plugins de Claude Code?

Sí. El flujo de importación de OpenAI enumera los plugins entre los elementos que puede traer desde Claude Code, en la aplicación de escritorio de ChatGPT y en la CLI de Codex con /import.

¿Cómo sabe Codex qué plugins uso?

Lee .claude/settings.json, incluyendo extraKnownMarketplaces, e infiere el marketplace oficial cuando los plugins habilitados provienen de él sin una fuente enumerada.

¿Importar cambia mi configuración de Claude Code?

No. OpenAI afirma que importar no cambia ni elimina su configuración de agente existente.

¿Se ejecutarán los hooks de los plugins automáticamente en Codex?

No hasta que los revise y confíe en ellos, en /hooks en la CLI o en Review hooks en la aplicación de escritorio.

¿Codex admite los formatos de plugins de Claude?

Codex lee .claude-plugin/marketplace.json y .claude-plugin/plugin.json, y establece CLAUDE_PLUGIN_ROOT y CLAUDE_PLUGIN_DATA para la compatibilidad con los hooks de plugins existentes.

¿Qué pasa con los datos guardados de mi plugin?

Los directorios de datos de los plugins no están en la lista de lo que transfiere la importación. Verifique si un plugin depende de sus datos antes de confiar en él en Codex.

¿Puede mi equipo importar todo nuestro marketplace?

Un administrador de espacio de trabajo puede importar un marketplace desde un repositorio de GitHub, incluyendo uno compatible con Claude.