Cómo usar Codex de OpenAI: de la primera tarea a un resultado comprobado

Codex es el agente de programación de OpenAI. Puede examinar un proyecto, modificar archivos y ejecutar comprobaciones con las herramientas disponibles. Tú describes el resultado que necesitas y después revisas los cambios. Comprueba que la función nueva hace lo esperado, que los datos son correctos y que el resto del proyecto sigue funcionando.

En este ejercicio crearemos una calculadora del precio de un taller. Podrás comprobar sus resultados a mano, sin saber programar. Las tarifas son ficticias: sustitúyelas por datos reales antes de usarla en un negocio.

Qué puedes encargar a Codex

Empieza con una tarea cuyo resultado puedas reconocer. Calcular un importe con una fórmula concreta es fácil de verificar. Una petición como «mejora mi web» deja demasiadas decisiones sin resolver.

• Añadir una calculadora, un filtro de catálogo o el índice de un artículo.
• Averiguar por qué falla un botón o un formulario acepta datos incorrectos.
• Localizar los textos de una web y explicar cómo poner en marcha el proyecto.
• Escribir un programa para revisar enlaces o limpiar una exportación. Pruébalo primero con una copia de los datos.

Una conversación puede bastar para comentar una idea o corregir un párrafo. Codex resulta útil cuando necesitas cambios en los archivos del proyecto. El acceso depende del entorno, las herramientas y los permisos disponibles.

Aplicación, editor o terminal: por dónde empezar

Si es tu primer contacto con el código, empieza por la aplicación. La guía oficial actual indica que debes instalar la aplicación de escritorio de ChatGPT, seleccionar Codex en el menú de productos y abrir la carpeta del proyecto. Las capturas antiguas pueden mostrar una interfaz distinta.

• Instalación y primeros pasos oficiales

• Aplicación de escritorio: para gestionar la tarea y trabajar con archivos locales.
• Extensión del editor: si ya utilizas un editor de código compatible y quieres revisar los cambios junto al código.
• Codex CLI: para trabajar desde el terminal. No hace falta para este ejercicio.

• Instalar Codex en un editor compatible

• Fuente de la imagen: documentación oficial de OpenAI

• Instalar y abrir Codex CLI

¿Hace falta una suscripción de pago?

En la fecha de revisión, OpenAI incluye acceso a Codex en los planes de ChatGPT, también en Free. Hay límites de uso y los modelos disponibles dependen del plan. El acceso mediante una clave API tiene una facturación aparte.

Prueba varias tareas con tu cuenta antes de contratar un plan superior. Consulta los precios y límites vigentes en OpenAI: una cifra publicada en una guía puede quedarse desactualizada.

• Planes y límites de Codex

Primer proyecto: una calculadora de precios

Prepara la carpeta y los datos

Crea una carpeta llamada workshop-calculator y ábrela como proyecto. Si vas a probar cambios en una web existente, guarda antes su estado en Git o haz una copia de la carpeta. Para el ejercicio necesitas una tarifa base, un precio por participante y un tamaño de grupo permitido.

Revisa la carpeta elegida y los permisos. Basta con permitir cambios dentro del proyecto. Si Codex pide instalar programas o usar un servicio externo, comprueba el motivo: el encargo siguiente no requiere dependencias externas.

• Permisos y controles de acceso

Indica las reglas y los resultados esperados

Crea en esta carpeta una calculadora del precio de un taller.

Tarifas ficticias: 120 € de base y 35 € por participante.
Admite solo números enteros de 1 a 12 participantes.
Total = 120 + 35 × participantes.

Incluye un campo para la cantidad, el total y la explicación de la fórmula.
Muestra un error claro si el campo está vacío o contiene una fracción, 0 o 13.
Oculta el total anterior cuando el valor no sea válido.

Usa HTML, CSS y JavaScript sin bibliotecas externas.
Guarda la página como index.html. Debe abrirse sin servidor ni internet
y funcionar en el móvil y con teclado.
No añadas pagos, recogida de contactos, analítica ni reseñas inventadas.

Comprueba: 1 participante = 155 €, 4 = 260 €, 12 = 540 €.
Explica cómo abrirla, qué has comprobado y qué queda por revisar a mano.

