Intégrer Kimi K3.1 Pro à Kimi Code CLI : installation, connexion et le piège Windows

Kimi Code CLI est l'agent de codage en terminal de Moonshot, et c'est le seul client où Kimi K3.1 Pro n'est pas une intégration tierce mais l'option par défaut. La configuration est plus courte que les parcours Claude Code ou Codex — un script d'installation, une commande /login, un choix de plateforme — car le client et le modèle viennent de la même entreprise. Le hic est spécifique à la plateforme : sous Windows, la CLI s'exécute dans le Git Bash qu'elle embarque, et si ce shell ne se trouve pas à l'endroit où l'installateur l'attend, l'outil démarre puis échoue d'une manière qui ressemble à des erreurs de modèle.

Voici la séquence qui fonctionne, vérifiée par rapport à la documentation de Moonshot le 24 octobre 2026, avec les modes de défaillance signalés là où ils se produisent réellement.

Installer

macOS et Linux tiennent en une ligne : curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Windows PowerShell tient également en une ligne : irm https://code.kimi.com/kimi-code/install.ps1 | iex. Le script télécharge la dernière version, vérifie sa somme de contrôle et place l'exécutable kimi dans votre PATH. Aucun environnement d'exécution Node.js ou Python n'est requis.

Windows a un prérequis facile à négliger : installez d'abord Git for Windows. Kimi Code CLI utilise le Git Bash fourni comme environnement shell. Si Git Bash se trouve à un emplacement non standard, définissez la variable d'environnement KIMI_SHELL_PATH sur le chemin absolu de bash.exe avant le lancement — sinon, l'agent démarre mais chaque commande shell qu'il tente d'exécuter échoue.

Se connecter avec une clé API

Pour démarrer la CLI, placez-vous dans le répertoire du projet dans lequel vous souhaitez travailler :

• Exécutez kimi pour ouvrir l’interface interactive.

• Tapez /login. Kimi Code CLI ouvre un sélecteur de plateforme.

• Choisissez Kimi Platform (clé API · platform.kimi.ai). Il s'agit de l'option pour une clé créée sur la plateforme ouverte ; les autres correspondent à différentes interfaces de compte.

• Collez la clé. Créez-en une sur platform.kimi.ai dans API Keys si vous n’en avez pas. La CLI la stocke localement, donc traitez le répertoire de configuration comme un coffre d’identifiants.

Voilà toute la connexion. Le sélecteur de modèle intégré au CLI liste les modèles Kimi actuels, et Kimi K3.1 Pro ainsi que sa variante haute vitesse sont les deux qui comptent pour le travail agentique.

Changer une configuration existante et remplacer une clé

Deux migrations sont courantes, et toutes deux passent par le même écran. Si Kimi Code CLI est déjà connecté via un abonnement plutôt qu’avec une clé API, exécuter /login à nouveau et sélectionner la plateforme de clé API permet de basculer sans réinstallation. Si vous renouvelez une clé — parce qu’elle a fuité, ou parce qu’un projet a besoin de sa propre facturation — le même flux remplace l’identifiant stocké.

La seule chose à ne pas faire est de modifier à la main la configuration stockée pendant que le CLI est en cours d'exécution ; le processus lit les identifiants au démarrage et toute modification effectuée en cours de session est écrasée à la fermeture.

Ce que l’agent fait réellement

Kimi Code CLI n’est pas une fenêtre de chat dans un terminal. Il lit et modifie le code, effectue des recherches dans le dépôt, exécute des commandes et lit les résultats, et peut récupérer du contenu web ou effectuer des recherches lorsqu’une tâche nécessite des éléments extérieurs au projet. Moonshot le décrit comme un agent de codage qui s’exécute sur votre propre machine, le modèle se chargeant de la planification — la même architecture que Claude Code ou Codex, avec les mêmes implications en matière d’autorisations : un agent capable d’exécuter des commandes shell doit être lancé dans un répertoire que vous acceptez de le laisser modifier, et ses modifications doivent être relues avant que quoi que ce soit ne soit poussé.

