Instalación y login (Mac / Windows / Linux)

📚 Navegación de la serie: El artículo anterior 02 · Conceptos clave de Codex de un vistazo explicó los términos principales de Codex (agente, sandbox, aprobación, local / nube). Este artículo te guiará para instalarlo físicamente en tu ordenador, cubriendo tanto la aplicación de escritorio como la CLI, detallando el proceso de login, las diferencias entre plataformas y los errores comunes de instalación. El próximo artículo 04 · Suscripción y facturación abordará el coste del servicio.

A principios de 2026, OpenAI dividió Codex en cuatro interfaces: versión web, aplicación de escritorio, CLI y extensiones para IDE. Habiéndolas utilizado todas, desde la CLI hasta la aplicación de escritorio, mi conclusión más directa es: las instrucciones oficiales de instalación y actualización a menudo difieren de los tutoriales obsoletos que encuentras en internet.

En realidad, instalar Codex no es difícil; lo complicado es saber cuál es la vía oficial recomendada y cuáles son las rutas obsoletas que dan problemas. Este artículo aclara el camino oficial para cada plataforma e instalación para que no repitas los errores comunes.

Al leer este artículo, obtendrás:

• El proceso para instalar la aplicación de escritorio y la CLI en Mac, Windows y Linux (con los resultados esperados para validar el proceso).
• Una comparación de los tres métodos de instalación de la CLI (script oficial, Homebrew y npm) para saber cuál elegir.
• La diferencia entre los dos métodos de login (cuenta de ChatGPT y API key), y la solución estándar si el login interactivo se bloquea en entornos remotos o servidores.
• Una tabla de solución rápida de errores para corregir la mayoría de los fallos iniciales.

---

01 Tres aspectos a verificar antes de instalar

No te apresures a ejecutar comandos. Muchos usuarios descubren a mitad de la instalación que «no hay versión de escritorio para su plataforma» o que «su cuenta requiere configurar MFA de antemano», perdiendo tiempo. Confirma estos tres puntos primero.

Primero: Qué interfaz vas a utilizar

Codex ofrece cuatro interfaces, pero en cuanto a la instalación, se reduce a elegir entre dos vías:

• Aplicación de escritorio: interfaz gráfica y de clic, ideal para quienes prefieren evitar la terminal. Sin embargo, solo está disponible para macOS y Windows, no para Linux (la página oficial muestra un registro de espera para Linux).
• CLI (Línea de comandos): el agente de programación que se ejecuta en la terminal, compatible con las tres plataformas y el método preferido por los desarrolladores.

Mi recomendación: Los desarrolladores deben aprender a usar la CLI, ya que es la más versátil y multiplataforma sin limitaciones. Este artículo se centrará en la CLI, dedicando una sección específica a la descarga e inicio de sesión de la aplicación de escritorio. Puedes empezar con cualquiera; las credenciales de sesión se comparten entre la CLI y las extensiones para IDE (la aplicación de escritorio se gestiona de forma independiente, ver sección 06).

Segundo: Necesitas una cuenta válida

El error más común de los novatos: Codex se asocia a tu suscripción de ChatGPT.

OpenAI especifica que los planes de ChatGPT Plus, Pro, Business, Edu y Enterprise incluyen el uso de Codex. También puedes optar por no vincular una suscripción y utilizar una API key de OpenAI bajo pago por uso; sin embargo, con el acceso por API key, algunas funciones dependientes del espacio de trabajo de ChatGPT pueden estar limitadas o no disponibles (por ejemplo, el uso de Codex en la nube exige iniciar sesión con cuenta de ChatGPT).

Usar una API key para ejecutar la CLI local es viable; OpenAI descontará el coste de tu cuenta de la plataforma según las tarifas de API estándar, siendo un saldo independiente al de la suscripción de ChatGPT.

Los detalles de las cuentas y tarifas se detallan en el próximo capítulo 04 · Suscripción y facturación. Para este artículo, asumiremos que dispones de un plan de ChatGPT activo o de una API key con saldo.

Tercero: Acceso estable a OpenAI

