Kimi K3.1 Pro in die Kimi Code CLI bringen: Installation, Login und die Windows-Falle

Kimi Code CLI ist Moonshots Coding-Agent für das Terminal und der einzige Client, bei dem Kimi K3.1 Pro keine Drittanbieter-Integration, sondern der Standard ist. Die Einrichtung ist kürzer als bei den Claude-Code- oder Codex-Routen – ein Installationsskript, ein /login, eine Plattformauswahl –, weil Client und Modell vom selben Unternehmen stammen. Der Haken ist plattformspezifisch: Unter Windows läuft die CLI in der mitgelieferten Git Bash, und wenn sich diese Shell nicht dort befindet, wo der Installer sie erwartet, startet das Tool und schlägt dann auf eine Weise fehl, die wie Modellfehler aussieht.

Dies ist die Sequenz, die funktioniert – abgeglichen mit Moonshots Dokumentation vom 24. Oktober 2026, wobei die Fehlermodi dort benannt werden, wo sie tatsächlich auftreten.

Installieren

macOS und Linux benötigen nur eine Zeile: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Auch Windows PowerShell benötigt nur eine Zeile: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Das Skript lädt die neueste Version herunter, überprüft ihre Prüfsumme und legt die kimi-ausführbare Datei in Ihren PATH ab. Es wird keine Node.js- oder Python-Laufzeit benötigt.

Unter Windows gibt es eine Voraussetzung, die leicht übersehen wird: Installieren Sie zuerst Git for Windows. Die Kimi Code CLI verwendet die mitgelieferte Git Bash als Shell-Umgebung. Wenn Git Bash an einem nicht standardmäßigen Ort liegt, setzen Sie die KIMI_SHELL_PATH-Umgebungsvariable vor dem Start auf den absoluten Pfad von bash.exe – andernfalls startet der Agent, aber jeder Shell-Befehl, den er auszuführen versucht, schlägt fehl.

Mit einem API-Schlüssel anmelden

Starten Sie die CLI in dem Projektverzeichnis, in dem Sie arbeiten möchten:

• Führe kimi aus, um die interaktive Oberfläche zu öffnen.

• Geben Sie /login ein. Die Kimi Code CLI öffnet eine Plattformauswahl.

• Wählen Sie Kimi Platform (API-Schlüssel · platform.kimi.ai). Dies ist die Option für einen Schlüssel, der auf der offenen Plattform erstellt wurde; die anderen entsprechen unterschiedlichen Kontooberflächen.

• Fügen Sie den Schlüssel ein. Erstellen Sie einen unter platform.kimi.ai unter API Keys, falls Sie noch keinen haben. Die CLI speichert ihn lokal, daher sollten Sie das Konfigurationsverzeichnis wie einen Anmeldedatenspeicher behandeln.

Das ist die gesamte Verbindung. Der Modellselektor in der CLI listet die aktuellen Kimi-Modelle auf, und Kimi K3.1 Pro sowie seine High-Speed-Variante sind die beiden, die für agentische Arbeit relevant sind.

Eine bestehende Konfiguration wechseln und einen Schlüssel ersetzen

Zwei Migrationen sind üblich, und beide laufen über denselben Bildschirm. Wenn die Kimi Code CLI bereits über ein Abonnement statt über einen API-Schlüssel angemeldet ist, wechselt man durch erneutes Ausführen von /login und Auswahl der API-Schlüssel-Plattform, ohne dass eine Neuinstallation erforderlich ist. Wenn Sie einen Schlüssel rotieren – weil er offengelegt wurde oder weil ein Projekt eine eigene Abrechnung benötigt –, ersetzt derselbe Ablauf die gespeicherten Anmeldedaten.

Das Einzige, was man nicht tun sollte, ist, die gespeicherte Konfiguration von Hand zu bearbeiten, während die CLI läuft; der Prozess liest die Anmeldedaten beim Start ein, und eine Änderung mitten in der Sitzung wird beim Beenden überschrieben.

Was der Agent tatsächlich tut

Kimi Code CLI ist kein Chatfenster in einem Terminal. Es liest und bearbeitet Code, durchsucht das Repository, führt Befehle aus und liest die Ergebnisse und kann Webinhalte oder Suchfunktionen einbeziehen, wenn eine Aufgabe etwas außerhalb des Projekts erfordert. Moonshot beschreibt es als Coding-Agent, der auf deinem eigenen Rechner läuft und bei dem das Modell die Planung übernimmt – ähnlich aufgebaut wie Claude Code oder Codex, mit denselben Implikationen für Berechtigungen: Ein Agent, der Shell-Befehle ausführen kann, sollte in einem Verzeichnis gestartet werden, das du bereit bist, ihn ändern zu lassen, und überprüft werden, bevor etwas gepusht wird.

