Tutorial de configuración de OpenCode: conexión con la API de NextHub

OpenCode es una herramienta de programación con IA para la terminal que admite la conexión de múltiples modelos. A continuación te explicamos cómo conectar el canal de Claude de NextHub.

Pasos de conexión

1. Instala OpenCode

Asegúrate de tener Node.js instalado y luego instala OpenCode globalmente:

npm i -g opencode-ai

Tras la instalación, ejecútalo una vez para que genere la carpeta de configuración predeterminada:

opencode

2. Abre la carpeta de configuración de OpenCode

Windows (CMD)

start "" "%USERPROFILE%\.config\opencode"

macOS (Terminal)

open "$HOME/.config/opencode"

3. Edita opencode.json — introduce la configuración de Claude

Busca opencode.json en la carpeta de configuración (si no existe, créalo) y, conforme al esquema oficial de OpenCode, introduce tu ApiKey y la dirección de conexión de NextHub en provider.anthropic.options:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "tu ApiKey de NextHub",
        "baseURL": "https://api.nexthub.cc"
      }
    }
  }
}

El Base URL no debe llevar /v1

OpenCode añade automáticamente /v1/messages después de baseURL, así que aquí basta con introducir solo el dominio https://api.nexthub.cc, sin añadir /v1 al final.

4. Verifica que la configuración sea correcta

Ejecuta opencode, escribe el comando /models y, si ves los modelos de Claude en la lista, la configuración es correcta:

opencode
# Tras entrar en la interfaz interactiva, ejecuta
# /models

También puedes conectar el canal de GPT

Añade el proveedor openai en el mismo opencode.json para usar los modelos de la serie GPT / Codex:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "tu ApiKey de NextHub",
        "baseURL": "https://api.nexthub.cc"
      }
    },
    "openai": {
      "options": {
        "apiKey": "tu ApiKey de NextHub",
        "baseURL": "https://api.nexthub.cc/v1"
      }
    }
  }
}

Los dos bloques de direcciones se configuran de forma distinta

anthropic usa el protocolo Anthropic, por lo que baseURL debe ser solo el dominio https://api.nexthub.cc (se añade automáticamente /v1/messages); openai usa el protocolo compatible con OpenAI, por lo que baseURL debe incluir /v1. Elige el grupo correspondiente para cada ApiKey (grupos de la familia Claude y grupos GPT-Azure / GPT-Pro); también puedes usar la misma clave, pero recuerda que el grupo determina los modelos disponibles y, normalmente, separarlas deja la configuración más clara.