Instalar Codex CLI y completar la primera ejecución segura
Guía actual para instalar Codex CLI, elegir autenticación o provider personalizado, verificar la configuración y hacer una primera tarea segura.
Índice
Para la automatización opcional del provider, use los scripts actuales https://www.bettertoken.ai/install-codex-provider.sh y https://www.bettertoken.ai/install-codex-provider.ps1; conserve valores temporales en TEMP solo cuando las instrucciones actuales lo requieran.
Para continuar, use su propia cuenta BetterToken y API Key. Crear una cuenta BetterToken
Codex CLI es el agente de programación de OpenAI para la terminal. Se instala un único cliente oficial, codex, y después se elige una vía de acceso: iniciar sesión con ChatGPT, usar una API Key de OpenAI o configurar un custom provider compatible. No se necesita una aplicación Codex distinta para cada provider.
La primera ejecución segura tiene cuatro pasos: instalarlo, comprobar codex --version, terminar una sola vía de autenticación o provider y ejecutar una tarea de solo lectura en un repositorio de prueba. No abras código de producción antes de esas comprobaciones.
Esta guía se contrastó con el repositorio actual de OpenAI Codex y la documentación de BetterToken el 21 de agosto de 2026. Los comandos de instalación y los campos de configuración pueden cambiar; aplica siempre las fuentes primarias enlazadas.
Si eliges un custom provider de pago por uso, consulta la guía actual de BetterToken para Codex, crea tu propia API Key y verifica la primera solicitud antes de abrir un repositorio de producción. BetterToken configura el Codex CLI oficial mediante un custom provider; no es otro cliente Codex ni una suscripción de ChatGPT.
Elegir el método de instalación
| Método | Útil para | Requisito |
|---|---|---|
| Instalador autónomo | Instalación directa en macOS, Linux o Windows | curl o PowerShell; no requiere Node.js |
| Homebrew cask | macOS gestionado con Homebrew | Homebrew |
| npm | Entornos gestionados con Node.js | Node.js y npm funcionales |
| Binario de GitHub Releases | Instalación manual o controlada | Gestionar archivo y PATH |
El Codex CLI mantenido está implementado en Rust. Node.js solo es necesario para instalar con npm o para un script de provider que lo requiera explícitamente.
Comprobar requisitos previos
La documentación de OpenAI enumera macOS 12+, Ubuntu 20.04+/Debian 10+ y Windows 11 mediante WSL2 como bases compatibles. Git es recomendable para trabajar con repositorios. El soporte nativo de Windows y los detalles de sandbox se documentan por separado y pueden evolucionar.
Antes de instalar:
- Decide entre autenticación oficial de OpenAI o un custom provider.
- Comprueba que la terminal puede actualizar
PATH. - Empieza con un repositorio de prueba, no con un working tree de producción.
- Mantén las API Keys fuera de argumentos, archivos fuente, capturas e historial del shell.
Instalar Codex CLI
macOS y Linux: instalador autónomo
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --versionAbre una terminal nueva si el instalador modificó PATH.
macOS: Homebrew
brew install --cask codex
codex --versionnpm: macOS, Linux o Windows
npm install -g @openai/codex
codex --versionSi no se encuentra codex, inspecciona el prefijo global real de npm:
npm config get prefixCompáralo con PATH, corrige la configuración normal de Node.js o del shell y abre otra terminal. No añadas un supuesto /bin sin comprobar la distribución real de la instalación.
Windows y GitHub Releases
El instalador oficial de PowerShell es:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex --versionPara desarrollo orientado a Linux en Windows, instala el CLI de Linux dentro de WSL2 y, cuando sea posible, guarda los proyectos en el sistema de archivos WSL en vez de bajo /mnt/. Las releases de Codex ofrecen archivos para cada sistema y arquitectura; extrae el binario apropiado en un directorio ya incluido en PATH y verifica la versión.
Elegir exactamente una vía de acceso
No mezcles un inicio de sesión oficial de OpenAI con la configuración de un custom provider mientras diagnosticas. Primero valida una vía.
Iniciar sesión con ChatGPT
codex login
codex login statusCompleta el flujo en el navegador. En una máquina sin interfaz gráfica, sigue el método vigente de OpenAI para device code o API Key, en lugar de copiar tokens del navegador entre máquinas.
Usar una API Key de OpenAI
Guarda la clave en un gestor de secretos o una variable de entorno, nunca como argumento visible. Sigue la guía de autenticación de OpenAI para el flujo compatible y el almacenamiento de credenciales. Usa codex logout para eliminar credenciales oficiales guardadas.
Configurar un custom provider
El custom provider usa el mismo CLI oficial; su configuración selecciona Base URL, protocolo de API, modelo y la variable de entorno que entrega la clave. BetterToken documenta una ruta para Codex mediante la API OpenAI Responses. La Base URL actual es https://www.bettertoken.ai/v1; los Model IDs y grupos de claves son dinámicos, así que cópialos de la interfaz o documentación actual.
Antes de probar, elimina variables OpenAI antiguas que puedan sobrescribir la configuración:
unset OPENAI_API_KEY
unset OPENAI_BASE_URLSigue después la guía actual de BetterToken para Codex. Incluye los campos actuales de config.toml, wire_api = "responses", la variable de clave, la selección de modelo y el comando de inicio. Reinicia Codex por completo tras cambiar la configuración.
Hacer la primera ejecución segura
Empieza en un repositorio no crítico:
git clone https://github.com/openai/codex codex-test
cd codex-test
codex --sandbox read-only "Explain the entry point of this project"La primera ejecución es correcta cuando Codex inicia con la vía prevista, identifica archivos relevantes, no modifica archivos y no solicita permiso inesperado de escritura o ejecución. Con BetterToken, una respuesta normal del modelo y el registro correspondiente de solicitud, modelo, estado y uso de tokens en el Dashboard también confirman la ruta API.
Diagnosticar por capas
codex: command not found
Abre otra terminal, confirma que la instalación terminó e inspecciona la ubicación real. Para npm usa npm config get prefix; para un binario Release, confirma que el directorio está en PATH.
El navegador no se abre
Comprueba que hay navegador y que el callback no está bloqueado. En una máquina headless usa la vía documentada de device code o API Key. No copies archivos de autenticación desde otra máquina.
El custom provider devuelve 401, 403, 404 o HTML
Revisa la variable de clave, cuenta, provider, Base URL y posibles variables antiguas que anulen la configuración. Nunca imprimas la clave. Para 404 o HTML, compara la Base URL con los Docs actuales de Codex y no reutilices una Base URL de Claude Code.
model not found o los cambios no tienen efecto
Copia el Model ID de la lista actual del provider, no de un artículo o captura antigua. Detén todos los procesos Codex, abre una nueva terminal, comprueba el perfil o archivo activo y repite una sola petición pequeña de solo lectura. No cambies autenticación, modelo, Base URL y sandbox a la vez.
Lista final
codex --versiondevuelve una versión.- Para la prueba hay activa una sola vía de autenticación o provider.
- Los secretos no aparecen en código fuente ni en el historial del shell.
- Base URL, protocolo, modelo y variable de clave coinciden con los Docs actuales.
- Una tarea de solo lectura se completa en un repositorio de prueba sin modificar archivos.
- El uso aparece en el Dashboard o historial de cuenta del provider esperado.
Después puedes abrir un repositorio real con el menor permiso necesario. Revisa comandos y diffs propuestos antes de aumentar la autonomía.
