Jak dodać Kimi K3.1 Pro do Kimi Code CLI: instalacja, logowanie i pułapka Windows

Kimi Code CLI to terminalowy agent programistyczny Moonshot i jedyny klient, w którym Kimi K3.1 Pro nie jest integracją zewnętrzną, lecz rozwiązaniem domyślnym. Konfiguracja jest krótsza niż w przypadku ścieżek Claude Code lub Codex — jeden skrypt instalacyjny, jedno /login, jeden wybór platformy — ponieważ klient i model pochodzą od tej samej firmy. Haczyk jest zależny od platformy: w systemie Windows CLI działa w dołączanej przez siebie powłoce Git Bash, a jeśli ta powłoka nie znajduje się tam, gdzie oczekuje jej instalator, narzędzie uruchamia się, a następnie zawodzi w sposób, który wygląda jak błędy modelu.

To jest sekwencja, która działa, sprawdzona na dokumentacji Moonshot z 24 października 2026 r., z trybami awarii wskazanymi tam, gdzie faktycznie występują.

Zainstaluj

macOS i Linux to jedna linia: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Windows PowerShell również to jedna linia: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Skrypt pobiera najnowsze wydanie, weryfikuje jego sumę kontrolną i umieszcza plik wykonywalny kimi w zmiennej PATH. Nie jest wymagane środowisko uruchomieniowe Node.js ani Python.

Windows ma jeden warunek wstępny, który łatwo przeoczyć: najpierw zainstaluj Git for Windows. Kimi Code CLI używa dołączonego Git Bash jako swojego środowiska powłoki. Jeśli Git Bash znajduje się w niestandardowym miejscu, ustaw zmienną środowiskową KIMI_SHELL_PATH na bezwzględną ścieżkę do bash.exe przed uruchomieniem — w przeciwnym razie agent uruchomi się, ale każde polecenie powłoki, które spróbuje wykonać, zakończy się niepowodzeniem.

Zaloguj się za pomocą klucza API

Uruchom CLI w katalogu projektu, w którym chcesz pracować:

• Uruchom kimi, aby otworzyć interaktywny interfejs.

• Wpisz /login. Kimi Code CLI otwiera selektor platformy.

• Wybierz Kimi Platform (klucz API · platform.kimi.ai). To opcja dla klucza utworzonego na otwartej platformie; pozostałe odpowiadają różnym powierzchniom konta.

• Wklej klucz. Jeśli go nie masz, utwórz go na platform.kimi.ai w sekcji API Keys. CLI przechowuje go lokalnie, więc traktuj katalog konfiguracji jak magazyn poświadczeń.

To jest całe połączenie. Selektor modeli w CLI wyświetla aktualne modele Kimi, a Kimi K3.1 Pro i jego wariant wysokiej prędkości to dwa, które mają znaczenie w pracy agentowej.

Przełączanie istniejącej konfiguracji i wymiana klucza

Dwie migracje są częste i obie przechodzą przez ten sam ekran. Jeśli Kimi Code CLI jest już zalogowany przez subskrypcję, a nie przez klucz API, uruchomienie /login ponownie i wybranie platformy klucza API przełącza go bez ponownej instalacji. Jeśli rotujesz klucz — ponieważ wyciekł albo ponieważ projekt wymaga własnego rozliczania — ten sam przepływ zastępuje zapisane poświadczenie.

Jedyną rzeczą, której nie wolno robić, jest ręczna edycja zapisanej konfiguracji, gdy CLI działa; proces odczytuje dane uwierzytelniające przy uruchomieniu, a zmiana wprowadzona w trakcie sesji zostaje nadpisana przy zakończeniu.

Co agent faktycznie robi

Kimi Code CLI nie jest oknem czatu w terminalu. Odczytuje i edytuje kod, przeszukuje repozytorium, uruchamia polecenia i odczytuje ich wyniki, a gdy zadanie wymaga czegoś spoza projektu, może pobrać treści z sieci lub skorzystać z wyszukiwania. Moonshot opisuje go jako agenta kodującego, który działa na twoim własnym komputerze, a planowanie wykonuje model — ma taki sam kształt jak Claude Code czy Codex, z takimi samymi konsekwencjami dla uprawnień: agenta, który potrafi uruchamiać polecenia powłoki, należy uruchamiać w katalogu, na którego modyfikację się zgadzasz, i sprawdzić jego pracę, zanim cokolwiek zostanie wypchnięte.