• Abrir la calculadora de ejemplo y probar los valores

Abre la página y comprueba los cálculos

Abre index.html en el navegador y prueba 1, 4 y 12. Después borra el campo: el importe anterior no debe seguir apareciendo como válido. El informe de Codex te orienta, pero no sustituye esta prueba.

1. Introduce 0, 13, un decimal y un campo vacío. El mensaje debe explicar qué corregir.
2. Reduce el ancho de la ventana hasta un tamaño de móvil. No debería hacer falta desplazarse horizontalmente.
3. Muévete entre los controles con Tab. Un borde u otra señal debe indicar cuál está seleccionado, y la calculadora debe poder utilizarse sin ratón.
4. Recarga y calcula de nuevo para comprobar que los datos anteriores no afectan al resultado.

Tienes un prototipo local, todavía sin enlace público. Si más adelante lo conectas a un pago, el servidor deberá validar el precio por separado: el visitante puede alterar los cálculos que se ejecutan en su navegador.

Cómo pedir una corrección concreta

Cuenta qué hiciste, qué ocurrió y qué esperabas. Por ejemplo:

Introduzco 4 y veo 260 €. Borro el campo, pero el total sigue ahí.
Si el campo está vacío, muestra «Introduce el número de participantes»
y oculta el total. Conserva la fórmula, el rango 1–12 y el diseño.
Prueba 4 → vacío → 1 y 12 → 13 → 12.
Explica la causa y cómo has comprobado la solución.

Continúa en la misma tarea hasta dar por buena la calculadora. Si una corrección rompe algo, compara los archivos con la versión guardada. Pedir que vuelva al estado anterior no garantiza recuperarlo exactamente si no existe un historial.

Cómo trabajar en una web existente

Pide a Codex que examine primero la parte del proyecto que vas a modificar. Una web existente puede tener componentes reutilizables, estilos y comprobaciones que no se ven en una captura. Conviene conocerlos antes de cambiar los archivos.

Averigua cómo se generan los artículos de este blog. No cambies archivos.
Explica de dónde salen los títulos, textos, metadatos y enlaces de idioma.
Indica qué archivos habría que modificar para añadir un artículo
y qué comandos de comprobación existen.

Después encarga un cambio acotado. Adaptar la calculadora al diseño de la web y añadir pagos son trabajos distintos, con criterios de aceptación diferentes.

Guarda las reglas en AGENTS.md

Codex lee las instrucciones de AGENTS.md antes de trabajar. Utilízalo para requisitos estables: cómo abrir el proyecto, de dónde obtener el contenido y qué comprobar.

# Reglas del proyecto

Calculadora de talleres. Los precios son ficticios.
Abrir index.html sin servidor ni bibliotecas externas.
Cambiar la fórmula o el rango solo si se pide expresamente.
Ocultar el total cuando el valor no sea válido.
Probar 1, 4, 12, 0, 13, un decimal y el campo vacío tras cada cambio.
Distinguir las pruebas realizadas de las que no se han podido ejecutar.

Deja las peticiones puntuales en la conversación. Actualiza las reglas cuando cambien los requisitos para evitar que una instrucción antigua condicione tareas nuevas.

• Cómo encuentra y aplica Codex los archivos AGENTS.md

Problemas habituales y siguientes pasos

• Hay un plan, pero no archivos: revisa el proyecto y los permisos de escritura; pide que implemente el cambio.
• El proyecto no arranca: facilita el error exacto y cómo lo abriste antes de pedir cambios en las dependencias.
• Solo funciona un ejemplo: añade valores límite y entradas incorrectas.
• Aparecen datos inventados: señala la fuente correcta y pide revisar los demás textos.
• Se agota el límite: conserva los archivos y consulta en tu cuenta cuándo puedes continuar.

Antes de publicar, revisa también textos, enlaces, formularios y ajustes de búsqueda. Estos artículos te ayudarán con los siguientes pasos:

• SEO y GEO: qué aporta cada uno

• llms.txt: cómo organizar el acceso al contenido

Información del producto y documentación revisadas el 6 de septiembre de 2026. La calculadora es un ejercicio, no un caso de cliente ni una promesa de terminar con una sola petición.