Instalación · Windows · macOS · Linux

Cómo instalar Codex CLI en Windows, macOS y Linux

Aprende cómo instalar OpenAI Codex CLI paso a paso en Windows, macOS y Linux. Veremos el instalador oficial, PowerShell, npm, Homebrew, WSL2, binarios manuales, inicio de sesión, actualización, PATH, verificación, codex doctor y los errores de instalación más habituales.

Instalación rápida Instalar en Windows
Standalone PowerShell npm Homebrew
Respuesta rápida

¿Cómo instalar Codex CLI?

La forma más directa de instalar Codex CLI es utilizar el instalador oficial de OpenAI. En macOS y Linux puedes ejecutar curl -fsSL https://chatgpt.com/codex/install.sh | sh. En Windows, OpenAI ofrece un instalador PowerShell. También puedes instalarlo mediante npm install -g @openai/codex o con brew install --cask codex. Después verifica la instalación con codex --version y ejecuta codex para iniciar sesión.

Métodos

Cuatro formas de instalar Codex CLI

01

Instalador oficial

La opción más directa para macOS, Linux y Windows.

02

npm

Útil si ya trabajas habitualmente con Node.js y npm.

03

Homebrew

Alternativa cómoda especialmente para macOS.

04

Binario

Descarga manual desde los releases oficiales de GitHub.

Publicidad
Qué elegir

El método recomendado depende de tu sistema

WINDOWS

PowerShell

Utiliza el instalador nativo oficial.

MACOS

Standalone

Instalador oficial o Homebrew si prefieres package manager.

LINUX

Standalone

Instalador shell y binario nativo.

NODE.JS

npm

Alternativa multiplataforma conocida por desarrolladores.

Publicidad
Antes de instalar

Requisitos para utilizar Codex CLI

Requisito Recomendación
Sistema operativo Windows, macOS o Linux compatibles
RAM 4 GB mínimo; 8 GB recomendados
Git Recomendado para trabajar con repositorios
Internet Necesario para instalación, autenticación y modelos remotos
ChatGPT / API Cuenta compatible o API key
Git no es estrictamente necesario para iniciar Codex.

Sin embargo, resulta muy recomendable porque permite revisar, aislar y revertir los cambios generados por el agente.

Instalación rápida

Instalador oficial de OpenAI

macOS / Linux 
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows PowerShell 
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
¿De dónde descarga Codex?

Los instaladores standalone descargan normalmente los paquetes desde la infraestructura oficial de releases de OpenAI y pueden utilizar GitHub Releases como respaldo.

Verificación

Comprueba que Codex se instaló correctamente

codex --version

Deberías obtener una salida similar a: 

codex-cli X.Y.Z
No copies una versión concreta desde esta guía.

Codex CLI se actualiza con frecuencia, por lo que el número exacto cambiará con el tiempo.

Primer inicio

Ejecuta Codex por primera vez

codex

Si todavía no estás autenticado, Codex mostrará las opciones disponibles para iniciar sesión.

Login

Iniciar sesión con ChatGPT

codex login
1

Ejecuta login

Codex inicia el proceso de autenticación.

2

Abre navegador

Inicia sesión con tu cuenta de ChatGPT.

3

Autoriza

Completa el proceso solicitado.

4

Vuelve al terminal

Codex queda preparado para utilizarse.

API

También puedes autenticar Codex con una API key

printenv OPENAI_API_KEY | codex login --with-api-key
La facturación cambia.

Con una API key, el consumo corresponde a tu cuenta de OpenAI API y no a la asignación incluida en tu plan ChatGPT.

Aprende cómo funciona OpenAI API →
Publicidad
Windows

Cómo instalar Codex CLI en Windows

Instalación nativa

El quickstart actual de OpenAI proporciona un instalador nativo para Windows mediante PowerShell. Por lo tanto, ya no necesitas instalar Codex obligatoriamente dentro de Linux para utilizar la CLI. 

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

Luego verifica: 

codex --version
Windows PATH

Comprueba qué ejecutable de Codex está utilizando Windows

Get-Command codex

Otra opción: 

where.exe codex
Muy útil si instalaste Codex varias veces.

Puedes tener, por ejemplo, una instalación standalone y otra instalada mediante npm. El primer ejecutable encontrado en PATH será el que normalmente se ejecute.

