Codex para principiantes: cómo empezar a programar con el agente de IA de OpenAI

Codex es el agente de programación de OpenAI: una IA que entra en tu proyecto, lee el código, modifica archivos, ejecuta comandos y pruebas, y sigue trabajando a partir de los resultados. Está incluido en todos los planes de ChatGPT —desde el nivel gratuito hasta el plan Pro— y la forma más sencilla de empezar es esta: abrir un proyecto real, dejar que Codex lo analice sin tocar nada, asignarle una tarea pequeña, revisar el diff y ejecutar las pruebas. Nada de memorizar prompts avanzados: primero se aprende el flujo de trabajo.

Si vienes de usar un chat de IA para programar, la diferencia es inmediata. En un chat normal pides «hazme un botón de inicio de sesión en React», copias el fragmento y lo integras tú. Con Codex puedes decirle «añade un botón de inicio de sesión a este proyecto, revisa antes la lógica de autenticación existente y sigue el estilo del código actual», y el agente explora el repositorio, localiza los archivos, edita el código y ejecuta las comprobaciones dentro del proyecto real.

Un apunte importante antes de continuar: este artículo habla de Codex, el agente de programación de OpenAI (2025–2026), no del antiguo modelo de generación de código de 2021, que quedó retirado. Toda la información de modelos, precios y funciones está verificada con la documentación oficial de OpenAI a fecha de octubre de 2026.

Qué es Codex y por qué se comporta distinto a un chat

La documentación oficial describe Codex como un agente capaz de navegar un repositorio a partir de una petición, editar archivos, ejecutar comandos y realizar pruebas. En la práctica eso significa que Codex puede:

• Escribir código adaptado a la estructura y convenciones de tu proyecto, no en el vacío.
• Entender bases de código ajenas o heredadas y explicarte cómo se organizan sus piezas.
• Revisar código: detectar errores de lógica, fallos potenciales y casos límite.
• Depurar y corregir: trazar el origen de un fallo y proponer o aplicar la corrección.
• Automatizar tareas repetitivas: refactorizaciones, pruebas, migraciones y trabajos de configuración.

Desde 2026, además, Codex puede ejecutar varios agentes en paralelo, trabajar en la nube aunque cierres el portátil y validar su propio trabajo usando el navegador y la pantalla de tu equipo. Como principiante no necesitas nada de eso el primer día, pero conviene saber que existe.

Qué necesitas antes de usar Codex por primera vez

Un plan de ChatGPT (el gratuito vale para probar)

Codex viene incluido en tu suscripción de ChatGPT. Los precios publicados por OpenAI en octubre de 2026 (en dólares, sin impuestos y sujetos a cambios por región) son estos:

Plan	Precio	Qué incluye de Codex
Free	$0	Codex con límites bajos y modelo ligero (GPT-5.6 Terra). Sin Codex Cloud.
Go	$8/mes	Tareas ligeras con límites reducidos. Sin Codex Cloud.
Plus	$20/mes	Uso local y en la nube (según disponibilidad), modelos GPT-5.6 completos, revisión de código en GitHub, integración con Slack y créditos opcionales.
Pro	desde $100/mes (5x) o $200/mes (20x)	Entre 5 y 20 veces más uso que Plus, acceso anticipado a modelos como GPT-5.3-Codex-Spark (vista previa de investigación) y GPT-6.
Business	$25/mes o $20/usuario/mes (anual, mínimo 2 usuarios)	Espacio de trabajo seguro con controles de administración. Desde abril de 2026 admite plazas «solo Codex» de pago por uso.
Enterprise y Edu	precio personalizado	Seguridad empresarial y precios flexibles por créditos.

Un cambio que conviene entender: el 2 de abril de 2026 OpenAI sustituyó los antiguos límites por mensaje por un sistema de créditos basado en tokens, alineado con el precio de la API. Una tarea típica con GPT-5.6 Sol consume aproximadamente entre 5 y 40 créditos. Si te quedas corto, Plus y Pro pueden comprar créditos adicionales sin cambiar de plan.

Qué modelo elegir según tu plan

