Cómo instalar Codex dentro de Claude Code y usar dos agentes en la misma terminal

OpenAI ha publicado como código abierto codex-plugin-cc, un plugin oficial que permite ejecutar Codex directamente desde Claude Code. Para desarrolladores y administradores de sistemas, lo interesante no está solo en poder consultar un segundo modelo: el plugin permite revisar cambios, delegar tareas, rescatar sesiones bloqueadas, transferir conversaciones completas y añadir una puerta de revisión que obliga a pasar por Codex antes de que Claude dé un trabajo por terminado. El repositorio oficial supera ya las 32.000 estrellas en GitHub y se distribuye bajo licencia Apache 2.0.

Las claves de Codex dentro de Claude Code en 30 segundos

• La instalación se realiza desde el propio sistema de plugins de Claude Code y necesita Node.js 18.18 o posterior.
• Codex utiliza su CLI local, por lo que conserva autenticación, configuración y acceso al repositorio.
• /codex:review revisa cambios y /codex:adversarial-review cuestiona decisiones de diseño.
• /codex:rescue delega un problema a Codex y /codex:transfer conserva el contexto al cambiar de agente.
• Existe una puerta opcional que impide finalizar una tarea hasta superar una revisión de Codex.

Para ponerlo en marcha no hace falta modificar manualmente archivos de Claude Code. OpenAI lo distribuye mediante su propio marketplace de plugins.

El primer paso es añadir el repositorio:

/plugin marketplace add openai/codex-plugin-cc

Después se instala el plugin:

/plugin install codex@openai-codex

Se recargan los plugins:

/reload-plugins

Y finalmente se ejecuta:

/codex:setup

Este último comando comprueba si Codex está instalado y autenticado correctamente. Si falta la CLI y npm está disponible, el propio asistente puede ofrecer su instalación. También puede hacerse manualmente:

npm install -g @openai/codexLenguaje del código: CSS (css)

Si Codex está instalado pero todavía no existe una sesión iniciada:

codex login

OpenAI exige Node.js 18.18 o posterior y permite utilizar una suscripción compatible de ChatGPT, incluida la modalidad gratuita según la documentación actual, o una clave de API. El consumo realizado desde Claude Code cuenta dentro de los límites habituales de Codex.

Una prueba rápida después de instalarlo puede hacerse con:

/codex:review --background
/codex:status
/codex:result

Con esto Codex revisa el trabajo actual en segundo plano, mientras Claude Code permanece disponible para continuar trabajando.

Codex no se ejecuta «dentro» de Claude: usa la CLI local

Desde el punto de vista de un sysadmin este detalle es importante.

codex-plugin-cc no incluye un runtime independiente ni levanta una segunda copia aislada de Codex. El plugin actúa como interfaz sobre Codex CLI y Codex app server instalados en la misma máquina.

Eso significa que utiliza:

• la misma autenticación;
• el mismo checkout del repositorio;
• el mismo entorno local;
• la misma configuración de Codex;
• los mismos límites de uso.

Si ya existe:

~/.codex/config.tomlLenguaje del código: JavaScript (javascript)

el plugin la utiliza.

También admite configuraciones específicas de proyecto mediante:

.codex/config.toml

Por ejemplo:

model = "gpt-5.4-mini"
model_reasoning_effort = "high"Lenguaje del código: JavaScript (javascript)

Esto permite que un equipo defina qué modelo o nivel de razonamiento quiere utilizar desde Claude Code sin mantener una configuración paralela.

Para operaciones, esta integración tiene una ventaja clara: no introduce otra plataforma remota adicional entre el agente y el repositorio. Se apoya en el mismo entorno desde el que ya se ejecutaría Codex directamente.

Eso no elimina los riesgos habituales. Si el agente tiene acceso a comandos, secretos, repositorios privados o herramientas de despliegue, el nivel de exposición seguirá dependiendo de cómo esté configurado el entorno.

/codex:review: una segunda revisión sin salir de Claude Code

El comando más directo es:

/codex:review

Ejecuta una revisión de solo lectura sobre los cambios actuales.

También puede comparar la rama activa contra otra referencia:

/codex:review --base main

OpenAI señala que utiliza la misma calidad de revisión que ejecutar /review directamente desde Codex. La operación no modifica archivos.

Esto puede encajar especialmente bien en flujos donde Claude Code ha escrito una modificación y se quiere una segunda evaluación antes de crear el pull request.

Por ejemplo:

Claude Code:
- cambia la configuración de Nginx
- modifica el middleware de autenticación
- actualiza los tests

