OpenCode

OpenCode accepte des fournisseurs compatibles OpenAI déclarés dans son fichier de configuration. On y déclare Kloria avec la liste des modèles que tu veux voir dans le sélecteur.

Configuration

1. Installe OpenCode

   macOS / Linux

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

   Ou avec npm : npm install -g opencode-ai.

   Windows (PowerShell)

   npm install -g opencode-ai

   Scoop (scoop install opencode) et Chocolatey (choco install opencode) fonctionnent aussi. OpenCode recommande WSL sous Windows.

2. Mets ta clé dans une variable d’environnement

   macOS / Linux

   Ajoute à ton ~/.zshrc ou ~/.bashrc, puis ouvre un nouveau terminal :

   export KLORIA_API_KEY="sk-…"

   Windows (PowerShell)

   [Environment]::SetEnvironmentVariable("KLORIA_API_KEY", "sk-…", "User")

3. Déclare Kloria dans la configuration

   Fichier global : ~/.config/opencode/opencode.json. Tu peux aussi mettre un opencode.json à la racine d’un projet, mais alors sans clé en clair dedans.

   ~/.config/opencode/opencode.json

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "kloria": {
         "npm": "@ai-sdk/openai-compatible",
         "name": "Kloria",
         "options": {
           "baseURL": "https://api.kloria.dev/v1",
           "apiKey": "{env:KLORIA_API_KEY}"
         },
         "models": {
           "claude-sonnet-5": { "name": "Claude Sonnet 5" },
           "claude-opus-5-5": { "name": "Claude Opus 5.5" },
           "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
           "gpt-6.1-sol": { "name": "GPT-6.1 Sol" },
           "gpt-5.6-terra": { "name": "GPT-5.6 Terra" }
         }
       }
     },
     "model": "kloria/claude-sonnet-5"
   }

   {env:KLORIA_API_KEY} dit à OpenCode de lire la clé dans la variable d’environnement : elle n’est jamais écrite dans le fichier.

4. Lance OpenCode et vérifie

   opencode

   Tape /models : les modèles Kloria apparaissent sous le fournisseur Kloria. Choisis-en un et envoie un message.

Astuce

Les clés de la section models doivent être les identifiants exacts de la page Modèles et tarifs. Le champ name est libre : c’est ce qui s’affiche dans le sélecteur.

Ça ne marche pas ?

Symptôme	Piste
Kloria n’apparaît pas dans /models	Le JSON est invalide ou le fichier n’est pas au bon endroit. Vérifie le chemin et la syntaxe (une virgule en trop suffit).
Erreur 401	KLORIA_API_KEY n’est pas visible dans ce terminal, ou la clé est invalide. opencode auth list montre les identifiants enregistrés.
« No available channel for model… »	Un identifiant de la section models est inexact.