Kimi Code CLI: como instalar, fazer login e rodar a primeira tarefa no terminal

Fala aí, beleza? A Moonshot tem um agente de programação próprio pra rodar no terminal, e dá pra colocar ele pra trabalhar num repo em poucos minutos 🙂

Aqui o recorte é bem prático: instalar, fazer login, gerar o contexto do projeto e rodar uma tarefa pequena num repositório de teste, sem liberar permissão demais logo de cara

Se liga num detalhe antes de tudo: o antigo MoonshotAI/kimi-cli, em Python, está arquivado e não recebe mais manutenção

A própria Moonshot indica usar o Kimi Code CLI, que vive no repo MoonshotAI/kimi-code

Então, se tu achar um tutorial antigo mandando instalar o kimi-cli, pula ele

O que você precisa antes de instalar o Kimi Code CLI

São quatro coisas, e nenhuma delas é PC da Nasa haha

• Uma forma de login: uma conta Kimi Code (pra entrar via OAuth) ou uma chave de API gerada em platform.kimi.com ou platform.kimi.ai
• Git for Windows, se você usa Windows: precisa estar instalado antes da primeira execução, porque o CLI usa o Git Bash que vem junto como ambiente de shell
• Node.js só se for instalar pelo npm: o script oficial dispensa Node.js, mas a instalação via npm exige Node.js 22.19.0 ou superior
• Um repositório de teste descartável: sem dados sensíveis, sem credencial, sem nada que doa perder

Por que o repo descartável?

Porque o agente lê e edita código e executa comandos de shell, e a primeira vez é justamente quando tu ainda está entendendo como ele pede permissão

Melhor errar num projeto de brinquedo do que no código do trampo 😛

Como instalar o Kimi e rodar a primeira tarefa, passo a passo

Os comandos abaixo vêm do repositório oficial e do guia de primeiros passos da documentação

1. Instale pelo script oficial do seu sistema (é o método recomendado)

No macOS e no Linux:

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

No Windows, pelo PowerShell:

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

Se preferir gerenciador de pacotes, também dá pra ir de Homebrew, npm ou pnpm:

brew install kimi-code
npm install -g @moonshot-ai/kimi-code
pnpm add -g @moonshot-ai/kimi-code

O erro comum deste passo: no Windows, rodar o CLI antes de instalar o Git for Windows. No npm, tentar instalar com Node abaixo do 22.19.0

2. Confira se o executável está pronto

kimi --version

O resultado esperado é o terminal reconhecer o comando e mostrar a versão instalada

O erro comum deste passo: ter instalado o kimi-cli arquivado em vez do kimi-code. Se o pacote não é o @moonshot-ai/kimi-code (ou o script do code.kimi.com), tu está no projeto legado

3. Entre na pasta do repositório de teste e abra o agente

cd seu-projeto
kimi

O kimi sem argumentos abre uma sessão interativa nova no diretório atual

Ou seja: a pasta onde tu roda o comando é o projeto que ele vai enxergar, então confere duas vezes se está no repo certo

4. Faça login com /login

Dentro da sessão, rode:

/login

Aí aparecem duas opções:

• Kimi Code (OAuth): o login usa device code. Você abre o link em qualquer dispositivo, entra na conta e digita o código pra autorizar
• Chave de API: tu cola a chave da Moonshot AI Open Platform, o CLI valida e carrega os modelos disponíveis pra aquela conta

Precisa trocar a chave? É só rodar /login de novo

E se quiser apagar as credenciais atuais, /logout resolve

5. Gere o contexto do projeto com /init

/init

O /init analisa o projeto e gera (ou atualiza) um AGENTS.md com estrutura, passos de build e convenções de código

Pensa nele como o "manual de onboarding" que tu daria pra um dev novo no time: é dali que o agente tira o contexto do repo 🙂

6. Rode a primeira tarefa em modo seguro

Primeiro, ligue o modo Plan, que faz o agente mostrar um plano de ação e esperar sua aprovação antes de mexer em qualquer arquivo:

/plan on

Depois peça algo pequeno. Um exemplo didático:

Crie um README.md curto explicando o que este projeto faz e como rodar ele localmente

Leia o plano, aprove se fizer sentido e, como o modo padrão é o Always Ask, confirme cada edição quando ele pedir

O erro comum deste passo: ativar /yolo ou --auto logo na primeira tarefa. Aí tu perde justamente a parte em que entende o que o agente está fazendo

7. Confira o resultado

Fora do Kimi, use o próprio Git pra ver o que mudou e leia o arquivo de contexto gerado:

git diff
cat AGENTS.md

Se o diff mostra só a mudança que tu pediu e o AGENTS.md descreve o projeto de um jeito que bate com a realidade, a primeira tarefa está fechada

