Codex para principiantes: empieza con una tarea comprobable

Si estás empezando con Codex, elige un cambio pequeño cuyo resultado puedas comprobar. No hace falta comenzar con una aplicación completa ni pedirle al agente que “mejore el proyecto”. Una primera tarea útil tiene tres partes: qué quieres cambiar, qué debe seguir funcionando y cómo sabrás si el resultado es correcto.

OpenAI describe Codex como un agente de programación que puede trabajar con código y proyectos según el producto, la configuración y los permisos disponibles. Antes de dar acceso a un repositorio, abre un proyecto de prueba o una copia que puedas recuperar. Lee las instrucciones oficiales actuales de Codex para la superficie que uses; la interfaz y los controles pueden variar.

Elige una petición pequeña

Puedes empezar con una tarea como: “En esta página, cambia el texto del botón ‘Enviar’ a ‘Guardar’. No cambies su comportamiento. Busca otros usos de este botón y dime qué archivo editarías antes de hacer cambios”. La petición tiene un objetivo visible y un límite. También invita al agente a explicar qué encontró antes de modificar nada.

Si el proyecto ya tiene reglas en AGENTS.md, pide a Codex que las consulte y sigue las convenciones del repositorio. No supongas que el agente conoce por sí solo qué archivos son generados, qué comando ejecuta las pruebas o qué parte del proyecto no debe tocarse. El contexto útil suele estar en los propios archivos del proyecto.

Sigue un ciclo corto

1. Describe el resultado. Escribe qué debería ver o poder hacer una persona después del cambio. Evita instrucciones vagas como “hazlo más bonito” si no sabes todavía qué significa eso.

2. Pide que explore. Solicita que localice el código relevante y explique los archivos que probablemente tendrá que modificar. Corrige una suposición equivocada antes de permitir una edición amplia.

3. Revisa el cambio. Cuando Codex termine, examina el diff: qué archivos cambiaron, qué líneas nuevas aparecen y si hay ediciones ajenas a la tarea. Pídele una explicación de cualquier fragmento que no entiendas.

4. Comprueba el comportamiento. Si existe una prueba específica, ejecútala. También abre la interfaz o reproduce manualmente el caso. Confirma que el texto cambió y que el botón todavía hace lo esperado. Que el agente diga “terminado” no demuestra por sí solo que todo funciona.

5. Aprende del error con un ejemplo. Si algo falla, describe el resultado esperado y el observado. “El botón está roto” es difícil de diagnosticar. “El texto cambió, pero al pulsar ya no se guarda el formulario” aporta un caso que el agente puede investigar.

Ejemplo: cambiar una etiqueta sin romper el uso

Imagina que un formulario muestra “Enviar” aunque la acción realmente guarda un borrador. Pide cambiar la etiqueta a “Guardar borrador” y conservar el comportamiento actual. Después confirma que solo se modificó el texto previsto. Abre el formulario, introduce un dato de prueba y pulsa el botón. Si el borrador no se guarda, registra el paso exacto y pide revisar el comportamiento; no asumas que la etiqueta era el único código relacionado.

Empieza con un proyecto sin datos privados. No incluyas contraseñas, claves ni información personal en una petición. Si Codex propone comandos o cambios que no entiendes, pregunta qué hacen antes de aceptarlos. Mantén una copia o una rama para poder comparar el estado anterior y volver atrás si el resultado se aparta de lo pedido.

Preguntas frecuentes

¿Necesito saber programar para empezar? Ayuda tener curiosidad y poder describir qué resultado esperas. Aun así, debes revisar el cambio y pedir explicaciones cuando no comprendas una decisión.

¿Puedo pedirle una aplicación completa? Puedes formular una meta grande, pero dividirla en pasos observables facilita revisar cada parte. Empieza con una acción pequeña y amplía el alcance cuando el ciclo de cambio y comprobación te resulte claro.