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 / gestore | Comando |
|---|---|
| Script per 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:
Inizia da qui
Quando accedi a un progetto per la prima volta, usa questo ciclo minimo:
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.
| Comando | Funzione |
|---|---|
kimi | Avvia una sessione interattiva nella directory corrente |
kimi -C | Riprendi qui la sessione più recente |
kimi -p "..." | Esegui un singolo prompt senza aprire la TUI |
/login | Accedi al primo avvio |
/init | Genera o aggiorna AGENTS.md |
/plan on | Entra in Modalità pianificazione per modifiche ampie o rischiose |
/model | Cambia il modello per questa sessione |
/compact | Libera contesto quando la conversazione si allunga |
/sessions | Sfoglia e riprendi le sessioni precedenti |
/help | Elenca tutti i comandi e le scorciatoie |
Shift-Tab | Attiva o disattiva la Modalità pianificazione |
Avvio e automazione
Opzioni CLI principali
| Comando / opzione | Funzione |
|---|---|
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 di sessione senza specificare un ID |
kimi -p "...", kimi --prompt "..." | Esegui un singolo prompt non interattivo senza aprire la TUI |
--output-format stream-json | Genera eventi JSONL per lo scripting; funziona solo con --prompt |
kimi --model <model>, kimi -m <model> | Avvia con un alias di modello specifico |
kimi --plan | Avvia una nuova sessione in modalità pianificazione |
kimi --yolo, kimi -y | Approva automaticamente le normali chiamate agli strumenti; usalo solo in directory affidabili |
kimi --auto | Avvia 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
Sottocomandi CLI
| Sottocomando | Scopo |
|---|---|
kimi login | Avvia l'accesso con codice dispositivo OAuth di Kimi Code senza entrare nella TUI |
kimi acp | Esegui Kimi Code come server Agent Client Protocol per l'integrazione con gli IDE |
kimi doctor | Convalida config.toml e tui.toml |
kimi export [sessionId] | Comprimi una sessione in un archivio ZIP |
kimi rc | Apri l'interfaccia web tramite Controllo remoto (alias kimi remote) |
kimi session list | Elenca le sessioni per gli script |
kimi upgrade | Verifica la disponibilità della versione più recente e mostra le opzioni di aggiornamento |
kimi web | Avvia l'interfaccia web locale e il servizio API REST/WebSocket |
Interfaccia web e accesso remoto:
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
| Comando | Alias | Scopo |
|---|---|---|
/login | — | Accedi tramite OAuth di kimi.ai / kimi.com o chiave API |
/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 |
/effort | — | Cambia il livello di ragionamento (disattivato/basso/alto/massimo) |
/secondary-model | — | Configura il pool di modelli dei subagenti |
/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 con Ctrl-G |
/theme | — | Cambia il tema colori dell'interfaccia del terminale |
/remote-control | /rc | Accedi da remoto a una sessione web locale |
Gestione delle sessioni
| Comando | Alias | Scopo |
|---|---|---|
/new | /clear | Avvia una nuova sessione, eliminando 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 un fork della sessione corrente e resta in questa sessione |
/title [...] | /rename | Visualizza 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 dell'interfaccia utente in tui.toml |
/init | — | Analizza il codice sorgente e genera AGENTS.md |
/export-md [...] | /export | Esporta la sessione corrente in formato Markdown |
/export-debug-zip | — | Esporta la sessione corrente come archivio ZIP di debug |
Modalità e controllo dell'esecuzione
| Comando | Alias | Scopo |
|---|---|---|
/yolo | /yes | Passa alla modalità Chiedi quando necessario: le azioni di routine vengono eseguite automaticamente, mentre per quelle rischiose viene comunque chiesta conferma |
/auto | — | Passa 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 clear | — | Cancella il piano corrente |
/tower | — | Orchestrazione di worktree multi-agente (sperimentale; abilitala in /experiments) |
/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 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.
/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
| Comando | Alias | Scopo |
|---|---|---|
/help | /h, /? | Mostra le scorciatoie da tastiera e i comandi disponibili |
/btw [question] | — | Apri una conversazione secondaria in un sotto-Agent separato |
/usage | — | Mostra l'utilizzo dei token, il consumo di contesto e le informazioni sulla quota |
/status | — | Mostra lo stato di runtime: versione, modello, directory di lavoro, modalità delle autorizzazioni e altro |
/mcp | — | Elenca i server MCP e lo stato della connessione |
/plugins | — | Apri il gestore dei plugin |
/version | — | Mostra la versione della CLI di Kimi Code |
/feedback | — | Invia feedback sul prodotto |
/exit | /quit, /q | Esci dalla CLI di Kimi Code |
Skills ed estensioni
Un singolo prompt può attivare più Skills.
| Comando | Scopo |
|---|---|
/mcp-config | Configura i server MCP e gestisci l'accesso OAuth MCP |
/custom-theme [...] | Crea o modifica un tema colori TUI personalizzato |
/update-config | Esamina o modifica config.toml e tui.toml |
/import-from-cc-codex | Importa 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
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
Read | Consentito automaticamente | Legge file di testo |
Write | Richiede approvazione | Crea o sovrascrive file |
Edit | Richiede approvazione | Sostituisce il contenuto esatto di un file |
Grep | Consentito automaticamente | Cerca nei contenuti dei file con ripgrep |
Glob | Consentito automaticamente | Trova file in base a un pattern glob |
ReadMediaFile | Consentito automaticamente | Legge un file immagine o video |
Bash | Richiede approvazione | Esegue comandi shell |
WebSearch | Consentito automaticamente | Cerca sul web quando disponibile |
FetchURL | Consentito automaticamente | Recupera il contenuto di un URL specificato |
Pianificazione, stato e collaborazione
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
EnterPlanMode | Autorizzazione automatica | Attiva la modalità piano |
ExitPlanMode | Autorizzazione automatica; l'utente conferma il piano | Esci dalla modalità piano e invia il piano |
TodoList | Autorizzazione automatica | Gestire un elenco visibile di attività da svolgere |
Agent | Autorizzazione automatica | Avviare un sotto-Agent per un sottoattività mirata |
AgentSwarm | Autorizzazione automatica in modalità swarm; altrimenti potrebbe richiedere l'approvazione | Avviare sottoagenti basati su elementi o riprendere sottoagenti esistenti |
AskUserQuestion | Autorizzazione automatica | Porre domande strutturate a scelta multipla |
Skill | Autorizzazione automatica | Richiamare una Skill inline registrata |
Attività in background e pianificate
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
TaskList | Autorizzazione automatica | Elencare le attività in background |
TaskOutput | Autorizzazione automatica | Visualizzare l'output di un'attività in background |
WaitFor | Autorizzazione automatica | Attendere le attività in background nel turno corrente |
TaskStop | Richiede approvazione | Arrestare un'attività in background in esecuzione |
CronCreate | Richiede approvazione | Pianifica l'esecuzione di un prompt in futuro |
CronList | Autorizzazione automatica | Elenca le attività pianificate |
CronDelete | Richiede approvazione | Annulla 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
| Scorciatoia | Azione |
|---|---|
Enter | Invia l'input corrente |
Shift-Enter / Ctrl-J | Inserisci una nuova riga |
↑ / ↓ | Sfoglia la cronologia degli input |
Esc | Chiudi un popup, annulla il completamento o interrompi lo streaming / la compattazione |
Ctrl-C | Interrompi l'output in streaming o cancella la casella di input |
Ctrl-D | Esci quando la casella di input è vuota |
Cambio di modalità e modifica
| Scorciatoia | Azione |
|---|---|
Shift-Tab | Attiva/disattiva la modalità Piano |
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 lo streaming e l'output degli strumenti
| Scorciatoia | Azione |
|---|---|
Ctrl-S | Guida: inserisci l'input corrente nel turno in esecuzione |
Esc | Interrompi l'output in streaming corrente |
Ctrl-C | Interrompi l'output in streaming corrente |
Ctrl-O | Espandi o comprimi l'output dello strumento |
Ctrl-B | Sposta il comando shell in esecuzione in un'attività in background |
Pannello di approvazione
| Scorciatoia | Azione |
|---|---|
↑ / ↓ | Passa da un'opzione di approvazione all'altra |
Enter | Conferma l'opzione di approvazione selezionata |
1 – 9 | Seleziona un'opzione di approvazione tramite numero |
Esc / Ctrl-C / Ctrl-D | Rifiuta la richiesta di approvazione corrente |
Ctrl-E | Espandi o comprimi il diff o l'anteprima del file in esame |
Popup e guida
| Scorciatoia | Azione |
|---|---|
PageUp / PageDown | Scorri un popup di 10 righe alla volta |
q / Q | Chiudi un popup |
Enter | Chiudi un popup della guida |
Flussi di lavoro comuni
Avvia un nuovo repository
Pianifica un refactoring prima di modificare
Avvia un'attività in background
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
Se ti serve una sessione specifica, esegui kimi --session oppure usa /sessions nella TUI.
Esporta o sottoponi a debug una sessione
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 --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 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./skill:name, /mcp e /mcp-config per scoprirli e configurarli.