Configuration des Coding Agents

Configurer Kodacode : API Key, Base URL et erreurs 429

Configurez Kodacode avec une API Key BetterToken, une Base URL et un Model ID, puis résolvez les erreurs 429 et autres problèmes courants. Avec exemples.

Pour connecter Kodacode à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza. Si l’erreur concerne MonkeyCode, consultez le guide MonkeyCode distinct.

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é
L’extension Kodacode / Koda est installée
Copiez le Model ID exact depuis la model plaza.

Installation

Installez ou ouvrez Kodacode, puis poursuivez avec la configuration manuelle ci-dessous.

Configuration manuelle

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

Configuration

Ouvrir le panneau Koda et ajouter un modèle

Ouvrez le panneau KODA dans la barre latérale VS Code, cliquez sur le sélecteur de modèle sous la zone de saisie et choisissez Add model: Agent.

Choisissez Add model: Agent dans le sélecteur de modèle du panneau Koda.

Renseigner les paramètres du modèle OpenAI compatible

Dans la boîte de dialogue d’ajout de modèle, utilisez ces valeurs :

Champ	Valeur recommandée
Provider	`Any OpenAI-compatible API`
API Base	`https://bettertoken.ai/v1/`
Model ID	Un model ID disponible du model plaza, par exemple `YOUR_MODEL_ID`
API Key	Votre BetterToken API Key

Cliquez sur Connect après avoir renseigné les champs.

Sélectionnez Any OpenAI-compatible API dans la boîte de dialogue d’ajout de modèle Kodacode et renseignez API Base, Model ID et API Key.

Confirmer que le modèle est actif

Une fois la connexion réussie, sélectionnez le nouveau modèle, tel que YOUR_MODEL_ID, dans le sélecteur sous la zone de saisie Koda. Envoyez un court message pour confirmer qu’il renvoie une réponse.

Vérifier config.yaml

Kodacode écrit la configuration dans ~/.koda/config.yaml. Ouvrez ce fichier pour confirmer que le modèle a été ajouté.

Fichier config.yaml Kodacode avec la configuration de modèle OpenAI compatible ajoutée.

Exemple de config.yaml

Utilisez cette structure complète comme référence. Remplacez YOUR_API_KEY par votre BetterToken API Key et ne validez pas une API Key réelle dans votre dépôt.

name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

Vérifier la connexion

Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

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.

Si la connexion échoue, vérifiez que API Base est https://bettertoken.ai/v1/ et conservez la barre oblique finale /.
Copiez le Model ID exact depuis la model plaza.
Si l’authentification échoue, copiez à nouveau l’API Key et évitez les espaces ou retours à la ligne superflus.
Si les modifications de config.yaml ne s’appliquent pas, redémarrez VS Code ou exécutez Developer: Reload Window.
BetterToken ne nécessite généralement pas de User-Agent supplémentaire ni d’en-têtes personnalisés.

Configuration avancée

Guides associés

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.