Referência rápida do CLI do Kimi Code

Uma folha de consulta rápida do CLI do Kimi Code, com comandos, comandos de barra, atalhos de teclado, ferramentas integradas, Plan Mode, Skills, MCP e fluxos de trabalho cotidianos de desenvolvimento.

Tempo de leitura: 8 minutosAtualizado: 2026-09-15
Prévia da interface CLI do Kimi Code

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 / gerenciadorComando
Script para macOS / Linuxcurl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash
Homebrewbrew install kimi-code
PowerShell do Windowsirm https://code.kimi.com/kimi-code/install.ps1 \| iex
npmnpm install -g @moonshot-ai/kimi-code
pnpmpnpm 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:

kimi --version

Comece aqui

Use este ciclo básico ao entrar em um projeto pela primeira vez:

cd seu-projeto kimi # Na sessão /login # faça login se esta for a primeira inicialização /init # gere ou atualize o 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 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.

ComandoO que faz
kimiInicie uma sessão interativa no diretório atual
kimi -CContinue a sessão mais recente aqui
kimi -p "..."Execute um único prompt sem abrir a TUI
/loginFaça login na primeira inicialização
/initGere ou atualize o AGENTS.md
/plan onEntre no Plan Mode para alterações amplas ou arriscadas
/modelAltere o modelo desta sessão
/compactLibere contexto quando a conversa ficar longa
/sessionsNavegue e retome sessões anteriores
/helpListe todos os comandos e atalhos
Shift-TabAtive ou desative o Plan Mode

Inicialização e automação

Opções principais da CLI

Comando / sinalizadorO que faz
kimiInicie uma sessão interativa no diretório atual
kimi --continue, kimi -CContinue 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-jsonEmita eventos JSONL para scripts; funciona apenas com --prompt
kimi --model <model>, kimi -m <model>Inicie com um alias de modelo específico
kimi --planInicie uma nova sessão no Modo de Planejamento
kimi --yolo, kimi -yAprove automaticamente chamadas regulares de ferramentas; use apenas em diretórios confiáveis
kimi --autoInicie 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

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

SubcomandoFinalidade
kimi loginInicie o login com código de dispositivo OAuth do Kimi Code sem entrar na TUI
kimi acpExecute o Kimi Code como um servidor Agent Client Protocol para integração com IDE
kimi doctorValide config.toml e tui.toml
kimi export [sessionId]Empacote uma sessão em um arquivo ZIP
kimi rcAbra a interface web por meio do Remote Control (alias kimi remote)
kimi session listListar sessões para scripts
kimi upgradeVerificar a versão mais recente e exibir opções de atualização
kimi webExecutar a interface web local e o serviço de API REST/WebSocket

Interface web e acesso remoto:

kimi web # executar a interface web local + o serviço de API REST/WebSocket kimi rc # abrir a interface web via Controle Remoto (alias: kimi remote) kimi session list # listar sessões para scripts

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

ComandoAliasFinalidade
/loginFazer login via OAuth do kimi.ai / kimi.com ou chave de API
/logoutLimpar as credenciais da conta atual
/providerAbrir o gerenciador de provedores para visualizar, adicionar e remover provedores configurados
/modelAlternar o modelo de LLM usado na sessão atual
/effortAlternar o nível de esforço de raciocínio (desativado/baixo/alto/máximo)
/secondary-modelConfigurar o conjunto de modelos de subagentes
/settings/configAbrir o painel de configurações na TUI
/experiments/experimentalAbrir o painel de recursos experimentais
/permissionSelecionar um modo de permissão
/editorConfigurar o editor externo aberto com Ctrl-G
/themeAlternar o tema de cores da interface do terminal
/remote-control/rcAcessar remotamente uma sessão web local

Gerenciamento de sessões

ComandoAliasFinalidade
/new/clearInicie uma nova sessão, descartando o contexto atual
/sessions/resumeNavegue pelas sessões anteriores e alterne para uma delas
/tasks/taskNavegue pela lista de tarefas em segundo plano
/forkCrie uma cópia bifurcada da sessão atual e permaneça nesta sessão
/title [...]/renameExiba 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
/reloadRecarregue a sessão e aplique as configurações mais recentes de config.toml e tui.toml
/reload-tuiRecarregue apenas as preferências de interface em tui.toml
/initAnalise a base de código e gere AGENTS.md
/export-md [...]/exportExporte a sessão atual como Markdown
/export-debug-zipExporte a sessão atual como um arquivo ZIP de depuração

Modos e controle de execução

ComandoAliasFinalidade
/yolo/yesAlterne para o modo Perguntar quando necessário: ações rotineiras são executadas automaticamente, mas as arriscadas continuam pedindo confirmação
/autoAlterne 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 clearLimpe o plano atual
/towerOrquestração de worktrees com múltiplos agentes (experimental; ative em /experiments)
/swarm on\|offAtive 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.

Comece a editar imediatamente uma refatoração de 40 arquivos sem revisar o plano.
Execute /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

ComandoAliasFinalidade
/help/h, /?Mostra os atalhos de teclado e os comandos disponíveis
/btw [question]Abre uma conversa paralela em um sub-Agente bifurcado
/usageMostra o uso de token, o consumo de contexto e informações sobre a cota
/statusMostra o estado de execução: versão, modelo, diretório de trabalho, modo de permissão e mais
/mcpLista os servidores MCP e o status da conexão
/pluginsAbre o gerenciador de plugins
/versionExibe a versão da CLI do Kimi Code
/feedbackEnvie feedback sobre o produto
/exit/quit, /qSai da CLI do Kimi Code

Skills e extensões

Um único prompt pode ativar várias Skills.

