Riferimento rapido della CLI di Kimi Code

Un cheat sheet e riferimento rapido per la CLI di Kimi Code che copre comandi, comandi slash, scorciatoie da tastiera, strumenti integrati, Modalità pianificazione, Skills, MCP e flussi di lavoro quotidiani per sviluppatori.

8 min di letturaAggiornato: 2026-09-15
Anteprima dell'interfaccia CLI di Kimi Code

Kimi Code CLI è Agent open-source di Moonshot AI per la programmazione con IA da terminale: legge e modifica il codice, esegue comandi shell e pianifica il passaggio successivo in base al tuo feedback. Questo riferimento rapido raccoglie i comandi Kimi Code, i comandi slash, le scorciatoie da tastiera, gli strumenti integrati e i flussi di lavoro quotidiani più usati dagli sviluppatori. Tienilo aperto accanto al terminale e usa /help in Kimi Code o kimi --help nella shell per verificare le funzionalità disponibili nella versione in uso.

Per i dettagli a monte, consulta i riferimenti ufficiali per il comando kimi, i comandi slash, gli strumenti integrati e le scorciatoie da tastiera.

Installare Kimi Code CLI

Per la maggior parte degli sviluppatori, lo script di installazione ufficiale è la soluzione più rapida: installa un unico binario Kimi Code e non richiede Node.js. Sono disponibili anche Homebrew, npm e pnpm, se si adattano meglio alla toolchain locale.

Piattaforma / gestoreComando
Script per macOS / Linuxcurl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash
Homebrewbrew install kimi-code
Windows PowerShellirm https://code.kimi.com/kimi-code/install.ps1 \| iex
npmnpm install -g @moonshot-ai/kimi-code
pnpmpnpm add -g @moonshot-ai/kimi-code

Su Windows, installa Git for Windows prima del primo avvio, perché Kimi Code CLI usa Git Bash incluso come ambiente shell. Dopo l'installazione, apri un nuovo terminale e verifica il binario:

kimi --version

Inizia da qui

Quando accedi a un progetto per la prima volta, usa questo ciclo minimo:

cd your-project kimi # All'interno della sessione /login # accedi se è il primo avvio /init # genera o aggiorna AGENTS.md /plan on # pianifica prima di interventi ampi, rischiosi o poco chiari /help # scopri comandi e scorciatoie /compact # libera contesto quando la conversazione diventa lunga

Usa --yolo, /yolo e /auto solo in spazi di lavoro affidabili. Riducono gli attriti legati alle approvazioni, ma consentono anche a Kimi Code di agire con maggiore autonomia.

Comandi più usati

Se devi memorizzarne solo alcuni, scegli questi: coprono la maggior parte delle sessioni quotidiane.

ComandoFunzione
kimiAvvia una sessione interattiva nella directory corrente
kimi -CRiprendi qui la sessione più recente
kimi -p "..."Esegui un singolo prompt senza aprire la TUI
/loginAccedi al primo avvio
/initGenera o aggiorna AGENTS.md
/plan onEntra in Modalità pianificazione per modifiche ampie o rischiose
/modelCambia il modello per questa sessione
/compactLibera contesto quando la conversazione si allunga
/sessionsSfoglia e riprendi le sessioni precedenti
/helpElenca tutti i comandi e le scorciatoie
Shift-TabAttiva o disattiva la Modalità pianificazione

Avvio e automazione

Opzioni CLI principali

Comando / opzioneFunzione
kimiAvvia una sessione interattiva nella directory corrente
kimi --continue, kimi -CContinua la sessione più recente in questa directory
kimi --session [id], kimi -S [id]Riprendi una sessione tramite ID oppure apri il selettore di sessione senza specificare un ID
kimi -p "...", kimi --prompt "..."Esegui un singolo prompt non interattivo senza aprire la TUI
--output-format stream-jsonGenera eventi JSONL per lo scripting; funziona solo con --prompt
kimi --model <model>, kimi -m <model>Avvia con un alias di modello specifico
kimi --planAvvia una nuova sessione in modalità pianificazione
kimi --yolo, kimi -yApprova automaticamente le normali chiamate agli strumenti; usalo solo in directory affidabili
kimi --autoAvvia in modalità di autorizzazione automatica; le approvazioni vengono gestite automaticamente e l'Agent non farà domande
--skills-dir <dir>Carica le Skills dalla directory specificata, sostituendo per questo avvio le directory delle skill utente e di progetto rilevate automaticamente

Esempi non interattivi

