Instalar Codex CLI: configuración, inicio de sesión y tu primera tarea

Instala Codex CLI, verifica el ejecutable, inicia sesión y empieza con una tarea pequeña en el directorio de tu proyecto. Los instaladores oficiales cubren ahora macOS, Linux y Windows; npm y Homebrew siguen siendo alternativas. Elige una de las opciones siguientes. Una instalación funcional es el primer paso; el acceso a la cuenta y la facturación de la API son decisiones independientes.

1. Elige un método de instalación

Estos comandos proceden de la guía oficial de instalación de Codex CLI. Usa el instalador del entorno en el que ejecutarás el agente. Instalar un ejecutable de Windows no instala una copia independiente de Linux dentro de WSL, y la instalación en tu portátil no instala nada en un servidor remoto al que te conectes posteriormente.

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

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

Si ya gestionas las herramientas de desarrollo con un gestor de paquetes, utiliza su alternativa en lugar de ejecutar ambos instaladores:

La vía de npm requiere una instalación funcional de npm; comprueba primero npm --version. La vía independiente es útil si no necesitas herramientas de Node. En una máquina gestionada, utiliza el método de instalación compatible con tu administrador para que las actualizaciones posteriores sigan siendo predecibles.

2. Verifica qué ejecutable se está ejecutando

Abre un terminal nuevo después de la instalación si no se encuentra el comando. En macOS o Linux, command -v codex muestra el ejecutable seleccionado por tu shell. En PowerShell, usa Get-Command codex. Compara esa ruta con el método de instalación que elegiste antes de reinstalar. Dos copias instaladas pueden hacer que actualices una mientras sigues iniciando la otra.

codex --version
codex --help

# Open your own project directory before starting
cd /path/to/your/project
codex login
codex login status
codex --sandbox read-only "Explain this project's structure and how its tests run. Do not modify files."

Sustituye la ruta de ejemplo del proyecto por la tuya. El comando final utiliza un sandbox de solo lectura para una explicación inicial. Es una primera comprobación útil porque permite confirmar el repositorio correcto y el acceso al modelo antes de pedir al agente que realice un cambio. Si quieres consultar las opciones disponibles, utiliza la ayuda de la CLI instalada o la referencia de comandos.

3. Elige la vía de cuenta adecuada

codex login inicia el flujo de inicio de sesión de la cuenta. Comprueba la cuenta del navegador y el espacio de trabajo antes de completarlo. Para la facturación directa de la API de OpenAI, la alternativa documentada acepta una clave de Platform mediante la entrada estándar:

# After supplying OPENAI_API_KEY through your credential setup:
printenv OPENAI_API_KEY | codex login --with-api-key

Este comando de API es para una clave de OpenAI Platform. No constituye la configuración completa de una pasarela de terceros. Un proveedor personalizado necesita su propia configuración, endpoint, fuente de credenciales y modelo compatible. La documentación de autenticación explica las vías, mientras que nuestra guía de claves de API de Codex cubre la configuración más profunda del proveedor.

4. Convierte la primera respuesta en una primera tarea útil

1. Pregunta dónde se encuentran el código fuente y las pruebas relevantes, y después comprueba la respuesta en el repositorio.
2. Elige un cambio pequeño y especifica el comportamiento esperado.
3. Usa una rama limpia o un punto de control, y elige permisos adecuados para ese cambio.
4. Haz que Codex ejecute las comprobaciones relevantes y después revisa su diff y su explicación.

Por ejemplo, empieza con una prueba fallida o una pequeña corrección de documentación. Evita que la primera tarea sea reescribir una aplicación completa: la instalación, las credenciales, las dependencias locales y la calidad de la tarea serían más difíciles de evaluar simultáneamente. Cuando el ciclo corto funcione, añade las instrucciones de tu proyecto y amplía el alcance.

Si la configuración se detiene, corrige la capa correspondiente

«Command not found» apunta a la instalación o al PATH. Un 401 apunta a la autenticación. Un error de modelo apunta al proveedor y al modelo seleccionados. Una advertencia de límite apunta al uso o a la facturación. Conserva las capas que funcionan y sigue la lista de comprobación para 401 o la guía de límites de uso según corresponda; reinstalar el ejecutable no recargará una cuenta.

Para evaluar Kunavo en trabajos locales con Codex, crea una cuenta y sigue la integración de Codex. Utiliza una configuración de proveedor compatible con Responses. Verifica una tarea pequeña antes de confiar en la nueva vía de facturación para un proyecto mayor.

Preguntas frecuentes

Documentación oficial de instalación y ayuda local de la CLI comprobadas el 17 de septiembre de 2026.