Cualquiera de las interfaces de Codex requiere conexión a internet para comunicarse con los servidores de OpenAI. Asegúrate de contar con una conexión a internet estable y sin restricciones que te permita acceder a dominios como chatgpt.com y platform.openai.com durante la instalación, el inicio de sesión y la ejecución de tareas, para evitar errores de «tiempo de espera agotado» o «fallo en la devolución de llamada del inicio de sesión».

💡 Resumen en una frase: Antes de instalar, confirma tres cosas: elige la CLI como interfaz principal (multiplataforma), dispón de un plan de ChatGPT o API key y asegura una conexión de red estable a OpenAI; superados estos puntos, puedes ejecutar los comandos.

---

02 Vía uno: Aplicación de escritorio (Mac / Windows)

Para quienes prefieren evitar la terminal, empezar con la aplicación de escritorio es la opción más sencilla.

Analogía: La aplicación de escritorio es como tener un «ChatGPT con acceso a directorios del proyecto». Funciona de forma similar a conversar con ChatGPT en la web, con la diferencia de que está vinculada a una carpeta de tu ordenador, pudiendo leer archivos, modificar código y ejecutar comandos directamente en ella; es decir, integra en una sola interfaz el chat, el directorio del proyecto y la memoria a largo plazo.

Escenarios reales:

• Eres diseñador o gestor de producto, no escribes código directamente pero quieres que la IA aplique una pequeña modificación o analice cómo está implementada una función en el proyecto.
• Trabajas en varios proyectos en paralelo: puedes dejar a Codex ejecutando pruebas en el proyecto A mientras cambias al proyecto B para seguir pidiendo modificaciones.
• Prefieres una interfaz gráfica de revisión para ver línea por línea qué cambios propone antes de aceptarlos.

Descarga e instalación

Visita https://chatgpt.com/codex y descarga el instalador correspondiente para tu plataforma:

Plataforma	Selección
macOS (Apple Silicon)	Descarga el instalador predeterminado
macOS (procesador Intel)	Selecciona Intel build para evitar problemas
Windows	Descarga el instalador oficial para Windows
Linux	No hay aplicación de escritorio; puedes registrarte en la lista de espera y usar la CLI

¿Eres usuario de Mac y no sabes si usas Intel o Apple Silicon? Haz clic en el icono de Apple en la esquina superior izquierda → «Acerca de este Mac»; si en «Chip» indica Apple serie M, es Apple Silicon; si indica Intel, descarga la versión Intel build. Instalar la versión incorrecta impedirá la instalación o provocará cierres inesperados.

Primer inicio de sesión y selección de proyecto

Tras instalar y abrir la aplicación, sigue estos tres pasos:

1. Login: inicia sesión con tu cuenta de ChatGPT o tu API key de OpenAI (con la API key algunas funciones estarán limitadas, ver siguiente sección).
2. Seleccionar proyecto: elige la carpeta local en la que trabajará Codex. Si ya has usado la aplicación, la CLI o la extensión de IDE anteriormente, verás un listado con los proyectos recientes.
3. Enviar el primer mensaje: una vez seleccionado el proyecto, asegúrate de que en la esquina inferior izquierda esté marcado Local (para que Codex actúe en tu ordenador y no en la nube) y escribe tus instrucciones en el cuadro de entrada.

En el primer acceso, familiarízate primero con los elementos básicos de «Chat» y «Proyecto»: el chat funciona de forma idéntica a la web de ChatGPT; el proyecto asocia la conversación a una carpeta de tu ordenador, y Codex limitará sus acciones a ese directorio.

Puedes cambiar el idioma de la aplicación desde la esquina inferior izquierda: «Configuración → General → Idioma» (la aplicación también puede detectar el idioma del sistema). Los paneles laterales se pueden expandir usando los iconos de la esquina superior derecha. La interfaz tiene este diseño:

💡 Resumen en una frase: La aplicación de escritorio solo está disponible para Mac y Windows; en Mac, asegúrate de elegir el instalador correcto (Intel o Apple Silicon). Tras instalar, los pasos son sencillos: iniciar sesión, seleccionar la carpeta del proyecto y confirmar el modo Local antes de enviar mensajes.

---

03 Vía dos: CLI (un comando para las tres plataformas)

Para ir directo al grano: se recomienda utilizar el script oficial de instalación (standalone installer) en todas las plataformas. No depende de Node.js, se descarga como un ejecutable independiente y ofrece una instalación limpia.

