# Codex: el agente de programación de OpenAI

> Codex es el agente de programación de OpenAI: CLI, IDE, app y nube. Qué hace, qué planes de ChatGPT lo incluyen, cómo usa AGENTS.md y cuándo conviene usarlo.

*Tags: ia, herramientas, openai, agentes*

---


> [!info] Definición Rápida
> **Codex** es el agente de programación de OpenAI. Trabaja sobre tu código: lo lee, edita archivos y corre comandos. Se usa desde una CLI, una extensión de IDE, la app de ChatGPT o un entorno en la nube.


## ¿Qué es Codex y dónde se usa?

Codex es un agente pensado para programar, aunque la documentación oficial también lo presenta para otros tipos de trabajo: empiezas con una meta o una tarea, y ChatGPT reúne contexto, actúa y entrega un resultado. Las superficies que lista la documentación son: la app de escritorio, la app móvil y la web de ChatGPT; la CLI de Codex; la extensión de IDE; y Codex Cloud, con entornos en la nube.

La documentación también enumera funciones como AGENTS.md para configurar al agente, MCP para conectar herramientas externas, git worktrees en entornos locales, subagentes, plugins, skills y hooks. Si ya conoces estos conceptos de otras herramientas, mira [[mcp|MCP]], [[subagentes|subagentes]] y [[skills-de-agentes|skills]]. La lista es amplia; lo que importa es saber cuáles usarás en tu flujo.

## ¿Cómo se instala y se inicia sesión?

La CLI de Codex corre en tu computador y su código es abierto: el repositorio `openai/codex` en GitHub declara la licencia Apache-2.0. Según su README, se instala con alguna de estas opciones:

- macOS y Linux: `curl -fsSL https://chatgpt.com/codex/install.sh | sh`
- Windows: un comando de PowerShell que indica el README
- npm: `npm install -g @openai/codex`
- Homebrew: `brew install --cask codex`

Después ejecutas `codex` en la carpeta de tu proyecto. Para entrar, el README recomienda iniciar sesión con tu cuenta de ChatGPT si tienes un plan Plus, Pro, Business, Edu o Enterprise. También se admite una clave de API, que requiere configuración adicional descrita en la documentación para desarrolladores.

## ¿Cómo usa Codex el archivo AGENTS.md?

Un `AGENTS.md` es un archivo de instrucciones permanentes para el agente. Según la guía oficial, Codex arma la cadena de instrucciones una vez por ejecución, así que los cambios se notan al iniciar una sesión nueva:

1. **Global:** en la carpeta de configuración de Codex (`~/.codex` por defecto) usa `AGENTS.override.md` si existe y, si no, `AGENTS.md`. Solo cuenta el primer archivo que no esté vacío.
2. **Proyecto:** desde la raíz del repositorio hacia el directorio de trabajo, revisa cada carpeta y toma como máximo un archivo por carpeta.
3. **Orden:** concatena los archivos de la raíz hacia abajo. Los más cercanos al trabajo van al final del prompt y por eso prevalecen sobre lo anterior.
4. **Límite:** deja de añadir archivos al llegar a 32 KiB combinados (`project_doc_max_bytes`). Si se corta, sube el límite o reparte las instrucciones en carpetas anidadas.

La guía sugiere poner ahí acuerdos de trabajo (qué comandos de prueba o gestor de paquetes usar), pasos antes de abrir un pull request y reglas específicas por equipo o servicio. Como con otros agentes, un AGENTS.md bien escrito reduce decisiones repetidas. Para el formato y los criterios de redacción, revisa [[claude-md-y-agents-md|CLAUDE.md y AGENTS.md]].

## ¿Qué planes lo incluyen?

Según la página oficial de precios de Codex, consultada el 19 de octubre de 2026, Codex viene incluido en los planes de ChatGPT Free, Go, Plus, Pro, Business, Edu y Enterprise:

