Codex para principiantes: cómo empezar a programar con IA

Si es la primera vez que utilizas OpenAI Codex, lo más importante no es aprender una lista de técnicas avanzadas de AI Coding, sino entender cómo trabajar correctamente con un Coding Agent.

En pocas palabras, Codex es el Coding Agent de OpenAI. No se limita a responder preguntas como «¿cómo escribo este código?». Puede entrar en un proyecto real, leer el código, entender su estructura, modificar archivos, ejecutar comandos y pruebas y, a partir de los resultados, continuar trabajando. OpenAI posiciona actualmente Codex como un AI Agent pensado para ayudar a los desarrolladores a escribir, revisar y entregar código.

Por eso, para un principiante, la forma más sencilla de empezar es:

Abrir un proyecto real → dejar que Codex lo entienda → asignarle una tarea pequeña → revisar los cambios → ejecutar pruebas → continuar según los resultados.

¿Qué es Codex?

Un chat de IA convencional suele funcionar así: haces una pregunta y recibes un fragmento de código.

Por ejemplo:

«Ayúdame a crear un botón de inicio de sesión en React».

Después tienes que copiar el código, localizar el archivo correspondiente, integrarlo en el proyecto y ejecutar las pruebas por tu cuenta.

Un Coding Agent va un paso más allá. Puedes decirle a Codex:

«Añade un botón de inicio de sesión a este proyecto. Primero revisa la lógica de autenticación existente y después impleméntalo siguiendo el estilo de código actual».

Codex puede explorar el proyecto, localizar los archivos relevantes, modificar el código y ejecutar pruebas u otros comandos cuando sea necesario. La documentación oficial indica que Codex puede navegar por un repositorio a partir de una petición, editar archivos, ejecutar comandos y realizar pruebas.

Esta es la diferencia fundamental entre Codex como Coding Agent y una herramienta que simplemente genera código mediante un chat.

Qué debes saber antes de utilizar Codex por primera vez

Actualmente puedes utilizar Codex de varias formas, entre ellas Codex App, extensiones para IDE, Codex CLI y Codex dentro de ChatGPT. El soporte oficial incluye editores como VS Code, Cursor y Windsurf, mientras que Codex App dispone de versiones para macOS y Windows.

Si ya tienes un proyecto en desarrollo, lo más recomendable para empezar es utilizar directamente un proyecto real.

Por ejemplo, podrías tener un proyecto de Next.js como este:

my-next-app/
├── app/
├── components/
├── lib/
├── public/
├── package.json
└── ...

No necesitas crear un proyecto completamente nuevo y sin utilidad solo para probar Codex. Un proyecto real tiene requisitos concretos, código existente y resultados que puedes comprobar, por lo que resulta mucho más fácil entender qué aporta realmente un Coding Agent.

Tampoco conviene que la primera tarea sea «refactorizar todo el proyecto».

Es mejor empezar con algo que puedas verificar en menos de media hora: modificar un botón, solucionar un Bug, añadir un parámetro a una API o ajustar una página.

Si utilizas Codex CLI, la instalación oficial actual es:

npm install -g @openai/codex

Después puedes iniciar Codex desde el directorio del proyecto. El CLI puede leer, modificar y ejecutar código localmente y ofrece distintos niveles de confirmación para controlar determinadas operaciones.

Si utilizas Codex App o una integración con un IDE, puedes iniciar sesión con tu cuenta de ChatGPT y comenzar a trabajar. Los límites disponibles dependen de la cuenta y del plan que tengas.

Primer paso: deja que Codex conozca tu proyecto

Supongamos que tienes un proyecto de Next.js. La primera vez no deberías pedirle directamente que modifique el código.

Empieza con algo como:

Lee primero este proyecto, pero no modifiques ningún código. Explícame la estructura general, las funciones principales y qué archivos debería revisar si quiero modificar el sistema de inicio de sesión.

Este paso es especialmente importante.

Codex analizará la estructura del proyecto y el código relacionado y te explicará cómo entiende el sistema.

También puedes profundizar:

Analiza el flujo de inicio de sesión desde que el usuario envía el formulario hasta que el servidor termina la validación. Indica qué archivos intervienen y qué relación existe entre ellos. Sigue sin modificar ningún código.

La ventaja es que puedes comprobar primero si Codex realmente entiende el proyecto.

Si ha interpretado mal la estructura o la lógica existente, no tiene sentido darle inmediatamente permiso para realizar modificaciones importantes.

En proyectos donde utilizas Codex con frecuencia, también puedes utilizar un archivo AGENTS.md para proporcionar instrucciones específicas del proyecto, como los comandos que debe utilizar para ejecutar pruebas o las convenciones de código que debe respetar. La documentación oficial de OpenAI contempla este tipo de instrucciones como una forma de ayudar a Codex a entender y seguir las reglas del proyecto.

Segundo paso: completa tu primera tarea de programación

Una vez que Codex entiende el proyecto, puedes asignarle una tarea concreta.

Por ejemplo:

