Codex de OpenAI, una inteligencia de programación basada en la nube para ingenieros de software, está cambiando el flujo de trabajo diario de los desarrolladores. Este tutorial te ayudará a configurar, utilizar y dominar las funciones de Codex para que tu desarrollo sea más eficiente.

Guía rápida de instalación

Para empezar a utilizar Codex, debe completar una serie de autorizaciones de cuenta y configuraciones de entorno. A continuación se detalla el proceso de configuración:

Privilegios de cuenta y requisitos previos

Actualmente (mayo de 2025), el Códice sólo está disponible para los siguientes usuarios:

• Usuarios de ChatGPT Pro (200 $ al mes)
• Usuarios de ChatGPT Enterprise
• Usuarios del equipo ChatGPT

Nota: Se espera que los usuarios de ChatGPT Plus y Edu tengan acceso a esta función en breve.

Pasos detallados de la configuración

• Acceso a la entrada del Códice
  • Acceda a su cuenta ChatGPT
  • Busque la opción Códice en la barra lateral
  • Al hacer clic en él, accederá a la página de solicitud del Codex.

• Activación de la autenticación multifactor (AMF)
  • Codex requiere que su cuenta esté habilitada para MFA.
  • Puede utilizar cualquier aplicación de autenticación como Google Authenticator, OnePass, etc.
  • Se trata de una medida de seguridad, ya que Codex tendrá acceso a sus repositorios de GitHub.

• Asociación de cuentas de GitHub
  • Conceder acceso Codex a su cuenta GitHub
  • Seleccione los derechos de acceso de la organización (si corresponde a su situación)
  • Establecer el alcance de los derechos de acceso (sólo lectura o lectura-escritura)
  • Nota: Codex podrá crear PRs si concede permisos de lectura y escritura.

• Configuración del uso de datos
  • Durante el proceso de configuración, habrá una opción de autorización de datos
  • Por defecto, Codex utilizará su código para la formación
  • Si no desea que su código se utilice para la formación, deberá desmarcar manualmente la casilla

Una vez que haya completado los pasos anteriores, estará listo para empezar a seleccionar repositorios de código y utilizar Codex. Todo el proceso de configuración está diseñado para ser muy intuitivo y fácil de completar, incluso para los desarrolladores novatos.

Interfaz y funcionamiento básico

Una vez que haya configurado correctamente su Codex, se le presentará una interfaz de usuario intuitiva, así que vamos a aprender a hacer lo básico.

Vista general de la interfaz principal

La interfaz principal del Codex contiene los siguientes elementos clave:

• Selector de repositorio: cambiar entre diferentes repositorios de GitHub
• Lista de tareas: muestra las tareas actuales e históricas
• Selector de tipo de tarea: para seleccionar el modo Pregunta o Código.
• Casilla de entrada de la tarea: introduzca una descripción de la tarea que desea realizar

Dos modelos de misión fundamentales

Codex ofrece dos modos de funcionamiento diferentes, cada uno adecuado para distintos escenarios:

1. Modo pregunta
   • Para consultar y comprender el código base
   • No se modificará ningún código
   • Ideal para comprender la estructura de un proyecto, buscar explicaciones o explorar la base de código.
   • Ejemplo: Pregunte por el total de líneas de código del proyecto, análisis de la estructura del código, etc.
2. Modo código
   • Para realizar tareas reales de modificación del código
   • El código se modificará y los cambios se generarán en un entorno en la nube
   • Sirve para corregir errores, añadir funciones, refactorizar código, etc.
   • Permite crear Pull Requests para confirmar cambios

Crear y gestionar tareas

Para crear una nueva tarea, los pasos son los siguientes:

1. Seleccione el tipo de tarea (Preguntar o Codificar)
2. Describa su tarea en el cuadro de entrada
3. Si es la primera vez que lo utiliza, puede hacer clic directamente en las tareas de ejemplo preestablecidas
4. Haga clic en el botón "Iniciar tarea" para enviar la tarea.

Tras el envío, Codex comenzará a procesar su tarea y mostrará el progreso en tiempo real. Cada tarea se gestiona en una página independiente y puede ejecutar varias tareas en paralelo.

Ver los resultados de las tareas

Una vez finalizada la tarea, verá los resultados detallados de la ejecución:

• Para el modo Preguntar: obtener respuestas detalladas a las preguntas
• Para el modo Código: ver los cambios de código, la salida del terminal y los resultados de las pruebas.

Para las tareas del Código, aún puedes:

• Crear un PR en GitHub: Enviar cambios al repositorio como PR
• Solicitud de nuevas modificaciones: comentarios para que el Codex adapte su solución
• Ver registros de ejecución detallados y la cadena de pruebas

Proceso completo de presentación y ejecución de tareas

Veamos un ejemplo real de cómo utilizar Codex para una sencilla tarea de corrección de código.

Elegir el almacén adecuado

En primer lugar, elige un repositorio de GitHub con el que estés familiarizado desde la interfaz principal de Codex. Lo ideal es elegir:

• Proyectos bien documentados
• Elementos incluidos para las pruebas
• Estructura de dependencia simple

Esto facilita la comprensión y la realización de las tareas del Codex.

Enviar una tarea codificada

1. Selección del modo "Código
2. Introdúzcalo en la descripción de la tarea: Explicar el código base a los novatos. Cuál es la estructura general, cuáles son las cosas importantes que hay que saber y cuáles son los siguientes puntos clave que hay que aprender.
3. Haga clic en el botón "Iniciar tarea".

Seguimiento del progreso de las tareas

Después de enviar una tarea, puede ver cómo trabaja Codex en tiempo real:

• Codex analiza primero la estructura de la base de código
• A continuación, busque los archivos en el directorio especificado
• Comprobación de problemas ortográficos y gramaticales en el código
• Aplicar correcciones y realizar pruebas para verificar

Todo el proceso puede durar varios minutos, dependiendo del tamaño y la complejidad de la base de código.

Revisión de los resultados y creación de relaciones públicas

Una vez completada la tarea, verás los resultados del trabajo de Codex:

• Qué documentos se han modificado
• Qué se ha arreglado exactamente
• Prueba superada

Si estás satisfecho con los resultados, puedes hacer clic en el botón "Create PR" y Codex creará automáticamente una Pull Request con los cambios, y luego puedes volver a GitHub y seguir el proceso habitual de revisión y fusión de la PR.

Con este sencillo ejemplo, puede ver cómo Codex puede integrarse perfectamente en su flujo de trabajo de desarrollo para ayudarle con las tareas de codificación cotidianas.

Consejos de uso avanzados

Para aprovechar todo el potencial del Codex, es importante contar con algunos consejos avanzados y buenas prácticas.

Palabra clave ingeniería

Redactar descripciones de tareas (prompts) de alta calidad es la clave para aprovechar al máximo el Codex. He aquí algunos consejos prácticos:

Optimización de la asignación de proyectos

Para que el Codex funcione con mayor eficacia, puede añadir información auxiliar a su proyecto:

Añada el archivo AGENTS.md

En el directorio raíz del proyecto, cree el archivo AGENTES.md documento que proporciona orientaciones de proyecto para las inteligencias AI, incluyendo:

• Descripción de la estructura del proyecto
• Normas de codificación y guías de estilo
• Método de ensayo
• Normas de creación de relaciones públicas
• Descripción del proceso de desarrollo

Ejemplo de contenido de AGENTS.md:

## Estructura del proyecto
- src/api: Definición del punto final de la API
- src/components: Componentes React
- src/utils: Funciones genéricas de utilidad

## Guía de pruebas
- Ejecuta `npm test` para ejecutar todas las pruebas.
- Cada característica debe tener pruebas unitarias

## Especificación PR
- Formato del título: [Módulo] Breve descripción
- Debe superar todas las pruebas y comprobaciones de lint

Limitaciones y precauciones medioambientales

El uso del Codex está sujeto a las siguientes restricciones:

