lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

Pon tu agente en marcha en tu equipo

Hoy toca configurar. Abres la terminal, instalas el agente elegido en el módulo 0, inicias sesión y ejecutas un prompt real sobre tu trabajo. Después viene lo que los veteranos desearían haber hecho primero: dos comandos de git que guardan una instantánea de la carpeta anterior al agente para poder revertir todo lo que toque. Sales con un archivo de configuración de valores prudentes que completa el módulo 2.

lectura
~11 min
ver en .md
DIEZ MINUTOS DE CONFIGURACIÓN / UN HÁBITO QUE PERDURA01Abre la cajade comandosuna ventana de chatcon tu equipo02Instala einicia sesiónun comandoy luego un acceso03Ejecuta unprompt realtu primertrabajo real04Comprueba larespuestaun enlace apunta,no demuestra05Crea el puntode restauraciónel botón de deshacerausente en tus archivosEn los módulos siguientes, un agente editará tus archivos reales.el punto de restauración lo convierte de riesgo en experimentovuelve aquíQUÉ TIENES AL CERRAR LA VENTANAinstalado y con sesión iniciadaun prompt, comprobado en la fuenteun punto previo al agenteTu agente no sabe deshacer: eso se construye en la parada 5.

lo que vas a poder hacer

entregable · lo que produces

Tu agente instalado, con sesión iniciada y a la escucha. Un prompt real ejecutado y contrastado con su fuente. Y un punto de guardado de tu carpeta de proyecto "antes del agente", para poder deshacer lo que haga a partir de hoy.

Tu agente no tiene botón de deshacer.

Ni en un menú ni a una pulsación. No existe. Si borra un archivo, la única copia que queda es la que guardaste antes en otro lugar.

Hoy son tres cosas pequeñas y un gran hábito.

Instalar, iniciar sesión y ejecutar un prompt: unos diez minutos. Después el hábito: un punto de guardado. Todos los módulos posteriores harán que un agente cambie archivos reales; el punto de guardado lo convierte de riesgo en experimento.

La instalación varía según el agente elegido en el módulo 0, así que está en su bloque más abajo. Lo demás es igual para los cinco.

Paso 1. Abre la terminal

Tu agente vive en una pequeña ventana de texto. Mac la llama Terminal; Windows, PowerShell. La misma idea: escribes una instrucción, pulsas Intro y el equipo la ejecuta.

Nada de lo que escribas allí te compromete a nada y cerrar la ventana no pierde nada. Es un chat con tu equipo, muy parecido a lo que será cuando funcione el agente.

En Mac pulsa Comando y Espacio, escribe "Terminal" y pulsa Intro. En Windows pulsa la tecla Windows, escribe "PowerShell" y pulsa Intro. En Linux abre tu terminal.

Aparece un cursor parpadeante. Esa es la terminal y la última palabra técnica que te pide aprender este módulo.

DOS NOMBRES / UNA VENTANA / LAS MISMAS TRES PARTESTerminal~/Work$123VACÍA HASTA QUE ESCRIBAS ALGOMacComando y Espacio, escribe «Terminal»PowerShell~/Work$123VACÍA HASTA QUE ESCRIBAS ALGOWindowsTecla Windows, escribe «PowerShell»1Línea de comandosel equipo dice: tu turno.2El cursorun bloque que parpadea. Espera.3El área de respuestatodo aparece debajo.Escribir aquí no te compromete a nada y cerrar no hace que pierdas nada.

Paso 2. Instala e inicia sesión

Busca el bloque del agente elegido en el módulo 0, sigue sus pasos y vuelve al paso 3.

Los cinco siguen el mismo patrón: un comando de instalación, una pestaña del navegador para identificarte y una pantalla de chat en la terminal. Si conoces el patrón, distingues un paso fallido de uno que te espera.

CINCO AGENTES / UN ESQUEMA / SOLO CAMBIA LA PRIMERA CAJAversátil y establegran ecosistemaagente independientenuevo y rápidocompañero del editorsolo cambia esta caja01Instala con elcomandode su páginaoficial02El agentearrancaescribes su nombre03Una pestaña webse abreverifica quién eres04Inicias sesióny vuelvescierra la pestañacuando te lo indique05Aparece la pantallade chatun área de entradaen la parte inferiorCONOCE EL ESQUEMA Y UN BLOQUEO DEJA DE ASUSTARTe está esperando.La pantalla no cambia y no hay ningún error.busca un enlace https largo y ábreloHa fallado de verdad.Apareció un error y volvió la línea de comandos.lee el error, no sigas a ciegasUn comando de instalación viejo falla como si todo estuviera roto.

