O Kimi Code CLI é o Agent de IA para programação em terminal de código aberto da Moonshot AI — ele lê e edita código, executa comandos de shell e planeja a próxima etapa com base no seu feedback. Esta referência rápida reúne os comandos, comandos com barra, atalhos de teclado, ferramentas integradas e fluxos de trabalho diários do Kimi Code que os desenvolvedores mais usam. Mantenha-a aberta ao lado do terminal e use /help no Kimi Code ou kimi --help no shell para verificar o que sua versão atual oferece.
Para mais detalhes da fonte original, consulte as referências oficiais de comando kimi, comandos com barra, ferramentas integradas e atalhos de teclado.
Instale o Kimi Code CLI
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 requer Node.js. Homebrew, npm e pnpm também estão disponíveis, caso se adequem melhor ao 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 |
| PowerShell do Windows | 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 inicialização, pois o Kimi Code CLI usa o Git Bash incluído como ambiente de shell. Após a instalação, abra um novo terminal e verifique o binário:
Comece aqui
Use este ciclo básico ao entrar em um projeto pela primeira vez:
Use --yolo, /yolo e /auto apenas em espaços de trabalho nos quais você confia. Eles reduzem a necessidade de aprovações, mas também permitem que o Kimi Code aja com mais autonomia.
Comandos mais usados
Se você memorizar apenas alguns, que sejam estes — eles abrangem a maioria das sessões do dia a dia.
| Comando | O que faz |
|---|---|
kimi | Inicie uma sessão interativa no diretório atual |
kimi -C | Continue a sessão mais recente aqui |
kimi -p "..." | Execute um único prompt sem abrir a TUI |
/login | Faça login na primeira inicialização |
/init | Gere ou atualize o AGENTS.md |
/plan on | Entre no Plan Mode para alterações amplas ou arriscadas |
/model | Altere o modelo desta sessão |
/compact | Libere contexto quando a conversa ficar longa |
/sessions | Navegue e retome sessões anteriores |
/help | Liste todos os comandos e atalhos |
Shift-Tab | Ative ou desative o Plan Mode |
Inicialização e automação
Opções principais da CLI
| Comando / sinalizador | O que faz |
|---|---|
kimi | Inicie uma sessão interativa no diretório atual |
kimi --continue, kimi -C | Continue a sessão mais recente neste diretório |
kimi --session [id], kimi -S [id] | Retome uma sessão pelo ID ou abra o seletor de sessões sem um ID |
kimi -p "...", kimi --prompt "..." | Execute um único prompt não interativo sem abrir a TUI |
--output-format stream-json | Emita eventos JSONL para scripts; funciona apenas com --prompt |
kimi --model <model>, kimi -m <model> | Inicie com um alias de modelo específico |
kimi --plan | Inicie uma nova sessão no Modo de Planejamento |
kimi --yolo, kimi -y | Aprove automaticamente chamadas regulares de ferramentas; use apenas em diretórios confiáveis |
kimi --auto | Inicie no modo de permissões automáticas; as aprovações são tratadas automaticamente e o Agent não fará perguntas |
--skills-dir <dir> | Carregue Skills do diretório especificado, substituindo os diretórios de skills de usuário e projeto detectados automaticamente nesta inicialização |
Exemplos não interativos
Subcomandos da CLI
| Subcomando | Finalidade |
|---|---|
kimi login | Inicie o login com código de dispositivo OAuth do Kimi Code sem entrar na TUI |
kimi acp | Execute o Kimi Code como um servidor Agent Client Protocol para integração com IDE |
kimi doctor | Valide config.toml e tui.toml |
kimi export [sessionId] | Empacote uma sessão em um arquivo ZIP |
kimi rc | Abra a interface web por meio do Remote Control (alias kimi remote) |
kimi session list | Listar sessões para scripts |
kimi upgrade | Verificar a versão mais recente e exibir opções de atualização |
kimi web | Executar a interface web local e o serviço de API REST/WebSocket |
Interface web e acesso remoto:
Comandos com barra
Os comandos com barra são controles integrados da TUI. Digite / na caixa de entrada para abrir a conclusão de comandos; os aliases também são reconhecidos. Se uma entrada iniciada por / não corresponder a um comando integrado ou a um comando de Skill, ela será enviada ao Agent como uma mensagem comum.
Conta e configuração
| Comando | Alias | Finalidade |
|---|---|---|
/login | — | Fazer login via OAuth do kimi.ai / kimi.com ou chave de API |
/logout | — | Limpar as credenciais da conta atual |
/provider | — | Abrir o gerenciador de provedores para visualizar, adicionar e remover provedores configurados |
/model | — | Alternar o modelo de LLM usado na sessão atual |
/effort | — | Alternar o nível de esforço de raciocínio (desativado/baixo/alto/máximo) |
/secondary-model | — | Configurar o conjunto de modelos de subagentes |
/settings | /config | Abrir o painel de configurações na TUI |
/experiments | /experimental | Abrir o painel de recursos experimentais |
/permission | — | Selecionar um modo de permissão |
/editor | — | Configurar o editor externo aberto com Ctrl-G |
/theme | — | Alternar o tema de cores da interface do terminal |
/remote-control | /rc | Acessar remotamente uma sessão web local |
Gerenciamento de sessões
| Comando | Alias | Finalidade |
|---|---|---|
/new | /clear | Inicie uma nova sessão, descartando o contexto atual |
/sessions | /resume | Navegue pelas sessões anteriores e alterne para uma delas |
/tasks | /task | Navegue pela lista de tarefas em segundo plano |
/fork | — | Crie uma cópia bifurcada da sessão atual e permaneça nesta sessão |
/title [...] | /rename | Exiba ou defina o título da sessão atual |
/compact [...] | — | Compacte o contexto da conversa; o texto opcional indica o que preservar |
/undo [n] | — | Desfaça prompts recentes do contexto ativo |
/reload | — | Recarregue a sessão e aplique as configurações mais recentes de config.toml e tui.toml |
/reload-tui | — | Recarregue apenas as preferências de interface em tui.toml |
/init | — | Analise a base de código e gere AGENTS.md |
/export-md [...] | /export | Exporte a sessão atual como Markdown |
/export-debug-zip | — | Exporte a sessão atual como um arquivo ZIP de depuração |
Modos e controle de execução
| Comando | Alias | Finalidade |
|---|---|---|
/yolo | /yes | Alterne para o modo Perguntar quando necessário: ações rotineiras são executadas automaticamente, mas as arriscadas continuam pedindo confirmação |
/auto | — | Alterne para o modo Nunca perguntar: tudo é executado automaticamente |
/plan [on\|off] | — | Ative ou desative o Modo de planejamento; apenas alterná-lo não cria um arquivo de plano vazio |
/plan clear | — | Limpe o plano atual |
/tower | — | Orquestração de worktrees com múltiplos agentes (experimental; ative em /experiments) |
/swarm on\|off | — | Ative ou desative o modo swarm sem enviar um prompt |
/swarm <task> | — | Ative o modo swarm, envie a tarefa como prompt e desative o modo swarm após uma interação normal |
/goal [...] | — | Inicie ou gerencie uma meta autônoma |
O modo Planejamento é indicado para trabalhos amplos, arriscados ou pouco claros. Ele prioriza a exploração e o planejamento antes de alterar arquivos.
/plan on, deixe o Kimi Code analisar o projeto, revise o plano proposto e aprove-o antes que alterações sejam feitas.Os subcomandos do modo de objetivo 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 os atalhos de teclado e os comandos disponíveis |
/btw [question] | — | Abre uma conversa paralela em um sub-Agente bifurcado |
/usage | — | Mostra o uso de token, o consumo de contexto e informações sobre a cota |
/status | — | Mostra o estado de execução: versão, modelo, diretório de trabalho, modo de permissão e mais |
/mcp | — | Lista os 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 | — | Envie feedback sobre o produto |
/exit | /quit, /q | Sai da CLI do Kimi Code |
Skills e extensões
Um único prompt pode ativar várias Skills.
| Comando | Finalidade |
|---|---|
/mcp-config | Configure servidores MCP e faça login via MCP OAuth |
/custom-theme [...] | Crie ou edite um tema de cores personalizado para a TUI |
/update-config | Inspecione ou edite config.toml e tui.toml |
/import-from-cc-codex | Importe instruções, Skills e configurações de MCP do Claude Code e do Codex |
/skill:name [extra text] | Invoque um Skill externo instalado |
/name [extra text] | Atalho para um Skill externo quando nenhum comando do sistema tiver o mesmo nome |
/parent.child [extra text] | Invoque um sub-Skill externo exposto com um nome de comando pontuado |
Ferramentas integradas
As ferramentas integradas são fornecidas pelo próprio Kimi Code CLI. Ferramentas somente de 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 permita.
Arquivos, shell e web
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
Read | Permitido automaticamente | Ler arquivos de texto |
Write | Requer aprovação | Criar ou sobrescrever arquivos |
Edit | Requer aprovação | Substituir o conteúdo exato de um arquivo |
Grep | Permitido automaticamente | Pesquisar o conteúdo de arquivos com ripgrep |
Glob | Permitido automaticamente | Encontrar arquivos por padrão glob |
ReadMediaFile | Permitido automaticamente | Ler um arquivo de imagem ou vídeo |
Bash | Requer aprovação | Executar comandos de shell |
WebSearch | Permitido automaticamente | Pesquisar na web quando disponível |
FetchURL | Permitido automaticamente | Buscar o conteúdo de uma URL especificada |
Planejamento, estado e colaboração
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
EnterPlanMode | Permitir automaticamente | Entrar no modo de planejamento |
ExitPlanMode | Permitir automaticamente; o usuário confirma o plano | Sair do modo de planejamento e enviar o plano |
TodoList | Permitir automaticamente | Gerenciar uma lista visível de tarefas pendentes |
Agent | Permitir automaticamente | Criar um sub-Agent para uma subtarefa específica |
AgentSwarm | Permitir automaticamente no modo swarm; caso contrário, pode exigir aprovação | Iniciar subagentes com base em itens ou retomar subagentes existentes |
AskUserQuestion | Permitir automaticamente | Fazer perguntas estruturadas de múltipla escolha |
Skill | Permitir automaticamente | Invocar uma Skill em linha registrada |
Tarefas em segundo plano e agendadas
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
TaskList | Permitir automaticamente | Listar tarefas em segundo plano |
TaskOutput | Permitir automaticamente | Ver a saída de uma tarefa em segundo plano |
WaitFor | Permitir automaticamente | Aguardar tarefas em segundo plano no turno atual |
TaskStop | Exige aprovação | Interromper uma tarefa em segundo plano em execução |
CronCreate | Exige aprovação | Agendar o envio de um prompt para o futuro |
CronList | Permitir automaticamente | Listar tarefas agendadas |
CronDelete | Requer aprovação | Cancelar uma tarefa agendada |
Atalhos de teclado
Digite /help na TUI para ver a lista de atalhos disponível na sua versão atual. Consulte a referência oficial de Atalhos de teclado para ver a lista completa da fonte original.
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 pop-up, cancelar a conclusão ou interromper o streaming / a 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 modo e edição
| Atalho | Ação |
|---|---|
Shift-Tab | Alternar o Modo de Planejamento |
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 a transmissão e a saída de ferramentas
| Atalho | Ação |
|---|---|
Ctrl-S | Direcionar: inserir a entrada atual na interação 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 |
Ctrl-B | Mover o comando de shell em execução para uma tarefa em segundo plano |
Painel de aprovação
| Atalho | Ação |
|---|---|
↑ / ↓ | Alternar entre as opções de aprovação |
Enter | Confirmar a opção de aprovação selecionada |
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 ou a prévia do arquivo em revisão |
Pop-ups e ajuda
| Atalho | Ação |
|---|---|
PageUp / PageDown | Rolar um pop-up em blocos de 10 linhas |
q / Q | Fechar um pop-up |
Enter | Fechar um pop-up de ajuda |
Fluxos de trabalho comuns
Inicie um novo repositório
Planeje uma refatoração antes de editar
Execute uma tarefa em segundo plano
Depois, abra /tasks para acompanhar o trabalho em segundo plano ou deixe que o Kimi Code avise quando a tarefa for concluída.
Retome o trabalho de ontem
Se precisar de uma sessão específica, execute kimi --session ou use /sessions na TUI.
Exporte ou depure uma sessão
Conclusão
O Kimi Code CLI funciona melhor quando você o trata como um colega de equipe no terminal, com contexto explícito do projeto. Comece com /init, use /plan para mudanças grandes ou incertas, acompanhe tarefas demoradas com /tasks, mantenha /compact à mão em 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 ignora a aprovação de chamadas regulares de ferramentas. Use-o apenas em espaços de trabalho confiáveis e com controle de versão. Para repositórios desconhecidos ou dados de produção, mantenha as aprovações ativadas./skill:name, /mcp e /mcp-config para descobri-los e configurá-los.