Blog

OpenAI Codex CLI: un Agente de Programación de Código Abierto en la Terminal

Daniel Costa

Daniel Costa

14 July 2025

OpenAI Codex CLI: un Agente de Programación de Código Abierto en la Terminal

La interfaz de línea de comandos (CLI) sigue siendo el dominio indiscutido de muchos desarrolladores: un lugar de eficiencia, poder y profunda integración en el ciclo de vida del desarrollo. Ahora, imagina aumentar ese entorno con un agente inteligente capaz de comprender tu código, editar archivos, ejecutar comandos e iterar sobre soluciones, todo sin salir de la comodidad de tu terminal. Esta es la promesa del OpenAI Codex CLI, un agente de codificación ligero disponible a través de npm (@openai/codex), diseñado específicamente para desarrolladores que viven en la terminal.

No es solo otro chatbot. El Codex CLI tiene como objetivo proporcionar razonamiento al nivel de ChatGPT combinado con la capacidad práctica de ejecutar tareas directamente dentro de tu repositorio local. Interactúa con tus archivos, ejecuta comandos de shell (¡de manera segura!) e integra perfectamente con el control de versiones, convirtiéndose en un verdadero compañero en el desarrollo impulsado por chat que comprende el contexto de tu repositorio.

💡
¿Quieres una gran herramienta de pruebas de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada, todo en uno, para que tu equipo de desarrolladores trabaje juntos con máxima productividad?

Apidog satisface todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
button

Comenzando con OpenAI Codex CLI:

Comenzar con el Codex CLI está diseñado para ser sencillo, reflejando su filosofía de "cero configuración" (más allá de proporcionar tu clave API).

Para ejecutar Codex CLI, tu sistema debe cumplir con estos requisitos:

GitHub - openai/codex: Lightweight coding agent that runs in your terminal
Lightweight coding agent that runs in your terminal - openai/codex
GitHubopenai

Instalación: Como herramienta de Node.js, la instalación se maneja a través de npm (o yarn). Instálala globalmente para hacer disponible el comando codex en cualquier lugar de tu terminal:

npm install -g @openai/codex

(Recuerda el consejo estándar: evita sudo npm install -g; configura correctamente los permisos de npm si es necesario).

Configuración de la clave API: Codex CLI requiere tu clave API de OpenAI para funcionar. Necesitas establecer esto como una variable de entorno:

export OPENAI_API_KEY="tu-clave-api-aquí"

Crucialmente, recuerda que este comando export normalmente solo establece la variable para tu sesión actual de terminal. Para hacerlo permanente, debes agregar esta línea al archivo de configuración de tu shell, como ~/.zshrc, ~/.bashrc o ~/.bash_profile, dependiendo de tu shell.

Ejecutando Codex: Puedes interactuar con Codex de varias maneras:

Modo Interactivo: Simplemente escribe codex para iniciar una sesión interactiva (REPL - Read-Eval-Print Loop) donde puedes emitir comandos e instrucciones.

Solicitud Directa: Proporciona una solicitud inicial directamente desde la línea de comandos:

codex "explícame esta base de código"

Ejecutación Automatizada: Combina una solicitud con un modo de aprobación (más sobre esto más adelante) para tareas más automatizadas:

codex --approval-mode full-auto "crea la aplicación de lista de tareas más elegante"

Una vez invocado, Codex comienza a trabajar. Puede crear archivos, ejecutar código dentro de un entorno aislado, instalar cualquier dependencia necesaria que identifique y presentar los resultados. Luego revisas los cambios propuestos (diferencias de archivos, salidas de comandos) y los apruebas para que se comprometan a tu directorio de trabajo.

¿Por qué elegir OpenAI Codex CLI?

El Codex CLI crea un nicho específico para desarrolladores que buscan asistencia de IA profundamente integrada en sus flujos de trabajo existentes. Sus principales puntos de venta, derivados directamente de su filosofía de diseño, incluyen:

Tres Modos de OpenAI Codex CLI, Explicados:

Conceder a una herramienta de IA el poder de editar archivos y ejecutar comandos de shell requiere un modelo de seguridad robusto. Codex CLI aborda esto con transparencia y control del usuario a través de la bandera --approval-mode (ajustable a través de la línea de comandos o un aviso interactivo durante la incorporación):

Modo Sugerir (Predeterminado):

Modo Edición Automática:

Modo Full Auto:

Precauciones Incorporadas:

Aislamiento Específico de la Plataforma:

El mecanismo de endurecimiento subyacente se adapta al sistema operativo anfitrión, con el objetivo de lograr transparencia en el uso:

Configuraciones de OpenAI Codex CLI

Más allá de la interacción básica, Codex CLI ofrece formas de ajustar su comportamiento e integrarlo en flujos de trabajo más complejos.

