Icono del sitio SomoS Guay

Cómo conectar Codex con Claude Code: guía paso a paso (Mac, Windows y Linux)

Guía práctica · IA para equipos
Haz que Claude Code y Codex trabajen juntos

Instala el plugin oficial de OpenAI para Claude Code y pide a Codex revisiones de código o tareas sin salir de Claude. Paso a paso, en Mac, Windows y Linux.

⏱ 10–15 minutos 💻 Mac · Windows · Linux 🧩 Plugin openai/codex-plugin-cc

Qué vas a conseguir

Claude Code sigue siendo tu asistente principal. El plugin suma a Codex como segunda opinión y como ayudante para tareas puntuales.

1

Revisiones de código

Codex revisa tus cambios en modo solo lectura y te marca errores antes de que llegues a producción.

2

Revisión crítica

Una revisión que cuestiona decisiones de diseño, supuestos y riesgos, no solo la sintaxis.

3

Delegar tareas

Pasa a Codex una investigación o un arreglo, en segundo plano, y sigue trabajando con Claude.

Antes de empezar

Comprueba que tienes estas cuatro cosas.

✓

Claude Code con plan de pago

Pro, Max, Team, Enterprise o una cuenta de Console. El plan gratuito de Claude no incluye Claude Code.

✓

Cuenta de ChatGPT o API key de OpenAI

El uso descuenta de tus límites de Codex. Con un plan pago (Plus, Pro, Business…) tienes más margen.

✓

Node.js 18.18 o superior

El plugin lo necesita para funcionar. Lo instalas desde nodejs.org (versión LTS).

✓

Sistema compatible

macOS 13+, Windows 10 (1809+) o Windows 11, Ubuntu 20.04+ o Debian 10+.

Tu sistema:

Instalación paso a paso

Los comandos cambian según el sistema que elijas arriba. Cópialos con el botón Copiar para no equivocarte.

1

Abre una terminal

Pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter.

Pulsa la tecla Windows, escribe PowerShell y ábrelo. No hace falta abrirlo como administrador. En la línea tiene que aparecer PS C:\; si no aparece el PS, estás en CMD.

Abre la terminal de tu distribución (en Ubuntu: Ctrl + Alt + T).

2

Instala Claude Code (si todavía no lo tienes)

Si ya usas Claude Code, salta al paso 3.

curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex

Recomendado en Windows: instala Git for Windows para que Claude Code pueda usar Bash.

Abre una terminal nueva y comprueba
claude --version

Después corre claude una vez para iniciar sesión con tu cuenta de Claude.

¿Usas la app de escritorio de Claude en lugar de la terminal? También sirve: los comandos de los pasos 5 y 6 los escribes en el chat de Claude Code, dentro de la app.

3

Comprueba Node.js

node -v

Si responde v18.18 o un número mayor (por ejemplo v22.x), todo bien. Si dice que no existe el comando o la versión es menor, instala la versión LTS desde nodejs.org y abre una terminal nueva.

4

Instala Codex CLI

Usa el instalador oficial de OpenAI. Instala Codex en tu carpeta de usuario, sin pedir contraseña de administrador.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Al final te pregunta Start Codex now? [y/N]. Puedes responder y para pasar directo al inicio de sesión del paso 5.

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Codex funciona de forma nativa en Windows 11 (Windows 10 versión 1809 o superior, con soporte limitado). En el primer uso puede pedirte configurar su “sandbox” (entorno aislado): acepta el aviso de Windows.

Abre una terminal nueva y comprueba
codex --version
Otras formas de instalarlo

Con npm (requiere Node.js):

npm install -g @openai/codex

Con Homebrew:

brew install --cask codex
5

Inicia sesión en Codex

codex

Elige Sign in with ChatGPT. Se abre el navegador; entra con tu cuenta y vuelve a la terminal. Para salir de Codex escribe /exit.

Comprueba que quedó conectado
codex login status
Logged in using ChatGPT
6

Instala el plugin de Codex en Claude Code

Abre Claude Code (con claude en la terminal o desde la app) y escribe estos tres comandos en el chat, uno por vez:

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
Prefiero hacerlo desde la terminal

Desde la terminal del sistema, fuera de Claude Code:

