Antes de la sesión
Bienvenida: qué es OpenCode y cómo funciona este taller
Qué bueno que estés aquí. Este taller es para una primera vez de verdad: no das por sabido nada sobre agentes de IA, ni sobre terminales, ni sobre programación. Al terminar vas a tener un agente funcionando en tu propia laptop y, sobre todo, vas a entender qué está pasando cuando lo usas.
Cuándo y dónde
- Miércoles 30 de septiembre de 2026, de 5:30 p. m. a 7:00 p. m., hora de la Ciudad de México.
- En vivo, por videollamada. El enlace para entrar está en la página del taller, en la plataforma, con tu sesión iniciada.
- Queda grabado. La grabación llega por correo a quienes apartaron su lugar.
Primero lo primero: qué es OpenCode
OpenCode es un agente de programación de código abierto que corre en tu terminal. Vamos por partes:
- Agente: un programa que no solo contesta, sino que actúa. Puede leer archivos, escribir archivos y ejecutar comandos en tu computadora.
- De código abierto: su código es público. Cualquiera puede ver cómo está hecho, y usarlo no cuesta.
- Corre en tu terminal: no es una página web. Lo abres dentro de la ventana de comandos de tu computadora (en la siguiente lección te explicamos qué es eso).
Una analogía: piensa en OpenCode como un asistente que se sienta en tu escritorio. Puede abrir tus carpetas, leer tus papeles y escribir documentos nuevos. Pero el asistente no piensa por sí mismo: cada vez que tiene que decidir algo, llama por teléfono a un experto que está en otra parte. Ese experto es el modelo de IA, y la compañía que te conecta con él es el proveedor.
| Pieza | Qué es | Dónde vive | Analogía |
|---|---|---|---|
| OpenCode | El agente: lee, escribe y ejecuta | En tu laptop | El asistente en tu escritorio |
| Proveedor | La empresa que da acceso a modelos | En internet (la nube) | La compañía telefónica |
| Modelo | La IA que entiende y responde texto | En los servidores del proveedor | El experto al otro lado de la línea |
| Tu llave | Una contraseña que te identifica | Guardada en tu laptop | Tu número de cliente |
Por eso OpenCode no trae un modelo dentro: tú eliges a qué proveedor conectarlo, y para eso necesitas una llave. Lo resolvemos antes de la sesión.
El mapa del taller
Este diagrama resume todo lo que vas a armar. Si en algún momento te pierdes, vuelve aquí.
TU LAPTOP LA NUBE (internet)
+-----------------------------------+ +------------------------------+
| | | |
| Tú | | Proveedor de modelos |
| (escribes un encargo) | | (OpenRouter, Zen, Groq) |
| | | | | |
| v | pedido | v |
| OpenCode ----------------------------------> Modelo de IA |
| (el agente) <------------------------------- (piensa y responde) |
| | | respuesta| |
| v | +------------------------------+
| Carpeta agent-workshop |
| (lee y escribe archivos aquí) |
| |
+-----------------------------------+
LA SESION EN VIVO, EN 5 PARTES
+------------+ +------------+ +------------+ +------------+ +------------+
| 1. Agente |-->| 2. Instalar|-->| 3. Primer |-->| 4. Primer |-->| 5. Que no |
| vs chat | | y conectar | | encargo: | | cambio: | | pedirle y |
| | | OpenCode | | que lea | | que escriba| | a donde |
| | | | | | | y revisas | | seguir |
+------------+ +------------+ +------------+ +------------+ +------------+Fíjate en dos cosas. Primera: el modelo nunca toca tus archivos. Quien lee y escribe es OpenCode, en tu máquina; el modelo solo recibe texto y contesta texto. Segunda: cuando OpenCode lee un archivo, le manda su contenido al modelo junto con tu encargo, para que pueda entenderlo. Por eso en este taller trabajamos con datos de ejemplo.
Qué vamos a hacer en vivo
En 90 minutos, con las manos en el teclado:
- Entender qué es un agente y en qué se diferencia de un chat.
- Instalar OpenCode y conectarlo a un modelo.
- Darle su primer encargo: que lea una carpeta y te explique qué hay.
- Pedirle su primer cambio, y revisarlo antes de aceptarlo.
- Ver qué no pedirle todavía, y a dónde seguir.
Qué vas a entender al final (no solo hacer)
Hacer los pasos es la mitad. La otra mitad es saber por qué funcionan, para que puedas repetirlos solo mañana. Al terminar vas a poder explicar con tus palabras:
- Qué es una terminal y por qué los agentes viven ahí.
- Qué es un proveedor, un modelo y una llave, y por qué la llave es secreta.
- Por qué un agente hace varias peticiones por un solo encargo, y qué tiene que ver eso con los límites del plan gratis.
- Por qué el agente te pide permiso antes de cambiar algo, y cómo revisar lo que propone.
- Por qué no hay que creerle a ciegas, y cómo comprobar un dato rápido.
Cómo encajan los tres módulos
+-------------------+ +-------------------+ +-------------------+
| 1. ANTES | | 2. EN VIVO | | 3. DESPUES |
| | | | | |
| Preparas la | ---> | Instalas, | ---> | Practicas solo |
| laptop y | | conectas y le | | y ves hacia |
| consigues tu | | das encargos | | donde seguir |
| llave | | al agente | | |
+-------------------+ +-------------------+ +-------------------+
~15 minutos 90 minutos 10 min por dia| Momento | Qué hay | Por qué va ahí | Cuándo |
|---|---|---|---|
| Antes | Preparar la laptop y conseguir una llave de un proveedor de modelos | Son pasos que no dependen de nadie y en vivo roban tiempo | Antes del miércoles |
| En vivo | Una sola lección con las cinco partes de la sesión, con comandos y encargos listos para copiar | Es donde conviene tener ayuda si algo falla | Durante la sesión |
| Después | Hacia dónde seguir y cómo obtener tu constancia | Lo que no se repite se olvida | En los días siguientes |
Durante la sesión, ten esta página abierta en otra pestaña. Así copias los comandos en vez de transcribirlos de la pantalla compartida: un espacio de más o una letra cambiada en un comando es el error más común de una primera vez.
Lo único que te pedimos antes
Haz las dos lecciones que siguen. Son unos 15 minutos:
- Preparar tu laptop: descargar Warp o Visual Studio Code, abrir una terminal y crear la carpeta de práctica.
- Conseguir tu llave de modelo: crear una cuenta gratuita en un proveedor y guardar tu llave.
Si llegas sin hacerlas no pasa nada: los primeros minutos de la sesión son justo para eso, y no avanzamos hasta que la sala esté lista. Pero conseguir la llave es lo más lento de hacer en vivo, así que si solo tienes cinco minutos, empieza por ahí.
Para comprobar que entendiste
1. Si OpenCode es el agente, ¿por qué necesito además un proveedor?
Porque OpenCode no trae un modelo dentro. OpenCode es quien lee y escribe en tu laptop, pero para "pensar" le pregunta a un modelo de IA que corre en los servidores de un proveedor. Sin proveedor (y sin llave), el asistente no tiene a quién llamar.
2. ¿Dónde viven tus archivos de práctica, en tu laptop o en la nube?
En tu laptop, dentro de la carpeta agent-workshop. OpenCode también corre en tu laptop. Lo único que está en la nube es el modelo, y a él le llega el texto que OpenCode le manda: tu encargo y el contenido de los archivos que haya leído.
3. ¿Por qué conviene conseguir la llave antes de la sesión?
Porque es el paso más lento: crear una cuenta en una página web, confirmar el correo y generar la llave. El resto (instalar y conectar) se hace en minutos durante la sesión.
Resumen
- OpenCode es un agente de código abierto que corre en tu terminal: lee, escribe y ejecuta en tu laptop, y para pensar se conecta a un modelo a través de un proveedor que tú eliges.
- El taller es el miércoles 30 de septiembre, de 5:30 p. m. a 7:00 p. m. hora de la Ciudad de México, y queda grabado. La grabación llega por correo.
- Este material tiene tres partes: antes, en vivo y después. Antes de la sesión: prepara la laptop y consigue tu llave. Siguiente lección.