Tempo de leitura: 8 minutos2026-06-18
Esta referência rápida reúne os comandos, comandos de barra, atalhos de teclado, ferramentas integradas e fluxos diários de trabalho do Kimi Code mais usados por desenvolvedores. Deixe-a aberta ao lado do terminal e use /help dentro do Kimi Code ou kimi --help no shell para conferir o que a sua versão atual oferece.
Para detalhes da fonte oficial, consulte as referências de comando kimi, comandos de barra, ferramentas integradas e atalhos de teclado.
Comece aqui
Use este ciclo mínimo ao entrar em um projeto pela primeira vez:
cd your-project
kimi
# Dentro da sessão
/login # faça login se esta for sua primeira execução
/init # gere ou atualize AGENTS.md
/plan on # planeje antes de trabalhos amplos, arriscados ou pouco claros
/help # descubra comandos e atalhos
/compact # libere contexto quando a conversa ficar longa
Use --yolo, /yolo e /auto apenas em workspaces confiáveis. Eles reduzem o atrito das aprovações, mas também permitem que o Kimi Code aja com mais autonomia.
Instalar 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 exige Node.js. Homebrew, npm e pnpm também estão disponíveis se combinarem melhor com sua toolchain 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, porque o Kimi Code CLI usa o Git Bash incluído como ambiente de shell. Depois de instalar, abra um novo terminal e verifique o binário:
kimi --version
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 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 em Plan Mode |
kimi --yolo, kimi -y | Aprova automaticamente chamadas de ferramentas comuns; 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 de usuário e de projeto descobertos automaticamente |
Exemplos não interativos
kimi -p "Resuma o status atual do repositório"
kimi -m kimi-code/kimi-for-coding -p "Explique o diff mais recente"
kimi -p "Liste os arquivos alterados" --output-format stream-json
Subcomandos da CLI
| Subcomando | Finalidade |
|---|---|
kimi login | Inicia o login por código de dispositivo OAuth do Kimi Code 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 interface do Kimi no navegador; 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 da sessão no navegador |
kimi provider | Gerencia provedores pelo terminal |
Comandos úteis de servidor:
kimi server run # inicie ou reutilize um servidor local em segundo plano
kimi server run --foreground # execute anexado ao terminal
kimi server install # registre um serviço gerenciado pelo SO
kimi server status # mostre o estado instalado / em execução / pid / porta
kimi web # abra a interface no navegador
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 iniciada 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 | — | Troca 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 | — | Troca o tema de cores da interface 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 a partir da conversa atual |
/title [...] | /rename | Exibe 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 regulares de ferramentas |
/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 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 depois desativa o modo swarm após um turno normal |
/goal [...] | — | Inicia ou gerencia uma meta autônoma |
O Plan Mode é indicado para trabalhos amplos, arriscados ou pouco claros. Ele prioriza exploração e planejamento antes de alterações em arquivos.
Começar a editar imediatamente uma refatoração de 40 arquivos sem revisar o plano.
Execute
/plan on, deixe o Kimi Code inspecionar o projeto, revise o plano proposto e só então aprove antes que as alterações sejam feitas.Os subcomandos do modo de meta 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 o uso de token, o 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 os servidores MCP e o status da conexão |
/plugins | — | Abre o gerenciador de plugins |
/version | — | Exibe a versão do Kimi Code CLI |
/feedback | — | Envia feedback sobre o produto |
/exit | /quit, /q | Sai do Kimi Code CLI |
Skills e extensões
| Comando | Finalidade |
|---|---|
/mcp-config | Configura servidores MCP e lida com o login MCP OAuth |
/custom-theme [...] | Cria ou edita um tema de cores TUI personalizado |
/update-config | Inspeciona ou edita config.toml e tui.toml |
/import-from-cc-codex | Importa instruções, Skills e configurações MCP do Claude Code e do Codex |
/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 nome de comando pontuado |
Ferramentas integradas
As ferramentas integradas são fornecidas pelo próprio Kimi Code CLI. 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 permita.
Arquivos, shell e web
| Ferramenta | Aprovação padrão | Finalidade |
|---|---|---|
Read | Permitir automaticamente | Ler arquivos de texto |
Write | Requer aprovação | Criar ou sobrescrever arquivos |
Edit | Requer aprovação | Substituir o conteúdo exato do arquivo |
Grep | Permitir automaticamente | Pesquisar conteúdo de arquivos com ripgrep |
Glob | Permitir automaticamente | Encontrar arquivos por padrão glob |
ReadMediaFile | Permitir automaticamente | Ler um arquivo de imagem ou vídeo |
Bash | Requer aprovação | Executar comandos do shell |
WebSearch | Permitir automaticamente | Pesquisar na web quando disponível |
FetchURL | Permitir 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 Plan Mode |
ExitPlanMode | Permitir automaticamente; o usuário confirma o plano | Sair do Plan Mode e enviar o plano |
TodoList | Permitir automaticamente | Gerenciar uma lista visível de tarefas |
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 subagents baseados em itens ou retomar subagents existentes |
AskUserQuestion | Permitir automaticamente | Fazer perguntas estruturadas de múltipla escolha |
Skill | Permitir automaticamente | Invocar uma Skill inline 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 |
TaskStop | Requer aprovação | Interromper uma tarefa em segundo plano em execução |
CronCreate | Requer aprovação | Agendar um prompt para ser disparado no futuro |
CronList | Permitir automaticamente | Listar tarefas agendadas |
CronDelete | Requer 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 de atalhos de teclado oficial para ver 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 pop-up, 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 | Conduzir: inserir a entrada atual na interação em andamento |
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 pop-ups
| Atalho | Ação |
|---|---|
↑ / ↓ | Mover entre opções de aprovação ou rolar um pop-up |
Enter | Confirmar a opção de aprovação selecionada; também fecha pop-ups de ajuda |
1 – 9 | Selecionar uma opção de aprovação por 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 da pré-visualização de arquivo no painel de aprovação |
PageUp / PageDown | Rolar um pop-up 10 linhas por vez |
q / Q | Fechar um pop-up |
Fluxos de trabalho comuns
Iniciar um novo repositório
cd your-project
kimi
/init
/status
Planejar uma refatoração antes de editar
/plan on
Refactor the auth module to use the new token format and update all callers.
Executar uma tarefa em segundo plano
Execute a suíte de testes e avise quando terminar.
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
kimi --continue
Se precisar de uma sessão específica, execute kimi --session ou use /sessions dentro da TUI.
Exportar ou depurar uma sessão
/export-md
/export-debug-zip
kimi export -y
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 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
A instalação do Kimi Code CLI é gratuita?
Sim. O Kimi Code CLI é open-source e gratuito para instalar. O acesso aos modelos ou serviços subjacentes pode depender do seu plano do Kimi Code. Veja os detalhes em preços do Kimi Code.
Por que esta página se chama referência rápida, e não apenas cola?
Referência rápida é o rótulo mais oficial, em estilo de documentação. A página ainda cobre o mesmo uso de uma cola: comandos para copiar e colar, comandos de barra, atalhos, ferramentas e fluxos de trabalho em um só lugar.
Preciso de Node.js para instalar o Kimi Code CLI?
Os scripts oficiais de instalação não exigem Node.js. Os métodos de instalação via npm e pnpm exigem um ambiente Node.js porque usam gerenciadores de pacotes JavaScript.
Qual é a diferença entre `/plan` e o modo normal?
O modo normal permite que o Agent trabalhe diretamente. O Plan Mode é para trabalhos amplos, arriscados ou pouco claros: o Kimi Code explora primeiro, escreve um plano e sai depois que o plano é aprovado.
Como retomo uma sessão anterior?
Execute
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` é seguro?
--yolo ignora a aprovação para chamadas de ferramentas comuns. Use apenas em workspaces confiáveis e com controle de versão. Em repositórios desconhecidos ou dados de produção, mantenha as aprovações ativadas.Como Skills e MCP se encaixam no Kimi Code?
Skills empacotam fluxos de trabalho reutilizáveis e podem aparecer como comandos de barra. MCP conecta o Kimi Code a ferramentas externas e fontes de dados. Use
/skill:name, /mcp e /mcp-config para descobri-los e configurá-los.