Configuración de Coding Agents

OpenCode: modelos propios, API Key y Base URL

Conecta OpenCode a Chat Completions compatible con OpenAI de BetterToken mediante /connect, opencode.json, una API Key, el Base URL y un Model ID. Más.

OpenCode se conecta a BetterToken con @ai-sdk/openai-compatible. Asigna al proveedor de OpenCode el nombre BetterToken u OpenAI Compatible. Usa esta página para la configuración general de API Key, Base URL u opencode.json. Consulta la guía de GLM o la guía de Kimi K3 cuando necesites seleccionar y verificar ese modelo concreto. Copia el Model ID exacto de la model plaza.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	`YOUR_MODEL_ID`

Requisitos previos

Instala OpenCode 1 con los comandos siguientes
Crea una BetterToken API Key
Copia un Model ID desde el model plaza o desde el cuadro Setup de la clave

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Instalar

Estos comandos instalan OpenCode 1. Para OpenCode 2, sigue su guía de instalación. OpenCode 2 lee la configuración existente desde las mismas ubicaciones y convierte los ajustes de proveedor V1 compatibles; consulta la guía de migración antes de cambiar la sintaxis de configuración.

curl

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

npm

npm install -g opencode-ai

Configuración mediante la línea de comandos

El script de configuración automática de BetterToken crea o actualiza el proveedor BetterToken en OpenCode. Requiere Node.js. Si no pasas una API Key o un Model ID como argumento, el script te los solicitará.

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-opencode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-opencode-provider.ps1" -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

Selecciona bettertoken/YOUR_MODEL_ID cuando termine el script. Si OpenCode ya está en ejecución, reinícialo antes de probar la conexión.

Configuración manual

Opción 1: guardar las credenciales con /connect

Inicia OpenCode y ejecuta:

/connect

Elige Other, introduce bettertoken como identificador del proveedor y, después, YOUR_API_KEY. OpenCode guarda la credencial de forma local.

Opción 2: configurar el JSON

El archivo global es ~/.config/opencode/opencode.json. Un proyecto puede usar opencode.json en su directorio raíz.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1"
      },
      "models": {
        "YOUR_MODEL_ID": {
          "name": "YOUR_MODEL_ID"
        }
      }
    }
  }
}

Si no usas /connect, añade "apiKey": "YOUR_API_KEY" dentro de options. No confirmes nunca en Git una configuración que contenga una clave real.

Este ejemplo usa @ai-sdk/openai-compatible para Chat Completions. El paquete SDK debe coincidir con el protocolo del endpoint; consulta la guía oficial de proveedores antes de usar otro protocolo. En pruebas en macOS con un modelo GPT, OpenCode 1.19.4 y 2.1.4 completaron llamadas a herramientas de lectura con ambos SDK: @ai-sdk/openai-compatible usó /v1/chat/completions y @ai-sdk/openai usó /v1/responses. Los cuatro casos superaron la prueba con read permitido y edit y bash bloqueados.

Verificar la conexión

Ejecuta opencode en un proyecto, selecciona bettertoken/YOUR_MODEL_ID y envía un mensaje breve. Una respuesta normal confirma que la configuración funciona. Reinicia OpenCode después de modificar el JSON.

Para probar texto sin interfaz con OpenCode 1:

opencode run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

OpenCode 2 requiere --standalone para esta ejecución sin interfaz:

opencode run --standalone --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Cambiar de modelo

Añade un nuevo YOUR_MODEL_ID dentro de provider.bettertoken.models, actualiza el model de nivel superior, guarda los cambios y reinicia OpenCode.

Errores comunes

Error	Solución
`401`	Vuelve a ejecutar `/connect` o comprueba `apiKey`.
`404`	Usa solo `https://bettertoken.ai/v1` como `baseURL`; no añadas `/chat/completions`.
No se encuentra el modelo	Asegúrate de que el `model` de nivel superior coincida exactamente con un ID de `models`.
No se aplica la configuración	Comprueba si el `opencode.json` del proyecto sustituye al archivo global y reinicia OpenCode.