Referencia de CLI:

Memoria & Contexto del Proyecto:

Codex CLI puede incorporar instrucciones y contexto específicos del proyecto desde archivos Markdown, superponiéndolos en un orden específico de precedencia:

  1. ~/.codex/instructions.md: Orientación personal y global aplicada a todos los proyectos.
  2. codex.md (en la raíz del repositorio): Notas compartidas del proyecto, convenciones o contexto general para todo el repositorio.
  3. codex.md (en el directorio de trabajo actual): Instrucciones específicas para subpaquetes o directorios.

Esto permite a los equipos incorporar estándares de proyecto o proporcionar pistas directamente dentro de la base de código para que Codex las use. Esta función se puede desactivar utilizando la bandera --no-project-doc o configurando la variable de entorno CODEX_DISABLE_PROJECT_DOC=1.

Modo No Interactivo / CI:

Diseñado para la automatización, Codex CLI puede ejecutarse sin cabeza en tuberías de Integración Continua (CI). Al usar la bandera --quiet (o -q) o configurar la variable de entorno CODEX_QUIET_MODE=1, se suprimen los elementos de UI interactivos.

Ejemplo de paso de GitHub Action:

- name: Actualizar changelog a través de Codex
  run: |
    npm install -g @openai/codex
    export OPENAI_API_KEY="${{ secrets.OPENAI_KEY }}"
    codex -a auto-edit --quiet "actualizar CHANGELOG para la próxima versión basado en los commits recientes"

Archivos de Configuración:

Codex busca configuración en el directorio ~/.codex/:

~/.codex/config.yaml: Define valores predeterminados como el modelo preferido o el comportamiento ante errores en modo full-auto.

model: o4-mini # Modelo predeterminado para invocaciones
fullAutoErrorMode: ask-user # Comportamiento ante error: ask-user o ignore-and-continue

~/.codex/instructions.md: Como se mencionó anteriormente, para instrucciones personalizadas globales (por ejemplo, "Siempre responde con emojis", "Solo usa comandos de git si menciono explícitamente que deberías").

Aplicaciones Prácticas: Recetas para el Éxito

El README proporciona varios ejemplos concretos ("recetas") que demuestran los tipos de tareas para las que Codex CLI es adecuado:

  1. Refactorización de Código: codex "Refactoriza el componente Dashboard a React Hooks" - Codex analiza el componente de clase, intenta la reescritura, potencialmente ejecuta pruebas (npm test) y muestra la diferencia para aprobación.
  2. Generación de Migraciones: codex "Genera migraciones SQL para agregar una tabla de usuarios" - Puede inferir el ORM que se está utilizando (por ejemplo, Prisma, Sequelize), crear los archivos de migración necesarios y potencialmente ejecutarlos en un entorno de base de datos aislado.
  3. Escritura de Pruebas Unitarias: codex "Escribe pruebas unitarias para utils/date.ts" - Codex genera casos de prueba, los ejecuta (probablemente a través de comandos de shell como npm test o jest) y potencialmente itera, corrigiendo el código o las pruebas hasta que pasen.
  4. Operaciones Masivas en Archivos: codex "Renombrar masivamente *.jpeg → *.jpg con git mv" - Formula y ejecuta los comandos necesarios git mv, potencialmente actualizando referencias/importaciones en el código también.
  5. Explicación de Código/Regex: codex "Explica qué hace esta expresión regular: ^(?=.*[A-Z]).{8,}$" - Aprovecha el poder explicativo del LLM para proporcionar un desglose legible por humanos.
  6. Análisis de Repositorio de Alto Nivel: codex "Revisa detenidamente este repositorio y propone 3 PRs de alto impacto bien definidos" - Demuestra el potencial para revisión de código estratégica y generación de sugerencias.
  7. Auditorías de Seguridad: codex "Busca vulnerabilidades y crea un informe de revisión de seguridad" - Usa la base de conocimientos de la IA para identificar posibles fallos de seguridad y explicarlos.

Conclusión

Al ser de código abierto y estar construido para el desarrollador centrado en la CLI, Codex CLI tiene como objetivo convertirse en un agente de codificación indispensable y de confianza, mejorando la productividad y permitiendo a los desarrolladores centrarse en desafíos más complejos, directamente desde su línea de comandos. A medida que continúa en desarrollo activo, tiene el potencial de transformar significativamente la forma en que los desarrolladores interactúan con la IA en sus flujos de trabajo diarios.

💡
¿Quieres una gran herramienta de pruebas de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada, todo en uno, para que tu equipo de desarrolladores trabaje juntos con máxima productividad?

Apidog satisface todas tus demandas y reemplaza a Postman a un precio mucho más asequible!
button

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs

Registrarse gratisDescargar