El recién llegado rápido. Se instala con un comando.

En Mac o Linux:

// shell

curl -fsSL https://x.ai/cli/install.sh | bash

En Windows (en PowerShell):

// shell

irm https://x.ai/cli/install.ps1 | iex

Inícialo escribiendo su comando e inicia sesión cuando lo pida.

Este agente es joven y cambia casi a diario: trata cualquier instrucción escrita, incluida esta, como una foto del momento. Si un paso no coincide con tu pantalla, cree a tu pantalla y consulta la página oficial de instalación.

Paso 3. Ejecuta tu primer prompt y compruébalo

Elige el más cercano a tu trabajo, escríbelo en el área de entrada y pulsa Intro.

Para un profesional de marketing:

// shell

Lee la página de inicio de https://stripe.com y dime en tres puntos qué venden y a quién.

Para un creador de contenido:

// shell

Hazme un esquema de 5 puntos para un boletín sobre por qué la mayoría de los perfiles de clientes son demasiado largos para ser útiles.

Para un fundador:

// shell

Escríbeme un correo de contacto en frío de 4 líneas a un fundador de SaaS para ofrecerle una auditoría gratuita de voz de marca.

Tu agente piensa unos segundos y responde en el chat. Es tu primer trabajo real, y es el mínimo, no el máximo.

Ahora haz lo que casi todos se saltan. Compruébalo.

Este fallo pasa desapercibido porque no lo parece. El agente te da una respuesta con fuente. El enlace abre. La página trata del tema correcto. Y no dice lo que el agente afirma. Un enlace que funciona es una referencia, no una prueba; la referencia y la afirmación pueden discrepar en silencio.

Algo más. Cuanto más trabaja un agente en una ejecución, cuantas más páginas consulta y más pasos da, más se degrada su precisión factual. La comprobación importa más cuando la respuesta parece más impresionante.

EL FALLO QUE NO PARECE UN FALLOPANEL 01La afirmaciónfuente: un enlace realEl agente responde yadjunta una fuente.Parece correcto.PANEL 02El enlace se abrela página que abristeLa página carga y tratael tema adecuado.Sigue pareciendo correcto.PANEL 03La frasela misma páginaesta línea dice otra cosaLees la línea de la quesalió la afirmación.No dice eso.Un enlace válido apunta, no demuestra. El enlace y la afirmación pueden discrepar sin avisar.cuanto más trabaja una ejecución, más pierde precisiónRevisa más a fondo cuando la respuesta más impresiona.

¿Ejecutaste el prompt de marketing? Abre stripe.com y lee la primera pantalla. ¿El resumen coincide con lo que ves o es una descripción verosímil de cualquier empresa de pagos? ¿El del fundador? Pregúntate si enviarías ese correo a una persona real cuyo nombre conoces.

Diez segundos de comprobación, siempre, mantienen honestos los siguientes quince módulos. No es un ritual de principiante que después abandonas: es la estructura de toda la relación. El agente lee, descompone, redacta, ordena y da formato. Tú eliges, juzgas y controlas el momento de publicar, enviar o pagar. Toda configuración que merece copiarse divide el trabajo así, y todas las historias de terror entregaron al agente también el último paso.

Si la decisión final es tuya, necesitas poder deshacer todo lo anterior.

Para salir del agente, escribe /exit o cierra la ventana. Para iniciarlo otra vez, ejecuta el mismo comando con el que lo lanzaste.

Paso 4. La red de seguridad que todo veterano desearía haber tenido el primer día

El paso más importante del módulo. Sáltate cualquier otro si quieres. Este no.

La solución al botón de deshacer ausente tampoco viene integrada en el agente. Es una herramienta gratuita llamada git, ya presente en la mayoría de los Mac y que se instala en un minuto en Windows. Git guarda una instantánea de una carpeta y permite devolverla a ese estado cuando quieras. Es el botón de guardar que tus archivos nunca tuvieron.

Aquí se pierde trabajo real. No porque el agente sea malicioso, sino porque "limpia los borradores antiguos de esta carpeta" significa una cosa para ti y algo un poco más amplio para un trabajador literal con acceso a archivos. La instantánea lo convierte en una molestia de cinco segundos en vez de una noche que acabas contando a otros.