Modelo	Disponible en	Para qué lo usarías
GPT-5.6 Terra	Todos los planes, incluido Free y Go	Equilibrio entre capacidad, velocidad y coste. Buena opción por defecto para empezar.
GPT-5.6 Luna	Planes de pago	El más rápido y económico de la familia 5.6, para tareas rutinarias.
GPT-5.6 Sol	Plus, Pro, Business y Enterprise	Trabajo complejo: depuración difícil, refactorizaciones grandes, tareas largas.
GPT-6 (Astra) y GPT-5.6 Sol Pro	Pro, Business y Enterprise (Astra también en Plus)	Máxima capacidad para flujos de trabajo de larga duración.
GPT-5.3-Codex-Spark	Vista previa de investigación en Pro	Tareas del día a día con latencia muy baja.

Si usas Codex iniciado con tu cuenta de ChatGPT, ten en cuenta que GPT-5.4 y GPT-5.4 mini se retiraron de Codex el 31 de agosto de 2026: sus sustitutos naturales son GPT-5.6 Terra y GPT-5.6 Luna. Mantén la CLI y las aplicaciones actualizadas; los modelos más recientes requieren versiones mínimas (por ejemplo, GPT-5.6 necesita Codex CLI 0.144.0 o superior). Si sigues leyendo artículos que recomiendan «GPT-5-Codex» a secas, probablemente sean de 2025.

Dónde puedes usar Codex

• Aplicación de Codex (escritorio, macOS y Windows): el punto de partida más cómodo para principiantes.
• ChatGPT en el navegador y en la app de escritorio: Codex está integrado como modo de trabajo.
• Codex CLI: el agente en la terminal, de código abierto y escrito en Rust.
• Extensión para IDE: compatible con VS Code, Cursor y Windsurf.
• Codex Cloud: ejecuta tareas en máquinas gestionadas por OpenAI y devuelve los cambios; requiere un plan de pago (no está en Free ni en Go).
• Móvil: desde la app de ChatGPT (iOS y Android) puedes iniciar, seguir y aprobar tareas de Codex que se ejecutan en tu Mac, una función en vista previa desde mayo de 2026.

Si ya tienes un proyecto en marcha —una web en Next.js, una API en Python, lo que uses a diario—, es mejor punto de partida que crear un repositorio de prueba sin utilidad: un proyecto real tiene requisitos concretos y resultados que puedes comprobar.

Paso 1: instala Codex y conéctalo a tu cuenta

La vía más rápida es la aplicación de escritorio, iniciando sesión con tu cuenta de ChatGPT. Si prefieres la terminal, la instalación oficial actual es:

npm install -g @openai/codex
codex

También puedes instalarla con Homebrew (brew install codex). La primera vez que ejecutes codex se te pedirá iniciar sesión con tu cuenta de ChatGPT; no necesitas una clave de API para empezar.

Dos detalles que los principiantes suelen pasar por alto:

• Windows: la aplicación de escritorio y el modo Codex de ChatGPT funcionan de forma nativa, con utilidades como codex doctor para diagnosticar problemas. La CLI, en cambio, soporta oficialmente macOS y Linux; en Windows se recomienda ejecutarla dentro de WSL.
• Modos de aprobación: por defecto Codex lee, edita y ejecuta comandos dentro del directorio del proyecto sin pedir permiso, pero necesita tu aprobación para salir de él o acceder a la red. Con el comando /approvals puedes cambiar a modo «solo lectura» (ideal para el primer contacto) o a acceso completo (con precaución).

Paso 2: deja que Codex conozca tu proyecto sin tocar nada

La primera interacción no debería modificar código. Empieza así:

Lee este proyecto, pero no modifiques ningún archivo. Explícame su estructura general, las funciones principales y qué archivos debería revisar si quisiera cambiar el sistema de inicio de sesión.

Después puedes profundizar:

Analiza el flujo de inicio de sesión, desde que el usuario envía el formulario hasta que el servidor valida. Indica qué archivos intervienen y cómo se relacionan. Sigue sin modificar nada.

Este paso cumple dos funciones: te ahorra tiempo (no hace falta que le expliques el proyecto a mano) y te permite comprobar si Codex entiende de verdad tu código antes de darle permisos para modificarlo. Si malinterpreta la estructura, corrígelo en la misma conversación; no tiene sentido encargarle cambios importantes a un agente que no ha entendido el punto de partida.

