Documentation

Qoder

L’application de bureau autonome Qoder accepte une Base URL arbitraire sous Provider → Custom. Renseignez trois champs et saisissez manuellement un identifiant de modèle : Qoder communique alors avec Claude et GPT avec une seule clé, alors qu’aucun de ces modèles ne figure dans son propre catalogue.

Qoder Settings → Models → + Add → Provider → Custom accepte une Base URL compatible OpenAI, une API Key et des Model IDs saisis manuellement — l’application Qoder autonome accède ainsi à Claude et GPT, absents de son propre catalogue.

Paramètres de Qoder → Modèles → + Ajouter → Fournisseur → Personnalisé

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

Il s’agit de l’application Qoder autonome, et non de Qoder IDE. « Qoder » désigne une famille de produits documentés séparément, et seule l’application de bureau autonome documente un point de terminaison arbitraire : sa page sur les modèles personnalisés propose OpenAI Compatible et Anthropic Compatible sous Custom, et la note de version 0.1.8 du 5 septembre 2026 l’a présenté ainsi : « BYOK est désormais compatible avec les Base URL personnalisées pour tout service de modèles compatible avec OpenAI ou Anthropic, dans le cadre du forfait Personal ». La page sur les modèles personnalisés de Qoder IDE répertorie uniquement des fournisseurs nommés et ne contient jamais la chaîne Base URL. Si le champ ne s’affiche pas à l’écran, vous utilisez probablement un autre produit Qoder.

La Base URL conserve le suffixe /v1. La page de Qoder indique de « saisir la Base URL exacte fournie par le service de modèles », puis présente https://api.example.com/v1 comme format d’exemple. Pour un point de terminaison compatible avec OpenAI, le champ attend donc la racine /v1, et non l’origine seule. C’est l’inverse des clients de type Anthropic, qui attendent https://api.kunavo.com et ajoutent eux-mêmes la route.

Qoder propose aussi un fournisseur personnalisé Anthropic Compatible, et Kunavo prend également en charge /v1/messages. Sa documentation publie un exemple de Base URL sans préciser quelle route chaque protocole ajoute ; elle ne permet donc pas de déterminer si ce type attend https://api.kunavo.com ou https://api.kunavo.com/v1. Le chemin compatible avec OpenAI ci-dessus correspond à son propre exemple. Si vous choisissez plutôt le type Anthropic, essayez les deux formes. La liste de dépannage de Qoder commence précisément par ce point : « Vérifiez que la Base URL est complète et que le protocole compatible et le type d’API sélectionnés correspondent au point de terminaison ».

Kunavo n’a pas exécuté de session dans Qoder. Rien ici ne constitue un test du comportement réel du client : les champs sont retranscrits depuis la page propre à Qoder à la date indiquée ci-dessous, et les informations sur le point de terminaison proviennent de l’interface publiée par Kunavo. Le bouton Validate and Add Model de Qoder est l’étape qui vérifie réellement la paire ; cette vérification s’effectue sur votre machine, pas sur la nôtre.

Pas encore de clé ? Créez un compte Kunavo, créez une clé (elle commence par sk-kn-) et ajoutez un crédit à partir de 10 $ — les appels sont payés sur ce solde et les appels échoués ne sont pas facturés. Le tableau de bord s’ouvre ensuite sur la configuration Qoder.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Ouvrez Qoder Settings, sélectionnez Models dans la navigation de gauche, puis cliquez sur + Add.
Ouvrez Provider et sélectionnez OpenAI Compatible sous Custom — pas l’un des fournisseurs prédéfinis qui le précèdent. Choisissez ensuite Chat Completions API comme type d’API.
Saisissez la Base URL, l’API Key et au moins un Model ID. Qoder ne documente aucune détection automatique de la liste de modèles pour ce champ : saisissez donc les identifiants. Pour chaque modèle supplémentaire sur le même point de terminaison, cliquez sur Add Model ID.
Cliquez sur Next et définissez les capacités que Qoder ne peut pas déduire : Display name, Supported Context Windows et, parmi ces valeurs, une Default Context Window, ainsi que les options Vision et Thinking Mode lorsque le modèle les prend en charge.
Cliquez sur Validate and Add Model. La page de Qoder consacrée au sélecteur de modèles indique qu’après son ajout, « le modèle est disponible dans les sélecteurs de modèles des tâches, de l’agent et de l’automatisation ».

