Configuration des Coding Agents

OpenCode : modèles personnalisés, API Key et Base URL

Connectez OpenCode aux Chat Completions BetterToken compatibles avec OpenAI à l’aide de /connect, opencode.json, d’une API Key, d’une Base URL et d’un Model ID.

OpenCode se connecte à BetterToken avec @ai-sdk/openai-compatible. Nommez le fournisseur OpenCode BetterToken ou OpenAI Compatible. Utilisez cette page pour la configuration générale de l’API Key, de la Base URL ou d’opencode.json. Consultez le guide GLM ou le guide Kimi K3 pour sélectionner et vérifier l’un de ces modèles. Copiez le Model ID exact depuis la model plaza.

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modèle	`YOUR_MODEL_ID`

Prérequis

Installez OpenCode 1 avec les commandes ci-dessous
Créez une BetterToken API Key
Copiez un Model ID depuis le model plaza ou la boîte de dialogue Setup de l’API Key

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Installation

Ces commandes installent OpenCode 1. Pour OpenCode 2, utilisez son guide d’installation. OpenCode 2 lit la configuration existante aux mêmes emplacements et convertit les paramètres V1 pris en charge des fournisseurs ; consultez le guide de migration avant de modifier la syntaxe de configuration.

curl

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

npm

npm install -g opencode-ai

Configuration par la ligne de commande

Le script de configuration automatique BetterToken crée ou met à jour le fournisseur BetterToken dans OpenCode. Il nécessite Node.js. Si vous ne transmettez pas l’API Key ou le Model ID en argument, le script vous les demande.

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"

Sélectionnez bettertoken/YOUR_MODEL_ID une fois le script terminé. Si OpenCode est déjà en cours d’exécution, redémarrez-le avant le test.

Configuration manuelle

Option 1 : enregistrer les identifiants avec /connect

Lancez OpenCode et exécutez :

/connect

Choisissez Other, saisissez bettertoken comme identifiant du fournisseur, puis entrez YOUR_API_KEY. OpenCode enregistre l’identifiant localement.

Option 2 : configurer le JSON

Le fichier global est ~/.config/opencode/opencode.json. Un projet peut utiliser opencode.json à sa racine.

{
  "$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 vous n’utilisez pas /connect, ajoutez "apiKey": "YOUR_API_KEY" sous options. Ne commitez jamais une configuration contenant une véritable Key.

Cet exemple utilise @ai-sdk/openai-compatible pour Chat Completions. Le package SDK doit correspondre au protocole du point de terminaison ; consultez les instructions officielles sur les fournisseurs avant d’utiliser un autre protocole. Lors d’un test sur macOS avec un modèle GPT, OpenCode 1.19.4 et 2.1.4 ont tous deux réussi les appels d’outils de lecture de fichiers avec chaque SDK : @ai-sdk/openai-compatible utilisait /v1/chat/completions et @ai-sdk/openai utilisait /v1/responses. Les quatre cas de lecture de fichiers ont réussi avec read autorisé et edit et bash bloqués.

Vérifier la connexion

Exécutez opencode dans un projet, sélectionnez bettertoken/YOUR_MODEL_ID et envoyez un court message. Une réponse normale confirme la configuration. Redémarrez OpenCode après avoir modifié le JSON.

Pour tester une requête texte sans interface avec OpenCode 1 :

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

OpenCode 2 nécessite --standalone pour cette exécution sans interface :

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

Changer de modèle

Ajoutez un nouveau YOUR_MODEL_ID sous provider.bettertoken.models, mettez à jour le champ model de premier niveau, enregistrez et redémarrez OpenCode.

Erreurs fréquentes

Erreur	Solution
`401`	Exécutez de nouveau `/connect` ou vérifiez `apiKey`.
`404`	Utilisez uniquement `https://bettertoken.ai/v1` comme `baseURL` ; n’ajoutez pas `/chat/completions`.
Modèle introuvable	Faites correspondre exactement le champ `model` de premier niveau à un ID sous `models`.
Configuration non appliquée	Vérifiez si le fichier `opencode.json` du projet remplace le fichier global, puis redémarrez OpenCode.