UNA CARPETA / UN ANCLA / CADA DÍA SIGUIENTE ES REVERSIBLEtiempoPunto de restauración«antes del agente»DÍA 1Rehízo tres viejosborradores.DÍA 2Renombró mediacarpeta.DÍA 3Borró lo queconsideró antiguo.vuelta al anclacualquier díaCINCO COMANDOS, UNA VEZ, Y LAS PALABRAS DEJAN DE SER EXTRAÑASgit initinicia el seguimientogit add .reúne todogit committoma la instantáneagit statusqué ha cambiadogit checkout .restaura la carpetaUna carpeta en iCloud, Dropbox o OneDrive rompe esto. Muévela primero a un lugar local.Lo que lamentas no es la tool: es no usarlos el día uno.

Tu agente puede configurarlo y dejarlo hacerlo anticipa cómo delegarás trabajo durante el curso. Inícialo dentro de tu carpeta de trabajo, pega esto y lee lo que pregunta antes de aprobar cada paso.

// shell

Configura un punto de guardado de esta carpeta para poder deshacer lo que hagas después.

1. Dime la ruta completa de la carpeta donde trabajas. Detente y avísame si
   está dentro de iCloud, Dropbox o OneDrive.
2. Si git aún no sigue esta carpeta, empieza a seguirla.
3. Crea o actualiza un .gitignore para que .env y cualquier archivo acabado en .key
   nunca se incluyan en una instantánea.
4. Guarda una primera instantánea con el mensaje "before agent".
5. Muéstramela y dime en una frase qué tendría que escribir para devolver
   la carpeta a ese estado.

Pregúntame antes de ejecutar cada comando. No cambies ni borres ningún archivo existente.

Observa la estructura del prompt, porque escribirás cien parecidos. Declara el objetivo, nombra los pasos, dice qué no tocar y exige explicar cómo volver atrás. Un límite escrito y un informe al terminar. Ese es el patrón.

O hazlo tú. Cinco comandos que merece la pena escribir una vez para que sus términos te resulten familiares después.

Entra en tu carpeta de trabajo. Si tu trabajo de negocio está en una carpeta "Work" dentro de Documentos:

// shell

cd ~/Documents/Work

Una advertencia primero. Los agentes y los servicios de sincronización no se llevan bien. Si tu carpeta está dentro de iCloud, Dropbox o OneDrive, el servicio y el agente sobrescriben sus cambios y realmente desaparecen archivos. Les pasa continuamente a usuarios de Mac, porque Documentos suele estar en iCloud sin haberlo elegido. Si es tu caso, crea una carpeta fuera, como Work-Local en tu carpeta personal, y mueve allí el proyecto antes.

Ahora convierte la carpeta en algo que pueda seguir git:

// shell

git init

Verás "Initialized empty Git repository". Después dile a git que ignore los archivos con contraseñas y claves para que una instantánea no copie en silencio un secreto donde no querías:

// shell

echo ".env" >> .gitignore

No ocurre nada visible en pantalla. Es correcto. Ahora toma la instantánea:

// shell

git add .
git commit -m "before agent"

Verás los archivos que se siguen y después una línea acabada en "before agent". Ese es tu punto de guardado y tardó unos treinta segundos.

Con el agente o a mano, el resultado es permanente. Haga lo que haga después con esta carpeta, tienes un momento al que volver.

Este hábito marca la diferencia entre sentirte tranquilo con un agente y sentirte vigilado por él. El arrepentimiento siempre es el mismo. No "elegí mal la herramienta", sino "ojalá hubiera ejecutado esos dos comandos el primer día".

Tú acabas de hacerlo.

Paso 5. Arranca con valores seguros

Tu agente lee un pequeño archivo de configuración cada vez que arranca. Hoy no necesitas entender cada línea. Una cosa debe ser cierta: el archivo existe y hace que el agente arranque prudente en vez de ansioso.

¿Por qué no limitarte a tener cuidado en el momento? Porque tendrías que acertar cada vez, incluso cansado, con prisa o medio distraído. Un valor predeterminado es una decisión que tomas una vez, con calma, y dejas de tomar.

El nombre y la ubicación del archivo cambian según el agente; el bloque del paso 2 te indicó el tuyo. El módulo 5 hace el recorrido completo. En el módulo 2 eliges y escribes los dos ajustes de seguridad para que cada sesión arranque en un punto seguro sin pensarlo.

