Saltar al contenido principal
OpenCode ahora admite familias principales de modelos como GPT, Claude, DeepSeek, Gemini y Qwen. Para los escenarios de uso de OpenCode, se recomiendan los siguientes modelos:
  • coding-minimax-m2.1-free
  • coding-glm-4.7-free
  • claude-sonnet-4-5
  • gpt-5
  • gpt-5-codex
Este documento explica cómo instalar, configurar e iniciar OpenCode en distintos sistemas operativos y cómo integrar la API de AIHubMix.
Antes de la instalación, asegúrate de que tu sistema cumpla los siguientes requisitos:
  • Node.js ≥ 18.0.0
  • Gestores de paquetes opcionales para tu sistema operativo:
    • macOS / Linux: brew
    • Arch Linux: paru
    • Windows: choco, winget o scoop

​
1. Instalación de OpenCode

Elige cualquiera de los siguientes métodos de instalación según tu sistema operativo y preferencias de herramientas.

​
1. Instalación mediante Node.js

​
2. Instalación mediante Homebrew (macOS / Linux)

​
3. Instalación mediante Paru (Arch Linux)

​
4. Instalación en Windows

​
2. Lanzar y iniciar sesión en OpenCode

Tras la instalación, sigue los pasos siguientes para completar la autenticación y la configuración.

​
1. Iniciar sesión en OpenCode

Ejecuta el siguiente comando en tu terminal:

​
2. Seleccionar el proveedor de IA

En la pantalla de inicio de sesión, selecciona AiHubMix como proveedor de modelos. Opencode 1

​
3. Autorización con la clave API

Introduce tu clave API de AiHubMix en la página de inicio de sesión de OpenCode para completar la autorización. Opencode 2

​
3. Uso de los modelos

​
1. Verificación de la instalación

Ejecuta el siguiente comando para verificar que OpenCode esté instalado y configurado correctamente:
Opencode 3

​
2. Seleccionar un modelo

Escribe /models, busca aihubmix y selecciona el modelo deseado. Opencode 4

​
4. Uso de AiHubMix en el cliente de escritorio de OpenCode

  1. Descarga la aplicación de escritorio de OpenCode: https://opencode.ai/download .
  2. Abre OpenCode y sigue los pasos: /model → Connect provider → busca aihubmix → introduce tu clave API → Submit. Opencode 5
  3. En el panel de selección de modelos, busca aihubmix y selecciona el modelo que deseas utilizar. Opencode 6

​
  1. URL base personalizada

De forma predeterminada, OpenCode envía las solicitudes de AIHubMix a https://aihubmix.com/v1. Si necesitas que las solicitudes pasen por una puerta de enlace propia, un proxy empresarial o un nodo de aceleración, puedes sobrescribirlo mediante options.baseURL, sin necesidad de modificar el código fuente de OpenCode ni de reinstalarlo.

​
Paso 1: Abrir el archivo de configuración

Abre ~/.config/opencode/opencode.json (en Windows, %USERPROFILE%\.config\opencode\opencode.json).

​
Paso 2: Añadir options.baseURL

Agrega options.baseURL dentro del proveedor aihubmix. Solo necesitas escribir este campo; OpenCode lo combinará automáticamente y en profundidad con la configuración integrada, por lo que no hace falta reescribir todo el proveedor:
Nota: baseURL solo debe indicarse a nivel de dominio (por ejemplo, https://api.inferera.com); la ruta la añade automáticamente el SDK. No agregues /v1 por tu cuenta (como https://api.inferera.com/v1), ya que de lo contrario se concatenaría como /v1/v1/ y provocaría un error 404.

​
Paso 3: Reiniciar y verificar

Cierra OpenCode por completo y vuelve a iniciarlo. Ejecuta:
En la salida, dentro de provider.aihubmix.options.baseURL, deberías ver la dirección que has indicado.

​
6. Preguntas frecuentes y consejos

Última actualización: 2026-06-01