5. Proveedores de modelos y OpenCode Zen

Objetivo del tema

Comprender cómo OpenCode se conecta con los modelos de inteligencia artificial, aprender a configurar tu primer proveedor con /connect, conocer OpenCode Zen y las opciones de suscripciones, nube y modelos locales.

5.1 Un agente independiente del proveedor

A diferencia de otros agentes atados a un solo fabricante, OpenCode fue diseñado desde el inicio para trabajar con cualquier proveedor de modelos. Internamente utiliza el ecosistema de SDKs de IA y el registro público models.dev, lo que le permite dar soporte a más de 75 proveedores además de modelos locales ejecutados en tu propia máquina.

Esto significa que:

  • Puedes elegir el modelo según la tarea: uno potente para refactors complejos, otro económico para consultas simples.
  • No quedas atrapado si un proveedor cambia precios o condiciones: cambiar de modelo es instantáneo.
  • Es posible trabajar sin enviar código a la nube usando modelos locales.

5.2 Conectar un proveedor con /connect

El comando /connect dentro de la TUI es la puerta de entrada a cualquier proveedor. El flujo general es siempre el mismo:

  1. Ejecuta /connect en la TUI.
  2. Busca y selecciona el proveedor en la lista (por ejemplo OpenCode Zen, Anthropic, OpenAI, GitHub Copilot).
  3. Ingresa tu clave de API cuando se solicite, o completa el inicio de sesión en el navegador si el proveedor ofrece OAuth.
  4. Ejecuta /models para ver los modelos disponibles y seleccionar el predeterminado.

Las credenciales se guardan localmente en ~/.local/share/opencode/auth.json, nunca dentro de tu proyecto.

5.3 OpenCode Zen: el punto de partida recomendado

OpenCode Zen es la lista de modelos curada por el propio equipo de OpenCode: todos fueron probados y verificados para funcionar bien con el agente. Si estás comenzando, es la opción más simple porque elimina la duda de qué modelo elegir.

  1. Ejecuta /connect, selecciona OpenCode Zen y visita opencode.ai/auth.
  2. Inicia sesión, carga tu medio de pago y copia la clave de API.
  3. Pega la clave en la TUI cuando la solicite.
  4. Ejecuta /models: verás los modelos recomendados listos para usar.

Zen funciona como cualquier otro proveedor y su uso es completamente opcional.

5.4 OpenCode Go y suscripciones reutilizables

  • OpenCode Go: un plan de suscripción de bajo costo del equipo de OpenCode que da acceso confiable a modelos abiertos populares. Se activa igual que Zen, mediante /connect.
  • ChatGPT Plus/Pro: al conectar OpenAI puedes autenticarte con tu suscripción existente vía navegador, sin clave de API manual.
  • GitHub Copilot: usa tu suscripción actual con el flujo de código de dispositivo en github.com/login/device (algunos modelos requieren plan Pro+).
  • GitLab Duo: integración experimental para suscriptores Premium/Ultimate, con OAuth o token personal.
  • Anthropic (Claude): admite autenticación con suscripción Claude Pro/Max o clave de API manual.

Si ya pagas alguna de estas suscripciones, aprovecharla evita duplicar costos. Verifica siempre los términos de uso de cada servicio respecto a herramientas de terceros.

5.5 Proveedores en la nube más utilizados

Proveedores populares y cuándo conviene cada uno
Proveedor Modelos destacados Ideal para
OpenCode Zen / Go Colección curada y verificada por el equipo Comenzar sin decisiones técnicas previas; simplicidad.
Anthropic Serie Claude (Sonnet, Opus) Razonamiento extenso sobre bases de código grandes.
OpenAI Serie GPT Tareas generales de código con ecosistema maduro.
Google Vertex AI Serie Gemini Organizaciones ya presentes en Google Cloud.
Amazon Bedrock Multiples familias vía AWS Empresas con políticas y facturación AWS.
Azure OpenAI GPT desplegados en Azure Corporativos con requisitos de residencia de datos.
OpenRouter / Groq / Cerebras / DeepSeek Modelos abiertos, inferencia ultrarrápida o económica Optimizar costo/velocidad y probar alternativas abiertas.
Ollama / LM Studio / llama.cpp Qwen-Coder, DeepSeek-Coder, GLM, entre otros Privacidad total: todo se ejecuta localmente.

5.6 Modelos locales con Ollama u otras opciones

Para trabajar sin enviar código a ningún servicio externo, OpenCode puede apoyarse en servidores locales compatibles con la API de OpenAI. Ejemplo con Ollama en opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": { "name": "Qwen3 Coder" }
      }
    }
  }
}

La misma estructura sirve para LM Studio (http://127.0.0.1:1234/v1) o llama.cpp (http://127.0.0.1:8080/v1). Si las llamadas a herramientas fallan con modelos locales, aumenta la ventana de contexto (num_ctx) a 16k-32k tokens.

5.7 Configuración avanzada de proveedores

La sección provider del archivo opencode.json permite ajustar el comportamiento:

  • Base URL personalizada: útil para proxies corporativos o endpoints propios (options.baseURL).
  • Ocultar modelos: con blacklist quitas modelos del selector /models; con whitelist dejas sólo los indicados.
  • Proveedores personalizados: cualquier API compatible con OpenAI puede registrarse indicando el paquete SDK (npm), nombre y lista de modelos.

5.8 ¿Cómo elegir el modelo adecuado?

Criterios según el perfil de uso
Perfil Recomendación
Primeros pasos OpenCode Zen: modelos probados, sin configuraciones extra.
Refactors críticos Modelo tope de gama (Claude Opus, GPT mayor) aunque sea más lento o caro.
Trabajo diario intensivo Modelo intermedio rápido y económico; reserva el grande para tareas difíciles.
Código sensible/confidencial Modelos locales (Ollama/LM Studio) o nubes corporativas (Bedrock, Azure, Vertex).
Presupuesto ajustado OpenCode Go, proveedores económicos o suscripciones ya existentes (Copilot, ChatGPT).

OpenCode utiliza además un "modelo pequeño" para tareas internas menores (como generar el título de una sesión). Puedes fijarlo con la opción small_model de la configuración si necesitas control total sobre a dónde viajan tus datos.

Recomendaciones de seguridad

  • Nunca subas claves de API a repositorios ni las pegues en documentos compartidos.
  • Protege el archivo auth.json con permisos restrictivos, especialmente en equipos compartidos.
  • Revisa periódicamente el consumo en el panel de tu proveedor para detectar usos anómalos.
  • En proyectos confidenciales, evalúa modelos locales antes que servicios de nube pública.

Conclusión: la independencia de proveedores es una de las mayores fortalezas de OpenCode: puedes comenzar con OpenCode Zen en cinco minutos, reutilizar una suscripción que ya tengas, combinar varios proveedores según la tarea o bajar todo a tu máquina con modelos locales. En el próximo tema pondremos el agente a trabajar sobre un proyecto real inicializando el archivo AGENTS.md.

Retornar