# Kimi Code: site oficial e instalação no Windows e macOS > Kimi Code da Moonshot AI: uma aplicação para computador, CLI e plug-ins para editores. Instalação no Windows e macOS, início de sessão com /login e planos em setembro de 2026. Source: https://ailoot.ai/blog/pt-pt/kimi-code-install/ Canonical: https://ailoot.ai/blog/pt-pt/kimi-code-install/ Language: pt-PT Publisher: Ailoot (https://ailoot.ai/) Translation: guide-161 Revision: sha256-1c18c7364b98c995091e983432dc8b14d1d6d3f3039e7c7e3770f7ac0f5958f9 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](https://ailoot.ai/docs/). ## O que é o Kimi Code
Principais pontos O Kimi Code é um agente de programação com IA da Moonshot AI, a empresa que cria os modelos Kimi. Lê e edita código, executa comandos e testes, pesquisa informações online e planeia autonomamente os passos seguintes. Está disponível em três formas: uma aplicação para computador, uma CLI para trabalhar no terminal e plug-ins para editores.
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](https://ailoot.ai/blog/pt-pt/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
Principais pontos A instalação é gratuita. A utilização dos modelos Kimi é paga por subscrição ou através da API: no site internacional do Kimi Code, está incluída nos planos a partir do Plus, por \$15 por mês; com uma chave da Kimi Platform API, paga os tokens que utiliza. A subscrição tem um limite separado: 5 horas de utilização do Kimi Code por semana.
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: | Plano | Faturação mensal | Faturação anual | |-------|-----------------------|-------------------| | Plus | \$15 por mês | \$180 | | Pro | \$31 por mês | \$372 | | Max | \$79 por mês | \$948 | | Ultra | \$159 por mês | \$1908 | 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
Principais pontos No macOS e no Linux, execute `curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash`; no Windows, execute `irm https://code.kimi.com/kimi-code/install.ps1 | iex` no PowerShell (instale primeiro o Git for Windows). Em seguida, aceda à pasta do projeto, execute `kimi` e inicie sessão com o comando `/login`.
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](https://ailoot.ai/blog/pt-pt/install-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: ```bash curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash ``` No Windows, execute o seguinte no PowerShell: ```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](https://gitforwindows.org/) 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: ```bash 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. ```bash kimi --version cd your-project kimi ``` Para executar um único comando sem o modo interativo, utilize a opção `-p`: ```bash 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
Principais pontos A aplicação Kimi Code para computador, disponível para macOS e Windows, pode ser descarregada na página oficial `kimi.com/code`. Inclui um browser e um terminal, e o agente consegue ver o seu projeto local.
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
Principais pontos No VS Code, procure o plug-in “Kimi Code” no marketplace e instale-o. No Zed e no JetBrains, a CLI funciona através do protocolo ACP: o editor inicia o comando `kimi acp` e não é necessário iniciar sessão separadamente.
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`: ```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](https://ailoot.ai/blog/pt-pt/mcp-servers-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](https://ailoot.ai/blog/pt-pt/kimi-k3-hands-on-review/). Está disponível uma comparação tarefa a tarefa em [Kimi K3 vs Claude Code](https://ailoot.ai/blog/pt-pt/kimi-k3-vs-claude-code/) e, entre as opções gratuitas, recomendo consultar a [análise do Qwen Code como alternativa ao Claude Code](https://ailoot.ai/blog/pt-pt/qwen-code-token-plan-setup/).
### Fontes - [Kimi Code — página oficial do produto](https://www.kimi.com/code/en) - [Documentação do Kimi Code: visão geral](https://www.kimi.com/code/docs/en/) - [Introdução: instalação da CLI](https://www.kimi.com/code/docs/en/kimi-code-cli/guides/getting-started.html) - [Repositório MoonshotAI/kimi-code no GitHub](https://github.com/MoonshotAI/kimi-code) - [Pacote @moonshot-ai/kimi-code no npm](https://www.npmjs.com/package/@moonshot-ai/kimi-code) - [Planos e subscrição Kimi](https://www.kimi.com/membership/pricing) - [Detalhes dos planos Kimi e limites do Kimi Code no centro de ajuda](https://www.kimi.com/en/help/membership/membership-overview) - [Transferências da aplicação Kimi](https://www.kimi.com/en/products/download) - [Documentação da Kimi API Platform: pagamento por token](https://platform.kimi.ai/docs/pricing) - [Novidades: lançamento do Kimi Code Desktop e da CLI 2.0](https://www.kimi.com/code/docs/en/kimi-code/whats-new.html) - [Kimi Code Desktop: início rápido](https://www.kimi.com/code/docs/en/kimi-code-desktop/getting-started.html)
Se precisar de acesso a redes neuronais através da Ailoot, visite a [Ailoot](https://ailoot.ai/). ## Perguntas frequentes ### A CLI foi instalada, mas o comando kimi não aparece. O que verifico? Abra um terminal novo para recarregar PATH e execute `kimi --version`. No Windows, confirme a instalação do Git for Windows; se o Git Bash estiver num local não habitual, verifique o `KIMI_SHELL_PATH` configurado. ### Transferir o Kimi Code dá acesso gratuito aos modelos? Não. A aplicação e a CLI são gratuitas para instalar, mas a utilização dos modelos exige uma subscrição paga elegível ou uma chave API Kimi Platform com saldo. Use `/login` para examinar a autenticação selecionada e verifique os limites correspondentes antes de diagnosticar uma tarefa parada. ## Ailoot · A empresa e a sua carteira de projetos A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI. A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões. A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.