OpenAI Codex CLI - agente de codificación ligero que se ejecuta en la terminal

• OpenAI Codex es un agente de codificación ligero que se ejecuta en la terminal, lo que permite a los desarrolladores aprovechar razonamiento al nivel de ChatGPT dentro del entorno de terminal, junto con ejecución de código, manipulación de archivos y control de versiones
• Codex no requiere configuración y se ejecuta de forma segura mediante red deshabilitada y sandbox de directorio
• Admite capacidades multimodales, por lo que puede implementar funciones a partir de capturas de pantalla o diagramas
• Codex es completamente de código abierto, con la ventaja de que los desarrolladores pueden contribuir directamente y hacerlo evolucionar
• Puede ejecutarse en varios sistemas operativos y es compatible con macOS, Linux y Windows WSL2

---

Introducción a OpenAI Codex

• OpenAI Codex es un agente de codificación ligero que se ejecuta en la terminal
• Los desarrolladores pueden aprovechar razonamiento al nivel de ChatGPT dentro del entorno de terminal, junto con ejecución de código, manipulación de archivos y control de versiones
• No requiere configuración y se ejecuta de forma segura mediante red deshabilitada y sandbox de directorio
• Admite capacidades multimodales, por lo que puede implementar funciones a partir de capturas de pantalla o diagramas
• Es completamente de código abierto, por lo que los desarrolladores pueden contribuir directamente y hacerlo evolucionar

Modelo de seguridad y permisos de Codex

• Codex ofrece la bandera --approval-mode para determinar el nivel de autonomía del agente
• En modo Suggest, solo puede leer archivos, y toda escritura/parcheo de archivos y los comandos de shell requieren aprobación
• En modo Auto Edit, puede leer archivos y escribir parches, y los comandos de shell requieren aprobación
• En modo Full Auto, puede leer/escribir archivos y ejecutar comandos de shell, con la red deshabilitada y limitado al directorio de trabajo actual

Detalles del sandboxing por plataforma

• En macOS 12+, envuelve los comandos usando Apple Seatbelt
• En Linux, ejecuta Codex dentro de una imagen mínima de contenedor usando Docker
• Ambos enfoques funcionan de forma transparente para el uso diario

Requisitos del sistema

• Sistema operativo: macOS 12+, Ubuntu 20.04+/Debian 10+, Windows 11 (WSL2)
• Node.js: 22 o superior (se recomienda LTS)
• Git: 2.23+ (recomendado para la función de asistente de PR)
• RAM: mínimo 4 GB (se recomiendan 8 GB)

Referencia de la CLI

• codex: ejecuta el REPL interactivo
• codex "…": prompt inicial del REPL interactivo
• codex -q "…": modo "silencioso" no interactivo
• Banderas principales: --model/-m, --approval-mode/-a, --quiet/-q

Memoria y documentación del proyecto

• Codex combina instrucciones de Markdown en el siguiente orden: ~/.codex/instructions.md, codex.md (raíz del repositorio), codex.md (directorio de trabajo actual)
• Se puede desactivar con --no-project-doc o CODEX_DISABLE_PROJECT_DOC=1

Modo no interactivo / CI

• Es posible ejecutar Codex en modo headless dentro de pipelines
• Se puede eliminar el ruido de la UI interactiva con CODEX_QUIET_MODE=1

Recetas

• codex "Refactor the Dashboard component to React Hooks": refactoriza un componente de clase y ejecuta pruebas
• codex "Generate SQL migrations for adding a users table": infiere el ORM y genera y ejecuta archivos de migración
• codex "Write unit tests for utils/date.ts": genera y ejecuta pruebas
• codex "Bulk‑rename *.jpeg → *.jpg with git mv": cambia nombres de archivos de forma segura y actualiza usos
• codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$": explica la expresión regular
• codex "Carefully review this repo, and propose 3 high impact well-scoped PRs": propone PRs de alto impacto y bien delimitados
• codex "Look for vulnerabilities and create a security review report": encuentra y explica fallas de seguridad

Instalación

• Instalación mediante npm (recomendada): npm install -g @openai/codex
• Compilar desde el código fuente: clonar el repositorio, luego ir al paquete CLI para instalar dependencias y compilar

Configuración

• Codex busca archivos de configuración en ~/.codex/
• Se pueden definir instrucciones personalizadas: ~/.codex/instructions.md

Preguntas frecuentes

• OpenAI lanzó en 2021 un modelo llamado Codex, un sistema de IA que genera código a partir de prompts en lenguaje natural
• Codex siempre se ejecuta en un sandbox; si propone comandos sospechosos o cambios de archivos, al ingresar n no afectará el árbol de trabajo
• No se ejecuta directamente en Windows; requiere Windows Subsystem for Linux (WSL2)
• Modelos compatibles: todos los modelos disponibles mediante la Responses API

Contribuciones

• Este proyecto está en desarrollo activo y es probable que el código cambie considerablemente
• Se agradecen las contribuciones, con énfasis en la confiabilidad y el mantenimiento a largo plazo
• Se proporcionan lineamientos sobre flujo de trabajo de desarrollo, cómo escribir cambios de código de alta calidad, abrir PRs, proceso de revisión, valores de la comunidad y cómo obtener ayuda

Licencia

• Este repositorio está bajo la licencia Apache-2.0

[GN⁺]

Comentarios de Hacker News

• Se intentó documentar una base de código de tamaño mediano comparando Codex o4-mini y Claude Code

  • Claude Code escribió una documentación excelente
  • Codex imaginó cosas que no estaban en el código y describió una arquitectura incorrecta
  • El problema de Codex parece ser que tiene dificultades para cargar el contexto correcto y prestar atención
  • Hay grandes expectativas para los modelos o3 y o4-mini, y se espera que den mejores resultados en otras pruebas

• Se pegó en gemini todo o parte del repositorio y se aplicaron cambios al código usando un script propio

  • Se probaron aider, copilot, continue y otros, pero cada uno tenía sus desventajas

• Claude Code es muy bueno, y ya había habido decepciones con otros agentes de programación

  • Usando Claude Code se obtuvieron resultados positivos, y el costo de $15 puede estar justificado
  • Ojalá la competencia traiga buenos resultados

• Hay demos y videos de introducción relacionados, y es una respuesta directa sobre Claude Code

  • No es de código abierto, y se menciona el tema de la DMCA
  • Pronto se publicará una entrevista sobre Claude Code, donde se abordará la importancia de los CLI de agentes de código
  • Se están buscando casos de uso de usuarios avanzados de Claude Code y OAI Codex

• Por ahora rinde peor que Claude Code, pero como es de código abierto, ojalá mejore rápido

• Codex no funciona directamente en Windows y requiere WSL2

  • Parece haber una tendencia a reducir el alcance del desarrollo nativo en Windows

• La experiencia inicial usando Codex no fue buena

  • El modelo predeterminado no funciona y hay que cambiarlo
  • Al principio falló por un error de NodeJS
  • Después de resolver los problemas iniciales, se lo está comparando con Claude Code

• Hay una forma de configurar la clave de la API de OpenAI como variable de entorno

  • Existe preocupación por la posibilidad de que otras utilidades de terceros puedan acceder a la clave de la API

• Se obtuvieron buenos resultados con Amazon Q Developer CLI, y se cree que usa claude-3.7-sonnet