Instalación y primera sesión

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.

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.

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

# macOS, Homebrew
brew install --cask codex

# or npm (any platform with Node)
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, 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 los explica. Por ahora, /help los enumera.
• Sal de forma ordenada. Tu historial se guarda para poder retomarlo después.

Esa es toda la interfaz. El resto del curso dirige el bucle con más precisión: qué puede tocar (módulo 2), qué sabe del proyecto (módulo 3), los atajos que le das (módulo 4) y la configuración subyacente (módulo 5).

Tu primera tarea

Abre el arnés en un repositorio real, en solo lectura si lo permite. El módulo 2 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.

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.

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 te da los muros y el curso sigue añadiendo lugares para que el agente diga que no.

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 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.

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 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.mddescargarInicio 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

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/codexanomalyco/opencode (instalación y versiones)Código fuente y notas de versión de opencode. Publica cada pocos días.https://github.com/anomalyco/opencodePá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.mdDocumentación de Cursor CLILa referencia actual interactiva y de modo de impresión de cursor-agent.https://docs.cursor.com/en/cli/overview