Theia IDE

Une entrée dans ai-features.openAiCustom.customOpenAiModels — model, url et apiKey — place Kunavo derrière Theia Coder, Architect et la complétion en ligne.

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

Étape par étape

1. Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
2. Activez la fonction : la documentation de Theia indique d’aller dans Préférences et d’activer le paramètre « AI-features => AI Enable ». Rien de ce qui suit ne s’affichera tant que ce ne sera pas fait.
3. Ouvrez la vue Configuration de l’IA — Alt+A, ou Configuration de l’IA dans le menu Manage (icône d’engrenage) en bas à gauche, juste sous Settings. Ses catégories sont Général, Fournisseurs et modèles, Alias de modèles, Agents, Prompts et compétences, Variables, Outils, Utilisation des jetons et Serveurs MCP.
4. Ajoutez les entrées ci-dessus. La documentation indique qu’il faut cliquer sur le lien dans la section des paramètres pour OpenAI Compatible Models — la préférence est une liste structurée, et Theia précise que les paramètres structurés sans éditeur dédié « renvoient vers settings.json », le fichier où vous aboutissez. Un objet par identifiant de modèle ; les url et apiKey se répètent.
5. Associez un élément à ce modèle. Sous Agents, chaque agent dispose d’un sélecteur Language Model ; de nombreux agents résolvent plutôt un alias de modèle. Définir default/code, default/universal, default/code-completion, default/summarize et default/fast sous Model Aliases permet donc de déplacer plusieurs agents à la fois.
6. Envoyez un message de chat à Theia Coder, puis demandez-lui de faire quelque chose qui touche à un fichier. Les agents de cet IDE s’appuient sur les appels d’outils et le contenu de l’espace de travail ; un premier essai qui lit ou modifie quelque chose vous en apprend donc davantage qu’une salutation — et Token Usage, dans la même vue, indique le coût du tour en tokens.

Vérifié avec la page des fonctionnalités d’IA de l’IDE Theia, section OpenAI Compatible Models le 21 septembre 2026. Les paramètres tiers évoluent ; si le nom d’un champ ne correspond plus à ce que vous voyez ici, cette page fait autorité, pas celle-ci.

Vérifiez avant de déboguer le client

Une requête suffit à déterminer si l’échec vient de l’endpoint, de la clé ou du fichier de configuration. Si cette requête renvoie du JSON, la même URL de base et la même clé fonctionnent dans Theia IDE.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Quel identifiant de modèle saisir dans le champ

Tous les modèles textuels sont accessibles sous forme d’identifiant de modèle — la liste à jour se trouve sur GET /v1/models, et le catalogue avec les prix sur la page des modèles. Les tarifs sont en USD par million de tokens, entrée / sortie.

Ce que Theia affirme au sujet de ce fournisseur

Dans le tableau LLM Providers Overview de sa propre page, Theia évalue chaque fournisseur selon trois axes. Il s’agit des affirmations de Theia sur Theia, reprises de ce tableau à la date indiquée ci-dessus — ce n’est pas un résultat de test de Kunavo, et la colonne intitulée « Ce que cela exige de l’identifiant de modèle » est la seule partie de ce tableau rédigée ici.

Deux paragraphes plus haut, Theia ajoute une réserve à ce tableau, qui mérite d’être répétée car elle donne le cadre honnête de toute cette page : tous les modèles « ne fonctionneront pas nécessairement dès le départ, car ils peuvent nécessiter des personnalisations ou optimisations spécifiques ».

Ce qui coûte réellement de l’argent

L’IDE Theia est libre et gratuit à télécharger, et ses fonctionnalités d’IA ne sont pas facturées — ce qui coûte de l’argent, ce sont les appels au modèle, facturés par le détenteur de la clé dans apiKey. Deux paramètres ont davantage d’incidence sur cette facture que le choix du modèle, et tous deux figurent dans la documentation :

1. Automatic Code Completion est activé par défaut ; la documentation indique qu’il effectue des « requêtes continues au LLM sous-jacent pendant la programmation ». C’est l’agent qui s’exécute des milliers de fois par jour. Associez default/code-completion à un identifiant peu coûteux, ou passez l’agent en mode manuel dans 'AIFeatures'=>'CodeCompletion' et déclenchez-le avec Ctrl+Alt+Space.
2. Max Context Lines, dans le même groupe de paramètres, limite la quantité de contenu environnant du fichier incluse dans chaque requête de complétion. Chaque ligne est facturée comme entrée à chaque appel déclenché par une frappe.

Les agents de chat ont le profil inverse : moins d’appels, un contexte bien plus vaste et les mêmes fichiers de l’espace de travail renvoyés à chaque tour. C’est précisément le cas d’usage de la mise en cache des prompts — voir /docs/caching — et c’est pourquoi les deux moitiés du tableau des modèles ci-dessus sont séparées selon la fréquence d’exécution de l’agent, plutôt que selon son niveau d’intelligence.

En cas de problème de connexion

1. 404 — le url. Kunavo sert /v1/chat/completions ; le champ attend donc la racine /v1. Une origine seule ou un .../chat/completions complet ne convient pas.
2. 401 — la clé. Le Readme de Theia précise que le apiKey « sera envoyé comme Bearer Token dans la requête d’autorisation », ce qui correspond exactement à ce qu’attend une clé sk-kn-. Notez la valeur par défaut documentée : en l’absence totale de apiKey, Theia envoie no-key ; un champ manquant ressemble donc à une clé rejetée plutôt qu’à une clé absente. (true signifie « utiliser la clé API OpenAI globale » — ce n’est pas ce qu’il vous faut ici.)
3. L’identifiant du modèle n’apparaît pas dans la liste — cette liste provient de vos propres entrées customOpenAiModels, et non du point de terminaison ; un identifiant absent signifie donc qu’il manque un objet. Le champ id est celui affiché dans l’interface ; omettez-le et le nom du modèle sera utilisé à la place.
4. Le premier message système est rejeté ou ignoré — c’est le developerMessageSettings. Sa valeur par défaut est developer, un rôle au format OpenAI ; l’exemple de Theia pour un fournisseur autre qu’OpenAI définit system, d’où le choix dans le bloc ci-dessus. user, mergeWithFollowingUserMessage et skip sont les autres possibilités documentées.
5. Aucune réponse, où que ce soit — vérifiez la confiance accordée à l’espace de travail. Theia exige cette confiance pour toutes ses fonctionnalités d’IA ; un espace de travail non approuvé désactive le champ de saisie du chat et la complétion en ligne, et affiche le message AI Features are Restricted.