Añade un botón «Copiar correo electrónico» a la página de configuración del usuario. Primero revisa la página actual y los componentes de botones existentes en el proyecto y sigue el estilo de código actual. No modifiques archivos que no estén relacionados. Al terminar, ejecuta las pruebas o comprobaciones relevantes y dime qué archivos has modificado.

Una buena tarea con Codex suele seguir este proceso:

Definir la necesidad → analizar el proyecto → modificar el código → revisar el Diff → ejecutar pruebas → corregir según los resultados.

Ahí es donde está gran parte del valor de Codex.

No se limita a entregarte una función que después tienes que integrar manualmente. Puede realizar una serie de acciones de desarrollo dentro del entorno real del proyecto.

Cuando termine, revisa primero el Diff antes de aceptar los cambios.

Comprueba especialmente tres cosas:

• ¿Los cambios solucionan realmente el problema planteado?

• ¿Ha modificado código que no estaba relacionado con la tarea?

• ¿Ha introducido algún cambio que pueda romper la lógica existente?

Si encuentras un problema, puedes continuar en la misma sesión:

La posición del botón es correcta, pero el diseño móvil no coincide con el sistema responsive actual. Ajusta los estilos siguiendo el diseño existente y modifica únicamente los estilos relacionados con este botón.

Esto suele ser mucho más eficiente que abrir otra conversación y volver a explicar todo el proyecto.

Cómo pedirle tareas a Codex

Para empezar no necesitas prompts complicados. Una estructura muy práctica es:

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

Por ejemplo:

Objetivo: añadir un botón de favoritos a la página de detalle de producto.

Situación actual: el proyecto ya dispone de autenticación de usuarios y páginas de detalle de productos.

Restricciones: utiliza los componentes de UI y la estructura de base de datos existentes. No añadas nuevas dependencias.

Alcance: modifica únicamente los componentes, la API y el código de base de datos estrictamente necesarios para los favoritos.

Requisito: analiza primero la implementación existente y después modifica el código. Al terminar, ejecuta las pruebas relevantes y resume los cambios realizados.

Si solo quieres comprender cómo funciona algo, puedes indicarlo claramente:

Lee primero este proyecto y no modifiques ningún código. Explícame cómo funciona actualmente esta característica y qué archivos podrían verse afectados si quisiera modificarla.

Si ya tienes claro lo que necesitas:

Implementa esta función siguiendo el estilo de código actual del proyecto. Al terminar, revisa el código relacionado y ejecuta las pruebas adecuadas. No modifiques nada que no esté relacionado con esta tarea.

Un consejo especialmente útil es pedirle a Codex que analice primero y modifique después.

Esto es todavía más importante cuando trabajas con funcionalidades sensibles como bases de datos, autenticación o pagos. No conviene limitarse a decir «refactoriza esto» y dejar que el Agent tome todas las decisiones por su cuenta.

Qué debería probar un principiante con Codex

Una progresión sencilla sería:

Leer y entender el proyecto

Pídele que localice archivos, explique el código y trace las relaciones entre diferentes partes del sistema.

Solucionar un Bug pequeño

Proporciónale el mensaje de error y los pasos para reproducirlo y deja que intente localizar el problema.

Modificar la UI

Por ejemplo, añadir un botón, cambiar un layout o ajustar el comportamiento responsive.

Añadir una pequeña función

Puede ser una API, un campo de formulario o una página sencilla.

Añadir pruebas

Pídele que cree casos de prueba siguiendo el estilo de las pruebas que ya existen en el proyecto.

Refactorizar código

Cuando ya tengas experiencia trabajando con Codex, puedes pasar a tareas que afecten a varios archivos.

Para la primera prueba no es recomendable pedirle directamente que «reescriba todo el proyecto», «rediseñe la base de datos» o «migre todo el sistema a otra arquitectura».

Cuanto mayor sea la tarea, mayor será también el impacto de una interpretación incorrecta de los requisitos.

Errores más habituales al empezar

El problema más común es aceptar los cambios sin revisar el Diff.

Que Codex pueda modificar código no significa que todos sus cambios sean correctos. El desarrollador sigue siendo responsable de revisar el código y comprobar los resultados de las pruebas.

El segundo problema es plantear tareas demasiado grandes.

«Optimiza este proyecto» tampoco es una tarea suficientemente concreta para un desarrollador humano, y mucho menos para un AI Agent.

Es mejor dividirla en tareas verificables, como «mejora la velocidad de carga de la página de inicio», «revisa la consulta de base de datos de esta API» o «reduce los renders innecesarios de este componente».

El tercer problema es no proporcionar suficiente información cuando aparece un error.

Si quieres que Codex solucione un Bug, intenta proporcionar:

Cómo reproducirlo → qué ocurre realmente → qué debería ocurrir → mensajes de error o logs.

Esto es mucho más útil que decir simplemente «hay un Bug aquí, arréglalo».

El cuarto problema es desplegar inmediatamente después de modificar una funcionalidad importante.

