DEV Community

Cover image for Kimi Code CLI: Como Instalar e Executar o Agente de Codificação Autônomo do Moonshot
Lucas
Lucas

Posted on • Originally published at apidog.com

Kimi Code CLI: Como Instalar e Executar o Agente de Codificação Autônomo do Moonshot

A Moonshot AI lançou o Kimi Code junto 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 cria sub-agentes para trabalho paralelo. Se você já usa Claude Code ou Codex, o fluxo é familiar. A principal diferença está no motor e no modelo de cobrança: o Kimi Code roda sobre um modelo open-weight e usa assinatura fixa, em vez de cobrança por token.

Experimente o Apidog hoje

Neste guia, você vai instalar o Kimi Code, fazer login, inicializar um repositório, executar sua primeira tarefa e configurar os recursos que mais importam no uso diário.

O que é o Kimi Code

Kimi Code é a estrutura de agente da Moonshot para desenvolvimento assistido por IA. Ele foi criado para aproveitar os recursos do Kimi K2.7 Code, como raciocínio entre turnos, uso de ferramentas e execução de tarefas em várias etapas.

Kimi Code

Na prática, ele pode:

  • Escrever, depurar e refatorar código em vários arquivos
  • Explorar e explicar bases de código grandes
  • Executar comandos shell
  • Ler, criar e modificar arquivos
  • Pesquisar documentação e informações atuais na web
  • Criar sub-agentes para executar tarefas em paralelo

Você pode usá-lo:

  • No terminal
  • No VS Code, via extensão
  • No JetBrains ou Zed, via protocolo ACP
  • Em ferramentas compatíveis com API OpenAI

O modelo por trás dele é open-weight, então também pode ser usado em cenários de auto-hospedagem. Para detalhes do modelo, veja o explicador do Kimi K2.7 Code.

Instalar o Kimi Code

O instalador configura primeiro o uv, um gerenciador de pacotes Python, e depois instala o CLI do Kimi Code.

macOS e Linux 

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

Windows PowerShell 

irm https://code.kimi.com/kimi-code/install.ps1 | iex
Enter fullscreen mode Exit fullscreen mode

Depois da instalação, entre no diretório do projeto em que você quer trabalhar e execute:

kimi
Enter fullscreen mode Exit fullscreen mode

O Kimi Code considera o diretório atual como a raiz do projeto. Portanto, sempre inicie o agente dentro do repositório correto:

cd meu-projeto
kimi
Enter fullscreen mode Exit fullscreen mode

Fazer login

Dentro da sessão interativa, autentique-se com:

/login
Enter fullscreen mode Exit fullscreen mode

Esse comando inicia um fluxo OAuth com sua conta Kimi e conecta o CLI à plataforma Kimi Code.

Se você precisa integrar o modelo a uma ferramenta externa, também pode gerar uma chave de API no console Kimi Code. Cada conta permite até 5 chaves.

Para acompanhar sua cota durante uma sessão, use:

/usage
Enter fullscreen mode Exit fullscreen mode

O Kimi Code usa planos de assinatura com limites renovados em ciclos de 7 dias. Os limites de taxa ficam aproximadamente entre 300 e 1200 requisições por 5 horas, com até 30 requisições simultâneas, dependendo do plano.

Inicializar um projeto

A primeira tarefa recomendada é fazer o agente entender o repositório:

/init
Enter fullscreen mode Exit fullscreen mode

Esse comando analisa a base de código e gera um arquivo:

AGENTS.md
Enter fullscreen mode Exit fullscreen mode

Esse arquivo registra informações úteis para sessões futuras, como:

  • Estrutura do projeto
  • Convenções de código
  • Pontos de entrada principais
  • Comandos comuns
  • Contexto relevante para o agente

Assim, o Kimi Code não precisa redescobrir o repositório em toda execução.

Se você já usa DESIGN.md para agentes de codificação, a ideia é parecida: fornecer contexto persistente para melhorar a qualidade das próximas tarefas.

Executar sua primeira tarefa

Depois de rodar /init, descreva uma tarefa real em linguagem natural.

Exemplo:

Adicione validação de entrada ao endpoint POST /users e escreva um teste para o caso de e-mail vazio.
Enter fullscreen mode Exit fullscreen mode

Um bom prompt de tarefa deve incluir:

  • O arquivo, módulo ou endpoint envolvido
  • O comportamento esperado
  • O tipo de teste desejado
  • Restrições importantes

Exemplo mais específico:

