¿Cómo usar Codex? Guía desde cero: de la instalación a tu primera tarea real

OpenAI Codex es un asistente de programación con IA que lee código, lo modifica y ejecuta comandos. Esta guía para principiantes explica, paso a paso, qué versión elegir, cómo instalarla, cómo plantear tu primera tarea, cómo usar AGENTS.md para que funcione cada vez mejor y cuáles son los errores más comunes al empezar.

cómo usar Codextutorial de CodexOpenAI Codex para principiantesinstalar Codex CLIprogramar con IA desde cero

Mucha gente abre Codex por primera vez, escribe «hazme una página web», recibe un montón de archivos que no entiende y se rinde. Casi nunca es culpa de la herramienta, sino de cómo se usa: Codex no es un chatbot. Se parece más a un programador junior sentado frente a tu computadora: puede leer tu proyecto, modificar archivos y ejecutar comandos, pero necesita que le expliques bien la tarea y le marques los límites.

Paso 1: elige una forma de usarlo

Codex se puede usar de varias maneras: la versión de línea de comandos (Codex CLI), la extensión para el editor, la aplicación de escritorio y la web, donde le encargas tareas que se ejecutan en la nube. Si empiezas desde cero, te recomendamos la aplicación de escritorio o la extensión del editor: la interfaz es más intuitiva y puedes ver qué archivos cambió. Cuando ya te sientas cómodo, pasa a la línea de comandos, que es más rápida y mejor para trabajos en lote. Sea cual sea la opción, puedes iniciar sesión con tu cuenta de ChatGPT; por detrás funciona con las mismas capacidades.

Paso 2: ábrelo dentro de un proyecto real

No le pidas en una carpeta vacía que «construya un gran sistema desde cero». Es mucho mejor empezar con un proyecto pequeño y real que ya tengas, aunque sea una página estática o un script para procesar un Excel, y abrir Codex en esa carpeta. Primero leerá la estructura del directorio y después actuará según lo que le pidas. La primera vez puedes preguntarle: «¿Para qué sirve este proyecto? ¿Cómo se ejecuta?», y comprobar si lo entendió bien.

Paso 3: tu primera tarea debe ser pequeña y verificable

Una buena primera tarea se ve así: «Cambia el título de la página de inicio a XXX; cuando termines, levanta el servidor local y dime en qué dirección puedo ver el resultado». Tiene tres características: alcance reducido, resultado visible de inmediato e incluye un paso de verificación. Cuando confirmes que lo hizo bien, pásale la siguiente tarea. Hacer una sola cosa a la vez funciona mucho mejor que encargarle diez de golpe.

Paso 4: usa AGENTS.md para que recuerde tu proyecto

Repetir cada vez «usamos pnpm», «el comando de pruebas es npm test» o «no toques la carpeta config» cansa. Codex lee el archivo AGENTS.md que esté en la raíz del proyecto: si escribes ahí las convenciones del proyecto, las respetará cada vez que arranque. Un AGENTS.md suficiente solo necesita dejar claro cómo instalar las dependencias, cómo ejecutar el proyecto, cómo correr las pruebas, qué carpetas no se deben tocar y qué estilo de código seguir. Puedes pedirle a Codex que te genere un primer borrador y luego ajustarlo tú.

Paso 5: no le des todos los permisos de entrada

Puedes configurar Codex para que te pida confirmación antes de modificar archivos o ejecutar comandos. Al principio conviene mantener esas confirmaciones: verás qué quiere hacer en cada paso, aprenderás algo y podrás frenar errores. Cuando ya confíes en cómo se comporta en ese proyecto, ve dándole más libertad poco a poco. Además, antes de empezar cada tarea haz un commit en Git: si algo se rompe, puedes volver atrás en cualquier momento. Es el seguro más barato para programar con IA.

Los cuatro errores más comunes al empezar

Uno: tareas demasiado grandes, como pedirle en una frase un producto completo, y a mitad de camino se desvía. Dos: usar lo que hizo sin revisar qué cambió, y los problemas se van acumulando. Tres: cuando aparece un error, decir solo «no funciona» en lugar de pegarle el mensaje de error. Cuatro: no escribir un AGENTS.md, de modo que cada conversación empieza de cero. Si evitas estos cuatro errores, Codex te resultará mucho más útil.

Si quieres aprenderlo de forma ordenada y sistemática, desde los fundamentos de la computadora, la instalación y la configuración hasta CLI, MCP, Skills y flujos de trabajo en equipo, echa un vistazo a Codex desde cero (las lecciones están en chino): las primeras 8 lecciones son gratis y puedes verlas sin iniciar sesión. Para conocer más formas de escribir AGENTS.md, lee este artículo: AGENTS.md: escribe las convenciones del proyecto en un archivo.