UN VALOR POR DEFECTO ES UNA DECISIÓN QUE DEJAS DE TOMARDecide cada vezCon cuidado en el momento, tarea tras tarea.primera tarea¿permitir?¿parar?segunda tarea¿permitir?¿parar?tercera tarea¿permitir?¿parar?cuarta tarea¿permitir?¿parar?También cuando tienes prisa o cansancio.Decide una vezEscrito en los ajustes, con calma, una vez.elegido una vezprimera tareasin preguntarsegunda tareasin preguntartercera tareasin preguntarcuarta tareasin preguntarCada sesión empieza en un lugar seguro.Tu agente lee un archivo breve de ajustes al arrancar. En el Módulo 2 escribes en él tus dos ajustes de seguridad.Hoy solo importa una cosa: que el archivo exista.

Paso 6. Qué falla el primer día

Cinco cosas hacen tropezar el primer día. Cada arreglo es menor que el pánico.

"command not found" después del comando de inicio. Se instaló, pero tu equipo aún no lo sabe: la lista de comandos se lee al abrir la ventana. Cierra la terminal, abre otra y prueba. Si sigue fallando, repite la instalación y busca un error que pasaste por alto.

No se abre la pestaña de inicio de sesión. Busca en la terminal una dirección larga que empiece por https://. Cópiala al navegador y termina allí el inicio de sesión. La terminal esperaba esa pestaña todo el tiempo, por eso parecía no pasar nada.

Un error que no entiendes. Deja de escribir. No pidas al agente que repare su instalación rota: si no puede arrancar no puede repararse y adivinará sin problema. Copia el error a un chat o buscador, lee los resultados y decide. Casi todo error del primer día es de configuración, no de tu equipo.

El agente cambió algo que no querías. En tu carpeta de proyecto ejecuta git status, que enumera las diferencias desde el punto de guardado. Después ejecuta git checkout . para descartar ediciones en archivos ya guardados. Los que creó desde cero permanecen y los borras tú. Todo lo que existía en el punto de guardado está a salvo.

Tu carpeta está en iCloud y pasan cosas raras. Archivos que reaparecen, cambios que no se mantienen, el agente insiste en que existe un archivo que no ves. Mueve la carpeta a una ubicación local y repite allí los pasos del punto de guardado.

CINCO TROPIEZOS / CADA ARREGLO ES MENOR QUE EL PÁNICO¿El agentearrancó?noCierra la ventana y abre otra.los comandos se leen al abrir la ventanasí¿Se abrió la pestañade acceso?noCopia el enlace https largo en tu navegador.la terminal esperaba esa pestaña todo el tiemposí¿La respuestaencaja aquí?noEscribe pwd para ver dónde estás.describió otro proyecto, no el tuyosíYa funciona.crea el punto de guardadoUn error que no entiendes.Pégalo en un chat o en un buscador.nunca pidas a un agente roto repararseLos cambios no quedan, los archivos vuelven.La carpeta está en iCloud o Dropbox. Sácala.repite los pasos del punto de guardadoCasi todo error inicial es de configuración, no del equipo.

Paso 7. Qué sigue

El módulo 2 cubre los dos interruptores que deciden qué puede tocar el agente y con qué frecuencia pregunta. Separan al agente que hace exactamente lo que querías del que reorganiza media carpeta mientras preparas café. También aprendes algo que casi ningún curso cubre: detectar un complemento dañino antes de instalarlo, no después.

Ya tienes un agente en marcha y un punto en el tiempo al que siempre puedes volver. Juntos convierten el resto del curso en algo con lo que experimentar en vez de algo con lo que ir con cuidado.

Avanza cuando estés listo.

descargas

// 2 archivos · listos para usar. copia, adapta, entrega.

Inicio rápido (recién llegado rápido)~2 KBScript de instalación, inicio de sesión y primera ejecución en lenguaje sencillo.grok-build/quickstart.mddescargarInicio rápido (Cursor CLI)~2 KBInstalación, inicio de sesión, primer prompt y límite del modo de impresión en lenguaje sencillo.cursor-cli/quickstart.mddescargar

recursos y referencias

// documentación oficial, herramientas e hilos que merece la pena guardar

agents.md (el archivo de memoria, más adelante)El archivo de texto plano que escribes en el módulo 3 para que tu agente conozca tu negocio.https://agents.md