OpenCode

OpenCode es un agente de programación de código abierto para la terminal. Un solo comando lo conecta a Synthorai: OpenCode recibe su propia clave de API y un provider Synthorai con los modelos que esa clave puede llamar. No hay que copiar ninguna clave ni editar ningún archivo de configuración.

Paso 1 - Iniciar sesión

opencode auth login https://synthorai.io

OpenCode lee https://synthorai.io/.well-known/opencode y ejecuta el comando de inicio de sesión que se indica ahí. Ese comando muestra un enlace y un código de 8 letras, como BCDF-GHJK, y abre el navegador.

Inicia sesión en la consola, comprueba que el código de la página coincide con el de la terminal, elige cuánto dura la clave (7, 30 o 90 días; por defecto, 90) y haz clic en Permitir. La terminal muestra Signed in y OpenCode guarda la nueva clave.

Por SSH el comando no abre ningún navegador: abre el enlace en otro dispositivo e inicia sesión allí. Para que haga lo mismo en tu propio equipo, define SYNTHORAI_NO_BROWSER=1.

Paso 2 - Elegir un modelo

opencode
# then, inside OpenCode:
/models

Abre OpenCode y escribe /models. El provider Synthorai muestra los modelos que tu clave puede llamar, con su límite de contexto y su precio. OpenCode actualiza la lista cada vez que arranca.

Cada modelo se llama con el protocolo que le corresponde, sin configurar nada: los modelos Claude usan la API Messages de Anthropic (el prompt caching sigue funcionando), los de OpenAI la API Responses y el resto Chat Completions.

La clave que usa OpenCode

La clave aparece en la página Claves API de la consola como OpenCode · …, seguida del lugar desde el que iniciaste sesión, con la etiqueta Inicio de sesión de agente. Puedes eliminarla desde ahí cuando quieras.

Cuando la clave caduca, las llamadas fallan con un mensaje que te pide volver a ejecutar opencode auth login https://synthorai.io.

Seguridad

• Aprueba solo un código que hayas solicitado tú. Si la solicitud de inicio de sesión llega desde una red distinta a la de tu navegador, la página de confirmación te avisa.
• Si el espacio de trabajo tiene activado Aprobación de IP nuevas (Ajustes › Seguridad), la dirección desde la que iniciaste sesión pasa a ser automáticamente una dirección de confianza de la nueva clave cuando permites el inicio de sesión desde la misma red, y las llamadas desde cualquier otra dirección esperan aprobación. Si lo permites desde otra red, la dirección no queda como de confianza: apruébala cuando se retenga su primera llamada. Si está desactivado, plantéate activarlo.

Manda la configuración local

Si tu opencode.json local define un provider llamado synthorai, OpenCode usa ese en lugar del que envía la pasarela, porque la configuración local tiene prioridad sobre la remota.

Configuración manual (Windows sin sh)

Crea una clave en la página Claves API de la consola, guárdala en la variable de entorno SYNTHORAI_API_KEY y añade este provider a opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "synthorai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Synthorai",
      "options": {
        "baseURL": "https://synthorai.io/v1",
        "apiKey": "{env:SYNTHORAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" }
      }
    }
  }
}

Pon bajo models cada modelo que quieras poder elegir en OpenCode. Los ID están en la página de modelos.

Solución de problemas

Failed to load auth provider metadata Revisa la dirección: es https://synthorai.io, sin ninguna ruta detrás.

Sign-in did not complete: the login was declined in the console La solicitud se rechazó en la página de confirmación. Vuelve a ejecutar el comando para empezar de nuevo.

El código ha caducado Los códigos duran 10 minutos. Vuelve a ejecutar opencode auth login https://synthorai.io para obtener uno nuevo.

Para límites, caducidad y eliminación de claves, consulta API keys.