| Plan | Precio mensual (USD) | Qué dice la página sobre Codex |
|---|---|---|
| Free | 0 | Tareas rápidas de programación |
| Go | 8 | Tareas ligeras de programación |
| Plus | 20 | Web, CLI, extensión de IDE e iOS; integraciones en la nube |
| Pro | Desde 100 (planes de 100, 200 y 500) | Todo lo de Plus; el plan de 500 añade el modo Ultrafast |
| Business | 20 por usuario con facturación anual para 2 o más usuarios; 25 si pagas mensual | Escritorio y móvil, con SAML SSO y MFA |
| Enterprise y Edu | Contacto con ventas | Todo lo de Business, más procesamiento prioritario, SCIM, RBAC y controles de retención y residencia |

Los límites de uso son estimaciones de mensajes locales por periodo de cinco horas para Plus y Business estándar, con posibles límites semanales, y varían mucho según el modelo elegido. La página dice que Pro no tiene hoy límite de cinco horas. Como los modelos, los planes y los precios de Codex cambian seguido, confirma la página antes de decidir. Si usas una clave de API, se factura al precio estándar de la API, aparte de la suscripción, y no incluye funciones en la nube como la revisión en GitHub o Slack.

## ¿Por qué le importa a un diseñador?

Porque te da otra vía para convertir un diseño en código dentro de tu proyecto. Si ya usas un agente para [[que-es-un-agente-de-ia|tareas de agente]] o trabajas con [[claude-code|Claude Code]], Codex es una opción más para comparar en el mismo caso: el mismo prototipo, el mismo repo, dos herramientas. Eso te enseña más sobre qué pide tu trabajo que leer cualquier comparativa. Lo que marca la diferencia suele ser el archivo de instrucciones, no la marca del agente.

## ¿Cuándo NO conviene Codex?

- Cuando necesitas funciones en la nube y solo tienes acceso por clave de API. Esas funciones no están incluidas.
- Cuando tu equipo ya tiene un flujo sólido con otro agente. Cambiar sin una razón concreta genera fricción.
- Cuando no tienes un repo con control de versiones. Sin git, revisar los cambios es más difícil.
- Cuando el límite de uso de tu plan no cubre tus sesiones largas. Revisa el plan antes de depender de él para una entrega.

## Ejemplo

Ejemplo ilustrativo: un diseñador tiene un repo con su sistema de componentes y un AGENTS.md que indica usar los tokens de `tokens.json`. Quiere comparar herramientas: pide a Codex una pantalla de configuración en la extensión de IDE y a otro agente la misma pantalla. Revisa ambos diffs contra el diseño y anota qué tokens respetó cada uno, qué inventó y cuánto espaciado tuvo que corregir a mano. Después ajusta el AGENTS.md con las reglas que el agente se saltó y repite la prueba.

Lo que aprende: la comparación dice más sobre tu proyecto que cualquier reseña, y las reglas del AGENTS.md pesan tanto como la herramienta.

## Errores comunes

- Elegir un plan por el precio sin revisar si incluye lo que vas a usar.
- Creer que la API y el plan de ChatGPT ofrecen exactamente lo mismo.
- Dejar AGENTS.md sin reglas y esperar que el agente conozca tu sistema.
- Escribir un AGENTS.md tan largo que pase el límite de 32 KiB y se corte.
- Aceptar un cambio grande sin revisarlo por partes.
- Usar la misma sesión para tareas distintas y mezclar contextos.

## Fuentes

- [Codex: planes y precios (learn.chatgpt.com)](https://learn.chatgpt.com/docs/pricing)
- [Codex: documentación general (learn.chatgpt.com)](https://learn.chatgpt.com/docs)
- [Codex: instrucciones personalizadas con AGENTS.md (learn.chatgpt.com)](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [openai/codex: repositorio de la CLI (GitHub)](https://github.com/openai/codex)


---

Source: https://www.fernandoux.com/es/wiki/ia/codex/