kimi -p "Riassumi lo stato attuale del repository" kimi -m kimi-code/kimi-for-coding -p "Spiega l'ultima diff" kimi -p "Elenca i file modificati" --output-format stream-json

Sottocomandi CLI

SottocomandoScopo
kimi loginAvvia l'accesso con codice dispositivo OAuth di Kimi Code senza entrare nella TUI
kimi acpEsegui Kimi Code come server Agent Client Protocol per l'integrazione con gli IDE
kimi doctorConvalida config.toml e tui.toml
kimi export [sessionId]Comprimi una sessione in un archivio ZIP
kimi rcApri l'interfaccia web tramite Controllo remoto (alias kimi remote)
kimi session listElenca le sessioni per gli script
kimi upgradeVerifica la disponibilità della versione più recente e mostra le opzioni di aggiornamento
kimi webAvvia l'interfaccia web locale e il servizio API REST/WebSocket

Interfaccia web e accesso remoto:

kimi web # avvia l'interfaccia web locale + il servizio API REST/WebSocket kimi rc # apre l'interfaccia web tramite Controllo remoto (alias: kimi remote) kimi session list # elenca le sessioni per gli script

Comandi slash

I comandi slash sono controlli TUI integrati. Digita / nella casella di input per aprire il completamento dei comandi; vengono riconosciuti anche gli alias. Se un input con prefisso / non corrisponde a un comando integrato o a un comando Skill, viene inviato all'Agent come messaggio normale.

Account e configurazione

ComandoAliasScopo
/loginAccedi tramite OAuth di kimi.ai / kimi.com o chiave API
/logoutCancella le credenziali dell'account corrente
/providerApri il gestore dei provider per visualizzare, aggiungere e rimuovere i provider configurati
/modelCambia il modello LLM usato nella sessione corrente
/effortCambia il livello di ragionamento (disattivato/basso/alto/massimo)
/secondary-modelConfigura il pool di modelli dei subagenti
/settings/configApri il pannello delle impostazioni nella TUI
/experiments/experimentalApri il pannello delle funzionalità sperimentali
/permissionSeleziona una modalità di autorizzazione
/editorConfigura l'editor esterno avviato con Ctrl-G
/themeCambia il tema colori dell'interfaccia del terminale
/remote-control/rcAccedi da remoto a una sessione web locale

Gestione delle sessioni

ComandoAliasScopo
/new/clearAvvia una nuova sessione, eliminando il contesto corrente
/sessions/resumeSfoglia le sessioni precedenti e passa a una di esse
/tasks/taskSfoglia l'elenco delle attività in background
/forkCrea un fork della sessione corrente e resta in questa sessione
/title [...]/renameVisualizza o imposta il titolo della sessione corrente
/compact [...]Compatta il contesto della conversazione; il testo facoltativo indica cosa preservare
/undo [n]Annulla i prompt recenti dal contesto attivo
/reloadRicarica la sessione e applica le impostazioni più recenti di config.toml e tui.toml
/reload-tuiRicarica solo le preferenze dell'interfaccia utente in tui.toml
/initAnalizza il codice sorgente e genera AGENTS.md
/export-md [...]/exportEsporta la sessione corrente in formato Markdown
/export-debug-zipEsporta la sessione corrente come archivio ZIP di debug

Modalità e controllo dell'esecuzione

ComandoAliasScopo
/yolo/yesPassa alla modalità Chiedi quando necessario: le azioni di routine vengono eseguite automaticamente, mentre per quelle rischiose viene comunque chiesta conferma
/autoPassa alla modalità Non chiedere mai: tutto viene eseguito automaticamente
/plan [on\|off]Attiva o disattiva la modalità Piano; la semplice attivazione o disattivazione non crea un file di piano vuoto
/plan clearCancella il piano corrente
/towerOrchestrazione di worktree multi-agente (sperimentale; abilitala in /experiments)
/swarm on\|offAttiva o disattiva la modalità swarm senza inviare un prompt
/swarm <task>Attiva la modalità swarm, invia l'attività come prompt, quindi disattiva la modalità swarm dopo un normale turno
/goal [...]Avvia o gestisci un obiettivo autonomo

La modalità Piano è pensata per attività ampie, rischiose o poco chiare. Privilegia l'esplorazione e la pianificazione prima delle modifiche ai file.

Inizia subito a modificare un refactoring di 40 file senza rivedere il piano.
Esegui /plan on, lascia che Kimi Code esamini il progetto, rivedi il piano proposto e approvalo prima di apportare modifiche.