Codex:
- revisa el diff completo
- identifica problemas
- devuelve observaciones

El objetivo no debería ser convertir a Codex en una autoridad infalible.

La utilidad está en introducir otro contexto de razonamiento sobre el mismo cambio. Un segundo modelo puede detectar una condición de carrera, una regresión o una decisión de diseño que el primero aceptó porque llevaba demasiados turnos trabajando sobre la misma dirección.

En cambios grandes es recomendable ejecutarlo en segundo plano:

/codex:review --background

y consultar después:

/codex:status
/codex:result

La revisión adversarial es más interesante que un simple code review

Para sistemas críticos, OpenAI incluye otro comando:

/codex:adversarial-review

Su función no es únicamente buscar errores. Está diseñado para cuestionar deliberadamente el enfoque utilizado.

Puede examinar:

• autenticación;
• condiciones de carrera;
• posibles pérdidas de datos;
• estrategias de rollback;
• tolerancia a fallos;
• decisiones de caché;
• reintentos;
• alternativas arquitectónicas.

Por ejemplo:

/codex:adversarial-review --base main \
challenge whether this retry strategy can duplicate jobsLenguaje del código: JavaScript (javascript)

O:

/codex:adversarial-review --background \
look for race conditions and failure modes

Para un administrador de sistemas este modo puede resultar particularmente útil en cambios de infraestructura generados por IA.

Un agente puede producir una configuración de Kubernetes que aparentemente funciona. Otro puede preguntarse qué ocurre si el nodo desaparece durante un despliegue, si el readinessProbe está mal definido o si una política permite más tráfico del necesario.

No convierte automáticamente la configuración en segura, pero añade un paso de crítica deliberada al flujo.

/codex:rescue: pasar el problema a otro agente cuando Claude se atasca

El plugin incluye además:

/codex:rescue

Este comando delega una tarea en un subagente de Codex.

Por ejemplo:

/codex:rescue investigate why the systemd service fails after reboot

O:

/codex:rescue fix the failing integration test with the smallest safe patchLenguaje del código: JavaScript (javascript)

También puede continuarse un trabajo anterior:

/codex:rescue --resume apply the top fix from the last runLenguaje del código: JavaScript (javascript)

y ejecutarlo en segundo plano:

/codex:rescue --background investigate the regression

Esto cambia la forma de utilizar los agentes.

Hasta ahora era habitual mantener Claude Code en una terminal y abrir Codex en otra, copiando errores, diffs, salidas de tests y explicaciones.

Ahora Claude puede delegar directamente una tarea sin que el usuario reconstruya manualmente el contexto.

Incluso puede pedirse en lenguaje natural:

Ask Codex to investigate why this deployment keeps rolling back.Lenguaje del código: JavaScript (javascript)

El plugin se encarga de crear la tarea correspondiente.

/codex:transfer: mover una sesión completa sin empezar de cero

Otro problema frecuente aparece cuando un agente lleva media hora depurando una incidencia y se quiere continuar con otro modelo.

Repetir toda la historia resulta poco práctico.

Para eso existe:

/codex:transfer

El plugin toma la sesión actual de Claude Code, la importa como una sesión persistente de Codex y devuelve algo similar a:

codex resume <session-id>Lenguaje del código: HTML, XML (xml)

Después puede continuarse el trabajo directamente en Codex.

La sesión original debe estar bajo el directorio de proyectos de Claude:

~/.claude/projectsLenguaje del código: JavaScript (javascript)

También puede indicarse manualmente mediante --source.

La transferencia utiliza el importador de sesiones externas de Codex. No significa que Claude y Codex compartan una memoria interna común: el historial se convierte e importa para que Codex pueda reconstruir el contexto y continuar desde ahí.

Para incidentes largos puede ser una de las funciones más útiles del plugin.

Un modelo puede investigar primero la causa de un problema y otro continuar desde el punto donde terminó, sin pedir de nuevo:

¿Qué hemos probado?
¿Qué logs hemos revisado?
¿Qué hipótesis ya hemos descartado?

Una puerta de revisión antes de dar una tarea por terminada

OpenAI incluye una función opcional todavía más agresiva:

/codex:setup --enable-review-gate

Al activarla, Claude Code no puede cerrar normalmente una tarea sin ejecutar antes una revisión de Codex.

El flujo pasa a ser aproximadamente:

Claude implementa
        ↓
Codex revisa
        ↓
¿Encuentra problemas?
   ↓            ↓
  Sí            No
   ↓            ↓
Claude corrige   Finaliza

Técnicamente se implementa mediante un Stop hook.