Diagnóstico

Codex Doctor en Windows

codex doctor
Diagnóstico

codex doctor puede ayudar a diagnosticar problemas relacionados con instalación, autenticación, conectividad, estado interno y componentes necesarios para Codex.

Windows vs WSL2

¿Codex nativo o Codex dentro de WSL2?

Windows nativo

Más directo

Trabaja con PowerShell, herramientas Windows y rutas nativas.

  • Instalador oficial PowerShell
  • Terminal Windows
  • Sandbox Windows
  • Rutas Windows
WSL2

Entorno Linux

Conveniente si tu stack de desarrollo ya vive dentro de Linux.

  • Bash
  • Tooling Linux
  • Sandbox Linux
  • Paquetes Linux
Elige según dónde vive tu proyecto.

Si desarrollas principalmente dentro de WSL2, instala Codex dentro de esa distribución Linux. Si trabajas directamente con PowerShell y herramientas Windows, la instalación nativa resulta más simple.

WSL2

Comprobar las distribuciones WSL instaladas

wsl -l -v

Busca que tu distribución indique: 

VERSION
2
Instalación WSL2

Instala Codex dentro de Ubuntu o Debian

Abre la terminal WSL y ejecuta: 

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

Después: 

codex --version

codex
Instala dentro del entorno donde desarrollarás.

Una instalación de Codex en PowerShell y otra dentro de WSL son instalaciones diferentes, con herramientas y PATH distintos.

Rendimiento

Si trabajas en WSL, guarda el proyecto dentro del filesystem Linux

Recomendado 
~/projects/mi-app
Menos ideal 
/mnt/c/Users/...
¿Por qué?

Herramientas que realizan muchas operaciones de filesystem suelen rendir mejor cuando proyecto y herramientas viven en el mismo filesystem Linux.

Publicidad
macOS

Cómo instalar Codex CLI en Mac

Opción recomendada

Ejecuta el instalador standalone oficial. 

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

Comprueba: 

codex --version
Homebrew

Instalar Codex con Homebrew

brew install --cask codex
Actualmente Codex se distribuye como cask.

Si tienes una instalación antigua mediante una fórmula de Homebrew, puedes encontrar diferencias al actualizar.

Arquitectura Mac

Apple Silicon o Intel

uname -m
Salida Arquitectura
arm64 Apple Silicon
x86_64 Mac Intel
Linux

Cómo instalar Codex CLI en Linux

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

Comprueba posteriormente: 

command -v codex

codex --version
Distribuciones documentadas históricamente por el proyecto

El repositorio de Codex incluye Ubuntu y Debian entre sus entornos Linux documentados. Para distribuciones distintas, el binario standalone puede ser una buena alternativa.

Sandbox Linux

Instalar Bubblewrap cuando sea necesario

sudo apt update

sudo apt install bubblewrap
bwrap

Codex utiliza mecanismos de aislamiento del sistema operativo para limitar los comandos que ejecuta. En Linux y WSL2, Bubblewrap forma parte de ese aislamiento.

npm

Instalar Codex CLI mediante npm

npm install -g @openai/codex
El paquete correcto es:

@openai/codex

No confundas ese paquete con paquetes antiguos o no relacionados que puedan llamarse simplemente codex.

npm

Verificar la instalación npm

npm list -g @openai/codex

codex --version
Error npm

Qué hacer si npm devuelve EACCES o permission denied

Evita mezclar instalaciones

En Linux puede ocurrir que npm global apunte a una carpeta propiedad de root. Esto provoca errores durante instalación o actualización.

Consulta el prefijo actual: 

npm prefix -g
Evita usar sudo como solución automática.

Una configuración npm global propiedad del usuario o un gestor de versiones de Node suele evitar este tipo de conflictos.

PATH

Evita tener varias instalaciones de Codex activas

command -v codex

which codex

codex --version
Un problema muy engañoso

es actualizar una instalación mientras tu terminal continúa ejecutando otra copia situada antes en PATH.

Publicidad
Instalación manual

Descargar el binario de Codex desde GitHub

Cada release oficial incluye binarios compilados para distintas plataformas.

Plataforma Ejemplo de artefacto
macOS Apple Silicon codex-aarch64-apple-darwin
macOS Intel codex-x86_64-apple-darwin
Linux x86_64 codex-x86_64-unknown-linux-musl
Linux ARM64 codex-aarch64-unknown-linux-musl
Después de extraerlo