Analogía: El script oficial funciona como una instalación en un clic de una tienda de aplicaciones. Se descarga, se coloca en su sitio y no altera el resto del sistema; por el contrario, usar npm equivale a «instalar un gestor de paquetes primero para luego instalar la aplicación», lo que añade dependencias (Node.js) y posibles puntos de conflicto.

macOS / Linux

Abre la terminal y ejecuta este comando:

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

Nota de red: En determinadas regiones, asegúrate de contar con una conexión de red estable para descargar el instalador desde chatgpt.com sin interrupciones.

Si estás configurando scripts de automatización o instalaciones desatendidas en CI (sin prompts interactivos), puedes usar esta variable de entorno oficial:

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

Windows (nativo, sin WSL)

Ejecuta en PowerShell (la terminal con el indicador PS C:\>):

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

Instalación desatendida (CI / scripts):

$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iex

El parámetro -ExecutionPolicy ByPass permite la ejecución temporal del script sin alterar permanentemente la política de seguridad del sistema; irm (Invoke-RestMethod) descarga el script e iex (Invoke-Expression) lo ejecuta. Si recibes el error irm is not recognized, estás ejecutando el comando en CMD; abre una ventana de PowerShell.

Métodos alternativos: Homebrew / npm

Existen dos métodos de instalación alternativos al script oficial; consulta esta tabla para elegir el que mejor se adapte a tus necesidades:

Método de instalación	Comando	Requisitos previos	Recomendación
Script oficial	curl ... | sh (Win: irm)	Ninguno	Recomendado; ejecutable independiente y limpio
Homebrew (Mac)	brew install --cask codex	Homebrew instalado	Si prefieres gestionar tu software con brew; las actualizaciones pueden tardar un poco más en publicarse
npm	npm install -g @openai/codex	Node.js	Si acostumbras a instalar herramientas globales con npm

La versión de Homebrew puede retrasarse uno o dos días respecto a la oficial debido a los tiempos de revisión de los mantenedores de Cask; esta demora suele asegurar versiones más validadas.

Instalación con Homebrew (macOS):

brew install --cask codex

Instalación con npm (cualquier plataforma con Node.js instalado):

npm install -g @openai/codex

Consejos para evitar problemas comunes:

• El uso de sudo con npm depende de tu configuración de Node.js. Muchos tutoriales antiguos sugieren ejecutar sudo npm install -g, pero instalar paquetes globales con sudo suele generar problemas de permisos a largo plazo. Mi recomendación: gestiona Node.js con herramientas como nvm o Volta instaladas en tu directorio de usuario para evitar el uso de sudo; si encuentras errores de permisos, utiliza el script oficial que no requiere npm.
• En Homebrew debes usar --cask; no lo omitas y escribe el nombre del paquete tal cual: codex.

💡 Resumen en una frase: Para instalar la CLI, utiliza el script oficial: curl ... | sh en Mac/Linux e irm en Windows, ya que genera un ejecutable independiente de Node; Homebrew y npm son alternativas válidas, procurando evitar sudo con npm.

Las dos vías de instalación se resumen en este diagrama:

El diagrama muestra ambas rutas en paralelo: la izquierda descarga el instalador de la aplicación de escritorio y realiza el login en ella; la derecha instala la CLI y requiere ejecutar codex login, finalizando ambas en el mismo estado operativo. Ambos métodos admiten iniciar sesión con cuenta de ChatGPT o con API key.

---

04 Usuarios de Windows: ¿Instalación nativa o WSL?

Windows presenta particularidades específicas para el uso de Codex; a continuación detallamos las tres formas de ejecutarlo.

La documentación oficial define tres métodos de ejecución:

• Windows nativo + sandbox elevated: recomendado. Utiliza un usuario con permisos limitados dedicado al sandbox, restricciones del sistema de archivos y reglas de cortafuegos para delimitar a Codex en el directorio de trabajo, ofreciendo la mayor seguridad.
• Windows nativo + sandbox unelevated: alternativa. Se utiliza cuando las directivas de seguridad corporativas impiden configurar accesos de administrador para el sandbox elevated; ofrece menor nivel de aislamiento pero mantiene la protección.
• WSL2 (Subsistema de Windows para Linux): ejecución en entorno Linux utilizando el sandbox de Linux. Recomendado si utilizas herramientas nativas de Linux o si tus repositorios ya están ubicados en WSL2.

