Kimi Code: site oficial e instalação no Windows e macOS

A 17 de setembro de 2026, a Moonshot AI lançou a versão para computador do Kimi Code, o seu agente de programação com IA. Antes, funcionava no terminal e como plug-ins para editores; agora também está disponível como aplicação autónoma para macOS e Windows, com um browser e um terminal integrados. Os comandos e os planos foram verificados nas páginas oficiais a 19 de setembro de 2026.

Documentação da Ailoot: API, chaves e configuração.

O que é o Kimi Code#

Em termos de finalidade, é um equivalente direto do Claude Code: abre uma pasta de projeto, descreve uma tarefa em linguagem corrente e o agente estuda a base de código, propõe alterações e executa-as. Escolhe com que frequência lhe pede autorização. Falei sobre as diferenças na prática em Kimi K3 vs Claude Code; este artigo aborda apenas a instalação e a configuração.

O Kimi Code utiliza modelos Moonshot: o K3, o modelo principal, com uma janela de contexto de até 1 milhão de tokens, e o modelo especializado K2.7 Code, que inclui um modo de alta velocidade de até 260 tokens por segundo. O código-fonte da CLI é aberto sob a licença MIT e o repositório no GitHub tem mais de 7 000 estrelas.

Site oficial, documentação e código-fonte:

• site do produto: kimi.com/code
• documentação da CLI: kimi.com/code/docs e moonshotai.github.io/kimi-code
• repositório: github.com/MoonshotAI/kimi-code

A 11 de setembro de 2026, o Kimi Code atualizou o seu modelo de programação; a 17, foram lançados ao mesmo tempo a versão para computador e a nova versão principal da CLI, a 2.0; e, a 18, foi lançada a atualização 2.0.1. Se tiver instalada a antiga versão em Python (kimi-cli), esta já não é suportada: os respetivos dados podem ser migrados para a nova CLI com um único comando, kimi migrate.

Quanto custa o Kimi Code#

A aplicação e a CLI são gratuitas para descarregar, mas o plano gratuito Adagio não inclui o Kimi Code. No momento da verificação, a página de subscrição kimi.com/membership apresentava estes preços:

O Kimi Code está disponível nos quatro planos pagos. Em setembro de 2026, a Kimi reviu a oferta de subscrições e deixou de vender o Kimi Code separadamente; por isso, as análises mais antigas com nomes de planos diferentes estão desatualizadas — consulte a página de subscrição antes de comprar.

A subscrição tem dois limites. Todas as funcionalidades (chat, Deep Research, sites e Kimi Code) utilizam um único conjunto partilhado de créditos, calculado com base no número real de tokens utilizados. O Kimi Code também tem o seu próprio limite: 5 horas por semana. Este não afeta as outras funcionalidades, mas pode esgotá-lo se trabalhar intensivamente.

Em vez de uma subscrição, pode pagar pelos tokens à medida que os utiliza: ao iniciar sessão na CLI, escolha “Kimi Platform API key” em platform.kimi.ai. É uma opção conveniente se trabalhar esporadicamente ou quiser ligar o modelo a uma ferramenta de terceiros. Consulte a página da plataforma para conhecer as condições e os limites desta opção.

Antes de pagar, confirme na prática se o seu cartão funciona ou utilize a opção da chave API, se estiver disponível para si.

Como instalar a Kimi Code CLI#

A CLI é a forma principal e mais completa do Kimi Code. Se já trabalhou com o Claude Code no terminal, o fluxo de trabalho ser-lhe-á familiar. Caso contrário, o guia sobre como instalar o Claude Code pode ajudá-lo a familiarizar-se: os dois seguem o mesmo fluxo de trabalho.

1. Instale a CLI com um único comando

   No macOS ou Linux, execute o seguinte no terminal:

   curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
   

   No Windows, execute o seguinte no PowerShell:

   irm https://code.kimi.com/kimi-code/install.ps1 | iex
   

   O instalador descarrega a versão mais recente, verifica a soma de verificação e adiciona o comando kimi ao PATH. Esta opção não requer Node.js.

   No Windows, há mais um requisito: instale o Git for Windows antes do primeiro arranque. O Kimi Code utiliza o respetivo Git Bash como shell de trabalho. Se o Git Bash estiver instalado numa localização não padrão, defina o caminho para bash.exe na variável de ambiente KIMI_SHELL_PATH.

   Também existe uma opção npm para quem já tenha o Node.js 22.19.0 ou posterior instalado:

   npm install -g @moonshot-ai/kimi-code
   

2. Verifique a instalação e inicie a CLI

   No comando cd your-project, substitua your-project pelo caminho para a pasta do seu projeto.

   kimi --version
   cd your-project
   kimi
   

   Para executar um único comando sem o modo interativo, utilize a opção -p:

   kimi -p "Look at the project structure and explain the main directories"
   

   Para continuar uma sessão anterior, utilize a opção -c: kimi -c regressa à mesma conversa.

3. Inicie sessão na sua conta

   Introduza o seguinte na CLI:

   /login
   

   Ser-lhe-á apresentada uma escolha entre duas opções. “Kimi Code (OAuth)” inicia sessão através da sua conta Kimi: abra a ligação em qualquer dispositivo, inicie sessão e introduza o código. Esta opção utiliza os limites da sua subscrição. “Kimi Platform API key” é uma chave de platform.kimi.ai; paga pelos tokens. Para terminar sessão, utilize /logout.

