Codex en Claude Code: la guía del plugin oficial de OpenAI

El plugin de Codex para Claude Code lo publica OpenAI, no la comunidad.

Vive en openai/codex-plugin-cc, tuvo su primera release el 30 de marzo de 2026 y, al 12 de agosto de 2026, supera las 31.000 estrellas.

Si venís siguiendo cuándo usar CLAUDE.md, Skills, MCPs y Hooks o cómo funcionan los subagentes, este es el siguiente paso.

El plugin suma un modelo de otro proveedor dentro de tu sesión.

No es un experimento de fin de semana. Es OpenAI publicando software para el harness de su competidor directo, con licencia Apache 2.0. La versión 1.0.6 se publicó el 8 de julio de 2026.

Acá te dejo qué hace cada comando, el detalle técnico del review gate que casi nadie cuenta, y cuándo conviene no instalarlo.

Aclaración antes de arrancar: el CHANGELOG.md incluido en el repositorio se detiene en 1.0.0. GitHub Releases sí documenta las versiones 1.0.1 a 1.0.6.

Lo que sigue está contrastado con el código de v1.0.6. Al 12 de agosto de 2026, main coincide con esa release.

Fuente de la imagen: OpenAI — repositorio “codex-plugin-cc” en GitHub. Tarjeta Open Graph del repositorio oficial, adaptada únicamente con relleno vertical para esta portada.

Para qué sirve: que otro modelo revise lo que escribió el tuyo

La razón práctica es simple: una revisión con el mismo modelo puede conservar supuestos de la primera pasada.

La autocorrección intrínseca puede fallar o degradar una respuesta. Los evaluadores LLM también pueden mostrar sesgo de autopreferencia.

Pero no es una ley universal. Self-Refine mostró que un mismo modelo puede mejorar su salida con feedback iterativo en algunas tareas. Cambiar de modelo tampoco elimina sesgos ni supuestos compartidos.

El valor del plugin es operativo: escribís con Claude y Codex aporta una segunda perspectiva sobre el mismo diff. Esa independencia parcial puede descubrir cosas distintas; no garantiza un veredicto mejor.

La delegación de tareas — mandarle un bug a Codex mientras seguís en Claude — es el segundo caso de uso, no el primero.

Instalación: cuatro comandos y una cuenta de ChatGPT

Los requisitos son Node.js 18.18 o superior y acceso a Codex mediante una cuenta de ChatGPT, incluso Free, o una API key de OpenAI. El consumo depende de cómo te autentiques.

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

Sin flags, /codex:setup comprueba instalación y autenticación, y puede ofrecer instalar Codex si falta. No completa el login: si está instalado pero no autenticado, todavía tenés que ejecutar !codex login desde Claude Code.

Cuando el setup informe que está listo, deberías ver los slash commands y el subagente codex:codex-rescue listado en /agents.

Los ocho comandos, y cuál te sirve en cada caso

Comando	Qué hace	Modifica código
/codex:review	Review estándar del working tree o de la rama	No
/codex:adversarial-review	Review steerable que cuestiona el diseño	No
/codex:rescue	Delega la tarea al subagente codex-rescue	Sí
/codex:transfer	Convierte la sesión actual en un thread de Codex	No
/codex:status	Muestra jobs corriendo y recientes del repo	No
/codex:result	Trae el output final de un job terminado	No
/codex:cancel	Cancela un job en background	No
/codex:setup	Verifica instalación y administra el review gate	No

Los reviews aceptan --base <ref> para comparar contra una rama, más --wait y --background. Para cambios de varios archivos, background no es opcional en la práctica: el review tarda.

/codex:rescue es el único comando que puede escribir en el repo. Los demás revisan o gestionan setup, sesiones y jobs; no todos son estrictamente read-only, porque transfer, cancel y setup tienen efectos operativos.

rescue acepta --model y --effort, y tiene un atajo lindo: si escribís spark, el plugin lo mapea a gpt-5.3-codex-spark.

/codex:review --base main --background
/codex:rescue --model spark fix the issue quickly
/codex:status
/codex:result

review vs adversarial-review: el segundo acepta foco y discute el diseño

Esta es la distinción que más se malinterpreta, y está escrita en el propio repo.

/codex:review no es steerable: no toma texto de foco. Ejecuta el review nativo de Codex en modo read-only y devuelve texto.

/codex:adversarial-review sí acepta texto libre después de los flags. Puede cuestionar implementación, diseño, supuestos, tradeoffs, modos de falla y si otro enfoque hubiera sido más seguro o más simple.

/codex:adversarial-review --base main challenge whether this was the right caching and retry design

Uno ejecuta el review nativo. El otro te deja dirigir una revisión adversarial más amplia.

