Colocando o Kimi K3.1 Pro no Kimi Code CLI: Instalação, Login e a Armadilha do Windows

Kimi Code CLI é o agente de programação para terminal da Moonshot, e é o único cliente no qual o Kimi K3.1 Pro não é uma integração de terceiros, mas sim o padrão. A configuração é mais curta do que as rotas do Claude Code ou do Codex — um script de instalação, um /login, uma escolha de plataforma — porque o cliente e o modelo vêm da mesma empresa. O detalhe crítico é específico de plataforma: no Windows, a CLI é executada dentro do Git Bash que ela própria inclui, e se esse shell não estiver onde o instalador espera, a ferramenta inicia e então falha de maneiras que parecem erros do modelo.

Esta é a sequência que funciona, verificada na documentação da Moonshot em 24 de outubro de 2026, com os modos de falha destacados onde eles realmente ocorrem.

Instalar

macOS e Linux usam uma linha: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. O Windows PowerShell também usa uma linha: irm https://code.kimi.com/kimi-code/install.ps1 | iex. O script baixa a versão mais recente, verifica o checksum e coloca o executável kimi no PATH. Não é necessário runtime de Node.js ou Python.

O Windows tem um pré-requisito fácil de passar despercebido: instale o Git for Windows primeiro. O Kimi Code CLI usa o Git Bash incluído como seu ambiente de shell. Se o Git Bash estiver em um local não padrão, defina a variável de ambiente KIMI_SHELL_PATH com o caminho absoluto de bash.exe antes de iniciar — caso contrário, o agente inicia, mas todos os comandos de shell que ele tentar executar falharão.

Faça login com uma chave de API

Inicie a CLI dentro do diretório do projeto em que você deseja trabalhar:

• Execute kimi para abrir a interface interativa.

• Digite /login. O Kimi Code CLI abre um seletor de plataforma.

• Escolha Plataforma Kimi (chave de API · platform.kimi.ai). Esta é a opção para uma chave criada na plataforma aberta; as demais correspondem a diferentes interfaces de conta.

• Cole a chave. Crie uma em platform.kimi.ai, em API Keys, se você não tiver. A CLI a armazena localmente, então trate o diretório de configuração como um cofre de credenciais.

Essa é a conexão completa. O seletor de modelos dentro da CLI lista os modelos Kimi atuais, e o Kimi K3.1 Pro e sua variante de alta velocidade são os dois que importam para trabalho agêntico.

Trocar uma configuração existente e substituir uma chave

Duas migrações são comuns, e ambas passam pela mesma tela. Se o Kimi Code CLI já estiver autenticado por meio de uma assinatura em vez de uma chave de API, executar /login novamente e selecionar a plataforma de chave de API faz a troca sem reinstalar. Se você estiver rotacionando uma chave — porque ela vazou ou porque um projeto precisa da própria cobrança —, o mesmo fluxo substitui a credencial armazenada.

A única coisa que não se deve fazer é editar à mão a configuração armazenada enquanto a CLI está em execução; o processo lê as credenciais na inicialização, e uma edição feita no meio da sessão é sobrescrita ao encerrar.

O que o agente realmente faz

Kimi Code CLI não é uma janela de chat em um terminal. Ele lê e edita código, pesquisa o repositório, executa comandos e lê os resultados, e pode buscar conteúdo ou pesquisar na web quando uma tarefa precisa de algo fora do projeto. A Moonshot o descreve como um agente de codificação que roda na sua própria máquina com o modelo fazendo o planejamento — o mesmo formato do Claude Code ou Codex, com as mesmas implicações para permissões: um agente que pode executar comandos de shell deve ser iniciado em um diretório que você aceite que ele modifique, e revisado antes que qualquer coisa seja enviada.

Dois modelos de cobrança se encontram neste cliente. O aplicativo Kimi Code é vendido como uma assinatura com níveis de plano, e a CLI pode usar essa assinatura ou uma chave de API da plataforma aberta. O caminho da chave de API é o que oferece a economia por token — $2.00 e $10.00 por milhão de tokens para o K3.1 Pro, $4.00 e $20.00 para a variante de alta velocidade —, enquanto a assinatura é uma taxa fixa com cota. Para uma equipe que já paga por uso de API em outro lugar, o caminho da chave mantém o gasto em um só lugar; para uma pessoa que programa o dia todo, a assinatura costuma ser mais barata, e a CLI é o mesmo download de qualquer forma.

Escolhendo o modelo e o esforço

Kimi K3.1 Pro sempre raciocina, e o esforço é definido por um campo de nível superior que aceita low, high e max, com padrão max. O Kimi Code CLI expõe o modelo; o padrão de esforço é o mais caro, então uma sessão que parece lenta geralmente é uma sessão rodando em max, e não uma conexão com problema. A variante de alta velocidade troca latência por preço — US$ 4,00 e US$ 20,00 por milhão de tokens em vez de US$ 2,00 e US$ 10,00 — e é o padrão sensato para trabalho interativo, em que o modelo está esperando por uma pessoa de qualquer forma.

Duas restrições acompanham o modelo em qualquer cliente: os parâmetros de amostragem são fixos (temperature 1.0, top-p 0.95, n em 1), e mudar o esforço no meio da conversa invalida os acertos de cache de prefixo. Decida o nível no início de uma sessão.

Como esta rota se compara ao Claude Code e ao Codex

Os três clientes usam três protocolos diferentes para acessar o mesmo modelo, e a escolha tem muito a ver com qual interface sua equipe já usa no dia a dia. O Kimi Code CLI é o que exige menos configuração: nenhum bloco de ambiente, nenhum arquivo TOML, e o fornecedor mantém as duas pontas. O Claude Code precisa do endpoint compatível com Anthropic e de quatro variáveis de nível de modelo configuradas corretamente, e o Codex precisa de um bloco de provedor com wire_api = "responses", mas ambos funcionam com qualquer provedor que fale esses protocolos — incluindo um gateway que também atende os modelos de outros fornecedores.

A divisão prática: use o Kimi Code CLI quando o Kimi for o único modelo de que você precisa e você quiser o caminho mais curto; use o Claude Code ou o Codex quando a mesma sessão precisar alternar entre fornecedores, ou quando as ferramentas, permissões e habilidades da sua equipe já estiverem nesses clientes.

Uma ordem de solução de problemas que economiza tempo

• A CLI inicia, mas nenhum comando de shell é executado — verifique o Git Bash e KIMI_SHELL_PATH primeiro, antes de culpar o modelo.

• Erros de autenticação após uma configuração funcional — execute novamente /login e confirme se a opção de plataforma corresponde ao local onde a chave foi criada; chaves de superfícies diferentes não são intercambiáveis.

• Sessões que parecem lentas — verifique o padrão de esforço antes de trocar de modelo; max é caro tanto em latência quanto em tokens.

• Modelo não encontrado após uma atualização — a CLI lista o que a plataforma disponibiliza; se {{1}}K3.1 Pro{{/1}} estiver ausente, o cliente está apontando para uma superfície que não foi atualizada.

O Kimi K3.1 Pro na plataforma custa US$ 2,00 por milhão de tokens de entrada e US$ 10,00 por milhão de saída, com contexto de 1M de tokens e até 943.718 tokens de saída. Se você preferir acessá-lo pela API que suas outras ferramentas já usam, o OrcaRouter disponibiliza o mesmo modelo como kimi/kimi-k3.1-pro pelo preço de tabela do provedor, sem acréscimo — a configuração dessa rota está abordada no guia do Claude Code e Codex.