Deux modèles de facturation se rencontrent chez ce client. L'application Kimi Code est vendue sous forme d'abonnement avec différents niveaux de formule, tandis que la CLI peut utiliser cet abonnement ou une clé API issue de la plateforme ouverte. C'est la voie de la clé API qui offre l'économie au token près — 2,00 $ et 10,00 $ par million de tokens pour K3.1 Pro, 4,00 $ et 20,00 $ pour la variante haute vitesse — alors que l'abonnement est un forfait fixe avec quota. Pour une équipe qui paie déjà pour un usage API ailleurs, la voie de la clé API concentre les dépenses au même endroit ; pour une personne qui code toute la journée, l'abonnement est généralement moins cher, et la CLI est le même téléchargement dans les deux cas.

Choix du modèle et de l'effort

Kimi K3.1 Pro raisonne toujours, et l’effort est défini par un champ de premier niveau qui accepte low, high et max, avec max comme valeur par défaut. Kimi Code CLI expose le modèle ; la valeur par défaut de l’effort est la plus coûteuse, donc une session qui semble lente est généralement une session fonctionnant à max plutôt qu’une connexion défaillante. La variante haute vitesse privilégie la réactivité au détriment du prix — 4,00 $ et 20,00 $ par million de jetons au lieu de 2,00 $ et 10,00 $ — et constitue le choix par défaut judicieux pour le travail interactif, où le modèle attend de toute façon un humain.

Deux contraintes suivent le modèle dans n’importe quel client : les paramètres d’échantillonnage sont fixes (température 1,0, top-p 0,95, n à 1), et modifier l’effort en cours de conversation invalide les hits de cache de préfixe. Décidez du niveau au début d’une session.

Comment cette route se compare à Claude Code et Codex

Les trois clients utilisent trois protocoles différents pour atteindre le même modèle, et le choix dépend surtout de l’interface dans laquelle votre équipe travaille déjà. Kimi Code CLI est celui qui demande le moins de configuration : aucun bloc d’environnement, aucun fichier TOML, et le fournisseur maintient les deux côtés. Claude Code a besoin du point de terminaison compatible avec Anthropic et de quatre variables de niveau de modèle correctement définies, et Codex a besoin d’un bloc de fournisseur avec wire_api = "responses", mais les deux fonctionnent ensuite avec n’importe quel fournisseur qui parle ces protocoles — y compris une passerelle qui sert aussi les modèles d’autres fournisseurs.

La répartition pratique : utilisez Kimi Code CLI lorsque Kimi est le seul modèle dont vous avez besoin et que vous voulez le chemin le plus court ; utilisez Claude Code ou Codex lorsque la même session doit basculer entre plusieurs fournisseurs, ou lorsque les outils, les autorisations et les compétences de votre équipe résident déjà dans ces clients.

Un ordre de dépannage qui fait gagner du temps

• L'outil CLI démarre mais aucune commande shell ne s'exécute — vérifiez Git Bash et KIMI_SHELL_PATH d'abord, avant de blâmer le modèle.

• Erreurs d'authentification après une configuration fonctionnelle — relancez /login et vérifiez que l'option de plateforme correspond à l'endroit où la clé a été créée ; les clés issues de surfaces différentes ne sont pas interchangeables.

• Les sessions qui vous semblent lentes — vérifiez la valeur par défaut de l'effort avant de changer de modèle ; le niveau max coûte cher en latence comme en tokens.

• Modèle introuvable après une mise à jour — la CLI liste ce que la plateforme expose ; si K3.1 Pro est absent, le client pointe vers une surface qui n’a pas été mise à jour.

Kimi K3.1 Pro sur la plateforme coûte 2,00 $ par million de tokens d’entrée et 10,00 $ par million de tokens de sortie, avec un contexte de 1 M de tokens et jusqu’à 943 718 tokens de sortie. Si vous préférez y accéder via l’API que vos autres outils utilisent déjà, OrcaRouter sert le même modèle que kimi/kimi-k3.1-pro au prix catalogue du fournisseur, sans marge ajoutée — la configuration de cette route est décrite dans le guide Claude Code et Codex.