Tabla de comparación oficial:

Ejecución	Requisitos	Escenario de uso
Nativo + elevated	Configuración del sandbox autorizada por administrador	Recomendado por defecto; mejor rendimiento y máxima seguridad
Nativo + unelevated	No requiere permisos de administrador	Alternativa si las directivas impiden usar el modo elevated
WSL2	WSL2 activado	Si dependes de herramientas de Linux o trabajas con repositorios en WSL2

Notas importantes:

• Versión de Windows: se recomienda Windows 11; en Windows 10 se ofrece soporte básico y se requiere la versión 1809 o superior (que incluye ConPTY y otros componentes modernos de consola). Las versiones anteriores de Windows 10 no están recomendadas.
• winget operativo: asegúrate de actualizar Windows o instalar el gestor de paquetes de Windows si no está disponible en tu terminal.
• WSL1 ya no es compatible: a partir de la versión 0.115 de Codex, el sandbox de Linux utiliza bubblewrap, por lo que el soporte para WSL1 finalizó en la versión 0.114. Si usas WSL, debe ser la versión WSL2.

Para utilizar WSL2, abre una terminal de PowerShell como administrador, instala el subsistema y accede a él:

wsl --install
wsl

Una vez dentro de la terminal de WSL (el indicador cambiará al formato de Linux):

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

Consejo de rendimiento en WSL: evita ubicar tus repositorios en rutas montadas de Windows como /mnt/c/..., ya que el rendimiento de lectura/escritura (I/O) se reducirá notablemente y pueden surgir conflictos con enlaces simbólicos y permisos. Es preferible ubicarlos en tu directorio personal de Linux (como ~/code/my-app). Para acceder a estos archivos desde Windows, introduce \\wsl$ en el Explorador de archivos.

El siguiente diagrama resume la decisión de instalación en Windows:

El flujo indica: prioriza el entorno nativo con sandbox elevated; si las políticas del sistema lo impiden, utiliza unelevated; y recurre a WSL2 si dependes de un entorno Linux.

💡 Resumen en una frase: En Windows, prioriza la instalación nativa con sandbox elevated, recurre a unelevated si hay restricciones de permisos, y utiliza WSL2 si dependes de herramientas de Linux; recuerda que WSL1 ya no es compatible y Windows 11 ofrece la mayor estabilidad.

---

05 Validar la instalación

Una vez instalada la CLI, verifica su correcto funcionamiento abriendo una nueva terminal y ejecutando:

codex --version

El resultado esperado mostrará el número de versión instalado (los dígitos pueden variar con las actualizaciones):

codex-cli 0.139.0

Ver el número de versión confirma que el ejecutable está instalado y es accesible. Si recibes el error command not found: codex (o 'codex' no se reconoce como un comando interno o externo en Windows), la instalación ha finalizado correctamente pero la ruta de instalación del ejecutable no se ha registrado en las rutas de búsqueda del sistema (PATH); consulta la sección 08 para solucionarlo.

Los parámetros para verificar actualizaciones y «cómo actualizar manualmente a la versión más reciente» deben consultarse en la documentación oficial o ejecutando codex --help, ya que son elementos en constante evolución. La consulta directa a la CLI con codex --help es el método más fiable para comprobar los subcomandos disponibles en la versión instalada.

La versión de la aplicación de escritorio se puede consultar en el menú de la aplicación. Mantener versiones dispares entre la CLI y la aplicación de escritorio puede generar diferencias en el comportamiento; compruébalo si encuentras inconsistencias.

💡 Resumen en una frase: Ejecuta codex --version para validar la instalación de la CLI; consulta los comandos de actualización y los parámetros de ayuda directamente con codex --help en lugar de confiar en tutoriales antiguos.

---

06 Iniciar sesión: Configurar tu cuenta

Tras la instalación, Codex requiere asociarse a tu cuenta para estar operativo. Accede al directorio de tu proyecto desde la terminal e inicia la CLI:

codex

Si no se detecta una sesión activa, el sistema te guiará para iniciar sesión con ChatGPT, abriendo el navegador para completar la autorización OAuth. Una vez concedida, el token de acceso se transferirá de vuelta a la CLI para finalizar el proceso.

