CLI · Primeiros passos
Guia atualizado da equipe Kimi Code
Kimi Code CLI é um Agent interativo no terminal: lê e altera código, executa comandos shell, pesquisa arquivos, consulta páginas web e adapta seus próximos passos aos resultados. Ajuda com novos recursos, bugs, refatoração, entendimento de projetos e automação de arquivos, builds e testes. É escrita em TypeScript, distribuída pelo npm e executada em Node.js.
Instalação
Use o script recomendado, sem necessidade de Node.js pré-instalado, ou npm. Para a interface interativa, prefira um terminal com cores reais e ligaturas, como Kitty ou Ghostty.
Script de instalação
No Windows, instale Git for Windows antes de iniciar. A CLI usa seu Git Bash. Em instalação personalizada, defina KIMI_SHELL_PATH com o caminho absoluto de bash.exe. O script baixa a versão mais recente, verifica o checksum e disponibiliza kimi no PATH.
Instalação pelo npm
Requer Node.js 22.19.0 ou posterior. Verifique a versão e escolha npm ou pnpm:
Primeira execução
Entre na pasta do projeto e execute kimi. -p executa uma instrução sem interface interativa; -c retoma a última sessão.
Login
Na primeira execução use /login. Kimi Code (OAuth) usa código de dispositivo: abra o link em qualquer aparelho, faça login e informe o código. Kimi Platform API key aceita uma chave de platform.kimi.com ou platform.kimi.ai. /logout apaga as credenciais atuais.
Para Anthropic, OpenAI, Google ou outros provedores, configure a chave API em ~/.kimi-code/config.toml. Consulte Provedores e modelos, Arquivos de configuração, Variáveis de ambiente e Sobrescritas.
Primeira conversa
A CLI lê arquivos e pesquisa conteúdos relevantes antes de responder. Leituras são automáticas por padrão; alterações e comandos shell exigem confirmação. Para uma tarefa concreta:
A CLI planeja, altera o código, executa testes e explica cada passo. /help abre comandos e atalhos: navegue com ↑/↓, feche com Esc. Para sair use /exit, duas vezes Ctrl-C quando ociosa ou Ctrl-D com a entrada vazia.
Comandos e atalhos principais
| Comando | Ação |
|---|---|
/new | Iniciar nova sessão e limpar o contexto |
/sessions | Explorar e retomar sessões |
/model | Trocar modelo |
/compact | Compactar o contexto |
/fork | Criar cópia independente com todo o histórico; você permanece na sessão atual |
Esc | Interromper saída ou fechar janela |
Ctrl-C | Interromper; duas vezes quando ociosa para sair |
Shift-Tab | Alternar modo Plan |
Ctrl-S | Inserir imediatamente a mensagem no turno atual |
Ctrl-O | Recolher ou expandir saídas e resumos de compactação |
Este artigo foi útil?