En especial con autenticación, pagos, migraciones de base de datos o permisos, incluso cuando Codex haya ejecutado las pruebas correctamente, conviene realizar una revisión manual y validar el comportamiento en un entorno adecuado antes de llevar los cambios a producción.

La forma correcta de trabajar con Codex

Para un principiante, todo el flujo puede resumirse así:

Entender el proyecto → definir claramente la tarea → ejecutar una tarea pequeña → revisar el Diff → probar → corregir → continuar.

Al principio quizá solo utilices Codex para modificar un par de archivos.

Con el tiempo puedes ampliar progresivamente el alcance:

Desarrollo de funciones en varios archivos → localización de Bugs → pruebas → refactorización → Code Review → mantenimiento del proyecto.

En ese momento puedes empezar a notar que el principal cambio no consiste simplemente en «escribir código más rápido», sino en modificar la forma de ejecutar el trabajo de desarrollo.

Ya no necesitas copiar cada archivo en un chat, esperar una respuesta y pegar manualmente el código generado. Puedes permitir que el Agent trabaje dentro del proyecto real y complete una parte del proceso de desarrollo.

Eso no significa que el desarrollador deje de necesitar conocimientos de programación.

Al contrario, cuanto más claros sean los requisitos, la arquitectura y los criterios de aceptación, más fácil será que Codex produzca un resultado útil.

Qué hacer después de tu primera experiencia

La primera vez puedes limitarte a una tarea pequeña:

Primero: deja que Codex lea el proyecto.

↓

Después: pídele que solucione un Bug sencillo.

↓

A continuación: desarrolla una pequeña función.

↓

Después: pídele que añada pruebas.

↓

Finalmente: intenta que complete por sí mismo una función completa y revisa el resultado.

Cuando ya controles este flujo, puedes pasar a tareas más complejas, como modificaciones en varios archivos, refactorizaciones, Code Review y trabajos de mayor duración.

Por eso, la mejor manera de aprender cómo usar Codex no consiste en memorizar una colección de prompts, sino en abrir tu propio proyecto y empezar a trabajar con una tarea real.

Lo más interesante de Codex no es preguntarle cómo escribir código, sino permitir que entre realmente en tu flujo de desarrollo: entender el código, ejecutar tareas, realizar pruebas y continuar trabajando a partir de los resultados.

FAQ sobre Codex

¿Cuál es la diferencia entre Codex y ChatGPT para programar?

ChatGPT es especialmente útil para explicar código, generar fragmentos y resolver dudas de desarrollo mediante una conversación. Codex está orientado al trabajo como Coding Agent y puede leer código dentro de un proyecto, modificar archivos, ejecutar comandos y realizar pruebas.

¿Para qué tipo de desarrolladores está pensado Codex?

Puede utilizarse en proyectos de frontend, backend y full stack, así como en tareas de mantenimiento de código existente. Resulta especialmente relevante cuando necesitas corregir Bugs, desarrollar funciones, añadir pruebas o realizar refactorizaciones dentro de un proyecto real.

¿Puede utilizar Codex alguien que no sabe programar?

Se puede probar, pero cuando se trabaja con un proyecto real sigue siendo necesario tener conocimientos básicos de programación para comprobar si la solución es correcta, revisar el Diff y valorar si los resultados de las pruebas son suficientes.

¿Codex modifica directamente mi código?

Sí, dependiendo del cliente de Codex y del modo de autorización que estés utilizando. Codex CLI ofrece distintos modos de aprobación para controlar si el Agent necesita tu confirmación antes de modificar archivos o ejecutar determinados comandos.

¿Necesito Git para utilizar Codex?

No es un requisito absoluto, pero es muy recomendable utilizar Git. Con un sistema de control de versiones puedes revisar los cambios, crear ramas y recuperar el estado anterior si algo sale mal. Esto resulta especialmente importante cuando trabajas con un AI Coding Agent.

¿Cómo debería revisar el código después de utilizar Codex?

Primero revisa el Diff. Después ejecuta las pruebas existentes, Lint, comprobaciones de TypeScript o el proceso de Build correspondiente. Finalmente, comprueba manualmente que la funcionalidad funciona como esperabas.

No deberías desplegar directamente solo porque Codex indique que la tarea ha terminado.

¿Qué debería hacer la primera vez que utilizo Codex?

En lugar de pedirle inmediatamente que escriba código, empieza por darle acceso a un proyecto real y pídele que explique su estructura.

Cuando hayas confirmado que entiende correctamente el proyecto, asígnale una tarea pequeña y fácil de verificar.

¿Puede Codex trabajar con proyectos grandes?

Sí. Codex está diseñado para tareas de ingeniería de software que pueden requerir varios pasos y sesiones de trabajo prolongadas, y puede trabajar con repositorios de código de gran tamaño.

Sin embargo, que pueda trabajar con un proyecto grande no significa que debas entregarle todo el proyecto en tu primera interacción.

Para empezar, sigue siendo más seguro y fácil de verificar una tarea concreta, pequeña y bien definida.