No se encontró el proveedor o modelo de OpenCode: guía de diagnóstico

Ante el error de proveedor o modelo no encontrado de OpenCode, primero haz coincidir el modelo seleccionado con los ID de proveedor y modelo que OpenCode cargó realmente. La referencia normalmente tiene la forma providerId/modelId. Una clave de API correcta no puede reparar un ID mal escrito, un modelo personalizado no declarado o un archivo de configuración que el proceso en ejecución nunca lee.

Sigue el error, no solo la frase «problema del proveedor»

La guía oficial de resolución de problemas orienta los errores de modelo no encontrado hacia las referencias de modelos. En el código fuente del proveedor, la búsqueda comprueba tanto la entrada del proveedor como su mapa de modelos. El mismo error también puede envolver un error de modelo ausente del adaptador. Captura el mensaje exacto antes de cambiar las credenciales o comprar más crédito.

1. Identifica la versión y el modelo seleccionado

Ejecuta estas comprobaciones desde el proyecto en el que se produce el fallo. Si la aplicación de escritorio utiliza otro servidor, compara su versión y configuración con esta instalación del terminal:

opencode --version
opencode models
opencode auth list

Busca la referencia completa del modelo en la lista y compárala carácter por carácter con tu selección. El prefijo del proveedor forma parte de la identidad. Un modelo ofrecido mediante una pasarela personalizada no se convierte en el proveedor Anthropic integrado solo porque su nombre contenga Claude.

No interpretes una credencial guardada como prueba de autenticación remota correcta. Demuestra que existe una credencial localmente; el endpoint aún debe aceptarla cuando se realiza una solicitud.

2. Corrige el par proveedor/modelo

Este ejemplo utiliza el formato de proveedor de v1 y muestra los tres identificadores que deben coincidir. Define la variable de entorno referenciada en el proceso que inicia OpenCode o utiliza el flujo de credenciales documentado. Combina los campos relevantes con tu configuración en lugar de sobrescribir ajustes no relacionados:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "kunavo/claude-sonnet-5",
  "provider": {
    "kunavo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Kunavo",
      "options": {
        "baseURL": "https://api.kunavo.com/v1",
        "apiKey": "{env:KUNAVO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5"
        }
      }
    }
  }
}

Aquí, kunavo es la clave del proveedor y claude-sonnet-5 es la clave del modelo. Por tanto, la selección es kunavo/claude-sonnet-5. Seleccionar anthropic/claude-sonnet-5 elige otro proveedor; seleccionar Kunavo/Claude Sonnet 5 sustituye las claves de búsqueda por nombres visibles. Ninguna de las dos opciones hace referencia a la entrada mostrada arriba.

Al usar /connect y Other para un proveedor personalizado, introduce el mismo ID de proveedor. La credencial por sí sola no define el catálogo de modelos. Comprueba también el adaptador: el adaptador compatible con v1 mostrado aquí utiliza Chat Completions; un endpoint de Responses requiere el adaptador adecuado.

3. Mantén separadas las configuraciones de v1 y v2

La documentación de proveedores de v2 utiliza providers, package y settings, en lugar de provider, npm y options de v1. Usa la configuración específica de su versión en lugar de copiar sin cambios el bloque anterior a una configuración de v2.

En v2, la clave del mapa de un modelo también puede diferir de modelID del proveedor original. Si el mapa contiene coder y envía el modelo original upstream/coder-v2, elige company/coder para el proveedor company. Cambiar la selección al nombre original omitiría el alias configurado.

4. Comprueba qué configuración prevalece

OpenCode combina las fuentes de configuración. Un archivo de proyecto puede sustituir al modelo global; las rutas personalizadas, la configuración integrada y los ajustes administrados también pueden ser relevantes. Inspecciona el archivo del proyecto que falla, la configuración global y cualquier sustitución configurada. Comprueba las listas de proveedores permitidos o las entradas de proveedores desactivados.

Haz un único cambio específico, reinicia el proceso afectado y vuelve a enumerar los modelos. Si el modelo ya está disponible, pero su primera solicitud devuelve un error HTTP, sigue ese nuevo error. Conserva los archivos originales y los datos de la sesión durante el diagnóstico; eliminar todo el directorio de datos puede borrar credenciales e historial sin corregir una referencia de modelo incorrecta.

Termina con una solicitud pequeña

Cuando la selección se resuelva, prueba una indicación breve antes de realizar una tarea en el repositorio. Confirma que el proveedor previsto la recibe y registra el modelo esperado. Si sigue fallando, recopila la versión, la configuración saneada, el error exacto y el fragmento de registro relevante. Revisa los registros en busca de claves y contenido del proyecto antes de compartirlos.

Para Kunavo, continúa con la guía de integración de OpenCode y consulta tu registro de uso. La tarifa actual de Claude Sonnet 5 es $1.40 por millón de tokens de entrada y $7.00 por millón de tokens de salida. La comparación de precios resulta útil después de que el cliente seleccione la ruta prevista.

Preguntas frecuentes

Documentación oficial y código fuente del proveedor comprobados el 17 de septiembre de 2026. El ejemplo explica la identidad de la configuración; no es una prueba comparativa completa de tareas.