Si Codex encuentra problemas, se bloquea la finalización y Claude puede volver a trabajar sobre el cambio.

Puede desactivarse con:

/codex:setup --disable-review-gate

OpenAI advierte de un efecto secundario importante: puede producir ciclos largos Claude-Codex y consumir rápidamente los límites de uso. Recomienda mantenerlo bajo supervisión activa.

Por eso probablemente tenga más sentido aplicarlo a tareas concretas que activarlo indiscriminadamente para todo.

Un cambio en documentación no necesita necesariamente la misma puerta que una modificación de Terraform, un módulo de autenticación o un procedimiento de migración de base de datos.

Un flujo interesante para sysadmins

El plugin permite construir procedimientos bastante naturales para infraestructura.

Por ejemplo, Claude podría preparar una modificación de Ansible:

Claude:
modifica el role de nginx para habilitar HTTP/3

Después:

/codex:review --base main

Si se quiere una evaluación más crítica:

/codex:adversarial-review \
check rollback, compatibility and failure scenarios

Para un incidente:

/codex:rescue --background \
investigate why this Kubernetes pod enters CrashLoopBackOffLenguaje del código: JavaScript (javascript)

Mientras Codex analiza el problema, Claude puede continuar revisando eventos, manifiestos o métricas.

Posteriormente:

/codex:status
/codex:result

El patrón se parece menos a «preguntar algo a una IA» y más a repartir una incidencia entre dos operadores.

Dos agentes tampoco sustituyen pruebas, CI ni revisión humana

Hay una tentación evidente con herramientas de este tipo: asumir que si Claude escribe el código y Codex lo revisa, el resultado queda automáticamente validado.

No es así.

Los dos modelos pueden reproducir el mismo error.

También pueden aceptar una mala suposición compartida, generar comandos peligrosos o interpretar incorrectamente una configuración.

Por eso un flujo razonable continúa necesitando:

Agente → segundo agente → tests → CI → revisión → despliegue

y no:

Agente → segundo agente → producción

En infraestructura esto resulta todavía más importante.

Una configuración de firewall sintácticamente correcta puede seguir abriendo un servicio innecesario. Un playbook puede funcionar en staging y causar una interrupción cuando se ejecuta simultáneamente sobre 200 servidores. Un cambio de Terraform puede ser válido y eliminar un recurso que no debería tocarse.

Los agentes pueden ampliar la capacidad de revisión, pero siguen necesitando límites y procedimientos operativos.

OpenAI acepta que Codex no tiene que ser siempre el agente principal

El aspecto más llamativo quizá sea quién ha publicado el plugin.

El repositorio está bajo la organización oficial de OpenAI y su descripción es explícita: «Use Codex from Claude Code to review code or delegate tasks.»

No se trata de una integración comunitaria no oficial.

OpenAI está facilitando que Codex funcione como segundo agente dentro del producto de uno de sus principales competidores.

El repositorio fue creado el 30 de marzo de 2026 y, en la consulta realizada el 14 de agosto, contaba con 31.848 estrellas y 2.187 forks, además de distribuirse bajo Apache 2.0.

Eso puede anticipar hacia dónde se dirige el desarrollo asistido por IA.

La pregunta quizá deje de ser:

¿Claude Code o Codex?

y pase a ser:

¿qué agente debe implementar, cuál debe revisar y cuál debe investigar cuando algo falla?

Para desarrolladores y sysadmins, esa diferencia es importante.

La terminal puede dejar de tener un único copiloto y convertirse en un entorno donde varios agentes se reparten tareas sobre el mismo repositorio.

Preguntas frecuentes

¿Cómo se instala Codex dentro de Claude Code?

Hay que añadir el marketplace openai/codex-plugin-cc, instalar codex@openai-codex, recargar los plugins y ejecutar /codex:setup. También es necesario disponer de Node.js 18.18 o posterior y tener Codex instalado y autenticado.

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

/codex:review realiza una revisión convencional y de solo lectura. /codex:adversarial-review está pensado para cuestionar decisiones, buscar supuestos ocultos y analizar riesgos o alternativas de diseño.

¿Codex puede modificar archivos desde Claude Code?

La revisión normal y la adversarial son de solo lectura. /codex:rescue, en cambio, delega tareas a Codex y puede utilizarse para investigar o intentar cambios según la tarea solicitada.

¿El plugin necesita una cuenta diferente?

No necesariamente. Utiliza la instalación local de Codex y su autenticación existente. Puede funcionar con una cuenta compatible de ChatGPT o mediante API key, y el consumo se aplica a los límites habituales de Codex.