Cómo crear un sistema con IA usando Codex

Esta guía usa Codex para crear una primera versión testeable, sin tratar el código generado como automáticamente correcto.

En este artículo vas a ver:

• Cómo elegir una primera funcionalidad que se pueda probar.
• Cómo pedirle a Codex que entienda el repositorio antes de editar.
• Cómo revisar la implementación, las pruebas y los permisos.
• Cuándo un prototipo visual necesita convertirse en un sistema con código propio.

Cómo crear un sistema con IA empieza por el flujo de usuario

Elige una tarea que alguien necesite completar de punta a punta, como registrar una solicitud y hacer seguimiento del estado. La primera versión debe resolver ese flujo, no reunir todas las ideas para el producto final.

Escribe en una frase quién usa el sistema, qué informa y qué resultado espera. Luego lista los casos que cambian el comportamiento, como un campo inválido, un usuario sin permiso o una búsqueda sin resultados.

La ruta oficial de entrenamiento de OpenAI divide el trabajo en ejercicios cortos. El módulo “Make your first code change” está estimado en 15 a 25 minutos, tiempo de aprendizaje del ejercicio, no una promesa de plazo para entregar un sistema.

Antes de empezar, prepara el repositorio y los criterios

Abre el proyecto en Codex y confirma que los archivos están guardados. Si aún no hay sistema, crea un proyecto mínimo en Git para revisar o revertir cada etapa.

Prepara una nota breve con objetivo, usuarios, reglas, pantallas y criterios de aceptación. Incluye los comandos de prueba que el proyecto ya usa, si existen, y los límites que el agente no debe superar.

No coloques contraseñas, claves de API, datos personales reales o credenciales de producción en el prompt. Usa datos de prueba y sigue las reglas de acceso de tu proyecto.

Paso 1: pídele a Codex que entienda antes de editar

Pídele a Codex que lea el repositorio, identifique la tecnología y resuma el flujo actual, sin editar archivos.

Compara la explicación con lo que sabes del proyecto. Si el agente no localiza el punto de entrada, las pruebas o la regla de negocio, corrige el contexto antes de pedir código.

Ese primer diagnóstico reduce el riesgo de una implementación basada en suposiciones. Si el sistema es nuevo, pide un plan de archivos y componentes antes de aceptar la creación del esqueleto.

Paso 2: transforma la funcionalidad en una tarea pequeña

En lugar de “crea mi sistema”, pide una entrega verificable, como “agrega un formulario de solicitud con título, responsable y plazo, valida campos obligatorios y muestra los ítems en la lista existente”.

Define también lo que no debe cambiar: “Mantén la estructura actual, explica nuevas dependencias y no alteres autenticación o base de datos sin necesidad”.

Pídele a Codex un plan breve con los archivos que pretende tocar y las pruebas que pretende ejecutar. Lee el plan y ajusta el alcance antes de liberar la implementación.

Paso 3: implementa una rebanada vertical

Una rebanada vertical conecta pantalla, regla de negocio y almacenamiento para completar una tarea. Puede ser pequeña, pero necesita funcionar de punta a punta.

Después de aprobar el plan, pide un cambio a la vez. Para un formulario, esto puede significar primero validar los campos, luego guardar un registro y por fin mostrar el estado actualizado.

Evita pedir varias áreas del sistema en una sola instrucción. Cambios más pequeños hacen más fácil entender qué cambió Codex y localizar la causa si algo falla.

Paso 4: exige pruebas y lee los resultados

Pide a Codex que localice las pruebas, cubra la nueva regla y ejecute los comandos del proyecto. Las pruebas aprobadas no demuestran seguridad completa, pero ayudan a revelar regresiones.

Revisa también casos negativos: campo vacío, usuario sin permiso, registro inexistente y respuesta de error de una integración. Si no hay pruebas automatizadas, haz una lista corta de verificaciones manuales y ejecuta cada una.

La demostración oficial de OpenAI presenta a Codex como un flujo de trabajo con contexto del proyecto, cambios y revisión. Usa el entrenamiento oficial de Codex como referencia para explorar la interfaz antes de aplicar el proceso en un repositorio real.

Crédito de la imagen: OpenAI. La miniatura es de la presentación oficial de la app Codex.

Paso 5: revisa cada diferencia antes de integrar

Lee el diff y confirma que cada archivo modificado es necesario. Revisa validación, errores y si aparecen datos sensibles en logs o en la interfaz.

Si el agente cambia una dependencia, una configuración o una regla de autorización, pregunta el motivo y compáralo con la documentación del proyecto. No integres un cambio solo porque Codex afirma que terminó.

Cuando otra persona pueda revisar, pide una segunda lectura enfocada en errores de lógica, seguridad y compatibilidad. Para separar tareas paralelas sin mezclar archivos, consulta cómo ejecutar agentes en Git worktrees.

Paso 6: valida la entrega con datos de prueba

Ejecuta las pruebas y prueba el flujo como usuario común. Confirma el camino feliz, los errores esperados y los permisos de cada cuenta.

Solo entonces registra el cambio en Git y prepara la entrega para revisión o publicación. Mantén un resumen de lo que se cambió, qué pruebas pasaron y qué aún necesita decisión humana.

Si quieres validar la idea antes de montar un repositorio, compara este camino con el prototipo de app hecho con ChatGPT Sites. El prototipo ayuda a aprender sobre el flujo; un sistema con código propio ofrece otro nivel de control, pero exige mantenimiento y pruebas.

Cómo evitar los errores más comunes al crear un sistema con IA

Si Codex inventa una regla, detente y proporciona la fuente correcta. Si el cambio es grande, pide dividir el trabajo en etapas más pequeñas y revisar el plan de nuevo.

Si las pruebas fallan, comparte el mensaje de error sin secretos y pide una explicación antes de solicitar la corrección. Confirma que el cambio resuelve la causa, no solo oculta el síntoma.

Si la tarea toca autenticación, permisos o datos reales, mantén la revisión humana obligatoria. Un agente puede acelerar la implementación, pero la responsabilidad por el acceso, la seguridad y la publicación sigue estando con el equipo.