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
/importen 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 deplugins".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
enabledPluginsyextraKnownMarketplacesen 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.

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.

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.

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.