1. Sin acceso a Internet
   • Codex Runtime Environment no puede acceder a la red externa
   • No se pueden instalar nuevos paquetes de dependencias (p. ej. npm instalar (No válido)
   • Utiliza sólo el código y las dependencias preinstaladas que ya estén en el proyecto.
2. Configuración del entorno
   • Los scripts de entorno pueden personalizarse mediante ajustes avanzados
   • Las dependencias y entornos necesarios deben estar preconfigurados.
3. aislamiento de tareas
   • Cada tarea se ejecuta en un entorno independiente y no comparte estado
   • No hay interacción directa entre varias tareas

Escenarios de aplicación y casos prácticos

En función de las necesidades reales de desarrollo, Codex puede proporcionar una ayuda eficaz en diversos escenarios. A continuación se presentan algunos casos de uso típicos y los métodos de diseño de tareas correspondientes.

Revisión y optimización del código

Descripción de la escenaComprobar la calidad del código y proponer mejoras

Formato del mandato::

Revisa el archivo src/components/UserProfile.tsx para analizar posibles problemas de rendimiento y sugerir mejoras. Presta especial atención al riesgo de renderizaciones innecesarias y fugas de memoria.

Puntos de aplicación::

• Solicitud de recomendaciones concretas y aplicables en lugar de generalidades
• Especificar las preocupaciones (por ejemplo, rendimiento, seguridad, mantenibilidad)
• Exigencia de pruebas o explicaciones, no sólo conclusiones

Diagnóstico y reparación de fallos complejos

Descripción de la escena: Reparación de errores condicionales difíciles de reproducir

Formato del mandato::

Ocasionalmente se produce el siguiente error cuando un usuario modifica varios campos al mismo tiempo y los guarda rápidamente:
TypeError: Cannot read properties of undefined (leyendo 'email')
en validateUserInput (/app/src/utils/validation.ts:41)

Por favor, analice las posibles causas y solucione este problema para garantizar que funcione incluso en condiciones de competencia para operaciones asíncronas.

Puntos de aplicación::

• Proporcionar información completa sobre la pila de errores
• Describa las situaciones y condiciones específicas en las que se produjo el error
• Aclarar los criterios de aceptación de la restauración (por ejemplo, qué pruebas deben superarse).

Programación de áreas especializadas

Descripción de la escenageneración de código para ámbitos específicos (por ejemplo, lenguajes de descripción de hardware)

Formato del mandato::

Diseñe un módulo Verilog para un procesador RISC de 8 bits que contenga los siguientes conjuntos de instrucciones: ADD, SUB, AND, OR, XOR, LOAD, STORE, JUMP. asegúrese de que la temporización es correcta y sintetizable.

Puntos de aplicación::

• Proporcionar especificaciones técnicas claras
• Especifique el método de verificación (por ejemplo, prueba de simulación)
• Los requisitos se ajustan a las prácticas habituales del sector

Generación automatizada de pruebas

Descripción de la escenaCrear conjuntos de pruebas para las nuevas funciones implementadas

Formato del mandato::

Genera pruebas unitarias para todos los métodos públicos del archivo src/services/authentication.js. Asegúrate de que las pruebas incluyen rutas normales, gestión de errores y casos extremos. Utiliza el marco de pruebas Jest y los estilos de prueba que ya están en el proyecto.

Puntos de aplicación::

• Aclarar el marco de pruebas y los requisitos de estilo
• Especifique el método o la función que se va a probar
• Requisitos para cubrir diferentes tipos de escenarios de pruebas

Resumen de consejos prácticos

Según los comentarios de los desarrolladores que utilizan Codex sobre el terreno, las siguientes prácticas pueden mejorar significativamente la eficacia:

1. procesamiento de lotes de tareas
   • Enviar un pequeño lote de tareas cada mañana para que Codex las procese en paralelo.
   • Vuelve y revisa los resultados directamente en lugar de esperar a cada tarea
2. Tareas progresivas
   • Dejemos que Codex analice primero el problema.
   • Perfeccionamiento de las tareas de seguimiento en función de los resultados del análisis
   • Soluciones paso a paso
3. Desarrollo exploratorio
   • Deje que el Codex pruebe varias soluciones a la vez
   • Comparar las ventajas e inconvenientes de los distintos programas
   • Selección del mejor programa para su aplicación
4. Integración con los flujos de trabajo del equipo
   • Hacer que el Codex revise el código antes que el RP
   • Utilizar el Codex para generar la documentación inicial y luego perfeccionarla manualmente.
   • Deje que Codex se encargue de las tareas rutinarias de mantenimiento, como actualizaciones de dependencias, ajustes de estilo, etc.

Con estos ejemplos prácticos y consejos, podrá integrar eficazmente Codex en su proceso de desarrollo diario, convirtiéndolo en su asistente de programación, encargándose de las tareas tediosas y mejorando la eficacia general del desarrollo.