Plugin de Codex para Claude Code: cómo instalarlo y usarlo con límites claros

El plugin de Codex para Claude Code es openai/codex-plugin-cc, un proyecto mantenido por OpenAI para invocar Codex desde una sesión de Claude Code y usarlo en revisiones o tareas delegadas. No sustituye el modelo de Claude Code, no es un servidor MCP genérico y tampoco convierte Codex en un servicio aislado de tu máquina.

La ruta documentada consta de cuatro pasos distintos: añadir el marketplace de OpenAI, instalar el plugin, recargar los plugins y ejecutar la configuración. El punto crítico llega después: /codex:review y /codex:adversarial-review están documentados como acciones de solo lectura, pero esa garantía no abarca cualquier tarea delegada. Esta guía te permite comprobar ambas cosas antes de probar el plugin en un repositorio real.

“

Estado de la guía: comandos y requisitos contrastados con la documentación pública el 15 de agosto de 2026. La instalación no se ejecutó durante la elaboración de este artículo; usa los puntos de comprobación para validar tu sistema, tu versión de Claude Code y las políticas de tu empresa.

Comprueba primero que es el plugin correcto

La referencia principal debe ser el repositorio público mantenido por OpenAI. Ese origen permite distinguir este proyecto de tutoriales antiguos, réplicas, listados de plugins y flujos manuales que también combinan Claude Code con Codex.

Hay además una distinción importante entre marketplace y plugin. Claude Code trata el registro de un marketplace y la instalación de un plugin como pasos separados. Añadir openai/codex-plugin-cc permite que Claude Code conozca ese catálogo; todavía hay que instalar codex@openai-codex. Que el repositorio pertenezca a OpenAI no significa que el catálogo sea el marketplace oficial de Anthropic. La documentación de plugins de Claude Code explica este modelo general y advierte que plugins y marketplaces son componentes de alta confianza: pueden ejecutar código con los permisos del usuario.

Esta comprobación de procedencia no es un formalismo. Evita tres errores frecuentes:

• seguir una guía cuyos comandos o requisitos ya no coinciden con el README actual;
• creer que añadir un marketplace equivale a terminar la instalación;
• asumir que todas las acciones iniciadas desde el plugin son de solo lectura.

Comprueba los requisitos antes de añadir el marketplace

El apartado de requisitos enumera:

• Node.js 18.18 o posterior;
• acceso a Codex mediante uno de los planes de ChatGPT indicados por OpenAI —incluido Free—, o una clave de la API de OpenAI;
• el Codex CLI instalado globalmente, con la autenticación y la configuración local que el plugin reutilizará.

La inclusión de un tipo de plan no demuestra que tu cuenta, región o workspace tenga permiso en este momento. Tampoco confirma la cuota que te queda. El uso del plugin contribuye a los límites de uso de Codex, que dependen del plan, el modelo, la complejidad de la tarea, el contexto y las condiciones del workspace. La documentación de precios de Codex sirve para comprobar las vías de acceso actuales, pero no permite calcular por sí sola el precio final con impuestos en España ni el coste combinado con Claude Code.

Antes de instalar, confirma en tu propia máquina:

1. que node --version devuelve 18.18 o una versión posterior;
2. que la política de tu espacio de trabajo permite añadir marketplaces y plugins;
3. que el Codex CLI instalado globalmente puede usar la autenticación y la configuración que esperas;
4. que aceptas que el trabajo consumirá tus límites de Codex.

El README no fija una versión mínima exacta de Claude Code. Si la sintaxis de plugins no existe en tu instalación o la política del workspace la bloquea, no des por hecho que repetir los comandos resolverá el problema: verifica primero la versión, la política y la documentación actual de Anthropic.

Instalación documentada, paso a paso

Ejecuta estos comandos dentro de Claude Code y en este orden:

text
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup

Cada paso habilita el siguiente y deja un punto de comprobación distinto: catálogo, plugin, sesión y entorno local.

1. Añade el marketplace

text
/plugin marketplace add openai/codex-plugin-cc

Este paso registra el origen del catálogo. Comprueba la respuesta de Claude Code antes de continuar. Si informa de un problema de red, política o confianza, resuélvelo en ese punto; instalar repetidamente el nombre del plugin no corrige un marketplace que no pudo registrarse.

2. Instala el plugin concreto

text
/plugin install codex@openai-codex

Aquí se instala codex desde el marketplace identificado como openai-codex. Mantén el identificador exacto: traducirlo o sustituirlo por el nombre del repositorio cambia el objetivo del comando.

3. Recarga los plugins

text
/reload-plugins

La recarga hace que la sesión actual reconozca el plugin recién instalado sin obligarte a interpretar su ausencia como un fallo de Codex. Anthropic documenta /reload-plugins como parte de la gestión de plugins; si tu versión no reconoce el comando, esa incompatibilidad debe aclararse antes de seguir.

4. Ejecuta la configuración de Codex

text
/codex:setup

El plugin se apoya en el Codex CLI instalado globalmente y envuelve su servidor de aplicación local. Reutiliza la autenticación, el checkout del repositorio, el entorno de la máquina y la configuración de Codex que ya existen. Por eso, un problema en este punto puede pertenecer al CLI, a la autenticación, a la configuración del proveedor, al repositorio o a la política local; el plugin no crea un entorno de ejecución separado ni evita esas restricciones.