Vérifié avec la page de l’application Qoder autonome consacrée aux modèles personnalisés 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.

Voici la version courte. Le guide complet — choix du modèle, coût d’une session réelle et modes d’échec — se trouve dans Qoder ou Claude Code — quel Qoder, quel point de terminaison, quelle facture.

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 Qoder.

# 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.

Identifiant du modèle	Entrée / sortie sur Kunavo	Où cela s’intègre dans Qoder
`claude-sonnet-5`	$1.40 / $7.00	le modèle de travail par défaut pour les sélecteurs de tâches et d’agents
`claude-opus-5`	$3.50 / $17.50	les remaniements importants, où un plan erroné coûte plus cher que les jetons
`claude-haiku-4-5`	$0.70 / $3.50	les tâches d’automatisation à fort volume, où c’est le nombre qui domine
`gpt-5-6-sol`	$2.00 / $12.00	un deuxième avis d’une autre famille, avec la même clé et le même point de terminaison

La facturation se fait au token à partir d’un solde prépayé, sans frais mensuels — consultez la facturation. Avec un contexte répété — ce qu’envoient la plupart des éditeurs et clients de chat — la mise en cache des prompts influe davantage sur la facture que le choix du modèle.

Pourquoi votre version de Qoder peut ne pas avoir de champ Base URL

Trois interfaces Qoder documentent l’utilisation de votre propre clé, mais une seule documente un point de terminaison que vous pouvez choisir. C’est le seul élément qui détermine si la configuration ci-dessus est accessible depuis l’interface que vous utilisez ; vérifiez-le avant de modifier un fichier de configuration — d’autant que la page de Qoder CLI vous déconseille explicitement de le faire.

Interface	Base URL personnalisée documentée ?	Ce qu’indique sa propre page
Qoder (application autonome)	Oui	`OpenAI Compatible` et `Anthropic Compatible` se trouvent sous Custom dans la liste Provider, avec une Base URL, une API Key et un ou plusieurs Model ID à saisir manuellement. Cette page.
Qoder IDE	Non	Sa page sur les modèles personnalisés indique « Applicable For: Users with Individuals plans » et cite les fournisseurs Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax et Xiaomi MIMO. La chaîne `Base URL` n’y apparaît pas.
Qoder CLI	Pas sur la page de documentation	Un onglet Custom se trouve sous `/model`, avec `Add custom model...`, mais la page ne documente aucune Base URL et avertit : « Ne configurez pas manuellement BYOK dans `settings.json` ».

Qoder CLI prête à confusion, car ses notes de version et sa documentation ne concordent pas. La note de version 1.1.50 du 11 septembre 2026 indique : « Les utilisateurs de l’édition Personal peuvent désormais configurer et gérer de façon centralisée, depuis la page Custom, des modèles BYOK avec des points de terminaison URL personnalisés ». Pourtant, la page sur les modèles personnalisés, toujours en ligne, décrit un catalogue : « les fournisseurs, modèles et champs d’identification disponibles sont déterminés par le catalogue BYOK associé au compte actuel ». Ces deux pages, ainsi que celle de l’IDE, réservent cette fonctionnalité au forfait Individual. Si l’onglet Custom est absent ou ne comporte pas de champ de point de terminaison, vérifiez le forfait associé au compte et les options proposées dans son catalogue. Ne modifiez pas un fichier de configuration : la page de Qoder CLI déconseille de le modifier manuellement et précise qu’il est de toute façon régénéré à partir du catalogue.

Questions fréquentes

Comment ajouter un fournisseur personnalisé à Qoder ?

Dans l’application de bureau autonome Qoder : ouvrez Qoder Settings, sélectionnez Models dans la navigation de gauche, cliquez sur + Add, puis ouvrez Provider et choisissez « OpenAI Compatible » ou « Anthropic Compatible » sous Custom. Pour le type OpenAI, choisissez aussi l’API Chat Completions ou Responses. Saisissez la Base URL, l’API Key et au moins un Model ID. Pour ajouter d’autres modèles sur le même point de terminaison, utilisez Add Model ID. Cliquez sur Next pour définir Display name, Supported Context Windows, Default Context Window, Vision et Thinking Mode, puis cliquez sur Validate and Add Model. Qoder vérifie la connexion avant d’enregistrer.

