La CLI de Codex de OpenAI se ha convertido rápidamente en una herramienta imprescindible para desarrolladores que buscan integrar IA directamente en sus flujos de trabajo locales. Desde su anuncio el 16 de abril de 2025 y las actualizaciones posteriores —incluida la capacidad de acceso a Internet el 3 de junio de 2025—, la Codex CLI ofrece una forma segura, centrada en la privacidad y altamente personalizable de aprovechar los potentes modelos de razonamiento de OpenAI directamente desde tu terminal. Este artículo sintetiza los últimos avances y proporciona una guía paso a paso para instalar y configurar la Codex CLI en tu máquina.
¿Qué es la Codex CLI de OpenAI?
Orígenes y anuncio
OpenAI presentó la Codex CLI junto con sus modelos más recientes, o3 y o4-mini, posicionándola como un proyecto experimental y de código abierto que lleva la asistencia de codificación impulsada por IA directamente al terminal. Anunciada el 16 de abril de 2025, esta herramienta permite que los agentes de IA lean, modifiquen y ejecuten código en tu entorno local, garantizando que el código confidencial nunca salga de tu máquina.
Características clave de Codex CLI
- Ligero y de código abierto: Diseñado para una instalación sencilla y para fomentar las contribuciones de la comunidad, el código base de Codex CLI está en GitHub, donde se anima a enviar informes de errores y pull requests.
- Comandos en lenguaje natural: Los desarrolladores pueden dar instrucciones a Codex en inglés sencillo para generar código base, refactorizar módulos existentes o incluso escribir pruebas.
- Ejecución local: Todas las operaciones ocurren en tu máquina, eliminando las preocupaciones sobre cargar código propietario en servidores externos.
- Acceso a Internet del agente: Desde el 3 de junio de 2025, Codex CLI puede acceder opcionalmente a Internet para tareas como instalar dependencias u obtener recursos externos, con controles granulares por dominio y método.
¿Cuáles son las últimas actualizaciones de arquitectura?
A principios de junio de 2025, OpenAI anunció una reescritura importante de la Codex CLI, pasando de su pila original en Node.js y TypeScript a Rust. Este cambio busca ofrecer “instalación sin dependencias”, mejorar el rendimiento y reforzar las garantías de seguridad aprovechando el diseño de seguridad de memoria de Rust. Los desarrolladores pueden esperar tiempos de inicio más rápidos, tamaños de binarios reducidos y comprobaciones de compilación más robustas, todo lo cual contribuye a una experiencia de desarrollo más fluida.
¿Por qué deberías instalar Codex CLI localmente?
¿Qué beneficios de seguridad y privacidad ofrece la instalación local?
Ejecutar modelos de IA localmente significa que tu código fuente permanece en las instalaciones. A diferencia de las soluciones exclusivamente en la nube, Codex CLI nunca comparte tus archivos a menos que lo solicites explícitamente, lo que reduce significativamente los riesgos relacionados con filtraciones de datos o accesos no autorizados.
¿Cómo mejora el rendimiento y la capacidad sin conexión la instalación local?
Al procesar comandos en tu propio hardware, Codex CLI minimiza la latencia y la dependencia de llamadas a API externas. Junto con la nueva función de acceso a Internet del agente, puedes trabajar sin conexión para la mayoría de las tareas y configurar cuándo se permite que el agente esté en línea, logrando el equilibrio adecuado entre autonomía y conectividad.
¿Cómo preparar tu entorno para la instalación?
¿Cuáles son los requisitos previos?
Antes de instalar Codex CLI, asegúrate de contar con:
- Node.js (v14 o posterior) instalado y añadido a tu
PATH. - npm (normalmente incluido con Node.js) para la gestión de paquetes.
- Una clave de API válida de OpenAI, que puedes obtener en tu panel de OpenAI en la sección de configuración de API.
¿Cómo obtener y proteger tu clave de API de OpenAI?
- Inicia sesión en el panel de OpenAI.
- Ve a API Keys y haz clic en Create new secret key.
- Copia la clave generada y guárdala en un gestor de credenciales seguro.
- Evita subirla al control de versiones; utiliza variables de entorno para el desarrollo local.
¿Cómo puedes instalar Codex CLI en diferentes sistemas operativos?
¿Cómo instalar mediante npm en macOS y Linux?
Abre tu terminal y ejecuta:
npm install -g @openai/codex
Este comando instala el ejecutable codex de forma global, haciéndolo accesible desde cualquier directorio.
¿Cómo instalar en Windows (PowerShell o Git Bash)?
- Abre PowerShell (como Administrador) o Git Bash.
- Ejecuta el mismo comando de npm:
npm install -g @openai/codex - Opcionalmente, configura Git Bash como tu shell predeterminado con:
Set-Alias sh.exe "C:\Program Files\Git\bin\bash.exe" ``` :contentReference{index=10}.
¿Cómo configurar y autenticar Codex CLI?
¿Cómo establecer variables de entorno?
Tras la instalación, configura tu clave de API exportándola en el perfil de tu shell:
export OPENAI_API_KEY="your-api-key-here"
Añade esta línea a ~/.bashrc, ~/.zshrc o ~/.profile para mantenerla de forma persistente.
¿Cómo iniciar sesión con la integración de ChatGPT?
Codex CLI admite un flujo de inicio de sesión simplificado para suscriptores de ChatGPT Plus y Pro:
codex --free
Este comando te guía para autenticarte con tu cuenta de OpenAI y canjear cualquier crédito elegible.
¿Cómo puedes verificar la instalación?
¿Cómo comprobar la versión?
Ejecuta:
codex --version
Una instalación correcta devuelve una cadena de versión (p. ej., 0.1.0), confirmando que la CLI es accesible.
¿Cómo ejecutar un comando de prueba?
Prueba un prompt sencillo para asegurarte de que todo funciona:
codex "Create a Python function to reverse a string."
Codex CLI debería mostrar el código Python correspondiente directamente en tu terminal, demostrando su funcionalidad principal.
¿Cómo mantengo la CLI actualizada?
Con npm:
npm update -g @openai/codex
Con el binario de Rust:
- Descarga la última versión desde GitHub.
- Sustituye tu binario existente por el recién descargado.
Alternativamente, si instalaste a través de un gestor de paquetes que admite actualizaciones (p. ej., Homebrew), puedes usar sus comandos de actualización.
¿Cómo ampliar y personalizar Codex CLI?
Opciones de configuración en codex.yml
Edita codex.yml para:
- Excluir directorios (p. ej.,
node_modules,vendor) - Definir plantillas de prompt predeterminadas
- Elegir modelos de respaldo o alternativas locales de código abierto (como StarCoder para uso sin conexión)
Scripting y automatización
Incorpora Codex CLI en scripts de compilación o flujos de trabajo de CI:
yaml# .github/workflows/codex.yml
jobs:
ai_lint:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run Codex Auto-Edit
run: |
codex --mode auto-edit "Optimize bundle size and tree-shake unused imports"
- name: Run Tests
run: npm test
Esto permite una mejora continua del código impulsada por IA junto con los linters estándar.
¿Cuáles son las mejores prácticas y consejos para usar Codex CLI?
¿Cómo deberías gestionar el acceso a Internet para los agentes?
De forma predeterminada, el acceso a Internet está deshabilitado. Para conceder acceso a tareas específicas, usa:
codex --allow-internet
Luego especifica los dominios o métodos HTTP en los que confías. Esto garantiza que Codex solo salga a la red cuando lo permitas explícitamente, preservando la seguridad y la auditabilidad.
¿Cómo contribuir y reportar problemas?
Como proyecto experimental, la retroalimentación de la comunidad es vital. Para contribuir:
- Haz un fork del repositorio de GitHub y envía pull requests.
- Crea issues para errores o solicitudes de funcionalidades, describiendo claramente los pasos para reproducirlos.
- Participa en las discusiones con los mantenedores para ayudar a definir las futuras direcciones.
Siguiendo los pasos descritos, puedes integrar sin problemas la Codex CLI de OpenAI en tu flujo de trabajo de desarrollo local, beneficiándote de los últimos avances en IA mientras mantienes el control total sobre tu código y entorno. A medida que el proyecto evolucione, mantente atento al registro de cambios oficial y a los foros de la comunidad para conocer las novedades, y no dudes en compartir tus experiencias y mejoras con la comunidad de desarrolladores.
Primeros pasos
CometAPI proporciona una interfaz REST unificada que agrega cientos de modelos de IA bajo un endpoint coherente, con gestión integrada de claves de API, cuotas de uso y paneles de facturación. En lugar de lidiar con múltiples URL de proveedores y credenciales.
Los desarrolladores pueden acceder a la API de ChatGPT, como la GPT-4.1 API, Plazo para la publicación del artículo, a través de CometAPI. Para comenzar, explora las capacidades del modelo en el Playground y consulta la [API guide] para obtener instrucciones detalladas. Antes de acceder, asegúrate de haber iniciado sesión en CometAPI y de haber obtenido la clave de API. CometAPI ofrece un precio muy inferior al oficial para ayudarte a integrar.
Véase también Claude Code vs OpenAI Codex: Which is Better