OpenCode

OpenCode est un agent de code open source pour le terminal. Une seule commande le connecte à Synthorai : OpenCode reçoit sa propre clé API et un provider Synthorai qui liste les modèles que cette clé peut appeler. Aucune clé à copier, aucun fichier de configuration à modifier.

Étape 1 - Se connecter

opencode auth login https://synthorai.io

OpenCode lit https://synthorai.io/.well-known/opencode et lance la commande de connexion qui y est indiquée. Cette commande affiche un lien et un code de 8 lettres, par exemple BCDF-GHJK, puis ouvre votre navigateur.

Connectez-vous à la console, vérifiez que le code affiché correspond à celui du terminal, choisissez la durée de validité de la clé (7, 30 ou 90 jours, 90 par défaut) et cliquez sur Autoriser. Le terminal affiche Signed in et OpenCode enregistre la nouvelle clé.

En SSH, la commande n'ouvre pas de navigateur : ouvrez le lien sur un autre appareil et connectez-vous depuis celui-ci. Pour obtenir le même comportement en local, définissez SYNTHORAI_NO_BROWSER=1.

Étape 2 - Choisir un modèle

opencode
# then, inside OpenCode:
/models

Lancez OpenCode et tapez /models. Le provider Synthorai liste les modèles que votre clé peut appeler, avec leur limite de contexte et leur prix. La liste est actualisée à chaque démarrage d'OpenCode.

Chaque modèle est appelé avec le protocole qui lui convient, sans rien régler : les modèles Claude passent par l'API Anthropic Messages (le prompt caching continue de fonctionner), les modèles OpenAI par l'API Responses, et tous les autres par Chat Completions.

La clé utilisée par OpenCode

La clé apparaît sur la page Clés API de la console sous le nom OpenCode · …, suivi de l'endroit d'où vous vous êtes connecté, avec le libellé Connexion d’agent. Vous pouvez la supprimer à tout moment depuis cette page.

Une fois la clé expirée, les appels échouent avec un message qui vous invite à relancer opencode auth login https://synthorai.io.

Sécurité

• N'approuvez qu'un code dont vous avez vous-même lancé la demande. Si la demande de connexion vient d'un autre réseau que votre navigateur, la page de confirmation vous prévient.
• Si l’espace de travail a activé Approbation des nouvelles IP (Paramètres › Sécurité), l’adresse depuis laquelle vous vous êtes connecté devient automatiquement une adresse de confiance de la nouvelle clé quand vous autorisez la connexion depuis le même réseau, et les appels venant d’autres adresses attendent une approbation. Autorisée depuis un autre réseau, l’adresse n’est pas rendue fiable : approuvez-la quand son premier appel est retenu. Si l’option est désactivée, pensez à l’activer.

La configuration locale l'emporte

Si votre opencode.json local définit un provider nommé synthorai, OpenCode utilise celui-ci plutôt que celui fourni par la passerelle : la configuration locale prime sur la configuration distante.

Configuration manuelle (Windows sans sh)

Créez une clé sur la page Clés API de la console, placez-la dans la variable d'environnement SYNTHORAI_API_KEY et ajoutez ce provider à 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" }
      }
    }
  }
}

Listez sous models chaque modèle que vous voulez pouvoir choisir dans OpenCode. Les identifiants figurent sur la page des modèles.

Dépannage

Failed to load auth provider metadata Vérifiez l'adresse : c'est https://synthorai.io, sans chemin à la suite.

Sign-in did not complete: the login was declined in the console La demande a été refusée sur la page de confirmation. Relancez la commande pour recommencer.

Le code a expiré Un code est valable 10 minutes. Relancez opencode auth login https://synthorai.io pour en obtenir un nouveau.

Pour les limites, l'expiration et la suppression des clés, consultez Clés API.