Guía de instalación offline de Codex CLI

Guía de instalación offline de Codex CLI para Windows y macOS, con la estructura del paquete, los scripts de configuración, los problemas comunes y cómo preparar una API key más barata y estable.

Esta guía está pensada para usuarios nuevos que quieren instalar Codex CLI sin depender de una red externa estable y empezar a usarlo justo después de configurarlo.

Para quién es esta guía

Para quien quiera probar Vibe Coding sin depender de una conexión fuerte

Para usuarios nuevos de Codex CLI que quieren una ruta de instalación limpia

Para equipos que necesitan un paquete offline portable para compañeros o amigos

Qué preparar antes de instalar

El equipo de destino ya debería tener Node.js y npm. Compruébalo primero en la terminal.

node -v
npm -v

Estructura del paquete

El bundle offline está separado por plataforma: windows-x64, macos-arm64 y macos-x64. Cada carpeta incluye el paquete principal, el paquete runtime de la plataforma y los scripts de instalación y configuración.

Identifica primero tu plataforma

Windows

La mayoría de los equipos Windows normales usan windows-x64.

macOS

Usa macos-arm64 para Apple Silicon y macos-x64 para los Mac Intel. En macOS puedes comprobarlo con uname -m.

uname -m

Pasos de instalación en Windows x64

Paso 1: entra en el directorio de instalación offline

cd "your-path\codex-npm-offline\windows-x64\npm-offline"

Paso 2: ejecuta el script de instalación

.\install-codex-windows-x64.cmd

Paso 3: instala manualmente si hace falta

npm install -g .\codex-npm-0.121.0-alpha.6.tgz @openai/codex-win32-x64@file:.\codex-npm-win32-x64-0.121.0-alpha.6.tgz

Paso 4: verifica que la instalación fue correcta

codex --version

Ejecuta el script de configuración

.\run-codex-setup.cmd

Después de instalar, el script de configuración te pedirá la Base URL y la API key.

Escribirá la configuración en los archivos principales de Codex y normalmente hará una copia de seguridad antes de sobrescribir.

~/.codex/config.toml
~/.codex/auth.json

Instalación en macOS Apple Silicon

cd "/your-path/codex-npm-offline/macos-arm64/npm-offline"
bash ./install-codex-macos-arm64.sh

Si prefieres la instalación manual, puedes usar npm para instalar el paquete principal y el paquete específico de plataforma.

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-arm64@file:./codex-npm-darwin-arm64-0.121.0-alpha.6.tgz

Instalación en macOS Intel

cd "/your-path/codex-npm-offline/macos-x64/npm-offline"
bash ./install-codex-macos-x64.sh

npm install -g ./codex-npm-0.121.0-alpha.6.tgz @openai/codex-darwin-x64@file:./codex-npm-darwin-x64-0.121.0-alpha.6.tgz

Problemas comunes

Después de instalar no aparece el comando codex

Cierra la terminal actual, abre una nueva y vuelve a ejecutar codex --version.

Windows bloquea el script

Usa la entrada del script de configuración porque llama a PowerShell con ExecutionPolicy Bypass.

macOS dice que el script no tiene permisos

Ejecuta los scripts shell directamente con bash en lugar de hacer doble clic.

Cómo conseguir una API key estable y barata

Si todavía necesitas una clave de proveedor, regístrate, compara grupos y precios, crea un API token y luego copia la Base URL y la API key dentro del flujo de configuración.

Ruta de uso más corta

Instala el paquete correcto para tu plataforma

Ejecuta el script de configuración e introduce Base URL y API key

Inicia Codex con codex o usa codex --yolo para un modo de ejecución más directo

codex
codex --yolo