Comparativa de los dos métodos de inicio de sesión

Método	Proceso	Escenario recomendado	Consideraciones
Cuenta de ChatGPT (Recomendado)	Selecciona Sign in with ChatGPT al iniciar y autoriza en el navegador	Uso general y acceso a las funciones en la nube	El consumo se imputa a tu plan de ChatGPT
API key	Selecciona login con API key e introduce la clave generada en la plataforma de OpenAI	Integraciones en CI/CD y scripts automatizados	Facturación por consumo de API estándar; algunas funciones del espacio de trabajo de ChatGPT no estarán disponibles

Para el desarrollo diario, te sugiero iniciar sesión con tu cuenta de ChatGPT; el volumen de uso incluido en el plan suele ser suficiente y permite aprovechar las funciones en la nube. El uso de API keys es preferible para scripts automatizados e integraciones en CI/CD, ya que no requiere interacción con el navegador y facilita la ejecución desatendida; sin embargo, no compartas ni expongas las API keys en entornos públicos o no seguros.

Ubicación y persistencia de las credenciales

Al iniciar sesión correctamente, las credenciales se almacenan localmente para evitar tener que autenticarse en cada inicio. Puntos clave a considerar:

• La CLI y las extensiones para IDE comparten el mismo almacén de credenciales; si cierras sesión en una interfaz, se cerrará también en la otra.
• Las credenciales se guardan localmente en el archivo de texto plano ~/.codex/auth.json o en el almacén de claves seguro del sistema operativo (como Keychain en macOS); puedes especificar el método con el parámetro cli_auth_credentials_store (file / keyring / auto, ver capítulo 18).

⚠️ El archivo ~/.codex/auth.json contiene tu token de acceso personal; considéralo una contraseña: no lo subas a repositorios Git, no lo adjuntes en tickets de soporte ni lo compartas en chats públicos.

Para las sesiones iniciadas con ChatGPT, Codex renovará el token automáticamente antes de que expire, evitando cierres de sesión frecuentes durante el uso normal.

Solución si el login se bloquea en servidores remotos o WSL

Este es un escenario común: en servidores remotos, entornos headless (sin interfaz gráfica) o cuando el cortafuegos local bloquea la redirección a localhost, el proceso de login por navegador no puede completarse porque no hay navegador disponible o la respuesta OAuth no puede recibirse en el puerto local. La solución estándar es el login mediante código de dispositivo (Device Code Login).

En el menú de inicio de sesión de la terminal, selecciona Sign in with Device Code, o ejecuta directamente:

codex login --device-auth

Esta función (en fase beta) generará una URL de acceso y un código de verificación de un solo uso; abre la URL en cualquier navegador web con acceso a internet (por ejemplo, en tu ordenador local), introduce el código y la sesión se iniciará en la máquina remota sin depender de un navegador local.

El login mediante código de dispositivo debe estar habilitado en la configuración de seguridad de tu cuenta de ChatGPT o por el administrador de tu espacio de trabajo. Si no está disponible, cuentas con dos alternativas:

1. Copiar las credenciales de sesión: realiza el proceso de codex login en un equipo local con navegador, localiza el archivo generado en ~/.codex/auth.json y cópialo al mismo directorio en el servidor remoto. Por ejemplo, mediante SSH:

   ssh usuario@servidor 'mkdir -p ~/.codex'
   scp ~/.codex/auth.json usuario@servidor:~/.codex/auth.json

2. Redirección de puertos SSH: redirige el puerto de retorno local de Codex (predeterminado en localhost:1455) desde el servidor a tu máquina local para completar la redirección del navegador:

   ssh -L 1455:localhost:1455 usuario@servidor

   Una vez conectado, ejecuta codex login en la terminal remota y abre el enlace de autorización en el navegador de tu máquina local.

El uso de codex login --device-auth es la forma más rápida en entornos remotos; basta con abrir el enlace en tu máquina de escritorio, introducir el código generado y en pocos segundos la terminal remota estará autenticada.

💡 Resumen en una frase: Inicia sesión por defecto con tu cuenta de ChatGPT, cuyas credenciales se guardan localmente en ~/.codex/auth.json (protégelo como una contraseña); en servidores remotos, utiliza codex login --device-auth, o copia el archivo de credenciales localmente si hay restricciones de red.