La Base URL de Qoder doit-elle se terminer par /v1 ?

Pour un point de terminaison compatible avec OpenAI, oui. La page de Qoder sur les modèles personnalisés indique de saisir la Base URL exacte fournie par le service de modèles et présente https://api.example.com/v1 comme format d’exemple. Le champ attend donc la racine /v1, et non l’origine seule ; pour Kunavo, utilisez https://api.kunavo.com/v1. Pour le type Anthropic Compatible, la page ne fournit pas d’exemple distinct et ne précise pas quelle route est ajoutée. Sa documentation ne tranche donc pas ce cas : essayez d’abord la racine /v1, puis l’origine seule si la validation échoue.

Pourquoi l’onglet Custom ou le champ Base URL n’apparaît-il pas dans mon Qoder ?

Les trois interfaces Qoder appliquent des règles différentes à l’utilisation de votre propre clé. Seule l’application de bureau autonome Qoder documente une Base URL arbitraire. La page de Qoder IDE sur les modèles personnalisés répertorie des fournisseurs nommés et ne mentionne jamais de Base URL ; celle de Qoder CLI indique que les fournisseurs, modèles et champs d’identification disponibles sont déterminés par le catalogue BYOK associé au compte actuel. Les pages de l’IDE et de CLI réservent aussi cette fonctionnalité aux forfaits Individual. Si le champ est absent, vérifiez quel produit Qoder vous avez ouvert et ce que permettent le forfait et le catalogue associés à votre compte. La page de Qoder CLI déconseille expressément de configurer BYOK manuellement dans settings.json.

Qoder peut-il utiliser des modèles Claude sans compte Anthropic ?

Oui, via un fournisseur personnalisé ; le catalogue intégré de Qoder est un cas distinct. La page de Qoder consacrée au sélecteur de modèles répertorie Qwen, DeepSeek, GLM, Kimi et MiniMax, mais aucun modèle Claude, GPT ou Gemini. L’utilisation de votre propre clé est donc la méthode documentée pour en utiliser un. « OpenAI Compatible » désigne ici un choix de protocole réseau, et non un fournisseur : l’identifiant Model ID que vous saisissez est résolu à la Base URL configurée. Un identifiant Claude fonctionne donc si le point de terminaison le fournit ; les identifiants utilisés sont ceux de ce point de terminaison, et non ceux d’Anthropic.

Un modèle personnalisé dans Qoder consomme-t-il toujours des Qoder Credits ?

La page de Qoder sur les modèles personnalisés précise que les frais liés aux modèles personnalisés sont facturés directement sur le compte API de votre fournisseur et n’utilisent pas de Qoder Credits. Elle indique que Repo Wiki fait exception, car cette fonctionnalité utilise un modèle fixe et est facturée séparément, avec un message affiché lors de la génération. Du côté de Kunavo, la facturation se fait au jeton, à partir d’un solde prépayé, sans frais mensuels. Notez aussi que, pour un modèle personnalisé déjà enregistré, l’opération Edit de Qoder ne met à jour que la clé API. Pour modifier une Base URL, supprimez l’entrée et ajoutez-la à nouveau.

Kunavo a-t-il testé cette configuration dans Qoder ?

Non. Kunavo n’a exécuté de session dans aucune interface Qoder, et cette page n’est pas un rapport de compatibilité en conditions réelles : les noms et l’ordre des champs sont retranscrits depuis la page de Qoder sur les modèles personnalisés à la date indiquée, et les informations sur le point de terminaison proviennent de l’API publiée par Kunavo. La vérification utile s’effectue sur votre machine : le bouton Validate and Add Model de Qoder teste ensemble la Base URL, la clé et le Model ID avant de les enregistrer. Une simple commande curl adressée à la même Base URL avec la même clé permet de déterminer si l’échec vient du point de terminaison ou du client.