Junie CLI

Junie CLI accepte un endpoint personnalisé sous forme de profil JSON dans $JUNIE_HOME/models/, où baseUrl est l’URL complète de l’endpoint et fasterModel détermine où aboutissent les requêtes auxiliaires.

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

Étape par étape

1. Créez une clé sur /app/keys et copiez-la : elle n’est affichée qu’une seule fois. Exportez-la sous le nom KUNAVO_API_KEY dans le shell depuis lequel vous démarrerez Junie, ou insérez directement la clé dans le fichier. JetBrains précise que « les valeurs sans référence $${...} sont utilisées telles quelles ».
2. Enregistrez le JSON ci-dessus sous le nom $JUNIE_HOME/models/kunavo.json pour votre compte, ou .junie/models/kunavo.json pour le partager avec un dépôt. Le nom de fichier sans .json devient l’identifiant du profil ; c’est pourquoi le sélecteur ci-dessous affiche custom:kunavo.
3. Définissez id sur l’identifiant du modèle que vous voulez réellement utiliser. Il est décrit comme « l’identifiant du modèle attendu par l’endpoint API » ; vous pouvez donc saisir directement un identifiant Kunavo du tableau ci-dessous. Les identifiants sont résolus par l’endpoint, et non par Junie.
4. Démarrez Junie et choisissez le profil : junie --model custom:kunavo, ou la commande /model dans une session interactive. Les modèles personnalisés « apparaissent dans la liste de sélection après les fournisseurs intégrés ».
5. Donnez-lui une tâche qui modifie un fichier plutôt qu’une simple formule de salutation. Junie est un client agentique et s’appuie sur les appels d’outils pour presque tout ce qu’il fait. Une première exécution qui lit et écrit quelque chose vous en apprendra donc bien plus qu’une simple réponse.

Vérifié avec Page des modèles LLM personnalisés de JetBrains pour Junie 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 Junie CLI.

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

Les deux autres valeurs apiType auxquelles Kunavo répond

apiType désigne un format de requête, et non un fournisseur. Junie accepte quatre valeurs : OpenAICompletion, OpenAIResponses, Google et Anthropic. Kunavo propose trois routes ; deux des trois autres valeurs ont donc une baseUrl correspondante ici. Comme Junie n’ajoute aucun chemin, changer de format implique aussi de modifier l’URL :

1. "apiType": "OpenAICompletion" avec https://api.kunavo.com/v1/chat/completions — le profil ci-dessus, recommandé sur cette page, car cette route est la plus utilisée des trois.
2. "apiType": "Anthropic" avec https://api.kunavo.com/v1/messages — Kunavo répond au format Messages sur cette route.
3. "apiType": "OpenAIResponses" avec https://api.kunavo.com/v1/responses.

Déterminer lequel des trois apiType de Junie fonctionne le mieux avec un modèle donné relève précisément d’un test à l’exécution, et non d’une lecture de la documentation ; cette page ne les classe donc pas au-delà de la première ligne. Choisissez-en un, gardez l’URL et le apiType cohérents, et si un profil avec une clé renvoie une erreur 401, indiquez explicitement les identifiants d’accès au lieu de deviner quel en-tête Junie utilise. JetBrains ne documente apiKey que sous forme négative : « Si omis, les requêtes sont envoyées sans en-tête Authorization » — et ne précise jamais le schéma utilisé lorsqu’il est présent. extraHeaders est décrit comme « des en-têtes HTTP supplémentaires à inclure dans chaque requête » et accepte les mêmes références $${VAR}, ce qui fait de "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"} la forme sans ambiguïté.