Saltar a la documentación

OpenCode

Configura un proveedor personalizado de Chat Completions.

Actualizado el 3 de noviembre de 2026

Instala el cliente

OpenCode 1.19.5 se probó con dos solicitudes, streaming y un ciclo de herramienta/resultado del cliente con una respuesta local sintética. Esto demuestra cliente/protocolo, no proveedor real ni cobro de producción. Instala esta versión desde el paquete npm oficial y revisa los cambios antes de actualizar.

bash
npm install -g opencode-ai@1.19.5
opencode --version

Antes de empezar

Abre un terminal nuevo, configura una clave con permisos y consulta los modelos disponibles para tu cuenta antes de usar el cliente. La configuración compartida incluye comandos Bash y PowerShell.

Configura el proveedor

Combina el bloque generado con tu opencode.json y conserva los demás proveedores. La clave se lee del entorno, no del archivo del proyecto. Selecciona notholy/MODEL_ID con /models.

Comprueba los límites del cliente

Usa @ai-sdk/openai-compatible para Chat Completions. Las herramientas se ejecutan en tu máquina bajo los permisos de OpenCode. La compatibilidad no autoriza comandos. Empieza en un repositorio desechable y verifica una solicitud breve antes de habilitar herramientas.

Configuración del cliente

Selecciona un modelo publicado para generar la configuración. Confirma el acceso de tu cuenta con GET /v1/models antes de enviar una solicitud.

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "notholy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NotHoly",
      "options": {
        "baseURL": "https://api.notholy.com/v1",
        "apiKey": "{env:NOTHOLY_API_KEY}"
      },
      "models": {
        "notholy-pulse": {
          "name": "NotHoly Pulse Flash",
          "limit": {
            "context": 1048576,
            "output": 131072
          }
        }
      }
    }
  },
  "model": "notholy/notholy-pulse"
}

Referencia de configuración: un ejemplo generado no certifica el cliente completo. Revisa los límites anteriores. Guarda las claves en tu entorno privado.