Instalar OpenCode y conectarlo

Ahora sí, a la terminal. Al terminar esta parte vas a tener OpenCode instalado, conectado a un modelo y contestándote. Vamos todos al mismo paso: si algo falla, paramos aquí.

1. Instala OpenCode

Elige una opción según tu sistema.

Mac o Linux (la más directa):

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

Descarga el instalador oficial y lo ejecuta.

Mac con Homebrew:

brew install anomalyco/tap/opencode

Windows (o cualquier sistema con Node.js 18 o superior):

npm install -g opencode-ai

Si no tienes Node.js, descárgalo de nodejs.org (la versión LTS), instálalo con las opciones por defecto y abre una terminal nueva antes de correr el comando. En Windows también puedes usar scoop install opencode o choco install opencode si ya usas alguno de esos dos.

Si en alguna guía ves un $ al inicio del comando, no lo escribas: solo indica que es una terminal.

2. Verifica la instalación

Cierra la terminal, ábrela de nuevo y escribe:

opencode --version

Si ves un número de versión, funcionó.

Si ves "command not found" (o "no se reconoce como un comando"), casi siempre es porque la terminal abierta todavía no se enteró de que instalaste algo. Ciérrala y ábrela otra vez.

3. Abre OpenCode dentro de tu carpeta de práctica

OpenCode trabaja sobre la carpeta donde lo abres. Entra a agent-workshop y ábrelo ahí:

cd agent-workshop
opencode

Se abre una interfaz dentro de la misma terminal. Abajo hay una caja para escribir. Todo lo que empieza con / es un comando de OpenCode; lo demás es un mensaje para el agente.

4. Conéctalo a tu proveedor

Escribe en la caja:

/connect

Busca tu proveedor: OpenRouter (o OpenCode Zen, o Groq).
Pega tu llave cuando te la pida y presiona Enter.

OpenCode guarda la llave en tu computadora, así que esto se hace una sola vez.

5. Elige un modelo

/models

Si usas OpenRouter, escribe free para filtrar y elige uno de los modelos que terminan en :free. En vivo te decimos cuál nos está funcionando mejor ese día: los gratuitos cambian seguido y a veces uno está saturado.

6. Tu primera respuesta

Escribe un mensaje normal, sin /:

Hola. En una frase: ¿qué puedes hacer en esta carpeta?

Si te contesta, lo lograste: tienes un agente funcionando en tu máquina.

Dos cosas de la interfaz que vas a usar hoy

La tecla Tab cambia entre dos modos. Plan analiza y propone, pero no cambia archivos. Build hace los cambios. Abajo a la derecha ves en cuál estás.
El @ te deja mencionar un archivo en tu mensaje (@expenses.csv) para que el agente lo lea sí o sí.

Trampas comunes

Error de autenticación: casi siempre es la llave mal pegada, con un espacio o incompleta. Vuelve a /connect y pégala de nuevo.
"Rate limit" o el modelo no contesta: el modelo gratuito está saturado o llegaste al tope del día. Cambia de modelo con /models.
El agente dice que no ve archivos: lo abriste en otra carpeta. Sal con /exit, entra a agent-workshop y vuelve a abrirlo.

Resumen

Instalaste OpenCode y verificaste con opencode --version.
Lo conectaste con /connect y elegiste modelo con /models.
Tab cambia entre Plan (propone) y Build (cambia). @ menciona un archivo.