normalmente conviene renombrar el ejecutable como codex y colocarlo en un directorio incluido en tu PATH.

Ver releases oficiales de Codex →
Arquitectura

Comprueba la arquitectura de tu sistema

macOS / Linux 
uname -m
Windows PowerShell 
$env:PROCESSOR_ARCHITECTURE
Avanzado

También puedes compilar Codex desde el código fuente

Rust

Codex CLI se desarrolla principalmente en Rust. El repositorio oficial incluye instrucciones para compilarlo desde fuente. 

git clone https://github.com/openai/codex.git

cd codex/codex-rs

cargo build
Esto no es necesario para la mayoría de usuarios.

Compilar desde fuente tiene sentido principalmente para contribuir, investigar la implementación o probar cambios del proyecto.

Descarga alternativa

Forzar el instalador a utilizar GitHub Releases

Si tienes problemas accediendo al servidor principal de releases, el instalador admite forzar GitHub Releases.

macOS / Linux 
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
PowerShell 
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'
irm https://chatgpt.com/codex/install.ps1 | iex
Actualización

Cómo actualizar Codex CLI

Actualiza con el mismo sistema que utilizaste para instalar.

Esto reduce conflictos entre ejecutables, package managers y rutas distintas.

npm 
npm install -g @openai/codex@latest
Homebrew 
brew upgrade --cask codex
Standalone

Utiliza el mecanismo de actualización mostrado por la instalación standalone o vuelve a ejecutar el instalador oficial.

Después de actualizar

abre una terminal nueva y ejecuta: 

codex --version
Problema común

Actualicé Codex pero continúa mostrando la versión antigua

which -a codex

command -v codex

codex --version

En Windows: 

where.exe codex

Get-Command codex
Probablemente tienes dos instalaciones.

Elimina o corrige la instalación antigua en vez de continuar actualizando una copia que tu terminal no está utilizando.

Error

codex: command not found

Causa probable

El ejecutable no está en una carpeta incluida en PATH, o la terminal todavía no ha cargado los cambios de configuración.

1

Reinicia terminal

Abre una sesión nueva.

2

Comprueba PATH

Verifica dónde se instaló Codex.

3

Comprueba instalación

Revisa npm, Homebrew o standalone.

4

Reinstala si es necesario

Utiliza un solo método.

Shell

La terminal puede recordar una ruta antigua

En algunas shells puedes limpiar el hash de comandos: 

hash -r

Después: 

command -v codex

codex --version
Login

Codex se instaló pero no puedo iniciar sesión

codex doctor
01

Comprueba conectividad.

02

Comprueba la cuenta utilizada.

03

Reintenta el login.

04

Comprueba proxy o firewall corporativo.

Sandbox

Codex abre pero falla al ejecutar comandos

Diagnóstico

Si la interfaz funciona pero los comandos fallan antes de ejecutarse, el problema puede estar en el sandbox y no en la instalación principal de Codex. 

codex doctor
En Windows especialmente

revisa la información del sandbox que muestre Codex Doctor antes de asumir que debes reinstalar toda la CLI.

Seguridad

No desactives el sandbox solamente para solucionar la instalación

Primero identifica la causa.

El sandbox existe para limitar qué puede hacer el código ejecutado por el agente. Deshabilitar todas las restricciones puede ocultar un problema de configuración a costa de reducir la seguridad.

Git

Instala Git si vas a utilizar Codex para desarrollo real

git --version
El proyecto Codex recomienda Git para determinadas funciones.

Git también permite comprobar exactamente qué archivos modificó el agente y revertir cambios fácilmente.

Prueba final

Abre tu primer proyecto después de instalar

cd mi-proyecto

git status

codex

Primer prompt: 

Analiza este repositorio.

No modifiques nada todavía.

Explícame:

- qué hace
- cómo está organizado
- tecnologías utilizadas
- comandos para ejecutarlo
- tests disponibles
- cinco archivos importantes.
Aprende ahora cómo usar Codex →
Decisión

¿Qué método de instalación elegir?