claude plugin marketplace add openai/codex-plugin-cc
claude plugin install codex@openai-codex

Luego abre una sesión nueva de Claude Code.

7

Verifica que todo esté listo

En el chat de Claude Code:

/codex:setup

Claude revisa Node, Codex y tu inicio de sesión. Si todo está bien, vas a ver algo así:

ready: true
node:  v22.x
codex: codex-cli 0.162.x
auth:  ChatGPT login active

Importante: /codex:setup puede ofrecerte activar el “review gate”, que hace que Codex revise cada vez que Claude termina una respuesta. Gasta tus límites muy rápido; déjalo desactivado salvo que vayas a estar mirando la sesión.

Comandos para el día a día

Escríbelos en el chat de Claude Code, dentro de la carpeta de tu proyecto.

ComandoPara qué sirve
/codex:reviewCodex revisa tus cambios sin modificar nada. Con --base main revisa una rama entera.
/codex:adversarial-reviewRevisión crítica: cuestiona el diseño, los supuestos y los riesgos. Puedes indicarle en qué enfocarse.
/codex:rescueLe pasa una tarea a Codex: investigar un error, arreglar algo o retomar un trabajo. Acepta --background.
/codex:statusMuestra las tareas de Codex en curso y las recientes.
/codex:resultMuestra el resultado de una tarea terminada.
/codex:cancelCancela una tarea que está corriendo en segundo plano.
/codex:transferPasa la conversación actual a Codex para seguirla allí.

Problemas frecuentes

Los errores que más aparecen al instalar, y cómo resolverlos.

“codex: command not found” o “no se reconoce” justo después de instalar

La terminal que tenías abierta todavía no sabe dónde quedó Codex. Ciérrala y abre una nueva. Si usas la app de escritorio de Claude, ciérrala y vuelve a abrirla para que encuentre el comando codex.

Error EACCES / permission denied al usar npm install -g

Tu usuario no tiene permiso sobre la carpeta global de npm. No uses sudo: instala Codex con el instalador oficial del paso 4, que no necesita permisos de administrador.

“claude: command not found”

Usas la app de escritorio de Claude, que no instala ese comando en la terminal. No es un problema: escribe los comandos /plugin … directamente en el chat de Claude Code, dentro de la app. Si quieres el comando en la terminal, instala Claude Code con el paso 2.

Windows: “’irm’ no se reconoce como un comando interno o externo”

Estás en CMD, no en PowerShell. Abre PowerShell (en la línea tiene que aparecer PS C:\) y repite el comando.

Windows: Codex pide configurar el sandbox o falla al configurarlo

Codex usa un entorno aislado para ejecutar comandos de forma segura. Acepta el aviso de Windows cuando aparezca. En una computadora de empresa puede estar bloqueado por políticas de seguridad: consulta con tu área de IT, o usa Claude Code y Codex dentro de WSL (Linux en Windows) siguiendo los pasos de Linux.

/codex:setup dice que no iniciaste sesión

Escribe !codex login en el chat de Claude Code (el ! ejecuta el comando en tu terminal), o corre codex login en una terminal, y vuelve a probar /codex:setup.

Los comandos /codex no aparecen en Claude Code

Escribe /reload-plugins o abre una sesión nueva de Claude Code. Los comandos nuevos no aparecen en una sesión que ya estaba abierta cuando instalaste el plugin.

Se me acaban los límites de Codex muy rápido

Revisa que el review gate esté desactivado: escribe /codex:setup --disable-review-gate. Cada revisión y cada tarea descuentan de los límites de tu plan de ChatGPT.

¿Quieres que lo configuremos con tu equipo?

En GUAY implementamos asistentes de IA en equipos de marketing y desarrollo: instalación, buenas prácticas y flujos de trabajo que ahorran horas cada semana.

Fuentes oficiales

Guía independiente elaborada por GUAY. No es una publicación oficial de OpenAI ni de Anthropic. Claude y Claude Code son marcas de Anthropic; Codex y ChatGPT son marcas de OpenAI. Los comandos pueden cambiar con nuevas versiones: ante cualquier diferencia, valen las fuentes oficiales. Última revisión: noviembre de 2026.

Salir de la versión móvil