OpenCode

Estado: Configuración candidata, aún no verificada por NexoRouter.

OpenCode soporta proveedores personalizados compatibles con OpenAI. Configura NexoRouter como proveedor que llama https://api.nexorouter.com/v1 y envía requests Chat Completions.

Qué usa este setup

Elemento	Valor
Tipo de proveedor	Proveedor personalizado OpenAI-compatible
Base URL	`https://api.nexorouter.com/v1`
API key	API key de NexoRouter
Model ID	ID exacto copiado desde Models
Endpoint público estable	`POST /v1/chat/completions`

No uses esta página para configurar Codex CLI, Claude Code o clientes nativos de Gemini. Esas herramientas tienen requisitos de protocolo distintos.

Antes de empezar

Instala OpenCode desde la documentación actual de instalación de OpenCode.
Ejecuta opencode --version para confirmar que está disponible.
Crea una API key de NexoRouter con bajo presupuesto para la primera prueba.
Copia un model ID desde Models, por ejemplo deepseek-v4-flash.
Mantén la key fuera de opencode.json, Git, capturas y mensajes de soporte.

Referencias de OpenCode:

Flujo de credenciales

La documentación de providers de OpenCode usa el comando /connect para agregar credenciales. Si tu versión lo soporta:

/connect

Luego elige Other, escribe un provider ID como nexorouter y pega tu API key de NexoRouter.

Si tu versión de OpenCode usa otro flujo de credenciales, sigue la documentación de providers de esa versión. Lo importante es que el secreto quede en el almacenamiento de credenciales de OpenCode, no en la configuración del proyecto.

Configuración de proveedor

Usa un ID de proveedor estable como nexorouter.

La configuración global suele estar en:

~/.config/opencode/opencode.json

Ejemplo:

{
  "provider": {
    "nexorouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "NexoRouter",
      "options": {
        "baseURL": "https://api.nexorouter.com/v1"
      },
      "models": {
        "deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash"
        },
        "gpt-4o-mini": {
          "name": "GPT-4o mini"
        },
        "Qwen/Qwen-Plus": {
          "name": "Qwen Plus"
        }
      }
    }
  },
  "model": "nexorouter/deepseek-v4-flash"
}

Si tu versión de OpenCode requiere la key en config, prefiere una referencia a variable de entorno si esa versión la soporta. No hardcodees la key completa en un archivo del repositorio.

Primera prueba

Empieza con una tarea solo lectura:

Read the current directory and summarize the project in one paragraph. Do not edit files.

Luego abre Usage Logs y confirma:

nombre de API key;
model ID;
estado del request;
prompt tokens y completion tokens;
costo y latencia;
request ID.

Segunda prueba

Solo después de ver la tarea solo lectura en Usage Logs, prueba una edición pequeña en una rama desechable:

Create a short README note in a temporary branch. Do not change existing source files.

Si el prompt de texto funciona pero el flujo de edición falla, trata ese par modelo/herramienta como no listo para trabajo real de coding agent.

Problemas comunes

Síntoma	Revisión
`invalid_api_key`	Confirma que la credencial está asociada al provider `nexorouter` y que la base URL es `https://api.nexorouter.com/v1`.
`model_not_found`	Copia el model ID exacto desde Models y confirma que la clave del modelo en OpenCode coincide.
Texto funciona pero ediciones fallan	Prueba otro modelo y revisa Tool calling.
El request no aparece en Usage Logs	Confirma que OpenCode usa el provider `nexorouter`, no un provider integrado.
Errores de paquete o caché del provider	Sigue la documentación de troubleshooting de OpenCode para la versión actual.

Límites conocidos

Trata esta página como configuración candidata hasta que tu versión actual de OpenCode pase la prueba solo lectura, la prueba de edición y la revisión en Usage Logs.
Streaming y tool calling pueden variar según modelo y versión de OpenCode.
Usa una key de bajo presupuesto para agentes locales.
No reutilices una key personal de producción en repositorios compartidos o demos.