Kimi K3.1 Pro in Kimi Code CLI krijgen: installeren, inloggen en de Windows-valkuil

Kimi Code CLI is de terminal-codingagent van Moonshot, en het is de enige client waarbij Kimi K3.1 Pro geen integratie van derden is, maar de standaard. De setup is korter dan de routes via Claude Code of Codex — één installatiescript, één /login, één platformkeuze — omdat de client en het model van hetzelfde bedrijf komen. De valkuil is platformspecifiek: op Windows draait de CLI binnen de Git Bash die hij meebundelt, en als die shell zich niet bevindt waar de installer hem verwacht, start de tool en faalt deze vervolgens op manieren die op modelfouten lijken.

Dit is de volgorde die werkt, gecontroleerd aan de hand van Moonshots documentatie op 24 oktober 2026, waarbij de faalmodi worden benoemd waar ze daadwerkelijk optreden.

Installeren

macOS en Linux hebben maar één regel nodig: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Windows PowerShell heeft ook maar één regel nodig: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Het script downloadt de nieuwste release, verifieert de controlesom en zet het uitvoerbare bestand kimi op je PATH. Er is geen Node.js- of Python-runtime nodig.

Windows heeft één voorwaarde die gemakkelijk over het hoofd wordt gezien: installeer eerst Git for Windows. Kimi Code CLI gebruikt de meegeleverde Git Bash als shellomgeving. Als Git Bash ergens op een niet-standaardlocatie staat, stel je de omgevingsvariabele KIMI_SHELL_PATH in op het absolute pad van bash.exe vóór het starten — anders start de agent wel, maar elke shellopdracht die hij probeert uit te voeren, mislukt.

Log in met een API-sleutel

Start de CLI in de projectmap waarin u wilt werken:

• Voer kimi uit om de interactieve interface te openen.

• Typ /login. Kimi Code CLI opent een platformselector.

• Kies Kimi Platform (API-sleutel · platform.kimi.ai). Dit is de optie voor een sleutel die op het open platform is aangemaakt; de andere opties horen bij andere accountoppervlakken.

• Plak de sleutel. Maak er een aan op platform.kimi.ai onder API Keys als je die nog niet hebt. De CLI slaat de sleutel lokaal op, dus behandel de configuratiemap als een opslagplaats voor inloggegevens.

Dat is de hele connectie. De modelselector in de CLI somt de actuele Kimi-modellen op, en Kimi K3.1 Pro en zijn hogesnelheidsvariant zijn de twee die van belang zijn voor agentisch werk.

Een bestaande configuratie omzetten en een sleutel vervangen

Twee migraties komen vaak voor, en beide verlopen via hetzelfde scherm. Als Kimi Code CLI al is ingelogd via een abonnement in plaats van een API-sleutel, dan schakelt het opnieuw uitvoeren van /login en het kiezen van het API-sleutelplatform over zonder herinstallatie. Als je een sleutel roteert — omdat deze is gelekt, of omdat een project zijn eigen facturering nodig heeft — vervangt dezelfde flow de opgeslagen inloggegevens.

Het enige wat je niet moet doen, is de opgeslagen configuratie handmatig bewerken terwijl de CLI draait; het proces leest inloggegevens bij het opstarten en een bewerking tijdens de sessie wordt bij het afsluiten overschreven.

Wat de agent daadwerkelijk doet

Kimi Code CLI is geen chatvenster in een terminal. Het leest en bewerkt code, doorzoekt de repository, voert opdrachten uit en leest de resultaten, en kan webinhoud of zoekresultaten ophalen wanneer een taak iets buiten het project nodig heeft. Moonshot beschrijft het als een coding agent die op je eigen machine draait, waarbij het model de planning doet — dezelfde vorm als Claude Code of Codex, met dezelfde implicaties voor machtigingen: een agent die shellopdrachten kan uitvoeren, moet worden gestart in een map waarvan je bereid bent die door hem te laten wijzigen, en moet worden gecontroleerd voordat er iets wordt gepusht.