I sottocomandi della modalità obiettivo includono /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective> e /goal next manage.

Informazioni e stato

ComandoAliasScopo
/help/h, /?Mostra le scorciatoie da tastiera e i comandi disponibili
/btw [question]Apri una conversazione secondaria in un sotto-Agent separato
/usageMostra l'utilizzo dei token, il consumo di contesto e le informazioni sulla quota
/statusMostra lo stato di runtime: versione, modello, directory di lavoro, modalità delle autorizzazioni e altro
/mcpElenca i server MCP e lo stato della connessione
/pluginsApri il gestore dei plugin
/versionMostra la versione della CLI di Kimi Code
/feedbackInvia feedback sul prodotto
/exit/quit, /qEsci dalla CLI di Kimi Code

Skills ed estensioni

Un singolo prompt può attivare più Skills.

ComandoScopo
/mcp-configConfigura i server MCP e gestisci l'accesso OAuth MCP
/custom-theme [...]Crea o modifica un tema colori TUI personalizzato
/update-configEsamina o modifica config.toml e tui.toml
/import-from-cc-codexImporta istruzioni, Skills e impostazioni MCP di Claude Code e Codex
/skill:name [extra text]Richiama una Skill esterna installata
/name [extra text]Scorciatoia per una Skill esterna quando nessun comando di sistema ha lo stesso nome
/parent.child [extra text]Richiama una sotto-skill esterna esposta con un nome di comando separato da punti

Strumenti integrati

Gli strumenti integrati sono forniti direttamente da Kimi Code CLI. Gli strumenti di sola lettura, come Read, Grep e Glob, sono consentiti automaticamente per impostazione predefinita; gli strumenti che scrivono file, eseguono comandi, interrompono attività o creano pianificazioni richiedono normalmente l'approvazione, a meno che la modalità di autorizzazione non lo consenta.

File, shell e web

StrumentoApprovazione predefinitaScopo
ReadConsentito automaticamenteLegge file di testo
WriteRichiede approvazioneCrea o sovrascrive file
EditRichiede approvazioneSostituisce il contenuto esatto di un file
GrepConsentito automaticamenteCerca nei contenuti dei file con ripgrep
GlobConsentito automaticamenteTrova file in base a un pattern glob
ReadMediaFileConsentito automaticamenteLegge un file immagine o video
BashRichiede approvazioneEsegue comandi shell
WebSearchConsentito automaticamenteCerca sul web quando disponibile
FetchURLConsentito automaticamenteRecupera il contenuto di un URL specificato

Pianificazione, stato e collaborazione

StrumentoApprovazione predefinitaScopo
EnterPlanModeAutorizzazione automaticaAttiva la modalità piano
ExitPlanModeAutorizzazione automatica; l'utente conferma il pianoEsci dalla modalità piano e invia il piano
TodoListAutorizzazione automaticaGestire un elenco visibile di attività da svolgere
AgentAutorizzazione automaticaAvviare un sotto-Agent per un sottoattività mirata
AgentSwarmAutorizzazione automatica in modalità swarm; altrimenti potrebbe richiedere l'approvazioneAvviare sottoagenti basati su elementi o riprendere sottoagenti esistenti
AskUserQuestionAutorizzazione automaticaPorre domande strutturate a scelta multipla
SkillAutorizzazione automaticaRichiamare una Skill inline registrata

Attività in background e pianificate

StrumentoApprovazione predefinitaScopo
TaskListAutorizzazione automaticaElencare le attività in background
TaskOutputAutorizzazione automaticaVisualizzare l'output di un'attività in background
WaitForAutorizzazione automaticaAttendere le attività in background nel turno corrente
TaskStopRichiede approvazioneArrestare un'attività in background in esecuzione
CronCreateRichiede approvazionePianifica l'esecuzione di un prompt in futuro
CronListAutorizzazione automaticaElenca le attività pianificate
CronDeleteRichiede approvazioneAnnulla un'attività pianificata

Scorciatoie da tastiera

Digita /help nella TUI per visualizzare l'elenco delle scorciatoie disponibile nella versione in uso. Consulta il riferimento ufficiale Scorciatoie da tastiera per l'elenco completo a monte.

Input generale

ScorciatoiaAzione
EnterInvia l'input corrente
Shift-Enter / Ctrl-JInserisci una nuova riga
/ Sfoglia la cronologia degli input
EscChiudi un popup, annulla il completamento o interrompi lo streaming / la compattazione
Ctrl-CInterrompi l'output in streaming o cancella la casella di input
Ctrl-DEsci quando la casella di input è vuota