El review gate: un hook de Stop con timeout de 900 segundos

Acá está la parte que no vas a encontrar en las reseñas, porque hay que abrir hooks/hooks.json para verla.

El plugin registra tres hooks. SessionStart y SessionEnd tienen timeout de 5 segundos. El tercero es otra cosa:

Hook	Script	Timeout
SessionStart	session-lifecycle-hook.mjs	5 s
SessionEnd	session-lifecycle-hook.mjs	5 s
Stop	stop-review-gate-hook.mjs	900 s

Novecientos segundos son quince minutos. Cuando activás el gate con /codex:setup --enable-review-gate, el hook Stop lanza la revisión configurada al cerrar el turno. Si encuentra problemas, puede devolver block y evitar el cierre.

OpenAI lo advierte en su propio README: puede generar un loop largo entre Claude y Codex y drenarte los límites de uso rápido. Recomiendan activarlo solo si vas a mirar la sesión de cerca.

Viene desactivado por defecto. Dejalo así hasta que sepas exactamente qué querés que audite.

El adversarial-review devuelve un contrato JSON con severidad y confianza

El review normal devuelve texto nativo. Solo /codex:adversarial-review usa review-output.schema.json, con cuatro campos obligatorios: verdict, summary, findings y next_steps.

El verdict es un enum de dos valores: approve o needs-attention. Y cada finding obliga a declarar:

• severity y confidence — qué tan grave, y qué tan seguro está
• file, line_start, line_end — dónde exactamente
• title, body y recommendation — qué pasa y qué hacer

No elimina la prosa: summary, title, body, recommendation y next_steps siguen siendo texto.

Los campos estructurados facilitan ordenar, filtrar o conectar automatizaciones. El plugin no las implementa por sí solo.

El detalle que casi nadie mira: OpenAI escribió skills de Anthropic

El plugin incluye tres skills en el formato de Claude Code: codex-cli-runtime, codex-result-handling y gpt-5-4-prompting.

Las tres están marcadas user-invocable: false: son contratos internos, no comandos para vos.

La tercera es la más interesante, porque es OpenAI documentando cómo hablarle a su propio modelo:

Prompt Codex like an operator, not a collaborator.

Y sigue: prompts compactos, estructurados en bloques con tags XML, declarando la tarea, el contrato de salida y las pocas restricciones que importan.

Si alguna vez dudaste de que el estilo de prompt cambia según el modelo, ahí tenés al proveedor diciéndolo por escrito.

Cuándo no instalarlo

No todo caso lo pide. Salteátelo si:

• Trabajás solo con cambios de uno o dos archivos, donde el review propio puede alcanzar
• Tus límites de uso ya están ajustados: esto suma consumo de Codex encima del de Claude
• Buscás este plugin dentro de CI: para automatizar Codex, OpenAI documenta codex exec y openai/codex-action@v1
• Tu política no permite enviar el repo a OpenAI con la autenticación, el plan o los controles disponibles

En cuentas individuales, OpenAI puede usar contenido para entrenamiento salvo que hagas opt-out.

Business, Enterprise, Edu y API no se usan para entrenar por defecto. Los controles del entorno completo de Codex son otra capa.

Por eso, privacidad y compliance dependen de la autenticación, el plan, el workspace y sus controles. Conviene resolverlo antes de instalar nada, no después.

Preguntas frecuentes

¿Qué es el plugin de Codex para Claude Code?

Es el plugin oficial de OpenAI para usar Codex desde Claude Code. Agrega ocho slash commands, un subagente y tres skills.

Te permite lanzar reviews con Codex y delegarle tareas sin salir de la terminal donde ya estás trabajando.

¿Necesito pagar dos suscripciones para usarlo?

Necesitás Claude Code, Node.js 18.18+ y una cuenta de ChatGPT, incluso Free, o una API key de OpenAI.

No hace falta pagar dos suscripciones. El consumo y las políticas de datos dependen del plan y de cómo te autentiques.

¿Qué diferencia hay entre /codex:review y /codex:adversarial-review?

Ambos revisan sin escribir código. /codex:review no es steerable y devuelve texto nativo.

/codex:adversarial-review acepta foco, cuestiona implementación, diseño, supuestos y tradeoffs, y devuelve el JSON del plugin.

¿Es peligroso activar el review gate?

El propio README lo marca con un WARNING. Es un hook Stop opcional, apagado por defecto y con timeout de 900 segundos.

Si la revisión configurada encuentra problemas, puede bloquear el cierre y generar un loop que consuma tus límites rápido.

---

Si estás armando un sistema donde varios agentes se revisan entre sí y querés discutir cómo encajarlo sin duplicar costos, escribime. Es el tipo de decisión que conviene pensar antes de instalar.