Configuration des Coding Agents

Configurer Kilo Code : clé API, Base URL et modèles

Installez Kilo Code, configurez la Base URL et l’API Key BetterToken, choisissez un modèle disponible et résolvez les erreurs courantes.

Pour connecter Kilo Code à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

La configuration tient en trois étapes : ajoutez un Custom provider dans les paramètres Providers de Kilo Code, choisissez OpenAI Compatible, puis saisissez la BetterToken API Key, https://bettertoken.ai/v1 et un Model ID actuel. Enregistrez, redémarrez l’extension et envoyez une première requête courte dans une nouvelle conversation pour vérifier la connexion.

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actuel du model plaza

Prérequis

La version actuelle de l’outil est installée
Une BetterToken API Key : inscrivez-vous pour en obtenir une
Un Model ID du model plaza

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.

Exigences supplémentaires

VS Code est installé

Installation

Si Kilo Code est déjà installé, passez directement à la configuration manuelle pour saisir votre BetterToken API Key, la Base URL et le Model ID.

Si vous devez encore installer l’extension ou souhaitez comprendre le contexte d’installation et d’utilisation régionale, consultez le guide en anglais sur l’installation et l’API personnalisée de Kilo Code, puis revenez ici pour utiliser les champs de configuration actuels.

Configuration manuelle

Effectuez cette configuration dans l’interface des paramètres Kilo Code. Vous n’avez pas besoin de modifier de fichier de configuration.

Champ	Valeur
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un Model ID actuel du model plaza

Configuration

Effacer les variables d’environnement en conflit

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Ouvrir les paramètres Kilo Code

Ouvrez Settings (icône d’engrenage), sélectionnez Providers, puis cliquez sur Custom provider en bas de la liste.

Configurer le fournisseur d’API

Renseignez :

Provider ID → bettertoken
Display name → BetterToken
Provider API → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → votre BetterToken API Key
Models → ajoutez manuellement un model ID copié depuis le model plaza et utilisez le même ID comme nom d’affichage

Cliquez sur Submit pour enregistrer le fournisseur. Il s’agit des champs de l’extension VS Code décrits dans le guide officiel Custom Models.

Configurer des en-têtes supplémentaires uniquement si la documentation officielle l’exige explicitement

La documentation officielle Kilo Code consultée mentionne des en-têtes personnalisés facultatifs pour les fournisseurs OpenAI compatibles, mais ne présente pas User-Agent comme une étape obligatoire de configuration BetterToken.

Si vous utilisez aussi une passerelle personnalisée, un routage de locataire, une couche d’observabilité ou de cache, ajoutez des en-têtes uniquement selon la documentation officielle de ce service en amont.

Redémarrer Kilo Code

Après avoir modifié la configuration, redémarrez VS Code ou rechargez l’extension Kilo Code pour appliquer les nouveaux paramètres.

Vérifier la connexion

Envoyez une première requête courte, par exemple Réponds uniquement : OK. Si l’outil répond sans erreur d’authentification ou de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après une modification. En cas d’échec, consultez les erreurs courantes.

CLI Kilo

Installez le CLI Kilo officiel séparément de l’extension. Lors d’un test sur macOS avec un modèle GPT, Kilo CLI 7.8.17 a traité des requêtes texte et des appels d’outils de lecture de fichiers via /v1/chat/completions.

Définissez votre BetterToken API Key dans le terminal :

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Créez kilo.json dans votre projet. Remplacez chaque YOUR_MODEL_ID par l’ID exact du model plaza :

{
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1",
        "apiKey": "{env:BETTERTOKEN_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  },
  "model": "bettertoken/YOUR_MODEL_ID",
  "permission": { "read": "allow", "edit": "deny", "bash": "deny" },
  "agent": { "build": { "steps": 4 } }
}

Pointez KILO_CONFIG vers ce fichier et exécutez un test texte sans interface :

export KILO_CONFIG="$PWD/kilo.json"
kilo run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Vérifiez que la réponse finale contient OK. Cette configuration autorise la lecture de fichiers et bloque les modifications ainsi que les commandes shell. En passant le fichier via KILO_CONFIG, vous le définissez comme source de configuration approuvée, ce qui permet de développer les références {env:...}. Une configuration de projet chargée uniquement depuis le dépôt ne développe pas ces références ; gardez la sélection explicite KILO_CONFIG ci-dessus.

Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ Model dans la configuration. Utilisez le Model ID exact du model plaza, puis redémarrez la session actuelle.

Erreurs courantes

Erreur	Vérifications
`401` ou `Unauthorized`	Vérifiez la BetterToken API Key et supprimez les espaces initiaux ou finaux.
`404`	Vérifiez la Base URL et n’ajoutez pas de chemin d’endpoint spécifique.
`model not found`	Copiez un Model ID actuel depuis le model plaza.
Les modifications ne sont pas appliquées	Enregistrez la configuration et redémarrez complètement l’outil.

Détails techniques

Protocole, endpoint et champs internes du fournisseur

Cette configuration utilise https://bettertoken.ai/v1. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas /chat/completions ni /responses sauf si un champ spécifique l’exige explicitement.