Как добавить Kimi K3.1 Pro в Kimi Code CLI: установка, вход и ловушка Windows

Kimi Code CLI — терминальный агент Moonshot для программирования, и это единственный клиент, в котором Kimi K3.1 Pro является не сторонней интеграцией, а вариантом по умолчанию. Настройка короче, чем в маршрутах Claude Code или Codex — один установочный скрипт, одна команда /login, один выбор платформы — потому что клиент и модель от одной компании. Подвох зависит от платформы: в Windows CLI работает внутри Git Bash, который поставляется вместе с ним, и если эта оболочка находится не там, где ожидает установщик, инструмент запускается, а затем падает так, что это выглядит как ошибки модели.

Это последовательность, которая работает; она сверена с документацией Moonshot от 24 октября 2026 года, а режимы отказа отмечены там, где они действительно возникают.

Установить

В macOS и Linux достаточно одной строки: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. В Windows PowerShell также достаточно одной строки: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Скрипт загружает последний выпуск, проверяет его контрольную сумму и добавляет исполняемый файл kimi в ваш PATH. Node.js или Python runtime не требуются.

В Windows есть одно предварительное требование, которое легко упустить: сначала установите Git for Windows. Kimi Code CLI использует встроенный Git Bash в качестве своей оболочки. Если Git Bash находится в нестандартном месте, перед запуском задайте KIMI_SHELL_PATH в качестве переменной окружения, указав абсолютный путь к bash.exe — иначе агент запустится, но каждая команда оболочки, которую он попытается выполнить, будет завершаться ошибкой.

Войти с помощью API-ключа

Запустите CLI в каталоге проекта, в котором вы хотите работать:

• Запустите kimi, чтобы открыть интерактивный интерфейс.

• Введите /login. Kimi Code CLI откроет окно выбора платформы.

• Выберите Kimi Platform (API-ключ · platform.kimi.ai). Это вариант для ключа, созданного на открытой платформе; остальные соответствуют другим интерфейсам аккаунта.

• Вставьте ключ. Если у вас его нет, создайте его на platform.kimi.ai в разделе API Keys. CLI хранит его локально, поэтому относитесь к каталогу конфигурации как к хранилищу учётных данных.

Вот и вся связь. Селектор моделей внутри CLI перечисляет текущие модели Kimi, и Kimi K3.1 Pro и его высокоскоростной вариант — это две модели, которые важны для агентной работы.

Переключение существующей настройки и замена ключа

Обычно встречаются два сценария миграции, и оба проходят через один и тот же экран. Если Kimi Code CLI уже авторизован через подписку, а не через API-ключ, то повторный запуск /login с выбором платформы с API-ключом переключает его без переустановки. Если вы выполняете ротацию ключа — потому что он утёк или потому что проекту нужен собственный биллинг — тот же процесс заменяет сохранённые учётные данные.

Единственное, чего делать не следует, — это вручную редактировать сохранённую конфигурацию, пока CLI запущен; процесс читает учётные данные при запуске, а изменения, внесённые в середине сеанса, перезаписываются при выходе.

Что агент на самом деле делает

Kimi Code CLI — это не окно чата в терминале. Он читает и редактирует код, ищет по репозиторию, выполняет команды и читает результаты, а также может подтягивать веб-контент или выполнять поиск, когда задаче нужно что-то за пределами проекта. Moonshot описывает его как coding-агента, который работает на вашей собственной машине, а планированием занимается модель — та же схема, что у Claude Code или Codex, с теми же последствиями для разрешений: агент, который может выполнять shell-команды, следует запускать в каталоге, который вы готовы позволить ему изменять, и проверять всё до отправки.

В этом клиенте встречаются две модели оплаты. Приложение Kimi Code продаётся по подписке с тарифными уровнями, а CLI может использовать эту подписку или API-ключ с открытой платформы. Именно путь с API-ключом даёт экономику оплаты за токены — $2,00 и $10,00 за миллион токенов для K3.1 Pro, $4,00 и $20,00 для высокоскоростного варианта, — тогда как подписка представляет собой фиксированную плату с квотой. Для команды, которая уже платит за использование API в другом месте, путь с ключом позволяет держать расходы в одном месте; для человека, который программирует весь день, подписка обычно дешевле, а CLI в любом случае скачивается один и тот же.

Выбор модели и уровня усилий

Kimi K3.1 Pro всегда выполняет рассуждение, а уровень усилий задаётся полем верхнего уровня, которое принимает значения low, high и max со значением по умолчанию max. Kimi Code CLI предоставляет доступ к модели; по умолчанию используется дорогостоящий уровень усилий, поэтому сеанс, который кажется медленным, обычно работает на max, а не из-за сломанного соединения. Высокоскоростной вариант снижает задержку ценой стоимости — $4.00 и $20.00 за миллион токенов вместо $2.00 и $10.00 — и является разумным выбором по умолчанию для интерактивной работы, где модель всё равно ждёт человека.

Два ограничения действуют для модели в любом клиенте: параметры сэмплирования фиксированы (temperature 1.0, top-p 0.95, n = 1), а изменение уровня усилий в середине разговора аннулирует попадания в prefix-cache. Выбирайте уровень в начале сессии.

Как этот маршрут соотносится с Claude Code и Codex

Три клиента используют три разных протокола для доступа к одной и той же модели, и выбор в основном сводится к тому, какой интерфейс уже привычен вашей команде. Kimi Code CLI требует минимум настройки: никакого блока окружения, никакого файла TOML, и вендор поддерживает обе стороны. Claude Code требует Anthropic-совместимую конечную точку и корректно заданные четыре переменные уровня модели, а Codex требует блок провайдера с wire_api = "responses", но затем оба работают с любым провайдером, который поддерживает эти протоколы — включая шлюз, который также обслуживает модели других вендоров.

Практическое разделение: используйте Kimi Code CLI, когда Kimi — единственная нужная вам модель и вам нужен самый короткий путь; используйте Claude Code или Codex, когда в рамках одной сессии приходится переключаться между поставщиками или когда инструментарий, права доступа и навыки вашей команды уже привязаны к этим клиентам.

Порядок устранения неполадок, который экономит время

• CLI запускается, но ни одна команда оболочки не выполняется — сначала проверьте Git Bash и KIMI_SHELL_PATH, прежде чем винить модель.

• Ошибки аутентификации после того, как всё уже работало — повторно выполните /login и убедитесь, что выбранная платформа соответствует той, где был создан ключ; ключи с разных интерфейсов не являются взаимозаменяемыми.

• Сессии, которые кажутся медленными — прежде чем менять модель, проверьте значение effort по умолчанию; max обходится дорого и по задержке, и по токенам.

• Ошибка «модель не найдена» после обновления — CLI показывает, что предоставляет платформа; если K3.1 Pro отсутствует, значит клиент направлен на поверхность, которая не была обновлена.

Kimi K3.1 Pro на платформе стоит $2.00 за миллион входных токенов и $10.00 за миллион выходных, при контексте 1M токенов и до 943,718 выходных токенов. Если вы предпочитаете обращаться к ней через API, который уже используют ваши другие инструменты, OrcaRouter предоставляет ту же модель, что и kimi/kimi-k3.1-pro по цене провайдера из прайс-листа без наценки — конфигурация для этого маршрута описана в руководстве по Claude Code и Codex.