4. Dê ao agente a primeira tarefa

   Comece por pedir uma visão geral do projeto: peça ao agente que estude as pastas principais e explique como está tudo organizado. Assim, poderá ver como lê os ficheiros e confirmar que o início de sessão e o acesso ao modelo funcionam.

   Quando for lançada uma nova versão, pode atualizá-la com o comando kimi upgrade.

Como instalar a versão para computador#

A versão para computador foi lançada a 17 de setembro de 2026 e destina-se a quem não quer trabalhar exclusivamente no terminal. De acordo com a documentação da Moonshot AI, uma única janela combina uma conversa com o agente, um browser e um terminal: abra um projeto local, discuta uma tarefa e submeta alterações sem alternar entre janelas. Pode acompanhar todos os passos do agente: chamadas a ferramentas, raciocínio e ficheiros modificados; as operações sensíveis requerem confirmação. Pode definir com que frequência o agente pede autorização antes de agir, através de três modos de permissões: Always Ask, Ask When Needed e Never Ask. Para uma primeira experiência, o primeiro ou o segundo modo são mais aconselháveis.

Existem dois modos de trabalho com tarefas. O modo Plan cria primeiro um plano, que pode rever e ajustar antes da execução. O modo Goal permite que o agente trabalhe autonomamente para atingir o objetivo; pode enviar uma tarefa longa para segundo plano, pausá-la ou pará-la. O browser integrado encontra-se no painel à direita e fornece ao agente o contexto da página: pode selecionar um elemento na página, comentar o texto selecionado ou uma área da captura de ecrã e especificar exatamente o que deve ser corrigido.

Os instaladores estão disponíveis no site oficial: para macOS, há versões para Apple Silicon e Intel; para Windows, há um instalador x64. Descarregue a sua versão em kimi.com/code, instale-a, abra uma pasta de projeto local e inicie sessão na mesma conta Kimi. Os limites e a faturação são partilhados com a CLI: a mesma subscrição e o mesmo conjunto de créditos.

Como ligar o Kimi Code a um editor#

A forma mais simples de instalar a extensão do VS Code é obter o “Kimi Code” no marketplace oficial: o agente aparecerá na barra lateral e poderá completar código, editar ficheiros e pesquisar online. A página de transferências do Kimi também lista Cursor, Web, Zed, JetBrains e Paseo.

Os editores que suportam o Agent Client Protocol ligam-se através da CLI. No Zed, adicione o seguinte a ~/.config/zed/settings.json:

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

Depois disto, as novas conversas no painel Agent do Zed serão executadas através do Kimi Code. Só precisa de iniciar sessão na sua conta uma vez na CLI.

O que o agente consegue fazer logo à partida#

Além das funções habituais de “ler, editar e executar testes”, a CLI inclui várias funcionalidades:

• Entrada de vídeo: pode arrastar uma gravação de ecrã ou um vídeo de demonstração para o chat, e o agente irá analisá-lo fotograma a fotograma — útil quando é mais fácil mostrar um erro do que descrevê-lo.
• MCP sem JSON manual: os servidores do Model Context Protocol podem ser adicionados e configurados através de uma conversa com /mcp-config. No artigo sobre servidores MCP para o Claude Code, explicámos o que é o MCP e por que motivo o utilizar; o protocolo é partilhado.
• Subagentes: os agentes integrados coder, explore e plan executam tarefas num contexto isolado, mantendo os detalhes do trabalho fora da conversa principal.
• Hooks do ciclo de vida: comandos personalizados em fases importantes do fluxo de trabalho para verificar ações arriscadas, enviar notificações e realizar auditorias.
• Competências e plug-ins: pacotes prontos a utilizar do marketplace ou de qualquer repositório GitHub.

O que verificar se algo correr mal#

• kimi --version não responde — abra uma nova janela do terminal; o PATH é carregado depois de reiniciar.
• No Windows, o agente termina com um erro ao executar comandos — confirme que o Git for Windows está instalado e que KIMI_SHELL_PATH está definido, caso esteja numa localização não padrão.
• O início de sessão falha ou as tarefas não são executadas — verifique /login: o OAuth só funciona com uma subscrição paga ativa; a chave API funciona quando o saldo da plataforma é positivo.
• Tudo estava a funcionar, mas o agente deixou de executar tarefas — pode ter esgotado o limite semanal de 5 horas do Kimi Code ou o conjunto partilhado de créditos; o saldo restante é apresentado na secção de subscrição do site Kimi.
• A antiga CLI em Python entra em conflito com a nova — remova a versão antiga e reinstale com o comando de instalação oficial.

O que fazer a seguir#

Escolha a aplicação, a CLI ou o plug-in e experimente uma tarefa real do seu projeto: peça ao agente que estude a base de código e faça uma pequena alteração. Assim, perceberá se o método de trabalho é adequado para si. Experimentei o Kimi K3 pessoalmente em tarefas reais e acabei por regressar ao Claude Code — expliquei aqui o que não correu bem. Está disponível uma comparação tarefa a tarefa em Kimi K3 vs Claude Code e, entre as opções gratuitas, recomendo consultar a análise do Qwen Code como alternativa ao Claude Code.

Se precisar de acesso a redes neuronais através da Ailoot, visite a Ailoot.