Quieres usar OpenAI Codex pero no sabes por dónde empezar. Esta guía te lleva del cero al primer proyecto funcionando — sin tecnicismos innecesarios. Si quieres primero entender qué es Codex antes de instalarlo, está en nuestra guía general; aquí vamos directo al uso.
Antes de empezar: qué necesitas
Solo necesitas dos cosas: una cuenta de ChatGPT (Plus, Pro, Business, Edu o Enterprise ya incluyen Codex) y un proyecto de código — puede ser nuevo o uno que ya tengas. Si no tienes cuenta de ChatGPT, el plan más básico que incluye Codex es Plus.
También puedes usar Codex con una API key de OpenAI, lo que activa la CLI y la extensión de IDE sin necesidad de plan ChatGPT, pero algunas funciones en la nube no estarán disponibles.
Paso 1: instalar la app de Codex
La forma más fácil de empezar es la app de escritorio, disponible para macOS y Windows. Descárgala desde el sitio oficial de OpenAI. Si usas Mac Intel, elige el build específico para Intel.
Alternativas si prefieres no instalar la app:
- Extensión de IDE: instálala desde el marketplace de VS Code, Cursor, Windsurf o JetBrains. Codex aparece en el panel lateral de tu editor.
- CLI: para usuarios que prefieren la terminal. Una vez instalada, escribe
codexpara iniciar una sesión interactiva. - Web: accede directamente desde el navegador si quieres delegar tareas en la nube sin instalar nada local.
Paso 2: abrir tu primer proyecto
Al abrir la app, inicia sesión con tu cuenta de ChatGPT. Luego selecciona la carpeta de tu proyecto — puede ser cualquier directorio en tu computador que contenga código.
Si ya usaste Codex antes, verás proyectos anteriores en la lista. Si es tu primera vez, solo haz clic en "Add new project" y navega a la carpeta.
Paso 3: elegir el modo de trabajo
Antes de enviar tu primer mensaje, elige cómo quieres que Codex trabaje:
- Local: Codex trabaja directamente en tu carpeta. Los cambios aparecen en tu editor en tiempo real. Ideal para la mayoría de tareas del día a día.
- Worktree: Codex crea una copia aislada del repositorio. Úsalo cuando quieres que Codex explore o cambie cosas sin tocar tu trabajo actual.
- Cloud: Codex trabaja en un entorno remoto de OpenAI. Requiere que el código esté en GitHub. Útil para tareas largas que quieres delegar y revisar después.
Para empezar, elige Local. Es el modo más directo.
Paso 4: tu primer prompt
Aquí es donde empieza el trabajo real. Escribe lo que quieres que Codex haga. Algunos ejemplos buenos para comenzar:
- "Explícame cómo está estructurado este proyecto."
- "Encuentra posibles bugs en los archivos de autenticación."
- "Agrega validación de email al formulario de contacto."
- "Escribe pruebas para la función de cálculo de descuentos."
Codex entra en un ciclo: lee archivos relevantes, hace cambios o análisis, corre comandos si es necesario, y te muestra el resultado. Puedes ver los cambios en el panel de review antes de aceptarlos.
Funciones que vale la pena explorar desde el día 1
El panel de review
Después de que Codex edita código, el panel de review muestra un diff de los cambios — igual que un code review en GitHub. Puedes aceptar, revertir o comentar directamente en líneas específicas. Ese comentario inline le llega a Codex para que lo corrija.
Skills: flujos repetibles con un comando
Un skill es un flujo de trabajo que defines una vez y puedes invocar después escribiendo $nombre-del-skill en el composer. Por ejemplo, si tienes un proceso estándar para hacer commits semánticos, lo empaquetas como skill y Codex lo sigue cada vez.
Goal mode: para tareas largas
Si la tarea es compleja y de muchos pasos, usa /goal para darle a Codex un objetivo persistente. Codex trabaja hacia ese objetivo paso a paso, y puedes pausar, editar o continuar en cualquier momento. Ejemplo: "Migra este proyecto de JavaScript a TypeScript con strict mode sin ningún any explícito."
Automations: tareas recurrentes sin intervención
Puedes programar que Codex haga algo todos los días o cada cierto tiempo — revisar commits recientes en busca de bugs, mantener documentación actualizada, o enviar un reporte de cambios. Las automations corren en segundo plano y te avisan si encuentran algo.
Consejos para sacarle más provecho
- Sé específico con el contexto. "Agrega un endpoint" produce resultados genéricos; "Agrega un endpoint GET /api/users/:id que devuelva el usuario con sus órdenes activas, siguiendo el patrón de los otros endpoints en routes/api.ts" produce código listo.
- Incluye pasos de verificación. Codex trabaja mejor cuando puede confirmar su propio trabajo: "corre las pruebas después del cambio y muéstrame el resultado" lo hace más preciso.
- Divide tareas grandes en pasos. Una tarea grande y ambigua produce más errores que varias tareas pequeñas y concretas.
- Usa AGENTS.md. Es el archivo donde defines las reglas que Codex debe seguir siempre en tu proyecto: comandos de build y test, convenciones de código, qué directorios son críticos. Una vez configurado, no tienes que repetir las mismas instrucciones.
- Revisa siempre antes de commitear. Codex es muy capaz, pero el code review sigue siendo tuyo. El panel de review está ahí por una razón.
En resumen
Empezar con Codex es simple: descarga la app, abre tu proyecto, elige Local, y manda tu primer prompt. La curva de aprendizaje está en aprender a escribir buenos prompts — específicos, con contexto y con criterio de "done" claro — y en aprovechar skills y automations para las tareas recurrentes.
En Aldama usamos Codex y herramientas similares en nuestros proyectos de desarrollo a la medida. Eso nos permite ir más rápido sin sacrificar calidad. Si quieres comparar Codex con la alternativa principal del mercado, mira Codex vs Claude Code. Y si lo que buscas es un equipo que ya domine estas herramientas para tu proyecto, conversamos. Sin humo.