Se tiver algo estranho no AGENTS.md, corrige na mão: é texto, e tu manda nele

Modos de permissão do Kimi Code CLI: quando usar cada um

O padrão é o Always Ask, e pra começar é ele que tu quer

São três modos de permissão, mais o Plan por cima, segundo a documentação de interação:

Modo	Nome antigo	Como liga	O que faz	Quando usar
Always Ask	Manual	É o padrão	Leituras rodam sozinhas, edições e comandos pedem confirmação a cada ação	Aprendizado e repo novo
Ask When Needed	YOLO	/yolo ou kimi --yolo	Aprova sozinho edições e comandos de rotina, mas pergunta antes de ações arriscadas, perguntas e planos	Rotina num repo que tu já conhece bem
Never Ask	Auto	/auto ou kimi --auto	Totalmente desassistido, todas as aprovações de ferramenta acontecem automaticamente	Automação em ambiente isolado

Pra escolher o modo sem decorar nada, rode /permission, que abre a seleção

E o Plan?

Ele liga e desliga com /plan on e /plan off, e funciona como uma etapa de revisão antes de qualquer mexida em arquivo

Um detalhe importante: o /yolo não pula a aprovação de saída do Plan. Então dá pra combinar os dois e ainda revisar o plano antes de soltar o agente

Tome cuidado com o Never Ask: desassistido significa que comando de shell também roda sem tu ver. Os rm -rf da vida não pedem licença 😅

Como trocar de modelo no Kimi Code CLI

Rode /model dentro da sessão e escolha outro modelo pra sessão atual

O que aparece nessa lista depende da conta e da plataforma que tu usou no /login, então a lista de quem entra via OAuth pode não ser a mesma de quem entra com chave de API

Pra ter uma referência, a lista de modelos da Kimi API Platform mostra:

• kimi-k3.1-pro: o carro-chefe atual, com contexto de 1M tokens
• kimi-k3: o carro-chefe da geração anterior
• kimi-k2.7-code: modelo dedicado a código

Esses nomes vêm da plataforma de API, não da tela do CLI, então confira no seu /model quais estão liberados pra sua conta

O CLI funciona de fábrica com os modelos Kimi e pode ser configurado pra usar outros provedores compatíveis, mas essa configuração é opcional e fica fora deste passo a passo

Comandos básicos do Kimi Code CLI para o dia a dia

Referência rápida pra deixar aberta do lado:

Comando	Pra que serve
kimi	Abre uma sessão interativa nova no diretório atual
kimi -p "Take a look at this project's directory structure"	Executa uma única instrução sem abrir a interface
kimi --session	Retoma sessões anteriores
/login	Entra com OAuth do Kimi Code ou chave de API (e troca a chave)
/logout	Apaga as credenciais atuais
/init	Gera ou atualiza o AGENTS.md do projeto
/model	Troca o modelo da sessão atual
/permission	Abre a seleção do modo de permissão
/plan on / /plan off	Liga e desliga o modo Plan
/yolo	Ativa o Ask When Needed
/auto	Ativa o Never Ask
kimi upgrade	Atualiza o CLI (escolha "Install update now"), seguindo a origem da sua instalação
npm install -g @moonshot-ai/kimi-code@latest	Atualiza pra quem instalou pelo npm

O kimi -p é o mais legal pra quem curte script: tu manda uma instrução pontual e não precisa entrar na interface

Só lembra que ele continua sendo um agente com acesso ao seu diretório, então a regra do repo de teste vale aqui também

Agentes de IA trabalhando em equipe:

Aqui o agente trabalha sozinho no terminal, mas a ideia de agente vai bem além disso

Se liga no vídeo abaixo 🙂

Próximo passo depois da primeira tarefa

Abre o AGENTS.md gerado e ajusta ele: corrige convenção errada, acrescenta o comando de teste que tu usa de verdade, tira o que não faz sentido

Depois, pede uma tarefa um pouco maior (tipo um teste simples pra uma função existente) ainda no Always Ask, revisando cada edição com git diff

Só quando o agente estiver acertando o contexto do repo vale a pena pensar em afrouxar pra /yolo

E se tu ainda está decidindo qual agente vai virar o seu daily driver, dá uma olhada no OpenCode, agente de código aberto, que segue a mesma pegada de rodar no terminal

Até o próximo post! 😀

Perguntas frequentes

Preciso desinstalar o kimi-cli antigo antes de instalar o Kimi Code CLI?

O MoonshotAI/kimi-cli antigo está arquivado e sem manutenção, e a Moonshot indica usar o MoonshotAI/kimi-code no lugar dele

Na hora de instalar, confere se o pacote é o @moonshot-ai/kimi-code (ou o script do code.kimi.com) e roda kimi –version pra ver se o executável certo está pronto

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.