DownloadCodex Guía no oficial
Español

Instala la Codex CLI

Instala la Codex CLI con el instalador independiente de OpenAI. En macOS o Linux, ejecuta curl -fsSL https://chatgpt.com/codex/install.sh | sh. En Windows, ejecuta el comando de install.ps1 desde una nueva ventana de PowerShell. Las alternativas son npm install -g @openai/codex o brew install --cask codex. Después, ejecuta codex en una carpeta de proyecto y elige Sign in with ChatGPT.

Se aplica a: Codex CLI, macOS, Linux, Windows

Esta página es una traducción de la guía en inglés. Los comandos y los nombres de archivo no cambian. Si ambas versiones no coinciden, prevalecen la página en inglés y las fuentes oficiales.

1. Instala

Elige un método.

macOS o Linux: instalador independiente

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

Windows: instalador independiente

Abre una nueva ventana de PowerShell y ejecuta:

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

npm (cualquier sistema operativo con Node.js)

npm install -g @openai/codex

Homebrew (macOS)

brew install --cask codex

Según el README, los instaladores independientes descargan desde releases.openai.com/codex y, si no está disponible, recurren a GitHub Releases. Para forzar el uso de GitHub Releases:

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

2. Confirma que se instaló

Abre un terminal nuevo para que se actualice tu PATH y ejecuta:

codex --version

Deberías ver un número de versión. Si ves “command not found”, sigue esta solución.

3. Inicia sesión

Ve a una carpeta de proyecto e inicia Codex:

cd path/to/your/project
codex

Elige Sign in with ChatGPT (iniciar sesión con ChatGPT). Se abre tu navegador y, cuando inicias sesión, devuelve las credenciales a la CLI. También puedes ejecutar codex login directamente. Para usar una clave de API en su lugar:

printenv OPENAI_API_KEY | codex login --with-api-key

Comprueba qué método está activo con codex login status. ¿Trabajas por SSH o en un servidor sin interfaz gráfica? Usa codex login --device-auth. Más opciones de inicio de sesión.

4. Ejecuta una primera instrucción

Tell me about this project

Después, continúa con tu primera tarea real.

Comandos útiles que conviene conocer

ComandoQué hace
codexInicia una sesión interactiva en la carpeta actual
codex resumeVuelve a abrir un chat reciente de este repositorio
codex exec "..."Se ejecuta de forma no interactiva, para scripts y CI
codex --searchUsa la búsqueda web en directo en esta ejecución
codex mcp add ...Conecta un servidor MCP
codex login statusMuestra el método de inicio de sesión activo
codex completionGenera el autocompletado para la shell

Preguntas frecuentes

¿Qué método de instalación debería usar?

El instalador independiente es el método que OpenAI menciona primero y no necesita Node.js. Usa npm o Homebrew si ya gestionas tus herramientas con ellos. Evita mezclar métodos, o podrías acabar con dos copias en tu PATH.

¿Puedo obligar al instalador a descargar desde GitHub?

Sí. El README indica que, si estableces CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false, el instalador usa GitHub Releases en lugar de releases.openai.com.

¿Cómo veo lo que hace Codex para depurar?

Ejecuta codex -c log_dir=./.codex-log para escribir un registro en texto plano y síguelo con tail -F ./.codex-log/codex-tui.log.

Fuentes

Enlazamos a la fuente oficial de cada instrucción de esta página. Si algo de lo que decimos no coincide con ella, confía en la fuente oficial y avísanos.

Lee a continuación