Antes de la sesión
Prepara tu laptop
En esta lección dejas lista la laptop para el taller: una terminal abierta, una carpeta de práctica con tres archivos y, si quieres, OpenCode instalado desde antes. Son unos 10 minutos.
1. Abre una terminal
La terminal es una ventana donde escribes comandos en lugar de hacer clic. Todas las computadoras traen una.
- Mac: abre Terminal (búscala con
Cmd + Espacioy escribe "Terminal"). - Windows: abre Terminal o PowerShell desde el menú Inicio.
- Linux: la terminal de tu escritorio (suele abrirse con
Ctrl + Alt + T).
Escribe esto y presiona Enter:
echo hola
Si la terminal te contesta hola, está lista. Eso es todo lo que hace falta saber de la terminal para empezar.
2. Crea la carpeta de práctica
Vamos a trabajar sobre una carpeta pequeña con datos de gastos de ejemplo. Crea una carpeta llamada agent-workshop donde prefieras (el Escritorio sirve). Puedes hacerlo con clic derecho, "Nueva carpeta", o desde la terminal:
mkdir agent-workshop
cd agent-workshop
Dentro de esa carpeta crea tres archivos con cualquier editor de texto (VS Code, Bloc de notas en Windows, TextEdit en Mac en modo texto sin formato). Copia el contenido tal cual.
Archivo expenses.csv:
date,description,category,amount
2026-09-01,Groceries at the market,food,54.20
2026-09-02,Bus card top-up,transport,20.00
2026-09-03,Coffee with a friend,Food,6.50
2026-09-05,Internet bill,home,35.00
2026-09-07,Movie tickets,fun,18.00
2026-09-09,Groceries at the market,food,61.75
2026-09-12,Taxi home,Transport,12.40
2026-09-14,Electricity bill,home,42.10
2026-09-18,Lunch near the office,food,11.90
2026-09-21,Concert,fun,45.00
2026-09-25,Bus card top-up,transport,20.00
2026-09-28,Groceries at the market,food,58.30
Archivo notes.md:
# Notas del presupuesto
- Quiero saber en qué se me va el dinero cada mes.
- Mi meta para octubre: gastar menos de 350 en total.
- Sospecho que la comida es lo más caro, pero no lo he sumado.
Archivo opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"edit": "ask",
"bash": "ask"
}
}
Este último es importante y lo explicamos en vivo: le dice al agente que te pida permiso antes de escribir un archivo o ejecutar un comando. Por defecto no lo pide. Para una primera vez, queremos que lo pida.
Fíjate en que el CSV tiene algo raro a propósito. No lo corrijas: es parte del ejercicio.
3. (Opcional) Instala OpenCode desde antes
Si quieres ganar tiempo, instálalo ya con los pasos de la lección Instalar y conectar OpenCode del módulo En vivo. Si algo falla, no te preocupes: lo resolvemos en los primeros minutos de la sesión.
4. (Opcional) Git, para poder deshacer
OpenCode tiene un comando /undo que deshace el último cambio del agente, pero solo funciona si la carpeta es un repositorio de Git. Si ya tienes Git instalado, entra a la carpeta y corre:
git init
Si no sabes qué es Git, sáltate este paso. Para el taller basta con que el agente te pida permiso antes de cada cambio.
Verifica que estás listo
- Abrí una terminal y respondió
hola. - Tengo la carpeta
agent-workshopconexpenses.csv,notes.mdyopencode.json.
¿Y si mi editor guardó el archivo como expenses.csv.txt?
Pasa mucho en Windows con Bloc de notas y en Mac con TextEdit. Al guardar, elige "Todos los archivos" como tipo y escribe el nombre completo con su extensión. En TextEdit, antes de pegar, usa Formato, Convertir a texto sin formato. Si no lo logras, llega así: lo arreglamos en vivo en un minuto.
Resumen
- Abriste una terminal y comprobaste que responde.
- Creaste la carpeta
agent-workshopcon los tres archivos de práctica. - Siguiente paso: conseguir la llave de un proveedor de modelos.