Esta guía es la continuación natural de OpenRouter en 15 minutos: la clave que creaste allí, con su tope de gasto, se convierte en el motor de un agente que trabaja en tus archivos. Final del recorrido: una tarea real completada por OpenCode bajo tus ojos.

Paso 1 · Instala

Dos caminos equivalentes, de la documentación oficial: el script (curl -fsSL https://opencode.ai/install | bash) o, si tienes Node, npm install -g opencode-ai. Verifica con opencode --version: si responde con un número, ya estás.

Paso 2 · Conecta el modelo

Crea una carpeta de trabajo dedicada y lanza opencode allí dentro. En el primer arranque usa el comando /connect: busca OpenRouter en la lista de proveedores, pega la clave. Luego elige el modelo: para la primera vuelta un modelo medio va perfectamente, y si quieres gastar cero están las variantes :free de varios modelos abiertos (con el límite por minuto documentado en la ficha de OpenRouter).

Paso 3 · Valla el campo

Un agente que lee, escribe y ejecuta se trata como a un colaborador nuevo: perímetro claro antes de la primera tarea. La regla práctica: trabaja siempre en una carpeta dedicada que contenga solo el material de la tarea, nunca en la home ni en carpetas con documentos ajenos al asunto. Dentro de ese vallado el agente puede hacer daños reducidos y recuperables.

Paso 4 · La primera tarea real

Pon en la carpeta un archivo sobre el que el agente pueda trabajar (un CSV que analizar, un puñado de notas que reorganizar, un script que comentar) y describe la tarea como se la darías a una persona: qué hay, qué quieres, cómo reconoces un buen resultado. Luego míralo trabajar: OpenCode muestra los pasos y los cambios, y tú supervisas. El momento formativo es justo ese: ver el ciclo leer-actuar-verificar suceder en tus archivos, con tus contenidos.

Los errores típicos

La tarea vaga. «Arréglame estos archivos» produce resultados vagos con cualquier agente. Objetivo, material, criterio de éxito: las tres cosas que le das a un colega se las das también aquí.

El vallado saltado. La tentación de lanzarlo «solo un momento» en la carpeta de los documentos de verdad. Copiar tres archivos a una carpeta limpia cuesta treinta segundos; la alternativa es supervisar conteniendo la respiración.

El modelo equivocado para la tarea. Si los resultados decepcionan, antes de condenar al agente prueba un modelo más capaz: con OpenCode el cambio es un comando, y es exactamente el tipo de experimento para el que existe la pareja con un gateway.

Estado de la verificación: instalación y versión verificadas de verdad el 19/07/2026 (v1.18.3, vía npm). La vuelta completa del paso 4 se ejecutó en la misma fecha, con clave y modelo reales, desde el workflow de verificación del sitio: OpenCode leyó el CSV de los materiales del curso dentro de un vallado dedicado, produjo el análisis con el total y las 4 anomalías que el material contiene a propósito, y no tocó el archivo original. Exactamente el ciclo leer-actuar-verificar descrito arriba.