ComandoFinalidade
/mcp-configConfigure servidores MCP e faça login via MCP OAuth
/custom-theme [...]Crie ou edite um tema de cores personalizado para a TUI
/update-configInspecione ou edite config.toml e tui.toml
/import-from-cc-codexImporte 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

FerramentaAprovação padrãoFinalidade
ReadPermitido automaticamenteLer arquivos de texto
WriteRequer aprovaçãoCriar ou sobrescrever arquivos
EditRequer aprovaçãoSubstituir o conteúdo exato de um arquivo
GrepPermitido automaticamentePesquisar o conteúdo de arquivos com ripgrep
GlobPermitido automaticamenteEncontrar arquivos por padrão glob
ReadMediaFilePermitido automaticamenteLer um arquivo de imagem ou vídeo
BashRequer aprovaçãoExecutar comandos de shell
WebSearchPermitido automaticamentePesquisar na web quando disponível
FetchURLPermitido automaticamenteBuscar o conteúdo de uma URL especificada

Planejamento, estado e colaboração

FerramentaAprovação padrãoFinalidade
EnterPlanModePermitir automaticamenteEntrar no modo de planejamento
ExitPlanModePermitir automaticamente; o usuário confirma o planoSair do modo de planejamento e enviar o plano
TodoListPermitir automaticamenteGerenciar uma lista visível de tarefas pendentes
AgentPermitir automaticamenteCriar um sub-Agent para uma subtarefa específica
AgentSwarmPermitir automaticamente no modo swarm; caso contrário, pode exigir aprovaçãoIniciar subagentes com base em itens ou retomar subagentes existentes
AskUserQuestionPermitir automaticamenteFazer perguntas estruturadas de múltipla escolha
SkillPermitir automaticamenteInvocar uma Skill em linha registrada

Tarefas em segundo plano e agendadas

FerramentaAprovação padrãoFinalidade
TaskListPermitir automaticamenteListar tarefas em segundo plano
TaskOutputPermitir automaticamenteVer a saída de uma tarefa em segundo plano
WaitForPermitir automaticamenteAguardar tarefas em segundo plano no turno atual
TaskStopExige aprovaçãoInterromper uma tarefa em segundo plano em execução
CronCreateExige aprovaçãoAgendar o envio de um prompt para o futuro
CronListPermitir automaticamenteListar tarefas agendadas
CronDeleteRequer aprovaçãoCancelar 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

AtalhoAção
EnterEnviar a entrada atual
Shift-Enter / Ctrl-JInserir uma nova linha
/ Navegar pelo histórico de entradas
EscFechar um pop-up, cancelar a conclusão ou interromper o streaming / a compactação
Ctrl-CInterromper a saída em streaming ou limpar a caixa de entrada
Ctrl-DSair quando a caixa de entrada estiver vazia

Alternância de modo e edição

AtalhoAção
Shift-TabAlternar o Modo de Planejamento
Ctrl-GEditar a entrada atual em um editor externo
Ctrl-VColar uma imagem ou vídeo da área de transferência no Unix / macOS
Alt-VColar 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

AtalhoAção
Ctrl-SDirecionar: inserir a entrada atual na interação em execução
EscInterromper a saída em streaming atual
Ctrl-CInterromper a saída em streaming atual
Ctrl-OExpandir ou recolher a saída da ferramenta
Ctrl-BMover o comando de shell em execução para uma tarefa em segundo plano

Painel de aprovação

AtalhoAção
/ Alternar entre as opções de aprovação
EnterConfirmar a opção de aprovação selecionada
19Selecionar uma opção de aprovação pelo número
Esc / Ctrl-C / Ctrl-DRejeitar a solicitação de aprovação atual
Ctrl-EExpandir ou recolher o diff ou a prévia do arquivo em revisão

Pop-ups e ajuda

AtalhoAção
PageUp / PageDownRolar um pop-up em blocos de 10 linhas
q / QFechar um pop-up
EnterFechar um pop-up de ajuda

Fluxos de trabalho comuns

Inicie um novo repositório

cd your-project kimi /init /status

Planeje uma refatoração antes de editar

/plan on Refatore o módulo de autenticação para usar o novo formato de token e atualize todos os chamadores.

Execute uma tarefa em segundo plano

Execute a suíte de testes e me informe quando ela terminar.

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

kimi --continue

Se precisar de uma sessão específica, execute kimi --session ou use /sessions na TUI.

Exporte ou depure 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 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

O Kimi Code CLI é gratuito para instalar?
Sim. O Kimi Code CLI é de código aberto e pode ser instalado gratuitamente. O acesso aos modelos ou serviços subjacentes pode depender do seu plano do Kimi Code. Consulte os preços do Kimi Code para mais detalhes.
Por que esta página é chamada de referência rápida em vez de apenas folha de consulta?
Referência rápida é o nome mais oficial, no estilo de documentação. A página continua abrangendo o mesmo caso de uso de uma folha de consulta: comandos para copiar e colar, comandos com barra, atalhos, ferramentas e fluxos de trabalho em um só lugar.
Preciso do 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 com 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 Modo de Planejamento é destinado a trabalhos amplos, arriscados ou pouco claros: o Kimi Code explora primeiro, escreve um plano e encerra após a aprovação do plano.
Como retomar 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 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.
Como as Skills e o MCP se encaixam no Kimi Code?
As Skills empacotam fluxos de trabalho reutilizáveis e podem aparecer como comandos com barra. O MCP conecta o Kimi Code a ferramentas e fontes de dados externas. Use /skill:name, /mcp e /mcp-config para descobri-los e configurá-los.
Referência rápida do Kimi Code CLI: comandos, atalhos e fluxos de trabalho