---

07 Práctica: Tu primera tarea con Codex

Una vez completada la instalación y el inicio de sesión, ejecuta una prueba básica para verificar que todo el flujo funciona correctamente. Este flujo no requiere una base de código previa; puedes realizarlo en un directorio vacío.

Paso 1: crea una carpeta de prueba, accede a ella desde la terminal e inicia Codex:

mkdir codex-test && cd codex-test
codex

Si es el primer inicio, completa el inicio de sesión según se describe en la sección 06. A continuación, verás el prompt de entrada de Codex esperando tus instrucciones.

Paso 2: pídele que realice una tarea sencilla escribiendo tus instrucciones en lenguaje natural:

Escribe una función en test.py que imprima "hello world"

Comportamiento esperado: Codex requiere tu aprobación antes de realizar cambios por defecto; te presentará las modificaciones sugeridas en pantalla y esperará a que confirmes (seleccionando Yes) antes de aplicarlas. Este paso es el flujo estándar de Codex: propone el plan, solicita tu aprobación y aplica las modificaciones, garantizando que tengas el control sobre los cambios en tus archivos (las políticas de sandbox y aprobación se explican en detalle más adelante).

Una vez aprobado, verás que se ha creado el archivo test.py en tu directorio. Para salir de la CLI, pulsa Ctrl + C o escribe /exit en el cuadro de entrada.

Paso 3 (Práctica recomendada): dado que Codex modificará los archivos del repositorio, se aconseja crear commits de Git antes y después de dejarle trabajar, de modo que puedas revertir cambios fácilmente si el resultado no es el esperado:

git init
git add -A && git commit -m "Commit previo al uso de Codex"

Con estos pasos, has completado el ciclo básico de: «instalar → iniciar sesión → dar instrucciones → revisar la propuesta → confirmar cambios → guardar el estado del repositorio». Comprobar cómo Codex se detiene para mostrarte los cambios antes de aplicarlos te dará confianza sobre el uso seguro del agente en tu base de código.

El flujo se resume en este diagrama:

El punto clave del flujo es el filtro de aprobación: el agente solo aplicará las modificaciones propuestas si seleccionas Yes en la terminal; si seleccionas No, la propuesta se cancelará para que puedas ajustar las instrucciones.

💡 Resumen en una frase: Puedes probar el agente en una carpeta vacía iniciando codex, dándole una instrucción y aprobando la propuesta con Yes; crear un commit de Git antes de iniciar es una práctica excelente para revertir cambios fácilmente.

---

08 Resolución de problemas comunes

Los errores durante la instalación y el primer uso son habituales, pero la mayoría tiene una solución conocida. Consulta esta tabla antes de intentar reinstalar el software:

Error / Síntoma	Causa principal	Solución
command not found: codex	El ejecutable de instalación no está en la ruta PATH	Añade el directorio de instalación al PATH del sistema (ver instrucciones abajo)
'codex' no se reconoce... (Windows)	PATH no configurado o la terminal no se ha reiniciado	Configura la variable PATH y reinicia la terminal
irm no se reconoce...	Ejecución de comandos de PowerShell en CMD	Abre una consola de PowerShell para ejecutar el comando con irm
El navegador de login se congela o falla la redirección	Entorno remoto, headless o cortafuegos bloqueando localhost	Utiliza el login mediante código de dispositivo con codex login --device-auth (sección 06)
Error de conexión o tiempo de espera al descargar el script	Restricciones de acceso a internet en la red local	Verifica tu conexión de red o utiliza Homebrew como alternativa
Faltan funciones tras iniciar sesión con API key	Las API keys limitan las funciones basadas en el espacio de trabajo de ChatGPT	Cierra sesión e inicia sesión con una cuenta de ChatGPT
Error 1385 en Windows (fallo al iniciar sandbox)	Directivas de grupo impidiendo privilegios al usuario del sandbox	Consulta con soporte de IT o cambia temporalmente al sandbox unelevated
Se ejecutan versiones distintas al llamar a codex	Existen múltiples instalaciones en la máquina	Ejecuta which -a codex para localizar y eliminar las instalaciones redundantes

