Qu’est-ce que le Kilo Code ?
Kilo Code, de Kilo AI, est un agent de codage d'IA open source disponible dans VS Code, JetBrains et CLI, avec des fournisseurs de modèles configurables.
Ce guide de configuration de Kilo Code utilise ses contrôles de fournisseur compatibles OpenAI pour connecter TokenHub. Commencez par une tâche en lecture seule, puis validez les modifications et les commandes avec un modèle compatible avec les outils. Kilo Code expose les flux de travail associés dans VS Code, JetBrains et la CLI, mais la portée de la configuration peut différer entre ces clients. Confirmez le profil actif et le fournisseur dans le client que vous utilisez réellement, puis comparez la qualité du modèle, la fiabilité de l'outil, la latence, la longueur du contexte et le coût sur une tâche de référentiel représentative.
Kilo Code peut acheminer ses requêtes de modèle via la passerelle API OpenAI compatible de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.
L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/chat/completions.
Quand l’utiliser
Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.
Installer ou ouvrir l’outil
Suivez la documentation officielle Kilo Code pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.
Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :
# open the tool, then open its model or provider settingsPréparer les identifiants TokenHub
Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.
export TOKENHUB_API_KEY="sk-..."Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.
Configurer le fournisseur TokenHub
Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.
Valeurs du provider
| Champ | Valeur |
|---|---|
| Fournisseur | OpenAI Compatible ou Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | La valeur de TOKENHUB_API_KEY |
| Modèle | gpt-4.1 ou un autre model ID TokenHub |
Emplacements des réglages
| Champ | Valeur |
|---|---|
| Provider settings | Kilo Code → Providers → Custom provider |
| Provider API | OpenAI Compatible |
| Required fields | Provider ID, Base URL, API Key, Model ID |
Save the custom provider in Kilo Code, let it fetch /v1/models when available, or add the TokenHub model ID manually. Verify a chat request before enabling agent edits.
Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.
Variables temporaires pour le diagnostic
Utilisez d’abord l’interface de réglages quand l’extension possède son propre schéma. Elle stocke les mêmes valeurs au niveau utilisateur et évite de deviner des clés privées qui peuvent changer.
Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.
Vérifier la connexion
Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.
Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.
Dépannage
| Symptôme | Correction |
|---|---|
| 401 ou échec d’authentification | Vérifiez que TOKENHUB_API_KEY est valide et enregistré dans le même terminal, IDE ou profil client. |
| 404 ou modèle introuvable | Utilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi. |
| Endpoint incorrect | Gardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement /v1; les outils compatibles Claude non. |
| Timeout | Vérifiez le réseau vers https://us-api.tokenhub.com, les paramètres proxy et l’allowlist de l’espace de travail. |
| L’outil utilise un autre modèle | Revérifiez tous les emplacements chat, edit, apply, fast ou autocomplete. |
Choisir un modèle
FAQ sur l'API personnalisée Kilo Code
Pourquoi Kilo Code ne peut-il pas lire la liste des modèles TokenHub ?
Un échec de découverte automatique de modèle ne signifie pas nécessairement que l’API n’est pas disponible. Copiez l'ID de modèle exact depuis TokenHub et saisissez-le manuellement.
Que se passe-t-il si Chat fonctionne mais pas la complétion des onglets ?
Chat et Tab peuvent utiliser différents emplacements de modèle. Configurez un modèle à faible latence et compatible avec l'achèvement pour Tab et vérifiez-le séparément.
Pourquoi l'EDI ne peut-il pas lire TOKENHUB_API_KEY ?
Un IDE lancé à partir d'une icône du bureau ne peut pas hériter des variables d'environnement du terminal. Utilisez le champ de clé API sécurisé de Kilo Code pour effectuer la vérification initiale.
Les extensions Kilo Code CLI et IDE partagent-elles une configuration de modèle ?
Ils peuvent utiliser le même modèle TokenHub, mais la portée et les profils de configuration peuvent différer. Vérifiez l'URL de base, la clé, le modèle et le profil actif dans chaque client.
Et si Kilo Code pouvait discuter mais ne pouvait pas modifier le code ?
Confirmez que le modèle prend en charge les appels d'outils natifs et les arguments structurés, puis vérifiez les autorisations de modification et les approbations de commandes. La génération de texte de base ne valide pas la chaîne d'outils de l'agent.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。
