# Pon tu agente en marcha en tu equipo

Stack agéntico · Emprendedores · OpenCode · módulo 01
Lectura: ~11 min

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

> Diagrama: Todo el módulo en una imagen: cinco paradas desde abrir la caja de comandos hasta crear un punto de restauración, dibujado como la parada a la que puede volver todo lo que hagas después de hoy.

## 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](/stack/emprendedores/opencode/module-00.md), 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.

> Diagrama: La misma ventana vacía en Mac y Windows, con sus tres partes etiquetadas en lenguaje sencillo: la línea de comandos, el cursor y el lugar donde aparecerá tu respuesta.

## Paso 2. Instala e inicia sesión

Busca el bloque del agente elegido en el [módulo 0](/stack/emprendedores/opencode/module-00.md), 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.

> Diagrama: La ruta de instalación común a los cinco agentes, dibujada como un flujo horizontal: comando de instalación, arranque del agente, apertura de una pestaña del navegador, inicio de sesión y aparición de la pantalla de chat. Los nombres de los agentes solo se separan en la primera caja.

El agente independiente, donde eliges el cerebro de IA que lo impulsa. Se instala con un comando.

// shell

```
curl -fsSL https://opencode.ai/install | bash
```

También sirve un gestor de paquetes: `brew install anomalyco/tap/opencode` en Mac y `npm install -g opencode-ai` en otros sistemas.

Inícialo escribiendo `opencode`. Como no está ligado a una empresa, la primera ejecución tiene un paso extra. Escribe `/connect` y sigue las indicaciones para añadir tu proveedor de IA: pegas una clave suya, una contraseña larga que permite a esta aplicación usar tu cuenta allí. Después escribe `/init` para que cree un archivo inicial de notas del proyecto.

Un aviso que ahorra una hora. Normalmente no se permite usar el inicio de sesión de suscripción de una gran empresa de IA en una aplicación independiente: usa una clave de proveedor en lugar de un plan que ya pagas.

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

> Diagrama: Tres paneles muestran por qué un enlace que funciona no es una prueba: la afirmación del agente con una fuente, la página citada que se abre correctamente y trata el tema adecuado, y una frase destacada de esa página que dice algo distinto.

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

> Diagrama: Una carpeta en una línea de tiempo: la instantánea anterior al agente anclada a la izquierda, tres días de ediciones del agente a lo largo de la línea y una flecha de restauración que vuelve desde cualquier punto hasta el ancla.

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] (próximamente) hace el recorrido completo. En el [módulo 2](/stack/emprendedores/opencode/module-02.md) eliges y escribes los dos ajustes de seguridad para que cada sesión arranque en un punto seguro sin pensarlo.

> Diagrama: Dos formas de trabajar con seguridad con un agente: decidir cada vez, dibujado como una bifurcación en cada tarea, frente a decidir una vez, dibujado como una bifurcación al principio y un camino despejado después.

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

> Diagrama: Un árbol de decisión para el primer día: ¿arrancó el agente?, ¿se abrió la pestaña de inicio de sesión?, ¿encaja la respuesta con tu carpeta? Cada rama negativa termina en el único paso que lo resuelve.

## Paso 7. Qué sigue

El [módulo 2](/stack/emprendedores/opencode/module-02.md) 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 (agente independiente)~2 KBInstalación, conexión de un proveedor y primera ejecución en lenguaje sencillo.opencode/quickstart.mddescargar](/descargas/business/module-01/opencode/quickstart.md)[Inicio 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](/descargas/business/module-01/cursor-cli/quickstart.md)

## 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](https://agents.md)