En proyectos donde vayas a usar Codex con frecuencia, crea un archivo AGENTS.md en la raíz del repositorio con las reglas del proyecto. Es la forma oficial de darle instrucciones persistentes:

# AGENTS.md
- Ejecuta `npm test` antes de dar por terminada cualquier tarea.
- Reutiliza los componentes de `src/components/ui`; no añadas dependencias nuevas sin avisar.
- El proyecto usa TypeScript estricto: sin `any` en código nuevo.
- Commit messages en inglés, imperativo y una línea.

Codex lee y combina los AGENTS.md por niveles de carpeta, así que puedes tener instrucciones generales en la raíz y específicas en subdirectorios.

Paso 3: completa tu primera tarea real

Cuando confíes en que entiende el proyecto, asígnale algo verificable en menos de media hora: arreglar un bug pequeño, añadir un botón, un parámetro a una API o una página de ajustes.

Una buena petición de tarea sigue esta estructura:

Objetivo + situación actual + restricciones + alcance + validación.

Por ejemplo:

Objetivo: añade un botón «Copiar correo electrónico» en la página de configuración del usuario. Situación actual: la página ya existe y el proyecto tiene componentes de botón reutilizables. Restricciones: usa los componentes existentes y el estilo responsive actual; no añadas dependencias. Alcance: modifica únicamente los archivos estrictamente necesarios. Validación: al terminar, ejecuta las pruebas relevantes y dime qué archivos has modificado.

El flujo de trabajo de una tarea queda así:

1. Definir la necesidad con precisión.
2. Codex analiza el proyecto y propone el enfoque.
3. Codex modifica el código y ejecuta comandos.
4. Revisas el diff antes de aceptar los cambios.
5. Ejecutas pruebas, lint o la compilación.
6. Corriges en la misma sesión según los resultados.

Al revisar el diff, comprueba tres cosas: que los cambios resuelven realmente el problema, que Codex no ha tocado archivos ajenos a la tarea y que no hay modificaciones que puedan romper lógica existente. Si algo no cuadra, continúas en la misma conversación: «la posición del botón es correcta, pero en móvil no respeta el sistema responsive; ajusta solo los estilos de este botón». Es mucho más eficiente que empezar de cero en otra sesión.

Progresión recomendada para principiantes

Una secuencia sensata de las primeras semanas:

1. Leer y entender: localizar archivos, explicar código y trazar relaciones entre módulos.
2. Arreglar un bug pequeño: dale el mensaje de error y los pasos para reproducirlo.
3. Modificar la interfaz: añadir un botón, cambiar un diseño, ajustar el comportamiento responsive.
4. Añadir una función pequeña: un endpoint, un campo de formulario, una página sencilla.
5. Escribir pruebas: siguiendo el estilo de las pruebas ya existentes.
6. Refactorizar: cuando ya domines el flujo, tareas que afectan a varios archivos.

Evita empezar con «reescribe todo el proyecto», «rediseña la base de datos» o «migra la arquitectura»: cuanto mayor es la tarea, mayor es el daño de una interpretación incorrecta de los requisitos.

Errores más habituales al empezar

• Aceptar cambios sin revisar el diff. Que Codex pueda modificar código no significa que todo sea correcto: la responsabilidad final sigue siendo tuya.
• Plantear tareas demasiado grandes. «Optimiza este proyecto» no es una tarea concreta para un humano, y mucho menos para un agente. Divídela: «mejora la carga de la página de inicio», «revisa la consulta de esta API».
• Dar poca información al reportar un error. Lo útil es: cómo reproducirlo → qué ocurre → qué debería ocurrir → mensajes de error o registros. Nada de «hay un bug, arréglalo».
• Desplegar sin validación manual. En autenticación, pagos, migraciones o permisos, revisa en un entorno adecuado aunque Codex diga que las pruebas pasan.
• No usar Git. No es un requisito técnico, pero sin control de versiones no puedes revisar cambios, crear ramas ni volver atrás si algo sale mal. Con un agente de IA, es tu red de seguridad.

