Proveedores de OpenCode: 7 controles para modelos, claves y configuración

La búsqueda proveedores de OpenCode puede significar qué servicios existen, cómo añadir un proveedor externo, si funciona un endpoint compatible con OpenAI o por qué aparece el proveedor pero no sus modelos. Una lista de marcas queda obsoleta cuando cambian precios, IDs y autenticación; una secuencia de decisión sigue siendo útil.

La documentación oficial de OpenCode reúne Credentials, Config, OpenCode Zen, OpenCode Go y un directorio de proveedores. Esta guía añade el orden práctico: identificar la capa, elegir la conexión mínima, comprobar el ID del modelo y guardar la evidencia antes de usar tareas con escritura.

El proveedor es la ruta hacia un servicio de modelos. El modelo es la capacidad concreta que ese servicio expone y las credenciales demuestran que la solicitud está autorizada. Si se tratan como un solo ajuste, los síntomas engañan: una clave válida no corrige un ID equivocado y un modelo visible no demuestra que la credencial siga vigente.

El alcance de configuración es una cuarta decisión. Un proveedor puede funcionar en el archivo del proyecto y no en el global, o una configuración administrada puede sobrescribir lo editado. Anota archivo, alcance, nombre del proveedor, ID del modelo y fecha de verificación; es más seguro que compartir un archivo completo con rutas locales o políticas internas.

Hay cuatro rutas habituales. OpenCode Go y OpenCode Zen son servicios de primera parte con planes y supuestos de modelos propios. Un proveedor alojado de terceros sirve cuando el equipo ya tiene facturación, controles regionales o un catálogo preferido. Un endpoint compatible con OpenAI o local es flexible, pero deja más superficie de URL, descubrimiento, runtime y diagnóstico bajo tu responsabilidad.

No elijas por el nombre del directorio. Decide qué restricción pesa más: coste mensual previsible, control por consumo, ubicación de datos, uso sin conexión, calidad, latencia o un servicio que el equipo ya opere. Un proveedor barato sigue siendo mala opción si el catálogo cambia o el entorno no puede verificar el endpoint.

La forma oficial coloca los proveedores personalizados bajo la clave provider. El adaptador npm, las opciones, la variable de autenticación y el mapa de modelos dependen del servicio. Lee primero la documentación del propietario, copia solo los campos que entiendas y anota por qué elegiste el endpoint y el adaptador.

Mantén el secreto fuera del repositorio: usa OAuth, una variable de entorno o el almacén de credenciales de la plataforma. No pegues una clave activa en opencode.json, una captura, el historial del shell o una sesión compartida. Si apareció en un log, rótala antes de continuar; borrar la línea no borra el historial.

Añade un proveedor cada vez. Un cambio mínimo separa un problema de schema de una caída del servicio y deja claro el rollback: quitar el bloque nuevo, recuperar el modelo anterior y repetir la solicitud conocida.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "my-provider": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "provider-demo",
      "options": { "baseURL": "https://api.provider.test/v1" },
      "models": { "model-id": { "name": "Model name" } }
    }
  }
}

Una entrada no está terminada hasta que OpenCode descubre un modelo real y completa una solicitud pequeña. Comprueba el ID y la autenticación en la documentación vigente y usa /models para ver qué puede seleccionar OpenCode. Si hay varias variantes, empieza por una cuyo contexto, herramientas, latencia y coste encajen con el trabajo.

La primera solicitud debe ser de solo lectura y fácil de comparar: pide explicar un archivo local pequeño o enumerar el siguiente comando de validación sin ejecutarlo. Registra si la respuesta está completa, si las herramientas funcionan, cuánto tarda y qué modelo se usó. Prueba escrituras solo después de esa evidencia.

1. Comprobar alcanceConfirma si es global, de proyecto, de ruta personalizada o administrado.
2. Proteger la claveUsa OAuth, una variable de entorno o el almacén del proveedor.
3. Confirmar proveedorComprueba ID, adaptador, endpoint e instrucciones oficiales.
4. Confirmar modeloUsa el ID exacto, no solo el nombre mostrado.
5. Listar modelosAbre el selector o sigue el flujo `/models` documentado.
6. Probar solo lecturaUsa un prompt pequeño y compáralo con una expectativa conocida.
7. Anotar rollbackGuarda la configuración válida, el resultado y la reversión mínima.

Los errores se arreglan mejor si separas autenticación, descubrimiento, modelo y transporte. Un 401 o un bucle OAuth apunta a credenciales o permisos. Un proveedor ausente apunta a alcance, schema u orden de carga. Un selector sin el modelo esperado apunta al catálogo o al ID. Un timeout después de descubrirlo apunta a red, proxy, región o salud del servicio.

Cambia una variable por prueba. Verifica primero el endpoint según la fuente oficial, luego el archivo que lee OpenCode, después la lista de modelos y por último un prompt. Añadir más proveedores para diagnosticar uno roto solo hace más difícil leer el catálogo y los logs.

OpenCode Go encaja cuando una suscripción y una cuota previsible cubren el volumen; Zen encaja cuando interesan un catálogo seleccionado y el pago por uso. Un proveedor alojado de terceros es razonable si importan facturación, cumplimiento, región o acceso a un modelo concreto. Un endpoint local o compatible con OpenAI es útil si aceptas mantener el runtime y el servicio. No son rankings universales.

El proveedor también cambia la suposición de privacidad. El CLI puede ejecutarse localmente mientras las solicitudes van al servicio de modelos elegido. Lee la política, no envíes secretos ni datos de clientes innecesarios y prueba primero en un repositorio no productivo. La guía de modelos cubre capacidad, JSONC cubre alcance, Ollama cubre runtime local y Go vs Zen cubre los dos caminos de primera parte.

Para la consulta amplia proveedores de OpenCode, el resultado útil es una conexión reproducible, no una lista fija de ganadores. Directorio, modelos, precios, cuotas y login cambian; vuelve a comprobar la fuente oficial el día de la configuración y anota la fecha.