OpenAI Codex CLI: Guía completa de programación en terminal impulsada por IA
Puede ejecutar comandos, leer registros y rastrear código
Soluciones rápidas de sintaxis
1. Define tu caso de uso: ¿Estás principalmente generando nuevo código, revisando código existente, depurando problemas o aprendiendo nuevas tecnologías? Diferentes herramientas sobresalen en diferentes áreas.
Linter / Formateador IDE
Instalación
Retroalimentación instantánea sin sobrecarga de IA
npm install -g @openai/codexDespués de la instalación, verifica que Codex CLI esté correctamente instalado comprobando la versión:
codex --version
# Output: @openai/codex/1.2.0 darwin-arm64 node-v20.11.0Si no quieres instalarlo globalmente, también puedes ejecutar Codex CLI directamente a través de npx, que descargará y ejecutará la última versión sin instalación persistente:
npx @openai/codex "Explain the architecture of this project"3. Evalúa las necesidades de privacidad: Si trabajas con código propietario, prioriza herramientas con políticas de privacidad de datos claras y opciones de implementación local.
Explorar herramientas AI
- Codex CLI entiende el contexto del proyecto a través de múltiples archivos. Cuando solicitas una función que abarca varios módulos — por ejemplo, agregar autenticación a una aplicación web — crea o modifica todos los archivos relevantes en una operación coherente. Esto incluye crear nuevos componentes, actualizar la configuración de enrutamiento, agregar endpoints API y modificar modelos de datos según sea necesario. La herramienta mantiene la consistencia entre archivos, asegurando que los imports sean correctos, las firmas de funciones coincidan y las convenciones de nomenclatura se mantengan uniformes en toda la base de código.
- Comando de autenticación interactiva: Ejecuta codex auth para introducir tu clave de forma interactiva. Codex CLI la almacenará de forma segura en el directorio de configuración.
- ¿Entrando en una base de código desconocida? Codex CLI puede explicar qué hace cualquier bloque de código, rastrear cómo fluyen los datos a través de tu sistema e identificar problemas potenciales. Puedes señalar archivos o funciones específicas:
4. Comienza con una herramienta: Domina una herramienta de IA antes de agregar otras. Comienza con un asistente de código, luego agrega herramientas especializadas según sea necesario.
Consejo profesional: Usa Claude Code en combinación con tu cadena de herramientas existente para máxima eficiencia. Usa Claude Code para el trabajo pesado — implementación de funciones, refactorización y depuración — mientras confías en tu IDE para ediciones rápidas y en GitHub Copilot para completados en línea. Las herramientas son complementarias, no competitivas.
{
"model": "gpt-4o",
"max_tokens": 4096,
"temperature": 0.7,
"max_files": 10,
"confirm_before_write": true,
"context_size": 128000
}Introducción a Codex CLI
5. Prueba antes de comprometerte: La mayoría de las herramientas ofrecen pruebas gratuitas o niveles gratuitos. Experimenta con diferentes opciones para encontrar la que mejor se adapte a tu stack tecnológico y estilo de codificación.
Mejores prácticas de Codex CLI
cd my-project
codexConfigurar la clave API de OpenAI
You: Summarize the structure of this project
Codex: This project appears to be a React application built with Vite.
It has the following structure:
- src/ Main application source code
- src/components/ Reusable UI components
- src/pages/ Page-level components
- public/ Static assets
- package.json Project dependencies and scripts
Key dependencies include React 18, React Router, and Axios for API calls.Configuración inicial
Claude Code se integra en la mayoría de los flujos de trabajo de desarrollo modernos. Puedes usarlo junto con editores de código, sistemas CI/CD y plataformas de gestión de proyectos.
Primeros comandos y flujo de trabajo
Explorar herramientas AI
Lenguaje natural a código
codex "Create a Python script that fetches weather data from OpenWeatherMap API, caches results in SQLite, and exposes a simple CLI interface with --city and --forecast flags"Generación de código multi-archivo
Consejo profesional: El mejor stack de herramientas de IA no es el que tiene más herramientas, sino el que usas de manera consistente. Comienza con una herramienta, intégrala profundamente en tu flujo de trabajo y solo agrega otras cuando tengas una necesidad clara.
Explicación y revisión de código
Mantén Claude Code abierto en una ventana de terminal junto a tu editor. Trátalo como un compañero de programación en pareja siempre disponible.
Pruebas automatizadas
codex "Explain the authentication middleware in src/middleware/auth.ts. What flow does a request follow, and what edge cases are handled?"Integración con flujo de trabajo Git
Ejecuta /init una vez por proyecto y mantén tu CLAUDE.md a medida que el proyecto evoluciona.
Asistencia con comandos Shell
codex "Write unit tests for src/utils/validator.ts using Vitest. Cover all functions, edge cases for empty input, invalid types, and boundary values. Aim for 100% coverage."Modo interactivo vs. modo único
Delega tareas repetitivas a Claude Code, como escribir código boilerplate, generar pruebas y actualizar documentación.
Paso de contexto de archivos
codex "Generate a detailed commit message for my staged changes"
codex "Create a PR description summarizing the changes in this branch compared to main"Selección de modelo
Usa Claude Code para exploración de código — pídele que explique cómo funciona un módulo específico o que rastree flujos de datos complejos.
Gestión de sesiones
codex "Write a command to list the 10 largest files in my project, excluding node_modules and .git"Si bien Claude Code se ejecuta en la terminal, puedes usarlo junto con cualquier editor de código. Muchos desarrolladores mantienen abierta una ventana de terminal con Claude Code mientras editan código en VS Code, vim o WebStorm. Este enfoque te permite obtener asistencia de IA sin cambiar de tu editor principal.
Similitudes
Revisa tus diffs antes de commitear — Claude Code genera mensajes de commit, pero siempre debes revisar los cambios.
Diferencias clave
Cuándo usar cada herramienta
Usa /compact para iterar — para tareas de larga duración, usa /compact para mantener el contexto manejable sin perder el hilo.
Escribir prompts efectivos
codex --file src/api/users.ts --file src/types/user.ts "Add a new endpoint for updating user roles"Gestionar la ventana de contexto
Comando
Consideraciones de seguridad
| Modelo | Mejor uso | Para revisiones de código, puedes pedirle a Codex que examine un diff o un conjunto de archivos modificados y proporcione retroalimentación sobre la calidad del código, posibles bugs, problemas de rendimiento y adherencia a las mejores prácticas. Esto lo convierte en una excelente herramienta para la auto-revisión antes de enviar un pull request. | Escribir pruebas a menudo es tedioso, pero Codex CLI puede generar suites de pruebas completas a partir del código existente. Analiza tus funciones, identifica casos límite y genera pruebas unitarias, de integración o end-to-end según lo solicites: |
|---|---|---|---|
| gpt-4o | Codex también entiende el mocking — puede examinar tus dependencias y generar mocks apropiados para servicios externos, llamadas a bases de datos y operaciones del sistema de archivos, produciendo pruebas que realmente se ejecutan sin necesidad de una configuración completa del entorno. | 128K tokens | Medio |
| gpt-4o-mini | Codex CLI se integra naturalmente con los flujos de trabajo de Git. Puede generar mensajes de commit significativos basados en tus cambios preparados, crear descripciones de pull request que resuman tu trabajo e incluso ayudar a resolver conflictos de fusión entendiendo la intención detrás de los cambios en conflicto: | 128K tokens | Bajo |
| o3-mini | Para operaciones Git más avanzadas, puedes pedirle a Codex que explique historiales Git complejos, sugiera estrategias de ramificación o genere changelogs a partir del historial de commits — todo dentro de tu terminal. | 200K tokens | findgrepawkjq, explicando cada parte para que aprendas mientras lo usas: |
| o4-mini | Comprender los modos y opciones de Codex CLI desbloquea todo su potencial. Aquí están los comandos y patrones de flujo de trabajo esenciales que usarás a diario. | 200K tokens | Medio |
Verificación de código después de la generación AI
Tipo de tarea
Prototipado rápido
codex sessions
# ID Started Model Messages
# abc123 2026-05-25 14:30 gpt-4o 12
# def456 2026-05-25 09:15 gpt-4o 8
codex --session abc123Codex CLI vs Claude Code: Comparación detallada
Convertir código entre lenguajes de programación
Mejor herramienta
Escribir código boilerplate
Analiza tu proyecto y genera un archivo CLAUDE.md con instrucciones del proyecto, convenciones y contexto que Claude Code referenciará en futuras sesiones.
| Para entornos de equipo, considera usar un gestor de secretos o la configuración de variables de entorno de la plataforma CI/CD para inyectar de forma segura la clave API sin codificarla en el código. | Codex CLI | Claude Code |
|---|---|---|
modo interactivocodex sin argumentos) inicia una sesión persistente donde puedes tener múltiples rondas de conversación, refinando iterativamente tus solicitudes. La IA mantiene el contexto a lo largo de la sesión, por lo que cada intercambio posterior se construye sobre los anteriores. Esto es ideal para tareas complejas de múltiples pasos donde deseas guiar a la IA a través de mejoras incrementales. | OpenAI GPT-4o, o3/o4-mini | Anthropic Claude 3.5/4 Sonnet, Opus |
modo únicocodex "tu prompt") ejecuta un solo prompt y devuelve los resultados inmediatamente. Esto es perfecto para tareas rápidas — generar un script, explicar una función o crear un archivo de configuración — donde no necesitas una conversación continua. El modo único también es excelente para scripting y automatización, donde puedes canalizar la salida de Codex CLI a otras herramientas. | --file-f) para incluir archivos específicos: | --dir, o usar patrones glob para incluir múltiples archivos que coincidan con un patrón. Este paso de contexto dirigido es crucial para proyectos grandes donde incluir cada archivo excedería la ventana de contexto del modelo. |
gpt-4o--model para cambiar de modelo: | gpt-4o-minigpt-4o y los modelos de razonamiento para decisiones arquitectónicas complejas, sesiones de depuración difíciles o cuando necesites la salida de mayor calidad para código crítico de producción. | codex sessionscodex --session <id>codex sessions clear para limpiar sesiones antiguas. Las sesiones persisten a través de reinicios de terminal, por lo que puedes retomar exactamente donde lo dejaste: |
| Con múltiples herramientas de programación AI ahora disponibles en la terminal, elegir entre ellas puede ser un desafío. Aquí hay una comparación honesta entre Codex CLI y Claude Code para ayudarte a decidir qué herramienta se adapta a tu flujo de trabajo. | Ambas herramientas se ejecutan en la terminal como compañeros de programación AI. Pueden leer tu base de código, entender el contexto a través de múltiples archivos y generar o modificar código basado en prompts de lenguaje natural. Ambas soportan sesiones interactivas y comandos únicos, se integran con flujos de trabajo Git y te permiten elegir entre diferentes niveles de modelo. También comparten capacidades centrales como explicación de código, refactorización, generación de pruebas y asistencia con comandos de shell. | Elige Codex CLI cuando: Necesites generación rápida de código, estés trabajando en proyectos completamente nuevos donde la velocidad importa, quieras generar rápidamente código boilerplate o scaffolding, necesites operaciones batch multi-archivo eficientes, o ya estés usando otras herramientas de OpenAI y tengas créditos API disponibles. La velocidad de generación de Codex CLI lo hace particularmente adecuado para prototipado e iteración rápida. |
| Elige Claude Code cuando: Estés haciendo revisión y análisis de código profundo, necesites orientación arquitectónica cuidadosa, estés trabajando en sistemas críticos de seguridad donde la minuciosidad importa más que la velocidad, o prefieras el enfoque de Anthropic en seguridad y alineación de IA. La fortaleza de Claude Code en razonamiento y análisis cuidadoso lo hace excelente para entender bases de código heredadas complejas. | Muchos desarrolladores encuentran valioso usar ambas herramientas. Un patrón común es usar Codex CLI para generación inicial e iteración rápida, luego cambiar a Claude Code para revisión final y pulido antes de mergear. Las herramientas son complementarias en lugar de competitivas, y usarlas juntas puede producir mejores resultados que depender de cualquiera por sí sola. | Aprovechar al máximo Codex CLI va más allá de conocer los comandos. Estas mejores prácticas te ayudarán a producir resultados de mayor calidad, gestionar costos y evitar trampas comunes. |
| Para revisiones de código, puedes pedirle a Codex que examine un diff o un conjunto de archivos modificados y proporcione retroalimentación sobre la calidad del código, posibles bugs, problemas de rendimiento y adherencia a las mejores prácticas. Esto lo convierte en una excelente herramienta para la auto-revisión antes de enviar un pull request. | específicosricos en contextoconscientes de las restricciones. En lugar de decir "agrega autenticación a mi aplicación", prueba algo como: | específicosricos en contextoconscientes de las restricciones. En lugar de decir "agrega autenticación a mi aplicación", prueba algo como: |
| Modelo de precios | Cuanto más contexto y requisitos específicos proporciones, más precisa y útil será la salida. Menciona patrones, bibliotecas y convenciones existentes en tu proyecto dentro del prompt para ayudar a Codex CLI a generar código que se integre perfectamente. | --file para incluir solo archivos relevantes para la tarea actual. Inicia nuevas sesiones para tareas no relacionadas para mantener el contexto enfocado. Si notas que la IA está perdiendo el hilo de instrucciones anteriores, es una señal de que la ventana de contexto se está congestionando — divide la tarea en partes más pequeñas o inicia una nueva sesión con un prompt más compacto. |
| El código generado por IA nunca debe confiarse ciegamente, particularmente cuando se trata de operaciones sensibles a la seguridad. Siempre revisa el código generado en busca de posibles vulnerabilidades antes de ejecutarlo en producción. Los problemas comunes incluyen riesgos de inyección SQL en consultas generadas, credenciales o claves API codificadas, validación de entrada insuficiente, manejo inadecuado de datos de usuario y versiones de dependencias obsoletas o vulnerables. Trata el código generado por IA con el mismo escrutinio que aplicarías al código escrito por un desarrollador junior — revísalo minuciosamente antes de mergear. | Sí | Sí |
Restablece el historial de conversación, limpiando todo el contexto anterior. Útil al cambiar a una tarea completamente diferente.
Aprender nuevas APIs y frameworks
¿Qué es OpenAI Codex CLI?
¿En qué se diferencia Codex CLI de Claude Code?
2. Considera tu flujo de trabajo: ¿Prefieres herramientas de terminal, integraciones IDE o interfaces web? Elige herramientas que se ajusten a cómo trabajas realmente.
¿Es Codex CLI gratuito?
Comprime el contexto de la conversación para liberar espacio cuando se acerca al límite de tokens, preservando la información más importante mientras descarta detalles menos relevantes.
¿Qué lenguajes de programación soporta Codex CLI?
codex "Add JWT-based authentication to the Express API in src/server.ts. Requirements:
- Use bcrypt for password hashing
- Create a POST /auth/login endpoint that returns access and refresh tokens
- Add an auth middleware that validates tokens on protected routes
- Store refresh tokens in the existing PostgreSQL database
- Follow the existing error handling pattern from src/middleware/errorHandler.ts
- Write tests using the existing Vitest setup"La línea de comandos siempre ha sido el santuario del desarrollador — un lugar de productividad pura, control preciso y flujo de trabajo sin distracciones. Pero, ¿y si tu terminal pudiera entender lenguaje natural, generar bases de código completas e incluso depurar errores antes de que los notes? OpenAI Codex CLI cierra la brecha entre la intención humana y la ejecución de la máquina, llevando el poder completo de los modelos GPT-4o de OpenAI directamente a tu terminal. Esta guía cubre todo, desde la instalación hasta flujos de trabajo avanzados, ayudándote a dominar Codex CLI y transformar cómo escribes software.
Muestra todos los comandos disponibles y sus descripciones.
OpenAI Codex CLI es una herramienta de línea de comandos ligera y de código abierto que conecta tu terminal con la API de OpenAI. Te permite describir lo que quieres en inglés simple — "crea un endpoint FastAPI con autenticación JWT", "refactoriza este módulo para usar async/await" o "explica por qué esta consulta SQL es lenta" — y Codex CLI genera código listo para producción, modifica archivos existentes y explica lógica compleja en segundos. Ya sea que estés prototipando una nueva función, traduciendo código entre lenguajes o poniéndote al día con una base de código desconocida, Codex CLI es un compañero de programación AI siempre disponible, justo donde ya trabajas.
Muestra los costos estimados de API para la sesión actual.
Configurar Codex CLI toma menos de cinco minutos. Necesitas Node.js 18 o superior instalado en tu sistema, una clave API de OpenAI con créditos disponibles y un entorno de terminal. El proceso de instalación es sencillo y la herramienta incluye comandos incorporados para ayudarte a configurar todo correctamente desde la primera ejecución.
codex esté disponible globalmente en tu sistema. Este método funciona en macOS, Linux y Windows con WSL:
Completado de código en línea
panel de la plataforma OpenAI. Hay tres formas de configurar la clave:
/initCLAUDE.md integral se amortizan en cada interacción posterior. Trata este archivo como documentación viva — actualízalo cuando tu stack tecnológico cambie o cuando descubras nuevos patrones que quieres que Claude Code siga.
~/.codex/config.json. La primera vez que ejecutes la herramienta, crea una configuración predeterminada sensata que puedes personalizar. Las configuraciones clave incluyen tu modelo predeterminado preferido, el tamaño de la ventana de contexto y el número máximo de archivos que Codex puede modificar en una sola operación:
GitHub Copilot / Autocompletado IDE
confirm_before_write es particularmente valiosa — cuando está habilitada, Codex CLI muestra cada cambio de archivo propuesto y solicita confirmación antes de modificar cualquier cosa en el disco. Esto te da control total sobre lo que se modifica y previene sobrescrituras accidentales.
codex "Create a real-time collaborative whiteboard app using Next.js, Socket.io, and Canvas API. Users should be able to create rooms, share a link, and draw together in real time. Include a color picker and brush size controls."Más rápido para completados de una sola línea en el editor
Recorramos una primera sesión típica con Codex CLI. Primero, navega a cualquier directorio de proyecto y ejecuta la sesión interactiva:
codex --file src/utils/data_processor.py "Convert this Python module to idiomatic Rust. Use serde for serialization, anyhow for error handling, and maintain the same test coverage."Implementación de funciones multi-archivo
Esto inicia Codex CLI en modo interactivo, donde puedes mantener una conversación continua con la IA. Tu primer prompt podría ser simple:
Asistentes de código AI
Codex CLI lee automáticamente los archivos de tu proyecto para proporcionar respuestas contextualmente relevantes. Puedes pedirle que cree nuevos archivos, modifique archivos existentes o explique partes específicas del código — todo dentro de la misma sesión de terminal.
codex "I'm getting this error in my Next.js app: 'Hydration failed because the initial UI does not match what was rendered on the server.' Here's the component code..." [paste code]Codex CLI es mucho más que un chatbot en la terminal. Su conjunto de características está diseñado en torno a flujos de trabajo de desarrollo reales, permitiéndote hacer un trabajo significativo sin cambiar de contexto.
El enfoque agéntico maneja cambios entre archivos de manera eficiente
La capacidad más fundamental de Codex CLI es convertir descripciones simples en inglés en código funcional. Describes lo que necesitas y Codex maneja los detalles de implementación — eligiendo bibliotecas apropiadas, siguiendo las mejores prácticas y escribiendo código idiomático para el lenguaje objetivo:
codex "Show me how to implement file uploads with progress tracking in a FastAPI application. Explain the multipart form handling, streaming approach, and best practices for saving files securely."Codex CLI genera un script completo y bien estructurado a partir de un solo prompt en lenguaje natural, con manejo de errores apropiado, lógica de solicitud API, operaciones de base de datos y análisis de argumentos. El código generado sigue las convenciones de Python, incluye type hints donde corresponde y maneja casos límite como fallos de red y claves API faltantes.
Además, sé consciente de qué código compartes con Codex CLI. Si tu base de código contiene algoritmos propietarios, claves API o lógica de negocio sensible, considera si esos datos deberían enviarse a los servidores de OpenAI. Revisa las políticas de uso de datos de OpenAI y considera usar claves API dedicadas con restricciones apropiadas.Preguntas frecuentes
Refactorización a gran escala
OpenAI Codex CLI is a command-line tool that brings OpenAI's powerful language models directly into your terminal. It allows developers to generate code, refactor existing files, debug errors, explain complex codebases, and manage development workflows using natural language prompts, all without leaving the command line. It is open-source and can be installed via npm.
¿Cómo instalar Codex CLI?
npm install -g @openai/codexcodex authOPENAI_API_KEYcodex --version. Node.js
18 or later is required.
Comprende el impacto de los cambios en todo el proyecto
Codex CLI is powered by OpenAI's models (GPT-4o, o3-mini, o4-mini) while Claude Code uses Anthropic's Claude models. Codex CLI excels at rapid code generation and efficient multi-file operations, making it ideal for prototyping and quick iterations. Claude Code is particularly strong at deep code review, nuanced architectural analysis, and careful reasoning. Both are excellent tools, and many developers use them together — Codex for generation, Claude for review — to get the best of both worlds.
Puede ejecutar pruebas e iterar automáticamente en fallos
Codex CLI itself is free and open-source, but you need an OpenAI API key to use it, which means you pay for API usage based on the model you select. API costs vary by model — GPT-4o is more expensive per token than GPT-4o-mini, and the reasoning models (o3-mini, o4-mini) have their own pricing tiers. You can set spending limits in your OpenAI account dashboard to control costs, and using GPT-4o-mini for routine tasks keeps expenses low.
Depuración de problemas complejos
Codex CLI supports all major programming languages including JavaScript, TypeScript, Python, Go, Rust, Java, C++, C#, Ruby, PHP, Swift, Kotlin, SQL, Shell scripting (Bash, Zsh), HTML, CSS, and many more. The underlying OpenAI models are trained on vast repositories of open-source code across dozens of languages. Codex also understands framework-specific patterns — it can generate idiomatic code for React, Next.js, Django, FastAPI, Express, Rails, Spring Boot, and other popular frameworks.