Considera la instalación verificada solo cuando cada etapa anterior haya terminado sin un error pendiente y /codex:setup reconozca el entorno previsto. Esta guía describe el contrato oficial, no garantiza el mismo resultado en todos los sistemas operativos, versiones, redes corporativas o configuraciones personalizadas.

Empieza por una revisión de solo lectura

Para una primera prueba sobre un repositorio importante, la opción con el límite más claro es una acción que el README documenta como revisión de solo lectura:

text
/codex:review

También está documentada como solo lectura la revisión adversarial:

text
/codex:adversarial-review

La diferencia relevante no es solo el estilo de revisión. Estas dos acciones tienen un alcance de lectura declarado; esa propiedad no se extiende automáticamente a toda tarea que puedas iniciar mediante el plugin. Revisa el resultado, confirma qué checkout y configuración está usando Codex y no interpretes “se ejecuta desde Claude Code” como una garantía global de no escritura.

Una revisión inicial resulta útil para validar, sin pedir cambios, que:

• el plugin llega al repositorio que esperabas;
• Codex responde con la autenticación y configuración locales previstas;
• la sesión produce un resultado recuperable;
• el consumo y el tiempo encajan con tu entorno antes de delegar trabajo.

Que la acción esté documentada como de solo lectura no convierte en inocuo todo el ecosistema de plugins. Claude Code considera plugins y marketplaces componentes de alta confianza, y el proceso local sigue sujeto a tus permisos, configuración y políticas.

Revisión, delegación y segundo plano no tienen el mismo alcance

El plugin cubre más que las dos revisiones. El README describe rescate y transferencia de tareas, traspaso de sesión y gestión de trabajos en segundo plano mediante acciones como rescue, transfer, status, result y cancel. Su propósito es permitir que Claude Code entregue trabajo a Codex y recupere su estado o resultado.

La frontera de solo lectura pertenece a las dos revisiones documentadas; las demás acciones requieren confirmar alcance, permisos y supervisión.

Antes de delegar, formula una tarea con límites explícitos: repositorio y rama correctos, archivos permitidos, si puede escribir, condiciones de parada y forma de revisar el resultado. El plugin reutiliza el checkout y la configuración local, así que una configuración demasiado permisiva o un proveedor personalizado no se neutralizan por pasar a través de Claude Code.

El review gate necesita supervisión, no fe

OpenAI advierte que el review gate opcional puede generar un bucle largo entre Claude y Codex y consumir rápidamente los límites de uso. La recomendación documentada es habilitarlo solo cuando vayas a supervisar activamente la sesión.

No existe una cifra pública universal para su duración o consumo. Dependerá del modelo, el contexto, la complejidad de la tarea y los hallazgos de cada vuelta. Por eso, antes de activarlo:

• confirma que puedes observar el progreso y detener el trabajo;
• empieza con un alcance pequeño y un criterio de finalización verificable;
• no lo uses para “mejorar hasta que esté perfecto” sin un límite operativo;
• revisa tu uso disponible en vez de extrapolarlo desde el precio de un plan.

El gate puede ser útil como control adicional, pero no demuestra por sí mismo que el código final sea mejor ni que el proceso resulte más barato.

Cómo interpretar los fallos sin probar comandos al azar

La etapa en la que aparece el error acota la causa probable:

• Falla al añadir el marketplace: revisa la URL o el identificador, la red, la política del workspace y la confianza permitida.
• El marketplace se añade pero el plugin no se instala: confirma el identificador codex@openai-codex y que Claude Code permite instalar desde ese catálogo.
• El plugin se instala pero no aparece: ejecuta /reload-plugins; si el comando no existe, comprueba la versión y la documentación actual de Claude Code.
• /codex:setup no completa la configuración: revisa el Codex CLI global, la autenticación, Node.js, el proveedor configurado y las restricciones de la máquina.
• La revisión o delegación no actúa sobre el lugar esperado: detente y confirma checkout, repositorio, configuración y permisos antes de repetirla.
• Un trabajo en segundo plano parece atascado: consulta su estado o resultado y usa la cancelación documentada; no abras tareas duplicadas sin saber cuál sigue activa.

Estas rutas son diagnósticas, no resultados reproducidos para todas las plataformas. La compatibilidad exacta depende de tu sistema operativo, versión de Claude Code, entorno Node.js, política de workspace, estado de autenticación y configuración de Codex.

La comprobación final antes de un repositorio real

Puedes considerar completada la preparación cuando hayas confirmado la fuente de OpenAI, cumplas Node.js 18.18 o posterior, hayas ejecutado la secuencia actual sin errores pendientes y una revisión de solo lectura apunte al checkout correcto. Solo después tiene sentido decidir si delegas una tarea con permisos de escritura o habilitas un proceso más largo.

No uses como prueba suficiente una promesa de ahorro, un precio en dólares o la mención de un plan concreto. Comprueba en tu propia cuenta el acceso regional, los permisos del espacio de trabajo, la cuota disponible y las condiciones comerciales vigentes. Para el primer uso, el criterio útil no es solo «el plugin está instalado», sino «sé qué fuente he instalado, qué entorno reutiliza y qué alcance tendrá la siguiente acción».