Quiero la instalación oficial sencilla macOS o Linux
install.sh
Quiero instalar nativamente Windows
PowerShell
Ya administro herramientas con Node Multiplataforma
npm
Uso Homebrew macOS
Cask
Quiero controlar el ejecutable exacto Instalación manual
Release
Todo mi desarrollo está en Linux Windows + WSL2
Instalar en WSL
Troubleshooting

Errores frecuentes al instalar Codex CLI

Problema Qué revisar
codex: command not found PATH e instalación activa
Versión antigua después de actualizar Múltiples instalaciones
npm EACCES npm global prefix y permisos
No puedo iniciar sesión Cuenta, navegador, conexión y firewall
Comandos del agente fallan Sandbox y Codex Doctor
Homebrew no actualiza Cask vs instalación antigua
Funciona en Windows pero no WSL Instalaciones y PATH independientes
Codex ejecutado no es el actualizado which, where.exe o Get-Command
Checklist

Instalación de Codex lista para usar

✓

codex --version funciona.

✓

Codex aparece correctamente en PATH.

✓

El login se completa correctamente.

✓

codex doctor no muestra fallos críticos.

✓

Git funciona en el mismo entorno.

✓

El sandbox puede ejecutar comandos.

✓

Codex abre dentro de un proyecto.

✓

Ya puedes crear tu AGENTS.md.

Publicidad
Evita problemas

Errores que conviene evitar

01

Instalar Codex por npm, standalone y Homebrew simultáneamente sin saber cuál estás usando.

02

Actualizar una instalación diferente a la que aparece primero en PATH.

03

Utilizar sudo npm install -g automáticamente sin comprender la configuración de npm.

04

Deshabilitar el sandbox para esconder un problema de instalación.

05

Instalar Codex en Windows esperando que automáticamente aparezca también dentro de WSL.

06

Publicar tu API key en comandos, repositorios o capturas.

Cluster Codex

Guías relacionadas

Fuentes oficiales

Documentación de instalación

Publicidad
Publicidad
Preguntas frecuentes

FAQ sobre la instalación de Codex CLI

Puedes instalar Codex CLI mediante el instalador standalone oficial de OpenAI. También existen instalaciones mediante npm, Homebrew y binarios descargados desde GitHub Releases.

OpenAI proporciona actualmente un instalador PowerShell para instalar Codex CLI de forma nativa en Windows. También puedes utilizar Codex dentro de WSL2 si tu entorno de desarrollo utiliza Linux.

Sí. Puedes instalar Codex dentro de una distribución Linux en WSL2. La instalación dentro de WSL es independiente de una instalación nativa de Windows.

Puedes utilizar el instalador shell oficial de OpenAI o instalar Codex mediante Homebrew con brew install –cask codex.

La forma más directa es utilizar el instalador shell oficial. También puedes utilizar npm o descargar el binario Linux correspondiente desde GitHub Releases.

Sí. El paquete oficial es @openai/codex y puede instalarse globalmente mediante npm.

Ejecuta codex –version. Si la instalación es correcta, la terminal mostrará la versión de Codex CLI instalada.

Normalmente significa que Codex no está instalado correctamente o que el directorio del ejecutable no se encuentra dentro del PATH de tu terminal.

Puedes ejecutar codex login y completar la autenticación con tu cuenta de ChatGPT. También existen workflows locales que permiten autenticación mediante API key.

codex doctor es una herramienta de diagnóstico que puede ayudar a encontrar problemas de instalación, autenticación, conectividad, rendimiento y configuración de Codex.

Lo más seguro es actualizar Codex utilizando el mismo método con el que se instaló. Para npm puedes instalar la versión latest de @openai/codex, mientras Homebrew utiliza brew upgrade –cask codex.

Una causa frecuente es tener varias instalaciones de Codex. Comprueba qué ejecutable está primero en PATH mediante command -v, which, where.exe o Get-Command.

Git no es obligatorio para todas las operaciones, pero resulta muy recomendable para desarrollo porque permite revisar, comparar y revertir los cambios realizados por el agente.

Publicidad
Siguiente guía

¿Cuánto cuesta Codex?

Ya tienes Codex CLI instalado. Ahora veremos cómo funciona su acceso desde los planes de ChatGPT, cuáles son sus límites, qué ocurre cuando consumes la asignación incluida y cuándo entra en juego la facturación de OpenAI API.

Ver precio de Codex →
Carrito de compra
Scroll al inicio