Antes de la sesión
Consigue tu llave de un proveedor de modelos
OpenCode es la herramienta, pero no trae un modelo dentro: se conecta a uno que corre en la nube. Para conectarlo necesitas una llave (API key) de un proveedor de modelos. En esta lección eliges proveedor, creas tu cuenta y guardas tu llave. Son unos 5 minutos.
Una advertencia honesta: estos pasos son sobre páginas web reales, y las páginas cambian. Esta guía es de septiembre de 2026. Si un botón se llama distinto, la lógica es la misma.
Qué es una llave
Una API key es una cadena de texto secreta que le dice al proveedor que la petición es tuya. Es como la llave de tu casa: con ella entras, y por eso no se la prestas a nadie ni la pegas en un chat.
Elige tu proveedor
Hay dos caminos que funcionan bien para el taller. Los dos te dan modelos gratuitos.
| OpenRouter | OpenCode Zen | |
|---|---|---|
| Qué es | Un servicio que da acceso a muchos modelos desde una sola cuenta | El servicio de modelos de los creadores de OpenCode |
| Costo de los modelos gratuitos | 0 | 0 |
| ¿Pide tarjeta o datos de facturación? | No, para los modelos gratuitos | Sí, para darte la llave |
| Límite de uso gratis | 20 peticiones por minuto y 50 al día | Depende del modelo |
| Dónde se consigue la llave | openrouter.ai, sección Keys | opencode.ai/auth |
Si no quieres dar ningún dato de pago, usa OpenRouter. Es el camino que seguimos en vivo.
Sobre el límite de 50 peticiones al día: un agente hace varias peticiones por cada encargo (lee un archivo, piensa, escribe otro), así que 50 alcanzan para la sesión y para practicar un rato, no para trabajar todo el día. Si un día se te acaban, no es un error: es el plan gratis haciendo su trabajo.
Camino A: OpenRouter
- Entra a openrouter.ai y crea una cuenta (puedes usar Google o GitHub).
- En el menú de tu cuenta, entra a Keys.
- Crea una llave nueva (Create Key) y ponle un nombre que reconozcas, por ejemplo
agent-workshop. - Cópiala y guárdala en ese momento. La llave completa solo se muestra una vez. Si cierras la ventana sin copiarla, tendrás que crear otra (no pasa nada, pero te ahorras el paso).
La llave se ve más o menos así: sk-or-v1-xxxxxxxxxxxx. Ese prefijo sk-or es normal.
Camino B: OpenCode Zen
- Entra a opencode.ai/auth e inicia sesión.
- Agrega tus datos de facturación. Los modelos marcados como gratuitos no generan cobro.
- Copia tu llave y guárdala.
Una nota sobre privacidad, que aplica a los dos caminos: varios modelos gratuitos usan lo que les escribes para mejorar sus modelos. Para el taller trabajamos con datos de ejemplo, así que no importa. Como regla general, no le pases a un modelo gratuito datos personales ni información de tu trabajo.
Plan B, por si tu proveedor falla
Cada cuenta es un mundo. Si ninguno de los dos te funciona, Groq (console.groq.com) también tiene capa gratuita: cuenta, API Keys, Create API Key, copiar. OpenCode se conecta a Groq igual que a los otros dos.
Guarda tu llave con cuidado
- Guárdala en un gestor de contraseñas o en una nota privada.
- No la pegues en el chat de la videollamada ni la muestres en pantalla.
- Si alguna vez se te filtra, entra al proveedor, bórrala y crea otra. Es gratis y toma un minuto.
Verifica que estás listo
- Tengo cuenta en OpenRouter (o en OpenCode Zen, o en Groq).
- Creé una llave y la guardé donde puedo encontrarla.
¿Y si perdí la llave?
Entra de nuevo a la sección de llaves, borra la anterior y crea una nueva. Esta vez, cópiala apenas aparezca.
Resumen
- OpenCode necesita una llave de un proveedor de modelos para funcionar.
- OpenRouter te da modelos gratuitos sin tarjeta, con un tope de 50 peticiones al día. OpenCode Zen también tiene modelos gratuitos, pero pide datos de facturación.
- Con la llave guardada, ya estás listo para la sesión.