Documentation

Kimi Code

Kimi Code conserve ses fournisseurs dans un fichier TOML. Pour un point de terminaison tiers, trois clés y sont nécessaires : type, base_url, api_key. Configurez-en un pour Kunavo et l’interface en ligne de commande pourra communiquer avec les identifiants de modèles Claude et GPT via le protocole qu’elle prend déjà en charge.

Kimi Code conserve les fournisseurs dans ~/.kimi-code/config.toml — définissez providers.<name>.base_url sur https://api.kunavo.com/v1 avec type = "openai" et la CLI exécute les identifiants Claude et GPT avec une seule clé.

~/.kimi-code/config.toml

default_model = "kunavo/claude-sonnet-5"

[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000

base_url conserve le suffixe /v1. La page des fournisseurs tranche la question sans qu’il soit nécessaire de déduire quoi que ce soit : la valeur par défaut documentée de type = "openai" est https://api.openai.com/v1, et l’exemple pratique de la page sur les variables d’environnement pour un point de terminaison tiers est KIMI_MODEL_BASE_URL="https://api.example.com/v1". Kimi Code ajoute uniquement la route ; une origine seule renvoie donc une erreur 404 plutôt qu’une erreur d’authentification. C’est l’inverse des clients utilisant le protocole Anthropic, qui attendent https://api.kunavo.com sans suffixe.

Exporter une variable shell ne fournit pas de clé au fournisseur. La page de Kimi Code consacrée aux fichiers de configuration est explicite : exécuter export KIMI_API_KEY dans le terminal ne fournit sa clé à aucun fournisseur. L’ordre de priorité documenté est api_key ou api_key_env — définissez-en exactement une, car elles s’excluent mutuellement —, puis une clé dans la sous-table [providers.kunavo.env] si aucune des deux n’est présente. Si elles sont toutes absentes, le démarrage échoue avec une erreur. Pour ne pas enregistrer la clé dans le fichier, écrivez api_key_env = "KUNAVO_API_KEY" au lieu de api_key ; si la variable n’est pas définie ou est vide, la requête échoue avec une erreur qui nomme la variable.

Kunavo n’a pas exécuté ce client avec son propre point de terminaison. Le bloc ci-dessus est tiré de la documentation actuelle de Kimi Code, et non d’une session : aucune exécution en streaming ou avec appel d’outil par Kimi Code n’a été enregistrée ici. Considérez donc la première vraie requête comme le test, et non comme une confirmation. La page publiée décrit la configuration ; elle ne constitue pas une validation.

type désigne le protocole, et non le fournisseur. La liste documentée comprend kimi, anthropic, openai, openai_responses, google-genai et vertexai — la table actuelle ne comporte pas de variante OpenAI héritée, donc tout guide qui vous recommande d’en définir une est antérieur à cette table. Choisir openai puis saisir l’identifiant d’un modèle Claude est la combinaison prévue : l’identifiant est résolu au niveau de l’URL de base, et non dans l’interface en ligne de commande.

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 Kimi Code.

Étape par étape

Créez une clé sur /app/keys et copiez-la — elle n’est affichée qu’une seule fois.
Ouvrez ~/.kimi-code/config.toml, créé lors du premier lancement. Si vous avez déplacé le répertoire de données avec KIMI_CODE_HOME, le fichier se trouve dans $KIMI_CODE_HOME/config.toml ; son nom reste toujours config.toml.
Ajoutez la table [providers.kunavo] ci-dessus. Pour ce type, la documentation présente ces trois clés dans cet ordre : type, base_url et api_key.
Déclarez un alias de modèle sous [models."..."] avec provider, model et max_context_size — les trois sont obligatoires. Cet alias est le nom que vous transmettez à -m et à default_model ; la valeur model est l’identifiant envoyé sur le réseau. Mettez entre guillemets tout alias contenant un point.
Lors de la première configuration, omettez capabilities. La page des fournisseurs indique que les capacités sont automatiquement associées selon le préfixe du nom du modèle, et la table des modèles précise que les valeurs du tableau sont uniquement ajoutées, jamais supprimées. Une balise incorrecte ne peut donc pas être annulée par la suite en modifiant la configuration.
Exécutez kimi, ou kimi -m kunavo/claude-sonnet-5 pour choisir l’alias d’une session. Pour essayer le point de terminaison sans toucher à la configuration, définissez KIMI_MODEL_NAME, KIMI_MODEL_API_KEY, KIMI_MODEL_PROVIDER_TYPE=openai et KIMI_MODEL_BASE_URL : l’interface en ligne de commande crée un fournisseur en mémoire sans rien réécrire.

Vérifié avec Page de Kimi Code consacrée aux fournisseurs et aux modèles 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 Kimi Code ou Claude Code — quel client, quel modèle, quel compte ?.

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 Kimi Code.

# 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 Kimi Code
`claude-sonnet-5`	$1.40 / $7.00	l’alias par défaut — le modèle de travail pour les cycles de modification et d’exécution
`claude-opus-5`	$3.50 / $17.50	un deuxième alias pour les étapes de planification, où un mauvais plan coûte cher
`claude-haiku-4-5`	$0.70 / $3.50	l’alias économique à associer sous [secondary_model] pour les sous-agents
`gpt-5-6-sol`	$2.00 / $12.00	un deuxième avis d’une autre famille, avec la même clé et la même table de fournisseurs

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.

Questions fréquentes

Comment diriger Kimi Code vers un point de terminaison API personnalisé ?

Ajoutez une table de fournisseur à ~/.kimi-code/config.toml avec type = "openai", base_url défini sur votre point de terminaison et api_key défini sur votre clé, puis déclarez un alias de modèle sous [models."<alias>"] avec provider, model et max_context_size. La page des fournisseurs de Kimi Code indique que type = "openai" convient au protocole OpenAI Chat Completions et à tout service tiers compatible, en remplaçant au besoin base_url. Vous pouvez aussi ouvrir le gestionnaire de fournisseurs avec /provider dans l’interface textuelle, mais son parcours pour les fournisseurs connus importe les données du catalogue models.dev ; il est donc plus rapide d’ajouter manuellement un point de terminaison absent de ce catalogue.

L’URL base_url de Kimi Code doit-elle se terminer par /v1 ?

Oui, pour un point de terminaison compatible avec OpenAI. Kimi Code ajoute uniquement la route ; base_url doit donc être la racine /v1, par exemple https://api.kunavo.com/v1. La documentation tranche la question sans qu’il soit nécessaire de déduire quoi que ce soit : la valeur base_url par défaut pour type = "openai" est https://api.openai.com/v1, et l’exemple tiers de la page sur les variables d’environnement est https://api.example.com/v1. Si /v1 est absent, vous obtenez une erreur 404 et non une erreur 401.

Pourquoi Kimi Code indique-t-il que ma clé API est manquante alors que la variable est exportée ?

Parce qu’il ne lit pas les variables d’environnement du shell pour obtenir des identifiants, sauf si vous lui indiquez laquelle lire. La page consacrée aux fichiers de configuration précise qu’exécuter export KIMI_API_KEY ne fournit sa clé à aucun fournisseur. Vous pouvez soit inscrire directement api_key dans config.toml, soit définir api_key_env avec le nom de la variable — ces deux options s’excluent mutuellement, il faut donc en définir exactement une. La sous-table [providers.<name>.env] est consultée uniquement si aucune des deux n’est présente. Si les trois sont absentes, le démarrage échoue avec une erreur.

Kimi Code peut-il utiliser des modèles Claude via un fournisseur tiers ?

Le type de fournisseur désigne un protocole, et non un fournisseur, et la valeur du modèle est transmise telle quelle à l’URL de base configurée. Un identifiant Claude défini pour un fournisseur de type openai est donc résolu à ce point de terminaison plutôt que dans l’interface en ligne de commande. Kimi Code propose aussi un fournisseur distinct de type = "anthropic" pour le protocole Anthropic Messages, dont l’URL de base est l’origine seule, sans suffixe /v1. Kunavo n’a pas exécuté de session Kimi Code avec son propre point de terminaison via l’un ou l’autre protocole. Vérifiez donc avec la requête curl ci-dessus et considérez votre première session comme le test.