8 min di lettura2026-06-18
Questo riferimento rapido raccoglie i comandi Kimi Code, gli slash command, 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 dentro Kimi Code o kimi --help nella shell per verificare cosa espone la tua versione attuale.
Per i dettagli a monte, consulta i riferimenti ufficiali di comando kimi, slash command, strumenti integrati e scorciatoie da tastiera.
Inizia da qui
Usa questo ciclo minimo quando entri in un progetto per la prima volta:
cd your-project
kimi
# Dentro la sessione
/login # accedi se è il primo avvio
/init # genera o aggiorna AGENTS.md
/plan on # pianifica prima di attività ampie, rischiose o poco chiare
/help # scopri comandi e scorciatoie
/compact # libera contesto quando la conversazione si allunga
Usa --yolo, /yolo e /auto solo in workspace di cui ti fidi. Riducono l’attrito delle approvazioni, ma permettono anche a Kimi Code di agire con maggiore autonomia.
Installa Kimi Code CLI
Per la maggior parte degli sviluppatori, lo script di installazione ufficiale è la via più rapida: installa un singolo binario Kimi Code e non richiede Node.js. Sono disponibili anche Homebrew, npm e pnpm se si adattano meglio alla tua toolchain locale.
| Piattaforma / gestore | Comando |
|---|---|
| Script 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 |
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
Avvio e automazione
Opzioni CLI principali
| Comando / flag | A cosa serve |
|---|---|
kimi | Avvia una sessione interattiva nella directory corrente |
kimi --continue, kimi -C | Continua la sessione più recente in questa directory |
kimi --session [id], kimi -S [id] | Riprendi una sessione tramite ID oppure apri il selettore sessioni senza ID |
kimi -p "...", kimi --prompt "..." | Esegue un singolo prompt non interattivo senza aprire la TUI |
--output-format stream-json | Emette eventi JSONL per gli script; funziona solo con --prompt |
kimi --model <model>, kimi -m <model> | Avvia con uno specifico alias di modello |
kimi --plan | Avvia una nuova sessione in Plan Mode |
kimi --yolo, kimi -y | Approva automaticamente le normali chiamate agli strumenti; usa solo in directory affidabili |
kimi --auto | Avvia in modalità permessi automatica; le approvazioni sono gestite automaticamente e l’Agent non farà domande |
--skills-dir <dir> | Carica le Skills dalla directory specificata, sostituendo per questo avvio le directory Skills utente e progetto rilevate automaticamente |
Esempi non interattivi
kimi -p "Riassumi lo stato attuale del repository"
kimi -m kimi-code/kimi-for-coding -p "Spiega l’ultimo diff"
kimi -p "Elenca i file modificati" --output-format stream-json
Sottocomandi CLI
| Sottocomando | Scopo |
|---|---|
kimi login | Avvia l’accesso Kimi Code con codice dispositivo OAuth senza entrare nella TUI |
kimi acp | Esegui Kimi Code come server Agent Client Protocol per l’integrazione con IDE |
kimi server | Esegui, installa e gestisci il servizio locale REST/WebSocket/web |
kimi web | Apre l’interfaccia browser di Kimi; equivalente a kimi server run --open |
kimi doctor | Convalida config.toml e tui.toml |
kimi export [sessionId] | Impacchetta una sessione in un archivio ZIP |
kimi migrate | Migra i dati locali da una vecchia installazione kimi-cli |
kimi upgrade | Controlla la versione più recente e mostra le opzioni di aggiornamento |
kimi vis [sessionId] | Avvia il visualizzatore di sessione nel browser |
kimi provider | Gestisci i provider dal terminale |
Comandi server utili:
kimi server run # avvia o riutilizza un server locale in background
kimi server run --foreground # esegui collegato al terminale
kimi server install # registra un servizio gestito dall’OS
kimi server status # mostra stato installato / in esecuzione / pid / porta
kimi web # apri l’interfaccia nel browser
Slash command
Gli slash command sono controlli integrati della TUI. Digita / nella casella di input per aprire il completamento dei comandi; vengono riconosciuti anche gli alias. Se un input che inizia con / non corrisponde a un comando integrato o a un comando Skill, viene inviato all’Agent come normale messaggio.
Account e configurazione
| Comando | Alias | Scopo |
|---|---|---|
/login | — | Seleziona un account o una piattaforma ed effettua l’accesso |
/logout | — | Cancella le credenziali dell’account corrente |
/provider | — | Apri il gestore dei provider per visualizzare, aggiungere e rimuovere i provider configurati |
/model | — | Cambia il modello LLM usato nella sessione corrente |
/settings | /config | Apri il pannello delle impostazioni nella TUI |
/experiments | /experimental | Apri il pannello delle funzionalità sperimentali |
/permission | — | Seleziona una modalità di autorizzazione |
/editor | — | Configura l’editor esterno avviato da Ctrl-G |
/theme | — | Cambia il tema colori dell’interfaccia terminale |
Gestione sessioni
| Comando | Alias | Scopo |
|---|---|---|
/new | /clear | Avvia una nuova sessione, scartando il contesto corrente |
/sessions | /resume | Sfoglia le sessioni precedenti e passa a una di esse |
/tasks | /task | Sfoglia l’elenco delle attività in background |
/fork | — | Crea una nuova sessione derivata dalla conversazione corrente |
/title [...] | /rename | Mostra 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 |
/reload | — | Ricarica la sessione e applica le impostazioni più recenti di config.toml e tui.toml |
/reload-tui | — | Ricarica solo le preferenze UI di tui.toml |
/init | — | Analizza la codebase e genera AGENTS.md |
/export-md [...] | /export | Esporta la sessione corrente come Markdown |
/export-debug-zip | — | Esporta la sessione corrente come archivio ZIP di debug |
Modalità e controllo dell’esecuzione
| Comando | Alias | Scopo |
|---|---|---|
/yolo [on|off] | /yes | Attiva o disattiva la modalità YOLO; quando è attiva, salta l’approvazione per le normali chiamate agli strumenti |
/auto [on|off] | — | Attiva o disattiva la modalità di autorizzazione automatica; le approvazioni vengono gestite automaticamente e le domande vengono saltate |
/plan [on|off] | — | Attiva o disattiva Plan Mode; la sola attivazione non crea un file di piano vuoto |
/plan clear | — | Cancella il piano corrente |
/swarm on|off | — | Attiva 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 turno normale |
/goal [...] | — | Avvia o gestisci un obiettivo autonomo |
Plan Mode è pensata per lavori ampi, rischiosi o poco chiari. Dà priorità all’esplorazione e alla pianificazione prima di modificare i file.
Iniziare subito a modificare un refactor da 40 file senza rivedere il piano.
Esegui
/plan on, lascia che Kimi Code ispezioni il progetto, rivedi il piano proposto e approva prima che vengano applicate modifiche.I sottocomandi della modalità Goal includono /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective> e /goal next manage.
Informazioni e stato
| Comando | Alias | Scopo |
|---|---|---|
/help | /h, /? | Mostra le scorciatoie da tastiera e i comandi disponibili |
/btw [question] | — | Apri una conversazione laterale in un sub-Agent derivato |
/usage | — | Mostra uso dei token, consumo del contesto e informazioni sulla quota |
/status | — | Mostra lo stato di runtime: versione, modello, directory di lavoro, modalità di autorizzazione e altro |
/mcp | — | Elenca i server MCP e lo stato della connessione |
/plugins | — | Apri il gestore dei plugin |
/version | — | Mostra la versione di Kimi Code CLI |
/feedback | — | Invia feedback sul prodotto |
/exit | /quit, /q | Esci da Kimi Code CLI |
Skills ed estensioni
| Comando | Scopo |
|---|---|
/mcp-config | Configura i server MCP e gestisci l’accesso MCP tramite OAuth |
/custom-theme [...] | Crea o modifica un tema colori TUI personalizzato |
/update-config | Ispeziona o modifica config.toml e tui.toml |
/import-from-cc-codex | Importa istruzioni, Skills e impostazioni MCP da Claude Code e Codex |
/sub-skill | Scopri e riorganizza l’inventario locale delle Skill |
/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 sub-skill esterna esposta con un nome comando puntato |
Strumenti integrati
Gli strumenti integrati sono forniti da Kimi Code CLI stesso. Gli strumenti in sola lettura come Read, Grep e Glob sono consentiti automaticamente per impostazione predefinita; gli strumenti che scrivono file, eseguono comandi, arrestano attività o creano pianificazioni richiedono normalmente approvazione, salvo che la modalità di autorizzazione in uso li consenta.
File, shell e web
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
Read | Consenti automaticamente | Legge file di testo |
Write | Richiede approvazione | Crea o sovrascrive file |
Edit | Richiede approvazione | Sostituisce il contenuto esatto del file |
Grep | Consenti automaticamente | Cerca nei contenuti dei file con ripgrep |
Glob | Consenti automaticamente | Trova file tramite pattern glob |
ReadMediaFile | Consenti automaticamente | Legge un file immagine o video |
Bash | Richiede approvazione | Esegue comandi shell |
WebSearch | Consenti automaticamente | Cerca sul web quando disponibile |
FetchURL | Consenti automaticamente | Recupera il contenuto di un URL specificato |
Pianificazione, stato e collaborazione
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
EnterPlanMode | Consenti automaticamente | Entra in Plan Mode |
ExitPlanMode | Consenti automaticamente; l’utente conferma il piano | Esce da Plan Mode e invia il piano |
TodoList | Consenti automaticamente | Gestisce una lista di attività visibile |
Agent | Consenti automaticamente | Avvia un sub-Agent per una sottoattività mirata |
AgentSwarm | Consenti automaticamente in modalità swarm; altrimenti può richiedere approvazione | Avvia subagent basati su elementi o riprende subagent esistenti |
AskUserQuestion | Consenti automaticamente | Pone domande strutturate a scelta multipla |
Skill | Consenti automaticamente | Richiama una Skill inline registrata |
Attività in background e pianificate
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
TaskList | Consenti automaticamente | Elenca le attività in background |
TaskOutput | Consenti automaticamente | Visualizza l’output di un’attività in background |
TaskStop | Richiede approvazione | Interrompe un’attività in background in esecuzione |
CronCreate | Richiede approvazione | Pianifica l’esecuzione futura di un prompt |
CronList | Consenti automaticamente | Elenca le attività pianificate |
CronDelete | Richiede approvazione | Annulla un’attività pianificata |
Scorciatoie da tastiera
Digita /help nella TUI per l’elenco delle scorciatoie disponibili nella versione in uso. Per l’elenco upstream completo, consulta il riferimento ufficiale Keyboard Shortcuts.
Input generale
| Scorciatoia | Azione |
|---|---|
Enter | Invia l’input corrente |
Shift-Enter / Ctrl-J | Inserisce una nuova riga |
↑ / ↓ | Sfoglia la cronologia degli input |
Esc | Chiude un popup, annulla il completamento o interrompe streaming/compattazione |
Ctrl-C | Interrompe l’output in streaming o svuota la casella di input |
Ctrl-D | Esce quando la casella di input è vuota |
Cambio modalità e modifica
| Scorciatoia | Azione |
|---|---|
Shift-Tab | Attiva o disattiva Plan Mode |
Ctrl-G | Modifica l’input corrente in un editor esterno |
Ctrl-V | Incolla un’immagine o un video dagli appunti su Unix / macOS |
Alt-V | Incolla un’immagine o un video dagli appunti su Windows |
Ctrl-- | Annulla la modifica dell’input |
Durante streaming e output degli strumenti
| Scorciatoia | Azione |
|---|---|
Ctrl-S | Steer: inserisce l’input corrente nel turno in esecuzione |
Esc | Interrompe l’output in streaming corrente |
Ctrl-C | Interrompe l’output in streaming corrente |
Ctrl-O | Espande o comprime l’output degli strumenti |
Pannello di approvazione e popup
| Scorciatoia | Azione |
|---|---|
↑ / ↓ | Sposta tra le opzioni di approvazione o scorre un popup |
Enter | Conferma l’opzione di approvazione selezionata; chiude anche i popup di aiuto |
1 – 9 | Seleziona un’opzione di approvazione tramite numero |
Esc / Ctrl-C / Ctrl-D | Rifiuta la richiesta di approvazione corrente |
Ctrl-E | Espande o comprime il diff completo o l’anteprima del file nel pannello di approvazione |
PageUp / PageDown | Scorre un popup di 10 righe alla volta |
q / Q | Chiude un popup |
Flussi di lavoro comuni
Avviare un nuovo repository
cd your-project
kimi
/init
/status
Pianificare un refactoring prima di modificare
/plan on
Refactor the auth module to use the new token format and update all callers.
Eseguire un’attività in background
Esegui la suite di test e avvisami quando finisce.
Apri quindi /tasks per monitorare il lavoro in background, oppure lascia che Kimi Code ti avvisi al completamento dell’attività.
Riprendere il lavoro di ieri
kimi --continue
Se ti serve una sessione specifica, esegui kimi --session oppure usa /sessions nella TUI.
Esportare o eseguire il debug di una sessione
/export-md
/export-debug-zip
kimi export -y
Conclusione
Kimi Code CLI dà il meglio quando lo tratti come un compagno di squadra nel terminale, con un contesto di progetto esplicito. Inizia con /init, usa /plan per modifiche ampie o incerte, tieni d’occhio i lavori lunghi con /tasks, tieni /compact a portata di mano per le sessioni prolungate e scegli una modalità di autorizzazione adatta al livello di fiducia del repository.
Domande frequenti
L’installazione di Kimi Code CLI è gratuita?
Sì. Kimi Code CLI è open-source e si installa gratuitamente. L’accesso ai modelli o servizi sottostanti può dipendere dal tuo piano Kimi Code. Vedi prezzi di Kimi Code per i dettagli.
Perché questa pagina si chiama riferimento rapido e non solo cheat sheet?
“Riferimento rapido” è un’etichetta più ufficiale, in stile documentazione. La pagina copre comunque lo stesso uso da cheat sheet: comandi da copiare e incollare, slash command, scorciatoie, strumenti e flussi di lavoro raccolti in un unico punto.
Mi 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. Plan Mode serve per attività ampie, rischiose o poco chiare: Kimi Code esplora prima, scrive un piano ed esce dopo l’approvazione del piano.
Come riprendo una sessione precedente?
Esegui
kimi --continue nella stessa directory di progetto per proseguire la sessione più recente. Usa kimi --session [id] nella shell o /sessions dentro la TUI per scegliere una sessione specifica.`--yolo` è sicuro?
--yolo salta l’approvazione per le normali chiamate agli strumenti. Usalo solo in workspace affidabili e sotto controllo versione. Per repository sconosciuti o dati di produzione, lascia attive le approvazioni.Come si inseriscono Skills e MCP in Kimi Code?
Le Skills incapsulano flussi di lavoro riutilizzabili e possono apparire come slash command. MCP collega Kimi Code a strumenti e origini dati esterni. Usa
/skill:name, /mcp e /mcp-config per scoprirli e configurarli.