W tym kliencie spotykają się dwa modele rozliczeń. Aplikacja Kimi Code jest sprzedawana jako subskrypcja z poziomami planów, a CLI może korzystać z tej subskrypcji albo z klucza API z otwartej platformy. Ścieżka z kluczem API to ta, która daje rozliczenie za tokeny — 2,00 USD i 10,00 USD za milion tokenów dla K3.1 Pro, 4,00 USD i 20,00 USD dla wariantu wysokiej prędkości — podczas gdy subskrypcja to stała opłata z limitem. W przypadku zespołu, który już płaci za korzystanie z API gdzie indziej, ścieżka z kluczem trzyma wydatki w jednym miejscu; dla osoby, która koduje cały dzień, subskrypcja jest zwykle tańsza, a CLI to i tak ten sam plik do pobrania.

Wybór modelu i poziomu wysiłku

Kimi K3.1 Pro zawsze prowadzi rozumowanie, a poziom wysiłku ustawia się polem najwyższego poziomu, które przyjmuje wartości low, high i max, domyślnie max. Kimi Code CLI udostępnia ten model; domyślny poziom wysiłku to ten kosztowny, więc sesja, która wydaje się wolna, zwykle działa na poziomie max, a nie ma zerwanego połączenia. Wariant wysokiej szybkości wymienia opóźnienie na cenę — 4,00 USD i 20,00 USD za milion tokenów zamiast 2,00 USD i 10,00 USD — i jest rozsądnym domyślnym wyborem do pracy interaktywnej, w której model i tak czeka na człowieka.

Dwa ograniczenia towarzyszą modelowi w każdym kliencie: parametry próbkowania są stałe (temperatura 1.0, top-p 0.95, n = 1), a zmiana poziomu wysiłku w trakcie rozmowy unieważnia trafienia w pamięć podręczną prefiksów. Poziom należy wybrać na początku sesji.

Jak ta ścieżka wypada w porównaniu z Claude Code i Codex

Trzy klienty używają trzech różnych protokołów, aby dotrzeć do tego samego modelu, a wybór sprowadza się głównie do tego, w którym interfejsie Twój zespół już funkcjonuje. Kimi Code CLI wymaga najmniejszej konfiguracji: bez bloku środowiskowego, bez pliku TOML, a dostawca utrzymuje oba końce. Claude Code potrzebuje punktu końcowego zgodnego z Anthropic i poprawnie ustawionych czterech zmiennych poziomów modeli, a Codex potrzebuje bloku dostawcy z wire_api = "responses", ale oba działają następnie z dowolnym dostawcą obsługującym te protokoły — w tym z bramą, która udostępnia również modele innych dostawców.

Praktyczny podział: używaj Kimi Code CLI, gdy Kimi to jedyny model, którego potrzebujesz, i chcesz wybrać najkrótszą drogę; używaj Claude Code lub Codex, gdy ta sama sesja musi przełączać się między dostawcami albo gdy narzędzia, uprawnienia i umiejętności Twojego zespołu już znajdują się w tych klientach.

Kolejność rozwiązywania problemów, która oszczędza czas

• CLI uruchamia się, ale nie wykonuje się żadne polecenie powłoki — najpierw sprawdź Git Bash i KIMI_SHELL_PATH, zanim obwinisz model.

• Błędy uwierzytelniania po działającej konfiguracji — uruchom ponownie /login i upewnij się, że opcja platformy odpowiada miejscu utworzenia klucza; klucze z różnych powierzchni nie są wymienne.

• Sesje, które wydają się wolne — przed zmianą modeli sprawdź domyślny poziom wysiłku; max jest kosztowny zarówno pod względem opóźnienia, jak i tokenów.

• Nie znaleziono modelu po aktualizacji — CLI wyświetla listę modeli udostępnianych przez platformę; jeśli brakuje K3.1 Pro, oznacza to, że klient wskazuje na interfejs, który nie został zaktualizowany.

Kimi K3.1 Pro na platformie kosztuje 2,00 USD za milion tokenów wejściowych i 10,00 USD za milion tokenów wyjściowych, z kontekstem 1 mln tokenów i do 943 718 tokenów wyjściowych. Jeśli wolisz uzyskać do niego dostęp przez API, którego używają już Twoje inne narzędzia, OrcaRouter udostępnia ten sam model jako kimi/kimi-k3.1-pro w cenie katalogowej dostawcy bez doliczanej marży — konfiguracja tej trasy jest opisana w przewodniku po Claude Code i Codex.