A Moonshot AI lançou o Kimi Code juntamente com o modelo Kimi K2.7 Code: um agente de codificação nativo de terminal que lê seu repositório, escreve e edita arquivos, executa comandos shell e gera sub-agentes para trabalho paralelo. Se você já usa Claude Code ou Codex, o formato parecerá familiar. A diferença é o motor subjacente e o preço. O Kimi Code roda em um modelo de código aberto (open-weight) e é cobrado por assinatura fixa, em vez de por token.
Este guia o levará de uma máquina limpa à sua primeira tarefa de agente, cobrindo em seguida os comandos e configurações que você realmente usará.
O que é o Kimi Code
Kimi Code é a própria estrutura de agente da Moonshot, construída para usar os pontos fortes do modelo K2.7 Code: pensamento preservado entre turnos, raciocínio intercalado e chamadas de ferramentas em várias etapas. Pronto para uso, ele pode:
- Escrever, depurar e refatorar código em vários arquivos
- Explorar e explicar grandes bases de código
- Executar comandos shell e processar arquivos
- Pesquisar na web por documentação e informações atuais
- Gerar sub-agentes para executar tarefas em paralelo
Ele funciona no seu terminal, no VS Code através de uma extensão, e no JetBrains ou Zed através do protocolo ACP. O modelo por trás dele é de código aberto (open-weight), então a mesma inteligência está disponível para auto-hospedagem, caso você precise; veja nosso explicador do Kimi K2.7 Code para detalhes do modelo.
Instalar o Kimi Code
O instalador puxa o uv (um gerenciador de pacotes Python) primeiro, depois instala o CLI através dele. Uma linha faz tudo.
macOS e Linux:
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
Windows (PowerShell):
irm https://code.kimi.com/kimi-code/install.ps1 | iex
Quando terminar, inicie o agente a partir de qualquer diretório de projeto:
kimi
A primeira execução o coloca em uma sessão interativa na sua pasta atual. O Kimi Code trata esse diretório como a raiz do projeto, então entre no repositório em que você quer trabalhar antes de iniciá-lo.
Fazer login
Autentique-se de dentro da sessão com um comando:
/login
Isso inicia um fluxo OAuth com sua conta Kimi e conecta o CLI à plataforma Kimi Code. Se preferir usar uma chave de API, por exemplo, para acionar uma ferramenta de terceiros, gere uma no console Kimi Code. Cada conta permite até 5 chaves.
Uma nota rápida sobre cota: o Kimi Code funciona com planos de assinatura, e os limites são atualizados em um ciclo de 7 dias, em vez de mensalmente. Os limites de taxa ficam em torno de 300 a 1200 requisições por 5 horas, com até 30 requisições simultâneas, dependendo do seu plano. Verifique /usage no meio da sessão para ver sua situação.
Sua primeira tarefa
Com o agente logado, basta descrever o que você quer em linguagem simples. Uma boa primeira execução é deixá-lo aprender o projeto:
/init
/init analisa a base de código e escreve um arquivo AGENTS.md que captura a estrutura, convenções e pontos de entrada principais. O agente lê esse arquivo em execuções futuras, então ele inicia cada sessão com contexto em vez de redescobrir seu repositório a cada vez. Se você usou DESIGN.md para agentes de codificação, esta é a mesma ideia aplicada automaticamente.
Depois disso, dê a ele um trabalho real:
Adicione validação de entrada ao endpoint POST /users e escreva um teste para o caso de e-mail vazio.
O Kimi Code planeja a mudança, edita os arquivos, executa o teste e reporta de volta. Por padrão, ele pergunta antes de ações destrutivas. Se você confiar nele em uma tarefa e quiser que ele pare de perguntar, alterne a aprovação automática:
/yolo
Use isso com cuidado. É ótimo para trabalhos de rascunho em projetos novos, arriscado em um repositório com o qual você se importa.
Comandos slash que vale a pena conhecer
Você controla uma sessão com comandos slash. Estes são os que você usará diariamente.
| Comando | O que faz |
|---|---|
/help |
Lista todos os comandos |
/login |
Autentica com sua conta Kimi |
/init |
Analisa o projeto e gera AGENTS.md |
/model |
Muda o modelo ativo |
/usage |
Verifica a cota restante para o ciclo atual |
/sessions |
Lista sessões anteriores |
/resume |
Reabre uma sessão anterior com seu contexto |
/clear |
Reinicia o contexto atual |
/compact |
Compacta a conversa para liberar contexto |
/yolo |
Alterna a aprovação automática de ações |
/exit |
Sai da sessão |
/compact é o comando subestimado. Longas execuções de agente preenchem a janela de contexto com a saída da ferramenta; compactar resume o histórico para que você possa continuar sem recomeçar ou estourar a janela.
Conecte-o ao seu editor ou agente existente
Você não precisa abandonar sua configuração atual para usar o modelo K2.7 Code.
VS Code. Instale a extensão "Kimi Code" do marketplace e faça login com a mesma conta.
JetBrains e Zed. Conecte-se através do protocolo ACP do CLI, para que o agente execute dentro do editor que você já usa.
Claude Code, Cline e RooCode. O modelo é servido através de uma API compatível com OpenAI. Aponte a URL base da ferramenta para https://api.moonshot.ai/v1, defina o modelo como kimi-k2.7-code e insira uma chave de API. O fluxo é o mesmo que documentamos para executar o Kimi dentro do Claude Code e Cursor; apenas o ID do modelo muda.
Personalize com MCP e sub-agentes
Duas funcionalidades fazem o Kimi Code valer a pena configurar, em vez de apenas executar.
Model Context Protocol (MCP). O Kimi Code é um cliente MCP, então você pode conectar servidores de ferramentas externas: um leitor de banco de dados, um navegador, uma API interna, seu rastreador de problemas. O agente então chama essas ferramentas como parte de uma tarefa. Se você está construindo ou testando um servidor MCP, nosso manual de teste de servidor MCP cobre como validar o contrato da ferramenta antes de entregá-la a um agente.
Sub-agentes. Para trabalhos que se dividem claramente, o Kimi Code pode gerar sub-agentes que rodam em paralelo e reportam à sessão principal. Pense em "escanear cada serviço para a chamada depreciada" ou "esboçar testes para esses seis módulos de uma vez". Você define agentes personalizados na configuração, muito parecido com os sub-agentes do Claude Code.
Teste a API por trás dele antes de construir
Se você estiver conectando o kimi-for-coding à sua própria ferramenta através da API, teste primeiro o endpoint bruto para saber exatamente o que ele retorna. O Apidog oferece um ambiente de trabalho visual para isso.
- Crie uma requisição
POSTparahttps://api.moonshot.ai/v1/chat/completions. - Adicione um cabeçalho
Authorization: Bearerusando uma chave do console da plataforma Kimi. - Envie um corpo estilo OpenAI com
"model": "kimi-k2.7-code"e suasmessages. - Leia a resposta formatada e o uso de tokens, e então salve a chamada como um teste reutilizável.
A partir daí, você pode fazer asserções sobre códigos de status, validar a estrutura de chamada de ferramenta da qual o agente depende e reexecutar as verificações sempre que a Moonshot atualizar o modelo. Baixe o Apidog para configurá-lo.
Vale a pena mudar para o Kimi Code?
A resposta honesta depende do que você otimiza. O modelo K2.7 Code está alguns pontos atrás do GPT-5.5 e Claude Opus na maioria dos benchmarks de codificação, então se você quer a mais alta qualidade possível em uma única tentativa, a fronteira fechada ainda vence. Mas o Kimi Code combina um agente capaz com um modelo de código aberto (open-weight) e precificação fixa, o que muda a matemática para qualquer um que execute longas sessões de agente o dia todo. Para uma comparação lado a lado de onde o cenário de agentes se encontra, veja nossa comparação entre Claude Code e OpenAI Codex.
O movimento de baixo risco: instale-o, execute /init em um projeto secundário e dê a ele uma tarefa real. Você saberá em uma tarde se ele merece um lugar ao lado do seu agente atual.
FAQ
Como instalo o Kimi Code? Execute o instalador de uma linha (curl ... | bash no macOS/Linux, irm ... | iex no Windows), então inicie-o com kimi.
Como faço login? Execute /login dentro da sessão para OAuth, ou crie uma chave de API no console do Kimi Code para ferramentas de terceiros.
Qual modelo ele executa? Kimi K2.7 Code. Na assinatura do Kimi Code, o ID do modelo é kimi-for-coding; na API da Moonshot, paga por token, é kimi-k2.7-code.
Funciona no VS Code? Sim, através da extensão “Kimi Code”. JetBrains e Zed se conectam via protocolo ACP.
Posso usá-lo com Claude Code ou Cline? Sim. A API é compatível com OpenAI, então aponte a URL base da ferramenta para o endpoint Kimi e defina o ID do modelo.
Quanto custa? Ele funciona com planos de assinatura com cota que se atualiza a cada 7 dias, sem cobrança por token. Verifique /usage para ver sua cota restante.
Ele suporta MCP? Sim. Kimi Code é um cliente MCP e suporta sub-agentes personalizados.
Resumo
Kimi Code é um agente de codificação para terminal e IDE, construído sobre o modelo de código aberto (open-weight) K2.7 Code da Moonshot. Instale-o com um comando, faça login com /login, execute /init para ensiná-lo ao seu repositório e comece a dar-lhe tarefas. Ele fala MCP, gera sub-agentes e se conecta ao VS Code, JetBrains, Zed e ferramentas compatíveis com OpenAI como o Claude Code. Não é o agente com maior pontuação no papel, mas a precificação fixa em um modelo aberto o torna uma opção séria para uso diário intenso. Teste a API no Apidog primeiro, depois coloque o agente em uma tarefa real e julgue-o em seu próprio código.