No endpoint POST /users, valide que o campo email não pode ser vazio.
Se o email estiver vazio, retorne status 400 com uma mensagem de erro.
Adicione ou atualize testes automatizados cobrindo esse caso.
Execute a suíte relevante antes de finalizar.
Enter fullscreen mode Exit fullscreen mode

O Kimi Code pode então:

  1. Inspecionar os arquivos relevantes
  2. Planejar a alteração
  3. Editar o código
  4. Criar ou ajustar testes
  5. Executar comandos shell
  6. Reportar o resultado

Por padrão, ele pede confirmação antes de ações sensíveis ou destrutivas.

Se você quiser ativar aprovação automática para uma sessão, use:

/yolo
Enter fullscreen mode Exit fullscreen mode

Use com cuidado. Esse modo é útil para protótipos e repositórios descartáveis, mas pode ser arriscado em projetos importantes.

Comandos slash essenciais

Você controla a sessão com comandos slash.

Comando O que faz
/help Lista todos os comandos disponíveis
/login Autentica com sua conta Kimi
/init Analisa o projeto e gera AGENTS.md
/model Altera o modelo ativo
/usage Mostra a cota restante do ciclo atual
/sessions Lista sessões anteriores
/resume Reabre uma sessão anterior com contexto
/clear Reinicia o contexto atual
/compact Compacta a conversa para liberar contexto
/yolo Alterna aprovação automática de ações
/exit Encerra a sessão

O comando mais útil em sessões longas costuma ser:

/compact
Enter fullscreen mode Exit fullscreen mode

Execuções extensas acumulam saídas de ferramentas, logs e histórico no contexto. O /compact resume a conversa para que você continue trabalhando sem reiniciar a sessão ou estourar a janela de contexto.

Conectar ao editor ou agente existente

Você não precisa trocar toda a sua configuração para testar o Kimi Code.

VS Code

Instale a extensão Kimi Code no marketplace e faça login com a mesma conta usada no CLI.

JetBrains e Zed

Use o protocolo ACP para conectar o agente ao editor. Assim, você mantém o fluxo de trabalho dentro da IDE que já usa.

Claude Code, Cline e RooCode

O modelo também é servido por uma API compatível com OpenAI.

Configuração geral:

Base URL: https://api.moonshot.ai/v1
Model: kimi-k2.7-code
Auth: API key do console Kimi Code
Enter fullscreen mode Exit fullscreen mode

O fluxo é semelhante ao descrito para executar o Kimi dentro do Claude Code e Cursor. A diferença principal é o ID do modelo.

Personalizar com MCP e sub-agentes

Duas funcionalidades tornam o Kimi Code mais útil em projetos reais: MCP e sub-agentes.

Usar MCP

O Kimi Code é um cliente MCP, então pode se conectar a servidores de ferramentas externas, como:

  • Leitor de banco de dados
  • Navegador
  • API interna
  • Rastreador de issues
  • Ferramentas de documentação
  • Serviços internos da empresa

Com MCP, o agente pode chamar essas ferramentas durante uma tarefa.

Exemplo de uso:

Use a ferramenta MCP de banco de dados para verificar o schema da tabela users.
Depois, atualize a validação do endpoint POST /users conforme o schema atual.
Enter fullscreen mode Exit fullscreen mode

Se você está criando ou validando um servidor MCP, veja o manual de teste de servidor MCP para testar o contrato antes de entregar a ferramenta a um agente.

Usar sub-agentes

Sub-agentes ajudam quando uma tarefa pode ser dividida em partes independentes.

Bons casos de uso:

Procure em todos os serviços chamadas à função depreciada createUserLegacy.
Crie um relatório com os arquivos afetados e sugira uma migração para cada caso.
Enter fullscreen mode Exit fullscreen mode

Ou:

Analise estes seis módulos e proponha testes unitários para cada um.
Divida o trabalho em sub-agentes e consolide o resultado no final.
Enter fullscreen mode Exit fullscreen mode

Você define agentes personalizados na configuração, de forma parecida com os sub-agentes do Claude Code.

Testar a API antes de integrar

Se você pretende conectar o kimi-for-coding ou o kimi-k2.7-code à sua própria ferramenta, teste o endpoint diretamente antes de escrever a integração.

O Apidog pode ser usado como ambiente visual para criar, enviar, validar e reutilizar chamadas de API.

Crie uma requisição POST para:

https://api.moonshot.ai/v1/chat/completions
Enter fullscreen mode Exit fullscreen mode

Adicione o cabeçalho:

Authorization: Bearer SUA_CHAVE_API
Content-Type: application/json
Enter fullscreen mode Exit fullscreen mode

Envie um corpo compatível com OpenAI:

{
  "model": "kimi-k2.7-code",
  "messages": [
    {
      "role": "system",
      "content": "Você é um assistente de codificação."
    },
    {
      "role": "user",
      "content": "Explique como validar um campo email vazio em um endpoint POST /users."
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

Depois, verifique:

  • Código de status
  • Estrutura da resposta
  • Conteúdo retornado
  • Uso de tokens
  • Formato de chamadas de ferramenta, se aplicável

Você também pode salvar a chamada como um teste reutilizável e reexecutá-la quando o modelo ou sua integração mudar.

Para configurar o ambiente local, baixe o Apidog.

Vale a pena usar o Kimi Code?

Depende do que você está otimizando.

Se o objetivo é obter a melhor resposta possível em uma única tentativa, modelos fechados de fronteira ainda podem levar vantagem em muitos cenários. O K2.7 Code fica alguns pontos atrás do GPT-5.5 e do Claude Opus na maioria dos benchmarks de codificação.

Mas o Kimi Code combina três pontos importantes:

  • Agente de terminal com fluxo familiar
  • Modelo open-weight
  • Preço por assinatura fixa

Isso pode fazer diferença para quem executa sessões longas de agente durante o dia todo.

Para uma comparação mais ampla entre agentes, veja a comparação entre Claude Code e OpenAI Codex.

A forma mais segura de avaliar é simples:

cd projeto-secundario
kimi
Enter fullscreen mode Exit fullscreen mode

Depois execute:

/init
Enter fullscreen mode Exit fullscreen mode

E dê uma tarefa real, como corrigir um bug pequeno, adicionar um teste ou refatorar um módulo isolado.

Em uma tarde, você deve conseguir decidir se ele merece espaço no seu fluxo de trabalho.

FAQ

Como instalo o Kimi Code?

No macOS ou Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
Enter fullscreen mode Exit fullscreen mode

No Windows PowerShell:

irm https://code.kimi.com/kimi-code/install.ps1 | iex
Enter fullscreen mode Exit fullscreen mode

Depois, inicie com:

kimi
Enter fullscreen mode Exit fullscreen mode

Como faço login?

Dentro da sessão, execute:

/login
Enter fullscreen mode Exit fullscreen mode

Para integrações externas, crie uma chave de API no console Kimi Code.

Qual modelo ele usa?

O Kimi Code usa o Kimi K2.7 Code.

Na assinatura do Kimi Code, o ID do modelo é:

kimi-for-coding
Enter fullscreen mode Exit fullscreen mode

Na API da Moonshot, paga por token, o ID é:

kimi-k2.7-code
Enter fullscreen mode Exit fullscreen mode

Funciona no VS Code?

Sim. Use a extensão Kimi Code.

JetBrains e Zed se conectam via protocolo ACP.

Posso usar com Claude Code ou Cline?

Sim. A API é compatível com OpenAI. Configure a ferramenta com:

https://api.moonshot.ai/v1
Enter fullscreen mode Exit fullscreen mode

E defina o modelo como:

kimi-k2.7-code
Enter fullscreen mode Exit fullscreen mode

Quanto custa?

O Kimi Code usa planos de assinatura com cota renovada a cada 7 dias, sem cobrança por token dentro do modelo de assinatura.

Para ver sua cota restante:

/usage
Enter fullscreen mode Exit fullscreen mode

Ele suporta MCP?

Sim. O Kimi Code é um cliente MCP e também suporta sub-agentes personalizados.

Resumo

Kimi Code é um agente de codificação para terminal e IDE, construído sobre o modelo open-weight K2.7 Code da Moonshot. O fluxo básico é:

cd seu-projeto
kimi
Enter fullscreen mode Exit fullscreen mode

Depois:

/login
/init
Enter fullscreen mode Exit fullscreen mode

A partir daí, você pode pedir alterações reais no código, executar testes, conectar ferramentas via MCP e usar sub-agentes para tarefas paralelas.

Ele não é necessariamente o agente com maior pontuação em benchmarks, mas a combinação de modelo aberto, assinatura fixa e integração com terminal, VS Code, JetBrains, Zed e ferramentas compatíveis com OpenAI torna o Kimi Code uma opção prática para uso diário intenso.

Antes de integrar a API em uma ferramenta própria, teste o endpoint no Apidog. Depois, rode o agente em um projeto real e avalie pelo resultado no seu próprio código.

Top comments (0)