Cambio di modalità e modifica

ScorciatoiaAzione
Shift-TabAttiva/disattiva la modalità Piano
Ctrl-GModifica l'input corrente in un editor esterno
Ctrl-VIncolla un'immagine o un video dagli appunti su Unix / macOS
Alt-VIncolla un'immagine o un video dagli appunti su Windows
Ctrl--Annulla la modifica dell'input

Durante lo streaming e l'output degli strumenti

ScorciatoiaAzione
Ctrl-SGuida: inserisci l'input corrente nel turno in esecuzione
EscInterrompi l'output in streaming corrente
Ctrl-CInterrompi l'output in streaming corrente
Ctrl-OEspandi o comprimi l'output dello strumento
Ctrl-BSposta il comando shell in esecuzione in un'attività in background

Pannello di approvazione

ScorciatoiaAzione
/ Passa da un'opzione di approvazione all'altra
EnterConferma l'opzione di approvazione selezionata
19Seleziona un'opzione di approvazione tramite numero
Esc / Ctrl-C / Ctrl-DRifiuta la richiesta di approvazione corrente
Ctrl-EEspandi o comprimi il diff o l'anteprima del file in esame

Popup e guida

ScorciatoiaAzione
PageUp / PageDownScorri un popup di 10 righe alla volta
q / QChiudi un popup
EnterChiudi un popup della guida

Flussi di lavoro comuni

Avvia un nuovo repository

cd your-project kimi /init /status

Pianifica un refactoring prima di modificare

/plan on Esegui il refactoring del modulo di autenticazione per usare il nuovo formato del token e aggiorna tutti i chiamanti.

Avvia un'attività in background

Esegui la suite di test e riferisci quando viene completata.

Poi apri /tasks per monitorare il lavoro in background oppure lascia che Kimi Code ti avvisi quando l'attività è completata.

Riprendi il lavoro di ieri

kimi --continue

Se ti serve una sessione specifica, esegui kimi --session oppure usa /sessions nella TUI.

Esporta o sottoponi a debug una sessione

/export-md /export-debug-zip kimi export -y

Conclusione

Kimi Code CLI funziona al meglio se lo consideri un compagno di squadra nel terminale, con un contesto di progetto esplicito. Inizia con /init, usa /plan per modifiche ampie o incerte, monitora le attività di lunga durata con /tasks, tieni /compact a portata di mano per le sessioni lunghe e scegli una modalità di autorizzazione adatta al livello di fiducia del repository.

Domande frequenti

Kimi Code CLI può essere installato gratuitamente?
Sì. Kimi Code CLI è open source e può essere installato gratuitamente. L'accesso ai modelli o ai servizi sottostanti può dipendere dal piano Kimi Code. Per i dettagli, consulta i prezzi di Kimi Code.
Perché questa pagina si chiama riferimento rapido anziché semplicemente cheat sheet?
Riferimento rapido è l'etichetta più ufficiale, in stile documentazione. La pagina copre comunque lo stesso caso d'uso di un cheat sheet: comandi da copiare e incollare, comandi slash, scorciatoie, strumenti e flussi di lavoro in un unico posto.
Serve Node.js per installare Kimi Code CLI?
Gli script di installazione ufficiali non richiedono Node.js. I metodi di installazione con npm e pnpm richiedono un ambiente Node.js perché usano gestori di pacchetti JavaScript.
Qual è la differenza tra `/plan` e la modalità normale?
La modalità normale consente all'Agent di lavorare direttamente. La modalità piano è destinata a lavori ampi, rischiosi o poco chiari: Kimi Code prima esplora, poi scrive un piano e termina dopo l'approvazione del piano.
Come posso riprendere una sessione precedente?
Esegui kimi --continue nella stessa directory del progetto per continuare la sessione più recente. Usa kimi --session [id] nella shell o /sessions nella TUI per scegliere una sessione specifica.
`--yolo` è sicuro?
--yolo salta l'approvazione per le normali chiamate agli strumenti. Usalo solo in spazi di lavoro attendibili e sottoposti a controllo di versione. Per repository sconosciuti o dati di produzione, mantieni attive le approvazioni.
Come si integrano Skills e MCP in Kimi Code?
Le Skills raccolgono flussi di lavoro riutilizzabili e possono comparire come comandi slash. MCP collega Kimi Code a strumenti e fonti di dati esterne. Usa /skill:name, /mcp e /mcp-config per scoprirli e configurarli.