Integraciones

OpenCode

Conecte OpenCode a HypersHub mediante un proveedor personalizado compatible con OpenAI. Use GPT, DeepSeek y otros modelos de la plataforma en su agente de codificación IA en la terminal.

Inicio rápido

Instalar OpenCode

OpenCode ofrece un script de instalación, npm y Homebrew. Elija cualquier método:

curl -fsSL https://opencode.ai/install | bash

Editar opencode.json

Cree o edite el archivo de configuración global ~/.config/opencode/opencode.json. Reemplace apiKey con la clave de la plataforma (hy-xxxx) generada en la consola.

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "hypershub/gpt-5.4",
  "provider": {
    "hypershub": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Hypers Hub",
      "options": {
        "baseURL": "https://apiclaw.cc/v1",
        "apiKey": "hy-******"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4",
          "id": "gpt-5.4"
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro",
          "id": "deepseek-v4-pro"
        }
      }
    }
  }
}

Nota: hypershub es el ID del proveedor; use el formato hypershub/gpt-5.4 al seleccionar un modelo. @ai-sdk/openai-compatible es para el endpoint compatible con OpenAI /v1/chat/completions.

Iniciar y seleccionar modelo

Inicie OpenCode en el directorio de su proyecto. Para cambiar de modelo, ejecute /models en una sesión de OpenCode.

cd /path/to/your/project
opencode

Verificar

Envíe una tarea de codificación simple. Si OpenCode responde correctamente y los registros de uso de la consola muestran esta solicitud, la configuración es exitosa.

OpenCode

Explica la estructura de directorios del proyecto actual

Referencia de configuración

Campo	Descripción
$schema	Use el JSON Schema oficial de OpenCode para validación y autocompletado del editor.
model	Modelo predeterminado, formato providerId/modelKey, ej. hypershub/gpt-5.4.
provider.hypershub.name	Nombre del proveedor mostrado en la interfaz de OpenCode.
provider.hypershub.npm	Paquete del proveedor AI SDK; use @ai-sdk/openai-compatible para interfaces compatibles con OpenAI.
options.baseURL	Dirección de API compatible con OpenAI de la plataforma: https://apiclaw.cc/v1
options.apiKey	Clave API de la plataforma, generada en la página "Claves API" de la consola.
models	Lista de modelos disponibles en OpenCode; key es el elemento del selector, id es el ID de modelo real enviado a la API.

Para agregar más modelos, añada entradas bajo models y asegúrese de que el id coincida con el ID de modelo de la plataforma.

Solución de problemas

No se encuentran los modelos de HypersHub

Confirme que opencode.json está en ~/.config/opencode/opencode.json y que model usa el formato proveedor/modelo hypershub/gpt-5.4.

Autenticación fallida

Verifique que options.apiKey esté configurado con una clave de plataforma válida y que baseURL sea https://apiclaw.cc/v1.

El proveedor personalizado no funciona

Confirme que el ID del proveedor, el prefijo del modelo y la clave del proveedor en la configuración sean consistentes. Para proveedores compatibles con OpenAI, establezca explícitamente npm como @ai-sdk/openai-compatible.