# Instalación y primera sesión Stack agéntico · Builders · Codex · módulo 01 Lectura: ~8 min > Instalas la opción elegida, te autenticas y abres el arnés dentro de un repositorio que ya conoces. La instalación es lo que cambia entre los cinco; los cinco movimientos de una sesión son iguales en todos. Tu entregable es la transcripción de la primera sesión: una pregunta basada en el proyecto, un pequeño cambio aprobado y una salida ordenada. > Diagrama: Todo el módulo en una imagen: cinco vías de instalación que solo difieren en la configuración, todas convergen en el mismo bucle de sesión y en la transcripción de la primera sesión que produce ese bucle. ## lo que vas a poder hacer entregable :: lo que produces ❯ Una instalación funcional y una transcripción de la primera sesión: abre el arnés en un repositorio real, haz una pregunta basada en él, contrástala con el código, aprueba un cambio pequeño y sal. Esa transcripción demuestra que el bucle funciona en tu máquina y que puedes auditarlo. La instalación lleva diez minutos y apenas te enseña nada. Los diez minutos posteriores son todo el módulo. Ahí ejecutas tu primera sesión sobre código que conoces lo bastante para detectar errores del agente, una habilidad que sobrevive a todas estas herramientas. Por eso el módulo se divide. La instalación y el inicio de sesión están en el bloque de tu arnés, más abajo. Lo demás es compartido, porque todos te llevan a lo mismo: una interfaz de texto con línea de estado, campo de entrada y salida en streaming mientras el agente lee, planifica y actúa. Aprende esa estructura una vez y cambiar de arnés costará una tarde, no una semana. > Diagrama: Qué cambia entre arneses y qué permanece igual: tres detalles de configuración en la columna estrecha de la izquierda frente a los cinco movimientos de sesión comunes a todos, dibujados con su tamaño relativo real. Una regla antes de instalar: **trae un repositorio real.** No un hola mundo. Necesitas código que conozcas lo bastante para juzgar la respuesta. Un proyecto de prueba te enseña a confiar en el resultado, el hábito que este módulo quiere evitar. > Diagrama: Por qué el repositorio que traes decide lo que enseña la primera sesión: un proyecto de prueba solo enseña a confiar en el resultado; el código que ya conoces es el único lugar donde puedes detectar que el agente se equivoca. ## Instala y autentica tu arnés Encuentra tu opción. Cada bloque contiene toda la instalación y el inicio de sesión. Los comandos cambian entre versiones: si uno no coincide, toma el comando actual de una línea de la página oficial enlazada. Codex es un producto en CLI, extensiones de IDE y aplicación de escritorio que comparten un archivo de configuración. Instala primero la CLI. Tiene más control y es donde se desarrolla el curso. // bash ``` brew install --cask codex npm install -g @openai/codex ``` Dos vías de inicio de sesión. La de ChatGPT usa tu plan actual y es la predeterminada: ejecuta `codex` y se abrirá el inicio de sesión en el navegador. La clave de API —`OPENAI_API_KEY` en tu shell— sale de los límites del plan y factura con las tarifas estándar de API, así que resérvala para ejecuciones sin interfaz y CI. Elige una por contexto. Así evitas un fallo aburrido y caro: una tarea programada que usa en silencio una clave de API configurada hace meses mientras supones que la cubre la suscripción. Añade la extensión y la aplicación de escritorio cuando uses la CLI sin pensar. Instalar todas las interfaces sin configurar ninguna es el atasco clásico de la primera semana. ## Anatomía de una sesión Llegues como llegues, verás lo mismo. Cinco movimientos impulsan cualquier arnés de este curso: - **Inícialo en un repositorio.** Entra con `cd` y lánzalo. Lee su contexto y te sitúa en el campo de entrada, limitado a ese directorio: la primera propiedad discreta de seguridad que recibes gratis. - **Pide en lenguaje natural.** El agente lee los archivos pertinentes, planifica y actúa. Observas el trabajo en directo, no solo una respuesta final; ahí detectas si lee archivos equivocados. - **Responde a sus preguntas.** Cuando lo exijan tus permisos, explicados en el [módulo 2](/stack/builders/codex/module-02.md), el agente se detiene antes de algo arriesgado. Lee la pregunta y aprueba o rechaza. - **Usa los comandos de control.** Consulta el estado, cambia de modelo, modifica permisos durante la sesión o inicia un contexto nuevo. El [módulo 4](/stack/builders/codex/module-04.md) los explica. Por ahora, `/help` los enumera. - **Sal de forma ordenada.** Tu historial se guarda para poder retomarlo después. > Diagrama: Los cinco movimientos que impulsan cualquier sesión, dibujados como un bucle: iniciar en un repositorio, pedir, responder sus preguntas, usar los comandos de control y salir. Solo el tercer movimiento es tuyo; los otros cuatro son el agente trabajando. Esa es toda la interfaz. El resto del curso dirige el bucle con más precisión: qué puede tocar ([módulo 2](/stack/builders/codex/module-02.md)), qué sabe del proyecto ([módulo 3](/stack/builders/codex/module-03.md)), los atajos que le das ([módulo 4](/stack/builders/codex/module-04.md)) y la configuración subyacente ([módulo 5] (próximamente)). ## Tu primera tarea Abre el arnés en un repositorio real, en solo lectura si lo permite. El [módulo 2](/stack/builders/codex/module-02.md) explica por qué es la opción predeterminada correcta, no un ajuste para principiantes. Después envía esto: // shell ``` Dime en tres frases qué hace este proyecto. Después enumera los tres archivos que debería leer primero para entenderlo y cita, para cada uno, las líneas concretas que te hicieron elegirlo. ``` Esa última cláusula marca la diferencia entre una demostración y una comprobación. Pide un resumen y obtendrás un resumen: fluido, verosímil y a menudo una paráfrasis del README en vez de una lectura del código. Cualquier agente dirigido a texto hace esto. Lee las páginas disponibles y escribe con seguridad; rara vez ejecuta el sistema o comprueba que la fuente respalde la afirmación. Es la forma del fallo, no una puntuación de tu herramienta, y aparece en todas partes: un README antiguo es la fuente más accesible de respuestas erróneas y seguras sobre una base de código, y está donde el agente mira primero. Las líneas citadas cierran la brecha. Una cita existe en tus archivos o no. > Diagrama: La misma pregunta respondida de dos formas: desde el README, con fluidez y sin poder refutarse, o desde el código, donde una cita existe o no. La cláusula que pide citar las líneas es la bifurcación entre ambas. Contrasta la respuesta con lo que sabes. ¿Es correcta, se acerca, omitió el módulo que todo tu equipo sabe que es problemático? ¿Las líneas citadas dicen lo que afirma? Ese juicio es la habilidad que desarrolla el curso, y este es el lugar más barato para practicarla, porque ya conoces la respuesta. **O hazlo tú:** abre los tres archivos que nombró y lee las líneas citadas. Si una cita no está donde dice, has aprendido más que con un resumen correcto. Anota qué arnés lo hizo y ante qué pregunta: te servirá al decidir en qué confiar sin supervisión en el [módulo 9] (próximamente). ## Proponer, aprobar, actuar Ahora, un cambio pequeño con un nivel de permisos operativo: // shell ``` Añade un comentario de una línea al principio del README que describa qué hace este proyecto y muéstrame el diff antes de guardar. ``` Propone, apruebas, escribe. Ese ritmo de proponer-aprobar-actuar es el latido de todas tus sesiones, y los módulos posteriores lo desarrollan. El agente investiga, extrae, redacta, evalúa y da formato con el contexto que le diste. Tú controlas la selección, el juicio y el momento de hacer algo permanente. Esa división se mantuvo en todos los ámbitos detrás de este curso, por eso es aquí la pauta firme. Los módulos posteriores construyen unas pocas excepciones autorizadas de forma expresa: excepciones que diseñas, no un mínimo que vas rebajando sin darte cuenta. Dos cosas hacen real esa división. La compuerta debe estar en tu configuración, no en tu prompt. "Pregúntame antes de hacer un commit" en un archivo de instrucciones es una petición que el modelo suele respetar. Una regla de permisos es un muro que hace fallar la operación, tanto si el modelo quiso preguntar como si no; cuando la acción es irreversible —publica, borra, gasta o envía—, solo cuenta el muro. Y un sistema necesita un lugar donde dejar el trabajo que no debe hacer. Un agente que solo puede producir resultados siempre los producirá, incluso cuando lo correcto era parar. Por eso las sesiones útiles tienen una vía de rechazo: una forma de responder "no tengo suficiente información", un estado de espera, una pila de pendientes de revisión. El [módulo 2](/stack/builders/codex/module-02.md) te da los muros y el curso sigue añadiendo lugares para que el agente diga que no. > Diagrama: Proponer, aprobar y actuar, con la aprobación dibujada donde realmente controla. Una línea del prompt es una petición que el modelo puede omitir; una regla de los ajustes es un límite contra el que falla la operación, y necesita una bandeja de espera para el trabajo que no deba publicarse. Después sal de forma ordenada. Ya tienes el entregable: una instalación, una pregunta basada en el proyecto que verificaste y un cambio que aprobaste. ## Si no funciona - **Comando no encontrado.** La instalación no colocó el arnés en tu PATH, la lista de carpetas donde el intérprete busca comandos. Repite el instalador o consulta su nota sobre PATH. Arréglalo antes del inicio de sesión: no puede fallar un inicio de sesión con un comando que nunca se ejecutó. - **El inicio de sesión no abre el navegador.** Busca un comando explícito de inicio de sesión o usa la clave de API. Es habitual en máquinas remotas sin navegador. - **Errores de límite de solicitudes o cuota.** Has llegado al límite temporal de tu plan. Espera, cambia a una clave de API o comprueba tu nivel. Anota qué credencial usaba la ejecución. - **El agente no puede escribir.** El entorno aislado hace su trabajo; no es un fallo. Estás en modo de solo lectura o restringido; el [módulo 2](/stack/builders/codex/module-02.md) explica cómo ampliar el acceso de forma deliberada, la única buena forma de hacerlo. - **La respuesta describe otro proyecto.** La sesión está limitada al directorio equivocado. Sal, entra con `cd` en la raíz del proyecto y vuelve a empezar. > Diagrama: Cinco síntomas de la primera ejecución, ordenados por la capa real de cada uno —ruta de shell, inicio de sesión, cuota del plan, entorno aislado y carpeta de trabajo—, con el primer paso para cada uno y lo que conviene saber después. **Una salvedad que sobrevive a los comandos.** Los comandos de instalación y nombres de flags caducan aquí más rápido que en el resto del curso. Si uno no coincide, no lo depures. Toma el comando actual de una línea de la página oficial de instalación del arnés, inicia sesión en el navegador y ejecuta tu primera sesión en solo lectura en un repositorio seguido por git. Esa alternativa sirve en cualquier versión. ## Qué haces después El [módulo 2](/stack/builders/codex/module-02.md) es el más importante de la parte 0: el modelo de permisos de dos ejes que decide qué puede tocar el agente y cuándo pregunta. También enseña lo que ningún otro curso: cómo detectar una extensión maliciosa antes de instalarla. No te lo saltes. La instalación era la parte fácil. El control es donde está el trabajo real. ## descargas // 2 archivos :: listos para usar. copia, adapta, entrega. [Inicio rápido (Codex)~2 KBInstalación, autenticación con ChatGPT o clave de API y pasos de la primera sesión.codex/quickstart.mddescargar](/descargas/dev/module-01/codex/quickstart.md)[Inicio rápido (Cursor CLI)~2 KBInstalación, autenticación por navegador o clave de API, primera ejecución interactiva y comprobaciones seguras del modo de impresión.cursor-cli/quickstart.mddescargar](/descargas/dev/module-01/cursor-cli/quickstart.md) ## recursos y referencias // documentación oficial, herramientas e hilos que merece la pena guardar [openai/codex (instalación y versiones)Código fuente y notas de versión de Codex CLI.https://github.com/openai/codex](https://github.com/openai/codex)[anomalyco/opencode (instalación y versiones)Código fuente y notas de versión de opencode. Publica cada pocos días.https://github.com/anomalyco/opencode](https://github.com/anomalyco/opencode)[Página de la especificación AGENTS.mdEl archivo de instrucciones que leerá tu arnés cuando lo escribas en el módulo 3.https://agents.md](https://agents.md)[Documentación de Cursor CLILa referencia actual interactiva y de modo de impresión de cursor-agent.https://docs.cursor.com/en/cli/overview](https://docs.cursor.com/en/cli/overview)