In diesem Client treffen zwei Abrechnungsmodelle aufeinander. Die Kimi-Code-App wird als Abonnement mit Planstufen verkauft, und die CLI kann entweder dieses Abonnement oder einen API-Schlüssel aus der offenen Plattform nutzen. Der Weg über den API-Schlüssel ist derjenige, der dir die tokenbasierte Kalkulation liefert – 2,00 $ und 10,00 $ pro Million Tokens für K3.1 Pro, 4,00 $ und 20,00 $ für die High-Speed-Variante –, während das Abonnement eine Pauschalgebühr mit Kontingent ist. Für ein Team, das andernorts bereits für die API-Nutzung zahlt, bündelt der Schlüssel-Weg die Ausgaben an einer Stelle; für eine Einzelperson, die den ganzen Tag programmiert, ist das Abonnement in der Regel günstiger, und die CLI ist in beiden Fällen derselbe Download.

Modell und Aufwand auswählen

Kimi K3.1 Pro denkt immer nach, und der Aufwand wird über ein Feld auf oberster Ebene festgelegt, das low, high und max akzeptiert und standardmäßig auf max steht. Die Kimi Code CLI macht das Modell verfügbar; der Standard-Aufwand ist der teure, eine Sitzung, die sich langsam anfühlt, läuft also meist mit max und nicht wegen einer kaputten Verbindung. Die Hochgeschwindigkeitsvariante tauscht Latenz gegen Preis — $4.00 und $20.00 pro Million Token statt $2.00 und $10.00 — und ist der sinnvolle Standard für interaktive Arbeit, bei der das Modell ohnehin auf einen Menschen wartet.

Zwei Randbedingungen begleiten das Modell in jeden Client: Die Sampling-Parameter sind fest (Temperature 1.0, Top-p 0.95, n auf 1), und ein Wechsel des Effort-Levels mitten im Gespräch macht Prefix-Cache-Treffer ungültig. Legen Sie die Stufe zu Beginn einer Sitzung fest.

Wie diese Route im Vergleich zu Claude Code und Codex abschneidet

Die drei Clients nutzen drei verschiedene Protokolle, um dasselbe Modell zu erreichen, und die Wahl hängt vor allem davon ab, in welcher Schnittstelle Ihr Team bereits zu Hause ist. Kimi Code CLI erfordert die geringste Konfiguration: kein Environment-Block, keine TOML-Datei, und der Anbieter pflegt beide Seiten. Claude Code benötigt den Anthropic-kompatiblen Endpunkt und vier korrekt eingestellte Variablen für Modellstufen, und Codex benötigt einen Provider-Block mit wire_api = "responses", aber beide funktionieren dann mit jedem Anbieter, der diese Protokolle spricht – einschließlich eines Gateways, das auch Modelle anderer Anbieter bereitstellt.

Die praktische Aufteilung: Verwenden Sie die Kimi Code CLI, wenn Kimi das einzige Modell ist, das Sie benötigen, und Sie den kürzesten Weg wollen; verwenden Sie Claude Code oder Codex, wenn dieselbe Sitzung zwischen Anbietern wechseln muss oder wenn die Tools, Berechtigungen und Skills Ihres Teams bereits in diesen Clients verankert sind.

Eine Reihenfolge zur Fehlerbehebung, die Zeit spart

• Die CLI startet, aber kein Shell-Befehl wird ausgeführt — prüfe zuerst Git Bash und KIMI_SHELL_PATH, bevor du das Modell verantwortlich machst.

• Authentifizierungsfehler nach einem funktionierenden Setup – führen Sie /login erneut aus und stellen Sie sicher, dass die Plattformoption mit der Stelle übereinstimmt, an der der Schlüssel erstellt wurde; Schlüssel von unterschiedlichen Oberflächen sind nicht austauschbar.

• Sitzungen, die sich langsam anfühlen – prüfen Sie den Effort-Standardwert, bevor Sie das Modell wechseln; max ist sowohl bei der Latenz als auch bei den Tokens teuer.

• „Modell nicht gefunden“ nach einem Update — die CLI listet auf, was die Plattform bereitstellt; fehlt K3.1 Pro, verweist der Client auf eine Oberfläche, die noch nicht aktualisiert wurde.

Kimi K3.1 Pro kostet auf der Plattform 2,00 $ pro Million Input-Tokens und 10,00 $ pro Million Output-Tokens, bei einem Kontext von 1 Mio. Tokens und bis zu 943.718 Output-Tokens. Wenn du lieber über die API zugreifen möchtest, die deine anderen Tools bereits verwenden, stellt OrcaRouter dasselbe Modell als kimi/kimi-k3.1-pro zum Listenpreis des Anbieters ohne Aufschlag bereit — die Konfiguration für diese Route wird im Claude-Code- und Codex-Leitfaden behandelt.