Si quieres que Codex CLI entienda tu proyecto desde el primer comando, necesitas algo más que un README: necesitas instalarlo bien, elegir el modelo correcto y darle una guía clara con un archivo agents.md. Aquí aprendes a montar ese flujo paso a paso para que tu asistente de IA trabaje rápido y con contexto real.

¿Cómo se instala Codex CLI en tu computador?

La instalación arranca en la página oficial de Codex CLI, donde encuentras dos rutas según tu sistema operativo.

• NPM, si trabajas con Node.js en cualquier sistema.
• Homebrew, si usas Mac y prefieres el gestor de paquetes nativo.
• API key, como alternativa al inicio de sesión con cuenta.

Una vez copies el comando que se ajusta a tu equipo, lo pegas en la terminal y dejas que el instalador haga lo suyo [00:32]. Después creas tu espacio de trabajo con mkdir proyecto, entras a esa carpeta y abres Codex desde ahí.

¿Necesito una cuenta paga para usar Codex? No siempre. Puedes iniciar sesión con tu cuenta de ChatGPT existente, reutilizar una sesión de otro dispositivo o autenticarte con tu API key. La licencia que uses define los modelos disponibles.

La primera vez que abres Codex, te pide permiso para acceder a la carpeta actual. Aceptas y entras a la interfaz principal de trabajo.

¿Qué modelo y nivel de reasoning conviene elegir?

Antes de pedirle algo a Codex, revisa dos cosas: el modelo activo y el directorio de trabajo. Para cambiar el modelo escribes /model y se despliega la lista disponible [02:15].

Los modelos están organizados por reasoning level, que define qué tan profundo razona la IA antes de responder:

• Bajo: respuestas rápidas, ideal para tareas simples.
• Medio: balance entre velocidad y razonamiento, recomendado para la mayoría de casos.
• Alto: máxima capacidad de análisis, pero más lento.

Para un flujo de desarrollo cotidiano, el nivel medium es la mejor apuesta. Te da capacidad de razonamiento sin que cada respuesta tarde una eternidad.

¿Cómo clonar un repositorio directamente desde Codex?

En lugar de descargar manualmente un repositorio, se lo pides a Codex con la URL. El modelo intenta verificar el directorio y ejecutar el clonado, pero la primera vez fallará por falta de permisos.

Y aquí viene un detalle clave: Codex no ejecuta comandos sensibles sin tu aprobación explícita. Puedes revisar qué comando quiere correr, entender el impacto y decidir si lo apruebas. Una vez das luz verde, el repositorio se clona sin problema [04:10].

Después le pides que entre al repositorio y te explique de qué trata. Codex inspecciona los archivos principales (README, estructura, metadatos) y devuelve un resumen del proyecto, su propósito y el stack tecnológico objetivo.

¿Qué pasa si el repo solo tiene un README? Codex lo lee rápido y entiende lo básico. El problema aparece cuando el proyecto crece: muchas carpetas, servicios y configuraciones obligan al modelo a invertir tiempo descubriendo qué es importante.

¿Qué es el archivo agents.md y por qué importa?

El agents.md es el manual interno que Codex consulta antes de cualquier tarea. Funciona como una guía donde defines:

• Qué hace el proyecto y cuál es su objetivo.
• Qué tecnologías y dependencias usa.
• Qué reglas debe seguir al modificar archivos.
• Qué consideraciones tener antes de responder o ejecutar comandos.

Para generarlo usas el comando /init dentro de Codex [05:48]. El sistema crea automáticamente un prompt que vuelve a leer el historial del repositorio y produce el archivo como guía de contribución.

¿Cómo cambiar el idioma del agents.md?

Por defecto, Codex genera el archivo en inglés. Si trabajas en español, simplemente le pides: "Quiero que este archivo esté en español". El modelo traduce manteniendo la misma estructura, tono instructivo y longitud original.

¿Cómo se nota la diferencia con agents.md activo?

La prueba real está en cerrar la terminal, abrirla de nuevo desde la carpeta del repositorio y volver a preguntar de qué trata el proyecto. Con el agents.md ya creado, Codex responde casi de forma instantánea, porque lee la guía por debajo en lugar de explorar todo el repositorio desde cero [07:30].

¿Cuál es el flujo completo para empezar con Codex?

Con estos pasos ya tienes tu primer flujo profesional con Codex CLI funcionando. Cada vez que arrancas un proyecto nuevo, repites esta secuencia:

1. Instala Codex CLI con NPM o Homebrew según tu sistema.
2. Crea la carpeta de trabajo y abre Codex dentro de ella.
3. Selecciona el modelo y ajusta el reasoning level a medium.
4. Clona el repositorio aprobando los permisos cuando se soliciten.
5. Genera el agents.md con /init y tradúcelo si es necesario.

El ejemplo del curso usa un proyecto llamado AI Radar, un sistema para registrar cambios en inteligencia artificial con dos modos previstos: lector y operador. Es un buen caso para practicar porque parte de un README mínimo y crece con cada interacción.

¿Ya probaste configurar tu primer agents.md? Cuéntame en los comentarios qué reglas le agregaste a tu proyecto.