OpenAI Codex: qué es, cómo funciona y cómo usarlo para programar
Codex es el agente de programación de OpenAI. Puede explorar repositorios, modificar múltiples archivos, ejecutar comandos, escribir tests, revisar código, trabajar con Git, utilizar herramientas externas y completar tareas de ingeniería desde ChatGPT, la terminal, el editor y entornos cloud. Además, incorpora workflows multiagente, Skills, AGENTS.md, MCP, Plugins, Hooks, worktrees, Automations y sandboxing.
¿Qué es OpenAI Codex?
Codex es un agente de inteligencia artificial especializado en desarrollo de software. A diferencia de un chatbot que solamente genera fragmentos de código, Codex puede trabajar directamente sobre un proyecto: leer archivos, comprender su arquitectura, modificar código, ejecutar comandos, correr tests, utilizar Git, revisar cambios y completar tareas de programación de principio a fin. Puedes utilizarlo mediante tu cuenta de ChatGPT o, en determinados workflows locales, mediante una API key de OpenAI.
Qué puede hacer Codex
Programar
Crear features, modificar código y trabajar en múltiples archivos.
Debugging
Investigar errores, seguir flujos y corregir causas raíz.
Testing
Ejecutar tests, linters, builds y validaciones.
Git
Revisar diffs, trabajar con ramas, commits y pull requests.
Multi-agent
Ejecutar distintos agentes y tareas en paralelo.
Automatizar
Programar tareas repetitivas y workflows de ingeniería.
Codex no solo responde: puede ejecutar un ciclo completo de desarrollo
Explora
Lee archivos, busca referencias y entiende el repositorio.
Planifica
Decide qué cambios necesita realizar.
Implementa
Modifica archivos y ejecuta herramientas.
Verifica
Ejecuta tests, inspecciona resultados y corrige errores.
Codex no es lo mismo que OpenAI API
Ambos pertenecen al ecosistema OpenAI, pero resuelven problemas distintos.
| OpenAI API | Codex |
|---|---|
| Plataforma para desarrolladores | Agente listo para programar |
| Tú construyes la integración | Codex trabaja directamente sobre el proyecto |
| Responses API | CLI, IDE, Desktop y cloud |
| API keys | ChatGPT o API key según workflow |
| Construyes apps con IA | Construyes software usando un agente |
Si creas una aplicación PHP que llama a los modelos de OpenAI, estás utilizando OpenAI API. Si abres ese mismo proyecto y le pides al agente que encuentre un bug, modifique archivos y ejecute tests, estás utilizando Codex.
Ver guía de OpenAI API →Dónde se puede usar Codex
Codex comparte el mismo agente a través de varias interfaces.
Codex en ChatGPT
Gestiona tareas de programación desde la experiencia de ChatGPT.
Aplicación de escritorio
Trabaja con proyectos locales, agentes, terminal y diffs.
Codex CLI
Ejecuta el agente directamente desde tu shell.
Extensión IDE
Trabaja junto al código en VS Code y editores compatibles.
Entornos remotos
Delega tareas largas en entornos cloud aislados.
GitHub Actions
Ejecuta Codex desde workflows automatizados.
Usar Codex desde la terminal
La CLI es una de las formas más directas de trabajar con el agente.
npm install -g @openai/codexcd mi-proyecto
codex
OpenAI publica
el agente CLI
y parte
de su infraestructura
en el repositorio
oficial
openai/codex.
Cuenta de ChatGPT o API key
Inicia sesión con tu cuenta
El uso se contabiliza según el plan y límites de ChatGPT.
codex loginUsa una OpenAI API key
El consumo se factura mediante tu cuenta de la plataforma API.
printenv OPENAI_API_KEY | codex login --with-api-keyIniciar sesión con ChatGPT utiliza la asignación disponible de tu plan. Si utilizas tu propia API key, se aplican las tarifas de OpenAI API.
Empieza pidiendo que entienda el repositorio
Analiza este repositorio.
No modifiques nada todavía.
Identifica:
- propósito
- arquitectura
- punto de entrada
- módulos principales
- dependencias
- tests
- build
- configuración
- riesgos importantes
Después explícame
cómo funciona el proyecto
como si me incorporara hoy
al equipo.Cómo trabaja Codex dentro de un proyecto
Recibe el objetivo
Le indicas qué quieres conseguir.
Obtiene contexto
Busca archivos, instrucciones y dependencias.
Usa herramientas
Lee, edita y ejecuta comandos.
Observa resultados
Interpreta tests, errores y comandos.
Itera
Corrige y continúa hasta completar el objetivo.
AGENTS.md: memoria de instrucciones del proyecto
Codex lee
archivos
AGENTS.md
antes de comenzar
una tarea.
# AGENTS.md
## Proyecto
Aplicación PHP + MySQL.
## Reglas
- Usa PDO.
- Utiliza prepared statements.
- No añadas dependencias sin necesidad.
- Mantén compatibilidad con PHP 8.2+.
- Ejecuta tests después de modificar código.
- No cambies APIs públicas sin autorización.
## Verificación
composer test
vendor/bin/phpcs
Codex puede combinar
instrucciones globales
y archivos
AGENTS.md
ubicados
en diferentes directorios
del repositorio.
/init
Este flujo puede ayudarte
a generar
una estructura inicial
de
AGENTS.md.
Convierte procedimientos repetitivos en capacidades reutilizables
Las Skills permiten empaquetar instrucciones, referencias y scripts para que Codex ejecute correctamente workflows especializados.
.agents/
└── skills/
└── release-check/
└── SKILL.md---
name: release-check
description: Review a project before release
---
1. Run tests.
2. Run lint.
3. Review git diff.
4. Check for secrets.
5. Review breaking changes.
6. Return a release recommendation.Puede revisar primero sus metadatos y cargar el contenido completo solamente cuando la Skill resulta relevante.
Divide problemas complejos entre agentes especializados
Agente de seguridad
Busca vulnerabilidades y problemas de permisos.
Agente de QA
Revisa cobertura, edge cases y regresiones.
Agente explorador
Investiga arquitectura sin llenar el contexto principal.
Puedes asignar roles diferentes y conectar determinadas herramientas a cada agente según la tarea.
Codex también soporta MCP
MCP permite conectar Codex con herramientas y fuentes de información externas: documentación, GitHub, diseño, bases de datos y sistemas internos.
codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp listLa aplicación de escritorio, Codex CLI y la extensión IDE pueden utilizar la misma configuración MCP del host.
Amplía Codex con Plugins
Un Plugin puede agrupar capacidades reutilizables como Skills, servidores MCP y Hooks.
codex
/pluginsDeterminadas capacidades pueden utilizarse en varias interfaces del ecosistema según compatibilidad.
Automatiza eventos del ciclo del agente
Los Hooks permiten ejecutar lógica personalizada en determinados momentos del workflow de Codex.
Validar comandos antes de ejecutarlos.
Ejecutar linters tras modificar código.
Añadir controles de seguridad.
Registrar acciones para auditoría.
Codex puede cargar
Hooks desde
hooks.json
o desde
config.toml
en capas
de usuario
y proyecto.
Worktrees: varios agentes sin pisarse los cambios
Codex puede trabajar con varias copias independientes del mismo repositorio. Cada agente puede modificar su propio worktree sin alterar tu checkout principal.
Agente 1
Implementa autenticación.
Agente 2
Corrige el checkout.
Agente 3
Añade tests.
La experiencia de escritorio está especialmente diseñada para supervisar varios agentes y worktrees simultáneamente.
Codex como centro de control multiagente
Una tarea por conversación
Mantén distintos objetivos separados.
Código aislado
Cada tarea puede usar su propia copia del repositorio.
Revisión visual
Examina y comenta los cambios del agente.
Terminal integrada
Ejecuta tests, Git y servidores sin salir.
Codex puede ejecutar tareas recurrentes en segundo plano
Issue triage
Clasificar incidencias periódicamente.
CI monitoring
Buscar y resumir fallos CI.
Release brief
Generar informes de releases.
Bug checks
Ejecutar revisiones recurrentes.
Las tareas pueden ejecutarse según un horario y posteriormente dejar resultados para revisión.
Codex utiliza sandbox y aprobaciones
Sandbox
Define los límites técnicos de acceso a archivos, comandos y red.
Aprobaciones
Definen cuándo Codex debe detenerse y pedirte autorización.
El Sandbox limita técnicamente qué puede hacer un proceso. Las aprobaciones controlan cuándo el agente debe preguntarte antes de superar determinados límites.
Sandbox nativo del sistema.
Aislamiento mediante mecanismos Linux.
Sandbox Linux.
Sandbox nativo de Windows.
El acceso a Internet puede estar restringido
En determinados entornos de Codex, el acceso de red del agente está desactivado por defecto y debe habilitarse cuando la tarea realmente lo necesita.
Permite Internet únicamente cuando sea necesario para instalar paquetes, consultar documentación o utilizar servicios externos.
Codex puede trabajar en entornos remotos aislados
Repositorio
Seleccionas el código y commit base.
Container
Codex crea un entorno aislado.
Setup
Instala herramientas y dependencias.
Agent
Ejecuta la tarea y los tests.
En entornos cloud, los secretos pueden ponerse a disposición de scripts de configuración sin permanecer expuestos durante toda la fase del agente.
Codex dentro del editor
La extensión permite trabajar con el agente directamente junto a tu código y compartir el contexto del proyecto abierto en el editor.
VS Code
Experiencia integrada dentro del editor.
Cursor
Compatible con entornos basados en VS Code.
MCP
Comparte configuración de servidores del host.
Codex puede integrarse en el workflow completo de Git
Revisar git status.
Inspeccionar git diff.
Trabajar en branches.
Preparar commits.
Hacer push.
Crear Pull Requests.
También puedes revisar diffs, stagear o revertir cambios y abrir pull requests desde la interfaz.
Codex también puede ejecutarse desde GitHub Actions
OpenAI proporciona una GitHub Action para integrar Codex en pipelines de CI/CD.
Revisar pull requests.
Ejecutar controles de calidad.
Automatizar migraciones.
Preparar releases.
uses: openai/codex-action@v1Usa Codex como segundo revisor
Revisa el diff actual.
Busca únicamente problemas que afecten:
- corrección
- seguridad
- rendimiento
- regresiones
- compatibilidad
- requisitos
Para cada hallazgo indica:
- severidad
- archivo
- línea
- problema
- impacto
- solución
No reportes preferencias
de estilo sin impacto real.Codex también puede utilizarse sin interfaz interactiva
codex exec "Revisa el proyecto y ejecuta los tests"Puedes incorporar Codex a workflows automatizados sin mantener abierta la TUI interactiva.
También existe Codex SDK y App Server
Automatiza Codex
Integra el agente en herramientas y workflows propios.
Integración profunda
Accede al protocolo utilizado por clientes avanzados de Codex.
Si quieres construir una aplicación alrededor del agente Codex, el SDK y App Server pueden ser relevantes. Si quieres crear una aplicación de IA general, la ruta principal sigue siendo OpenAI API.
¿Cuánto cuesta Codex?
Codex está incluido en los planes de ChatGPT, incluidos Free y Go, aunque los límites dependen del plan. Plus ofrece mayor capacidad, mientras los niveles Pro aumentan considerablemente la asignación para tareas de Codex.
| Plan | Codex |
|---|---|
| Free | Incluido con límites |
| Go | Incluido con límites |
| Plus | Uso ampliado |
| Pro | Mayor capacidad |
| Business | Uso organizacional |
| Enterprise | Controles empresariales y opciones flexibles |
El modelo, tamaño del contexto, razonamiento, herramientas, ejecución paralela y duración pueden hacer que dos tareas consuman cantidades muy diferentes.
En planes compatibles, puedes utilizar créditos para continuar usando Codex después de agotar el uso incluido.
Codex puede trabajar con distintos modelos OpenAI
Codex permite seleccionar distintos modelos según plan, cliente y disponibilidad. Algunos ofrecen más razonamiento, mientras otros priorizan velocidad y menor consumo.
/modelPara cambios rutinarios puede ser suficiente un modelo más rápido y económico, reservando los modelos de mayor razonamiento para arquitectura, debugging difícil y refactors complejos.
Consulta cuánto Codex te queda disponible
/statusDurante una sesión de Codex CLI, este comando permite consultar información sobre el estado de uso disponible.
Para qué tareas usar Codex
Comprender repositorios desconocidos.
Crear features multiarchivo.
Corregir bugs complejos.
Refactorizar sistemas.
Crear y ejecutar tests.
Revisar Pull Requests.
Realizar migraciones.
Automatizar workflows repetitivos.
Codex también puede trabajar con WordPress y WooCommerce
Plugins
Actions, filters, clases y shortcodes.
Frontend + backend
Sigue requests entre JavaScript y PHP.
Ecommerce
Productos, pedidos, checkout y hooks.
MySQL
Analiza consultas y rendimiento.
En
/codex-para-wordpress/
desarrollaremos
un workflow completo
para plugins,
WooCommerce,
WP-CLI,
AJAX,
REST API
y seguridad.
Codex vs Claude Code
| Codex | Claude Code |
|---|---|
| Modelos OpenAI | Modelos Claude |
AGENTS.md |
CLAUDE.md |
| Skills | Skills |
| MCP | MCP |
| Subagents | Subagents |
| Hooks | Hooks |
| Plugins | Plugins |
| Worktrees integrados | Worktrees disponibles |
| Automations integradas | Automatización mediante workflows |
Codex vs pedir código en un chat normal
Asistente
Puede explicarte cómo escribir una función.
- Genera ejemplos
- Explica conceptos
- Responde preguntas
- Trabaja con contexto entregado
Agente
Puede trabajar sobre el repositorio completo.
- Lee archivos
- Modifica código
- Ejecuta comandos
- Corre tests
- Itera sobre errores
Codex no reemplaza todas las herramientas de desarrollo
Tu editor sigue siendo útil para cambios manuales.
El control de versiones sigue siendo esencial.
Los tests siguen siendo evidencia objetiva.
Cambios críticos deberían recibir revisión humana.
Cómo trabajar con Codex de forma más segura
Utiliza Git antes de cambios importantes.
Mantén el Sandbox cuando sea posible.
Limita el acceso a la red.
No almacenes secretos en el repositorio.
Revisa las herramientas de Plugins y MCP.
Ejecuta tests antes de integrar cambios.
¿Para quién es Codex?
Guías que desarrollaremos en este cluster
Documentación recomendada de Codex
Codex
Producto, agentes, Skills, multi-agent y workflows.
Ver Codex →Codex Documentation
CLI, AGENTS.md, Skills, MCP, Sandbox y entornos.
Ver documentación →Codex CLI
Código fuente del agente local.
Ver repositorio →Continúa aprendiendo programación con IA
FAQ sobre OpenAI Codex
Respuestas sobre Codex, CLI, ChatGPT, API, Skills, agentes y precios.
Codex es el agente de programación de OpenAI. Puede escribir, revisar y entregar código, además de trabajar directamente sobre repositorios mediante herramientas, terminal, IDE y entornos cloud.
No. OpenAI API es una plataforma para integrar modelos y herramientas de OpenAI en aplicaciones propias. Codex es un agente listo para realizar tareas de ingeniería sobre proyectos de software.
Sí. Codex CLI permite ejecutar el agente directamente desde terminal, donde puede leer archivos, realizar modificaciones y ejecutar comandos.
Sí. OpenAI publica Codex CLI en el repositorio oficial openai/codex de GitHub.
Sí. Los clientes locales de Codex pueden iniciar sesión con tu cuenta de ChatGPT. También admiten autenticación mediante API key para determinados workflows locales.
Codex está incluido actualmente en todos los planes de ChatGPT, incluidos Free y Go. Los límites disponibles dependen del plan.
AGENTS.md permite guardar instrucciones persistentes sobre un proyecto, como convenciones, comandos de test, arquitectura y reglas que Codex debería seguir en cada tarea.
Sí. Las Skills permiten empaquetar instrucciones, referencias y scripts reutilizables para workflows especializados.
Sí. Codex puede conectarse con servidores MCP para acceder a herramientas y contexto de servicios externos.
Sí. Codex está diseñado para workflows multiagente y puede utilizar worktrees para mantener tareas paralelas aisladas dentro del mismo repositorio Git.
Sí. Codex dispone de Automations para ejecutar tareas recurrentes según un horario y entregar posteriormente los resultados para revisión.
Sí. Codex puede trabajar sobre proyectos PHP y WordPress, analizar plugins, WooCommerce, AJAX, REST API, JavaScript, CSS, MySQL y ejecutar herramientas como WP-CLI.
Codex CLI: el agente de OpenAI desde la terminal
Ahora que conoces qué es Codex, el siguiente paso es aprender a utilizarlo directamente desde terminal: instalación, autenticación, comandos, permisos, modelos, AGENTS.md, MCP y automatización.
Aprender Codex CLI →