A continuación detallamos las soluciones para los dos fallos más frecuentes.

Error 1: command not found: codex (Comando no encontrado)

Si tras instalar recibes el error de comando no encontrado al ejecutar codex, el ejecutable se ha instalado correctamente pero el sistema no sabe dónde buscarlo porque su directorio no está registrado en la variable PATH.

Analogía: La variable PATH es como el callejero de búsqueda de tu sistema operativo. Al llamar a un programa, el sistema busca en los directorios registrados en esa lista. Si el directorio de Codex no está registrado, el sistema no sabrá dónde localizarlo.

Solución (en macOS y Linux que utilizan Zsh por defecto; verifica en qué directorio se ha instalado y añádelo al archivo de configuración de tu terminal):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

En el ejemplo asumimos que la instalación se realizó en ~/.local/bin; ajusta la ruta según los mensajes de confirmación impresos por el script de instalación. Si usas Bash en lugar de Zsh en Linux, edita ~/.bashrc en lugar de ~/.zshrc. En Windows, añade la ruta del directorio de instalación a las variables de entorno de tu usuario y reinicia la terminal para aplicar los cambios.

Verifica el cambio con el comando de versión:

codex --version

El error se habrá resuelto si se muestra el número de versión.

Error 2: Resolver conflictos entre múltiples instalaciones

Si has instalado Codex previamente usando npm y luego ejecutas el script oficial, tendrás varias versiones del ejecutable en tu PATH, lo que puede provocar inconsistencias en su comportamiento. Identifica las rutas de instalación ejecutando:

which -a codex

Si el resultado muestra más de una ruta, elimina las instalaciones redundantes para quedarte únicamente con la versión oficial. Por ejemplo, desinstala la versión global de npm:

npm uninstall -g @openai/codex

Tener ejecutables duplicados compitiendo por la misma llamada en la terminal suele provocar que se ejecuten versiones antiguas almacenadas en directorios con prioridad en el PATH. Mantén una instalación única del script oficial y limpia tu PATH para evitar conflictos.

💡 Resumen en una frase: Si la terminal no localiza el comando, verifica la configuración de tu variable PATH; si el comportamiento del ejecutable es errático, comprueba si existen instalaciones duplicadas con which -a codex y elimina las versiones de npm globales.

---

09 Resumen

En este capítulo hemos cubierto el proceso de configuración inicial de Codex:

• Requisitos previos: elige la CLI como interfaz de desarrollo principal, dispón de una cuenta de ChatGPT o API key y asegura un acceso estable a internet a los servidores de OpenAI.
• Vías de instalación: la aplicación de escritorio está disponible en Mac y Windows; la CLI es multiplataforma y se aconseja instalarla con el script oficial de instalación (curl ... | sh / Windows: irm), dejando Homebrew y npm como alternativas.
• Windows: utiliza por defecto la instalación nativa con sandbox elevated; recurre a unelevated si hay restricciones de directivas del sistema, o a WSL2 si necesitas un entorno de desarrollo Linux (WSL1 ya no es compatible).
• Inicio de sesión: prefiere la cuenta de ChatGPT, que almacena las credenciales locales de forma persistente en ~/.codex/auth.json; utiliza codex login --device-auth en entornos remotos o sin interfaz gráfica.
• Solución de problemas: los comandos no encontrados se resuelven configurando el PATH; las inconsistencias en la terminal suelen deberse a instalaciones duplicadas.

Con estos pasos completados, dispones de una instalación funcional de Codex en tu equipo local y estás listo para empezar a programar con el agente.

El próximo capítulo 04 · Suscripción y facturación abordará los costes del servicio: ¿qué volumen de uso de Codex incluye tu suscripción de ChatGPT? ¿Cómo se calcula el consumo mediante API keys? ¿Cómo se comparan los costes frente a Claude Code? Analizar estos costes te permitirá gestionar tu presupuesto de uso y evitar sorpresas de consumo al programar.

---

Lecturas recomendadas

• Reglas y ganchos (Rules & Hooks): configurar disparadores y puntos de control en Codex
• Guía de uso en Windows: configurar el entorno nativo o WSL
• Skills de agentes: empaquetar tareas repetitivas para que Codex las ejecute de forma autónoma