Cómo controlar los límites de uso (y que no te sorprenda)

Desde el cambio a créditos por tokens, el consumo depende del modelo, del tamaño de tus peticiones y de si trabajas en local o en la nube. Los mensajes locales y las tareas en la nube comparten una ventana de cinco horas, y pueden aplicarse límites semanales adicionales. Para no agotarlos antes de tiempo:

• Consulta tu consumo con /status en la CLI o en el panel de uso de Codex dentro de ChatGPT.
• Para tareas rutinarias usa un modelo más pequeño (Terra o Luna); reserva Sol para lo difícil.
• Mantén los prompts precisos pero sin contexto innecesario, y el AGENTS.md lo más ligero posible.
• Desactiva los servidores MCP que no uses: cada uno añade contexto y consume límite.
• Si te quedas sin uso, Plus y Pro pueden comprar créditos para terminar el trabajo en curso.

Qué hacer después de tu primera experiencia

Cuando el ciclo «entender → encargar → revisar → probar → corregir» te resulte natural, el abanico se amplía:

• Tareas en la nube: lanza trabajos largos desde la web o la app y sigue el progreso desde el móvil; Codex continúa aunque apagues el equipo.
• Revisión automática de pull requests en GitHub: etiqueta a @Codex en un PR y deja que analice el diff.
• Modo objetivo (goal mode): define un resultado con criterios de éxito y el agente trabaja de forma persistente hasta alcanzarlo, disponible en la app, la extensión de IDE y la CLI.
• Multiagente: abre, bifurca y sigue varios agentes trabajando en paralelo sobre la misma base de código.

El verdadero cambio no es «escribir código más rápido», sino dejar de copiar archivos a un chat y pegar fragmentos: el agente trabaja dentro del proyecto real y completa parte del ciclo de desarrollo. Eso no elimina la necesidad de saber programar; al contrario, cuanto más claros tengas los requisitos, la arquitectura y los criterios de aceptación, mejor será el resultado de Codex.

Preguntas frecuentes sobre Codex

¿Codex es gratis?

Está incluido en todos los planes de ChatGPT, incluido el gratuito, con límites bajos y un modelo ligero (GPT-5.6 Terra). El nivel gratuito y Go no incluyen Codex Cloud. Para uso semanal regular, Plus ($20/mes) es el punto de partida razonable; mantén la CLI y las aplicaciones actualizadas para acceder a los modelos más recientes.

¿Qué diferencia hay entre Codex y ChatGPT para programar?

ChatGPT te explica código y genera fragmentos en una conversación. Codex es un agente de programación: trabaja dentro de tu repositorio, edita archivos, ejecuta comandos y pruebas, y puede revisar pull requests o continuar tareas en la nube. Ambos comparten tu cuenta y plan de ChatGPT.

¿Qué modelo debo elegir como principiante?

Empieza con el modelo por defecto (Terra si usas Free o Go). Cuando necesites resolver algo difícil —un bug persistente, una refactorización grande—, cambia a Sol con el comando /model. Luna es la opción rápida y barata para tareas rutinarias si tienes un plan de pago.

¿Puedo usar Codex en Windows?

Sí. La aplicación de Codex y el modo Codex de ChatGPT funcionan de forma nativa en Windows, con herramientas como codex doctor para diagnosticar problemas y selección de distribución de WSL. Para la CLI, la vía recomendada oficialmente sigue siendo WSL, ya que el soporte nativo es experimental.

¿Puede usar Codex alguien que no sabe programar?

Puede probarlo, pero con un proyecto real conviene tener bases: hace falta criterio para revisar el diff, valorar si las pruebas son suficientes y detectar cambios que rompen lógica existente. Sin ese criterio, el riesgo de aceptar código incorrecto es alto.

¿Qué pasa si Codex rompe mi código?

Trabaja siempre con Git: crea una rama antes de encargar la tarea y recupera el estado anterior si algo sale mal. Usa el modo de aprobación de lectura para las primeras interacciones, revisa cada diff y ejecuta pruebas antes de aceptar. Codex no debería desplegar a producción solo porque indique que la tarea terminó.