Tu primera tarea con Codex
En esta página
Actualizado el 3 de noviembre de 2026 según la referencia de comandos de Codex (CLI 0.166.0): las opciones
--show-diffy--applyno existen. Localmente, Codex modifica los archivos directamente dentro de su entorno aislado (sandbox); revisa los cambios usando/diffogit diff. El comando de extensión “Codex: New Task” ha sido reemplazado por Codex: Open Codex Sidebar. Fuentes: Developer commands · Codex IDE extension.
Lanza tu primera tarea
Tu cuenta está configurada, GitHub conectado y el archivo AGENTS.md en su sitio: es hora de ver al agente en acción. Aquí tienes una regla de oro para cualquier nivel de habilidad: empieza con una tarea cuya respuesta correcta ya conozcas. No aprenderás mucho viendo a Codex resolver un problema que no puedes evaluar, pero aprenderás una cantidad enorme observándolo operar en terreno familiar.
Desde Codex Cloud
En la web o en la aplicación de escritorio, elige Work in › Cloud, selecciona el entorno publicado para tu repositorio (Lección 2) e introduce tu tarea en el campo de entrada. Algo deliberadamente modesto funciona perfectamente.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Esta redacción incluye una condición —«if one doesn’t already exist»—, que es exactamente lo que hace interesante su observación. En Codex Cloud, la tarea se ejecuta en el entorno que publicaste para este repositorio: Codex comprueba si existe un .gitignore, verifica que cubra Node.js y TypeScript si es así, crea o actualiza el archivo según sea necesario y, a continuación, te muestra el resultado como un diff. El registro de ejecución se transmite en tiempo real: aquí es donde verás si el agente respetó la condición o sobrescribió tu archivo existente.
Desde el IDE
Abre tu proyecto en VS Code (o Cursor, Windsurf) y lanza Codex mediante su icono o la paleta de comandos:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
A continuación, formula una solicitud que aproveche el contexto local nombrando el archivo específico:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
La extensión muestra un resumen y las líneas modificadas junto al código; conservas los cambios que deseas y solicitas seguimientos dentro de la misma conversación. La documentación recomienda crear un punto de control de Git antes y después de la tarea para poder revertir los cambios si fuera necesario.
Desde la CLI
# Navigate to the project directory
cd my-project
# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"
Localmente, Codex modifica los archivos directamente en tu directorio de trabajo, dentro de los límites del entorno aislado y la política de aprobación: solicita permiso antes de realizar acciones que lo requieran. Para revisar qué ha cambiado antes de hacer un commit, escribe /diff en la sesión: el comando muestra el diff de Git, incluidos los archivos no rastreados. /review pide a Codex que revise tu árbol de trabajo. Para usos automatizados, codex exec ejecuta la misma tarea sin interacción (Lección 14); en ese caso, corresponde a Git y a tu pipeline decidir qué se conserva.
Anatomía de un resultado de Codex
Independientemente del punto de entrada, una tarea completada devuelve siempre los mismos cuatro elementos. Revísalos en este orden: el diff indica qué ha cambiado, el registro explica por qué, las pruebas dicen si es seguro y las acciones te devuelven el control.
| Elemento entregado | Qué contiene |
|---|---|
| Change diff | Cada línea añadida, modificada o eliminada, archivo por archivo |
| Execution log | Todos los pasos: archivos leídos, comandos ejecutados, razonamiento del agente |
| Test results | Si existen pruebas, Codex las ejecuta para verificar que nada se ha roto |
| Available actions | Aprobar, modificar, crear una PR o volver a ejecutar con instrucciones diferentes |
Los principiantes suelen pasar por alto el registro de ejecución, pero es el elemento que te enseña a formular tus tareas. Al ver qué archivos abrió Codex antes de tomar una decisión, descubres qué estaba buscando pero no pudo encontrar; a menudo, una convención que debería haber estado en AGENTS.md.
Redacción de buenas instrucciones
La calidad del resultado depende directamente de la calidad de la instrucción, y la brecha entre las dos formulaciones siguientes es mucho mayor que la brecha entre dos modelos.
"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling
with the jose library. Keep the same public interface
(signToken, verifyToken). Update the corresponding tests."
La segunda versión funciona porque responde a cuatro preguntas que el agente se hace de todos modos. Especifica los archivos implicados, ahorrándole explorar y apuntar a la ubicación incorrecta. Define el resultado esperado —comportamiento, interfaz, formato— para que sepa cuándo detenerse. Establece restricciones, aquí preservando la interfaz pública, lo que le impide «mejorar» cosas rompiendo a quienes las llaman; en otros contextos podría ser «no romper las pruebas». Y cuando la importancia lo justifica, añade contexto de negocio: especificar «esto es un formulario de pago, la seguridad es crítica» cambia genuinamente sus compensaciones.
Para hacerlo tuyo, toma un proyecto existente y encadena tres tareas de naturaleza diferente: un análisis sin modificación, «List all TypeScript files that lack associated tests»; una generación dirigida, «Generate a unit test for this file»; una corrección de alcance limitado, «Fix ESLint warnings in src/utils/». Para cada una, anota qué deberías haber especificado desde el principio: esta lista de lamentaciones es tu primer borrador de AGENTS.md.
Puntos clave
- Lanza tus primeras tareas con solicitudes simples y dirigidas
- Codex proporciona un registro de ejecución completo para cada tarea
- La calidad del resultado depende de la precisión de tus instrucciones
- Siempre mantienes el control: aprueba, modifica o rechaza
- Empieza con tareas de bajo riesgo antes de pasar a cambios críticos