In deze client komen twee factureringsmodellen samen. De Kimi Code-app wordt verkocht als abonnement met abonnementsniveaus, en de CLI kan dat abonnement gebruiken of een API-sleutel van het open platform. De route via de API-sleutel is degene die je de kosten per token geeft — $2,00 en $10,00 per miljoen tokens voor K3.1 Pro, $4,00 en $20,00 voor de snelle variant — terwijl het abonnement een vast bedrag met quotum is. Voor een team dat al elders voor API-gebruik betaalt, houdt de sleutelroute de uitgaven op één plek; voor iemand die de hele dag programmeert, is het abonnement meestal goedkoper, en de CLI is hoe dan ook dezelfde download.

Het model en de inspanning kiezen

Kimi K3.1 Pro redeneert altijd, en de effort wordt ingesteld met een veld op het hoogste niveau dat low, high en max accepteert, met max als standaardwaarde. Kimi Code CLI stelt het model beschikbaar; de standaardwaarde voor effort is de dure variant, dus een sessie die traag aanvoelt, is meestal een sessie die op max draait in plaats van een kapotte verbinding. De high-speedvariant ruilt latentie in voor prijs — $ 4,00 en $ 20,00 per miljoen tokens in plaats van $ 2,00 en $ 10,00 — en is de verstandige standaard voor interactief werk waarbij het model toch op een mens wacht.

Twee beperkingen volgen het model naar elke client: samplingparameters zijn vast (temperatuur 1,0, top-p 0,95, n op 1), en als je effort midden in een gesprek wijzigt, worden prefix-cachehits ongeldig. Bepaal het niveau aan het begin van een sessie.

Hoe deze route zich verhoudt tot Claude Code en Codex

De drie clients gebruiken drie verschillende protocollen om hetzelfde model te bereiken, en de keuze draait vooral om de vraag in welke interface je team al werkt. Kimi Code CLI vereist de minste configuratie: geen environment-blok, geen TOML-bestand, en de leverancier onderhoudt beide kanten. Claude Code heeft het Anthropic-compatibele endpoint nodig en vier correct ingestelde model-tier-variabelen, en Codex heeft een provider-blok met wire_api = "responses", maar beide werken daarna met elke provider die die protocollen spreekt — inclusief een gateway die ook de modellen van andere leveranciers aanbiedt.

De praktische scheidslijn: gebruik Kimi Code CLI wanneer Kimi het enige model is dat je nodig hebt en je de kortste weg wilt; gebruik Claude Code of Codex wanneer dezelfde sessie tussen leveranciers moet kunnen wisselen, of wanneer de tooling, rechten en skills van je team al in die clients zitten.

Een stappenplan voor probleemoplossing dat tijd bespaart

• De CLI start, maar er wordt geen shellopdracht uitgevoerd — controleer Git Bash en KIMI_SHELL_PATH eerst, voordat je het model de schuld geeft.

• Authenticatiefouten na een werkende configuratie — voer /login opnieuw uit en controleer of de platformoptie overeenkomt met waar de sleutel is aangemaakt; sleutels van verschillende interfaces zijn niet onderling uitwisselbaar.

• Sessies die traag aanvoelen — controleer de standaardwaarde voor effort voordat je van model wisselt; max is duur qua latency én tokens.

• Model niet gevonden na een update — de CLI vermeldt wat het platform aanbiedt; als K3.1 Pro ontbreekt, is de client gericht op een omgeving die niet is bijgewerkt.

Kimi K3.1 Pro op het platform kost $2,00 per miljoen inputtokens en $10,00 per miljoen outputtokens, met een context van 1M tokens en tot 943.718 outputtokens. Als je het liever bereikt via de API die je andere tools al gebruiken, serveert OrcaRouter hetzelfde model als kimi/kimi-k3.1-pro tegen de lijstprijs van de provider, zonder extra markup — de configuratie voor die route staat in de Claude Code- en Codex-gids.