A CLI do Kimi Code é o agent de codificação por IA para terminal open-source da Moonshot AI — ela lê e edita código, executa comandos de shell e planeja o próximo passo a partir do seu feedback. Esta referência rápida reúne os comandos do Kimi Code, comandos de barra, atalhos de teclado, ferramentas integradas e fluxos de trabalho diários que desenvolvedores mais usam. Deixe-a aberta ao lado do seu terminal e use /help dentro do Kimi Code ou kimi --help no shell para verificar o que a sua versão atual oferece.
Para detalhes na fonte, consulte as referências oficiais de comando kimi, comandos de barra, ferramentas integradas e atalhos de teclado.
Instalar a CLI do Kimi Code
Para a maioria dos desenvolvedores, o script oficial de instalação é o caminho mais rápido: ele instala um único binário do Kimi Code e não exige Node.js. Homebrew, npm e pnpm também estão disponíveis se combinarem melhor com o seu conjunto de ferramentas local.
| Plataforma / gerenciador | Comando |
|---|---|
| Script para macOS / Linux | curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash |
| Homebrew | brew install kimi-code |
| Windows PowerShell | irm https://code.kimi.com/kimi-code/install.ps1 \| iex |
| npm | npm install -g @moonshot-ai/kimi-code |
| pnpm | pnpm add -g @moonshot-ai/kimi-code |
No Windows, instale o Git for Windows antes da primeira execução, pois a CLI do Kimi Code usa o Git Bash incluído como ambiente de shell. Depois de instalar, abra um novo terminal e verifique o binário:
Comece aqui
Use este ciclo mínimo ao entrar em um projeto pela primeira vez:
Use --yolo, /yolo e /auto apenas em workspaces nos quais você confia. Eles reduzem o atrito das aprovações, mas também permitem que o Kimi Code aja com mais autonomia.
Comandos mais usados
Se for memorizar apenas alguns, que sejam estes — eles cobrem a maioria das sessões do dia a dia.
| Comando | O que faz |
|---|---|
kimi | Inicia uma sessão interativa no diretório atual |
kimi -C | Continua aqui a sessão mais recente |
kimi -p "..." | Executa um único prompt sem abrir a TUI |
/login | Faça login na primeira execução |
/init | Gera ou atualiza AGENTS.md |
/plan on | Entra no Plan Mode para alterações amplas ou arriscadas |
/model | Troca o modelo desta sessão |
/compact | Libera contexto quando a conversa fica longa |
/sessions | Navega por sessões anteriores e as retoma |
/help | Lista todos os comandos e atalhos |
Shift-Tab | Alterna o Plan Mode |
Inicialização e automação
Opções principais da CLI
| Comando / flag | O que faz |
|---|---|
kimi | Inicia uma sessão interativa no diretório atual |
kimi --continue, kimi -C | Continua a sessão mais recente neste diretório |
kimi --session [id], kimi -S [id] | Retoma uma sessão por ID ou abre o seletor de sessões sem informar um ID |
kimi -p "...", kimi --prompt "..." | Executa um único prompt não interativo sem abrir a TUI |
--output-format stream-json | Emite eventos JSONL para scripts; funciona apenas com --prompt |
kimi --model <model>, kimi -m <model> | Inicia com um alias de modelo específico |
kimi --plan | Inicia uma nova sessão no Plan Mode |
kimi --yolo, kimi -y | Aprova automaticamente chamadas regulares de ferramentas; use apenas em diretórios confiáveis |
kimi --auto | Inicia no modo de permissões automático; as aprovações são tratadas automaticamente e o Agent não fará perguntas |
--skills-dir <dir> | Carrega Skills do diretório especificado, substituindo, nesta execução, os diretórios de skills do usuário e do projeto descobertos automaticamente |
Exemplos não interativos
Subcomandos da CLI
| Subcomando | Finalidade |
|---|---|
kimi login | Inicia o login do Kimi Code por código de dispositivo OAuth sem entrar na TUI |
kimi acp | Executa o Kimi Code como servidor Agent Client Protocol para integração com IDE |
kimi server | Executa, instala e gerencia o serviço local REST/WebSocket/web |
kimi web | Abre a UI de navegador do Kimi; equivalente a kimi server run --open |
kimi doctor | Valida config.toml e tui.toml |
kimi export [sessionId] | Empacota uma sessão em um arquivo ZIP |
kimi migrate | Migra dados locais de uma instalação legada do kimi-cli |
kimi upgrade | Verifica a versão mais recente e exibe opções de atualização |
kimi vis [sessionId] | Abre o visualizador de sessões no navegador |
kimi provider | Gerencia provedores pelo terminal |
Comandos úteis do servidor:
Comandos de barra
Comandos de barra são controles integrados da TUI. Digite / na caixa de entrada para abrir o preenchimento de comandos; aliases também são reconhecidos. Se uma entrada prefixada por / não corresponder a um comando integrado nem a um comando de Skill, ela será enviada ao Agent como uma mensagem comum.
Conta e configuração
| Comando | Alias | Finalidade |
|---|---|---|
/login | — | Selecione uma conta ou plataforma e faça login |
/logout | — | Limpa as credenciais da conta atual |
/provider | — | Abre o gerenciador de provedores para ver, adicionar e remover provedores configurados |
/model | — | Alterna o modelo LLM usado na sessão atual |
/settings | /config | Abre o painel de configurações dentro da TUI |
/experiments | /experimental | Abre o painel de recursos experimentais |
/permission | — | Seleciona um modo de permissão |
/editor | — | Configura o editor externo iniciado por Ctrl-G |
/theme | — | Alterna o tema de cores da UI do terminal |
Gerenciamento de sessões
| Comando | Alias | Finalidade |
|---|---|---|
/new | /clear | Inicia uma nova sessão, descartando o contexto atual |
/sessions | /resume | Navega por sessões anteriores e alterna para uma delas |
/tasks | /task | Navega pela lista de tarefas em segundo plano |
/fork | — | Cria uma nova sessão derivada da conversa atual |
/title [...] | /rename | Mostra ou define o título da sessão atual |
/compact [...] | — | Compacta o contexto da conversa; o texto opcional indica o que preservar |
/undo [n] | — | Desfaz prompts recentes do contexto ativo |
/reload | — | Recarrega a sessão e aplica as configurações mais recentes de config.toml e tui.toml |
/reload-tui | — | Recarrega apenas as preferências de UI de tui.toml |
/init | — | Analisa a base de código e gera AGENTS.md |
/export-md [...] | /export | Exporta a sessão atual como Markdown |
/export-debug-zip | — | Exporta a sessão atual como um arquivo ZIP de depuração |
Modos e controle de execução
| Comando | Alias | Finalidade |
|---|---|---|
/yolo [on\|off] | /yes | Alterna o modo YOLO; quando ativado, dispensa aprovação para chamadas de ferramentas comuns |
/auto [on\|off] | — | Alterna o modo de permissão automática; as aprovações são tratadas automaticamente e as perguntas são ignoradas |
/plan [on\|off] | — | Alterna o Plan Mode; apenas alternar o modo não cria um arquivo de plano vazio |
/plan clear | — | Limpa o plano atual |
/swarm on\|off | — | Ativa ou desativa o modo swarm sem enviar um prompt |
/swarm <task> | — | Ativa o modo swarm, envia a tarefa como prompt e desativa o modo swarm após uma rodada normal |
/goal [...] | — | Inicia ou gerencia um objetivo autônomo |
O Plan Mode é indicado para trabalhos amplos, arriscados ou pouco claros. Ele prioriza exploração e planejamento antes de alterações em arquivos.
/plan on, deixe o Kimi Code inspecionar o projeto, revise o plano proposto e então aprove antes que as alterações sejam feitas.Os subcomandos do modo Goal incluem /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective> e /goal next manage.
Informações e status
| Comando | Alias | Finalidade |
|---|---|---|
/help | /h, /? | Mostra atalhos de teclado e comandos disponíveis |
/btw [question] | — | Abre uma conversa paralela em um sub-Agent derivado |
/usage | — | Mostra uso de token, consumo de contexto e informações de cota |
/status | — | Mostra o estado de execução: versão, modelo, diretório de trabalho, modo de permissão e mais |
/mcp | — | Lista servidores MCP e o status da conexão |
/plugins | — | Abre o gerenciador de plugins |
/version | — | Exibe a versão da CLI do Kimi Code |
/feedback | — | Envia feedback sobre o produto |
/exit | /quit, /q | Sai da CLI do Kimi Code |
Skills e extensões
| Comando | Finalidade |
|---|---|
/mcp-config | Configura servidores MCP e gerencia o login OAuth do MCP |
/custom-theme [...] | Cria ou edita um tema de cores personalizado para TUI |
/update-config | Inspeciona ou edita config.toml e tui.toml |
/import-from-cc-codex | Importa instruções do Claude Code e do Codex, Skills e configurações de MCP |
/sub-skill | Descobre e reorganiza o inventário local de Skill |
/skill:name [extra text] | Invoca uma Skill externa instalada |
/name [extra text] | Atalho para uma Skill externa quando nenhum comando do sistema tem o mesmo nome |
/parent.child [extra text] | Invoca uma sub-skill externa exposta com um nome de comando pontuado |
Ferramentas integradas
As ferramentas integradas são fornecidas pela própria CLI do Kimi Code. Ferramentas somente leitura, como Read, Grep e Glob, são permitidas automaticamente por padrão; ferramentas que gravam arquivos, executam comandos, interrompem tarefas ou criam agendamentos normalmente exigem aprovação, a menos que seu modo de permissão as autorize.
Arquivos, shell e web
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
Read | Permissão automática | Ler arquivos de texto |
Write | Exige aprovação | Criar ou sobrescrever arquivos |
Edit | Exige aprovação | Substituir conteúdo exato de arquivos |
Grep | Permissão automática | Pesquisar conteúdo de arquivos com ripgrep |
Glob | Permissão automática | Encontrar arquivos por padrão glob |
ReadMediaFile | Permissão automática | Ler um arquivo de imagem ou vídeo |
Bash | Exige aprovação | Executar comandos de shell |
WebSearch | Permissão automática | Pesquisar na web quando disponível |
FetchURL | Permissão automática | Buscar o conteúdo de uma URL especificada |
Planejamento, estado e colaboração
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
EnterPlanMode | Permissão automática | Entrar no Plan Mode |
ExitPlanMode | Permissão automática; o usuário confirma o plano | Sair do Plan Mode e enviar o plano |
TodoList | Permissão automática | Gerenciar uma lista de tarefas visível |
Agent | Permissão automática | Criar um sub-Agent para uma subtarefa específica |
AgentSwarm | Permissão automática em modo swarm; caso contrário, pode exigir aprovação | Iniciar subagents baseados em itens ou retomar subagents existentes |
AskUserQuestion | Permissão automática | Fazer perguntas estruturadas de múltipla escolha |
Skill | Permissão automática | Invocar uma Skill inline registrada |
Tarefas em segundo plano e agendadas
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
TaskList | Permissão automática | Listar tarefas em segundo plano |
TaskOutput | Permissão automática | Ver a saída de uma tarefa em segundo plano |
TaskStop | Exige aprovação | Parar uma tarefa em segundo plano em execução |
CronCreate | Exige aprovação | Agendar um prompt para disparar no futuro |
CronList | Permissão automática | Listar tarefas agendadas |
CronDelete | Exige aprovação | Cancelar uma tarefa agendada |
Atalhos de teclado
Digite /help dentro da TUI para ver a lista de atalhos disponível na sua versão atual. Consulte a referência oficial de atalhos de teclado para a lista upstream completa.
Entrada geral
| Atalho | Ação |
|---|---|
Enter | Enviar a entrada atual |
Shift-Enter / Ctrl-J | Inserir uma nova linha |
↑ / ↓ | Navegar pelo histórico de entradas |
Esc | Fechar um popup, cancelar a conclusão ou interromper streaming / compactação |
Ctrl-C | Interromper a saída em streaming ou limpar a caixa de entrada |
Ctrl-D | Sair quando a caixa de entrada estiver vazia |
Alternância de modos e edição
| Atalho | Ação |
|---|---|
Shift-Tab | Alternar Plan Mode |
Ctrl-G | Editar a entrada atual em um editor externo |
Ctrl-V | Colar uma imagem ou vídeo da área de transferência no Unix / macOS |
Alt-V | Colar uma imagem ou vídeo da área de transferência no Windows |
Ctrl-- | Desfazer edição da entrada |
Durante streaming e saída de ferramentas
| Atalho | Ação |
|---|---|
Ctrl-S | Direcionar: inserir a entrada atual no turno em execução |
Esc | Interromper a saída em streaming atual |
Ctrl-C | Interromper a saída em streaming atual |
Ctrl-O | Expandir ou recolher a saída da ferramenta |
Painel de aprovação e popups
| Atalho | Ação |
|---|---|
↑ / ↓ | Mover entre opções de aprovação ou rolar um popup |
Enter | Confirmar a opção de aprovação selecionada; também fecha popups de ajuda |
1 – 9 | Selecionar uma opção de aprovação pelo número |
Esc / Ctrl-C / Ctrl-D | Rejeitar a solicitação de aprovação atual |
Ctrl-E | Expandir ou recolher o diff completo ou o conteúdo de pré-visualização do arquivo no painel de aprovação |
PageUp / PageDown | Rolar um popup 10 linhas por vez |
q / Q | Fechar um popup |
Fluxos de trabalho comuns
Iniciar um novo repositório
Planejar uma refatoração antes de editar
Executar uma tarefa em segundo plano
Depois, abra /tasks para monitorar o trabalho em segundo plano ou deixe o Kimi Code avisar quando a tarefa for concluída.
Retomar o trabalho de ontem
Se precisar de uma sessão específica, execute kimi --session ou use /sessions dentro da TUI.
Exportar ou depurar uma sessão
Conclusão
A CLI do Kimi Code funciona melhor quando você a trata como uma colega de terminal, com o contexto do projeto bem explícito. Comece com /init, use /plan para mudanças grandes ou incertas, acompanhe trabalhos demorados com /tasks, mantenha /compact à mão para sessões longas e escolha um modo de permissão compatível com o nível de confiança do repositório.
Perguntas frequentes
kimi --continue no mesmo diretório do projeto para continuar a sessão mais recente. Use kimi --session [id] no shell ou /sessions dentro da TUI para escolher uma sessão específica.--yolo dispensa aprovação para chamadas comuns de ferramentas. Use apenas em workspaces confiáveis e versionados. Em repositórios desconhecidos ou com dados de produção, mantenha as aprovações ativadas./skill:name, /mcp e /mcp-config para descobrir e configurar esses recursos.