Kimi Code CLI è l'agent di coding AI da terminale open-source di Moonshot AI: legge e modifica codice, esegue comandi shell e pianifica il passo successivo in base al tuo feedback. Questo riferimento rapido raccoglie comandi Kimi Code, slash command, scorciatoie da tastiera, strumenti integrati e 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 upstream, consulta i riferimenti ufficiali di comando kimi, slash command, strumenti integrati e scorciatoie da tastiera.
Installa Kimi Code CLI
Per la maggior parte degli sviluppatori, lo script di installazione ufficiale è la via 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 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 il Git Bash incluso come ambiente shell. Dopo l'installazione, apri un nuovo terminale e verifica il binario:
Inizia da qui
Usa questo ciclo minimo quando entri in un progetto per la prima volta:
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.
Comandi più usati
Se devi memorizzarne solo alcuni, scegli questi: coprono la maggior parte delle sessioni quotidiane.
| Comando | A cosa serve |
|---|---|
kimi | Avvia una sessione interattiva nella directory corrente |
kimi -C | Continua 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 Plan Mode per modifiche ampie o rischiose |
/model | Cambia il modello per questa sessione |
/compact | Libera contesto quando la conversazione si allunga |
/sessions | Sfoglia e riprendi sessioni passate |
/help | Elenca tutti i comandi e le scorciatoie |
Shift-Tab | Attiva/disattiva Plan Mode |
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 "..." | Esegui 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 un alias di modello specifico |
kimi --plan | Avvia una nuova sessione in Plan Mode |
kimi --yolo, kimi -y | Approva automaticamente le normali chiamate agli strumenti; usa solo in directory attendibili |
kimi --auto | Avvia in modalità autorizzazioni 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 il login OAuth con codice dispositivo di Kimi Code senza entrare nella TUI |
kimi acp | Esegue Kimi Code come server Agent Client Protocol per l'integrazione con gli IDE |
kimi server | Esegue, installa e gestisce 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] | Comprimi una sessione in un archivio ZIP |
kimi migrate | Migra i dati locali da un'installazione kimi-cli precedente |
kimi upgrade | Controlla la versione più recente e mostra le opzioni di aggiornamento |
kimi vis [sessionId] | Avvia il visualizzatore della sessione nel browser |
kimi provider | Gestisce i provider dal terminale |
Comandi server utili:
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 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 | — | Seleziona un account o una piattaforma ed effettua l'accesso |
/logout | — | Cancella le credenziali dell'account corrente |
/provider | — | Apre il gestore dei provider per visualizzare, aggiungere e rimuovere i provider configurati |
/model | — | Cambia il modello LLM usato nella sessione corrente |
/settings | /config | Apre il pannello delle impostazioni nella TUI |
/experiments | /experimental | Apre 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 delle sessioni
| Comando | Alias | Scopo |
|---|---|---|
/new | /clear | Avvia una nuova sessione, scartando il contesto corrente |
/sessions | /resume | Sfoglia le sessioni precedenti e passa a quella scelta |
/tasks | /task | Sfoglia l'elenco delle attività in background |
/fork | — | Crea una nuova sessione a partire dalla conversazione corrente |
/title [...] | /rename | Mostra o imposta il titolo della sessione corrente |
/compact [...] | — | Compatta il contesto della conversazione; il testo opzionale indica cosa conservare |
/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 il 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 chiamate agli strumenti ordinarie |
/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 semplice 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 normale turno |
/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 delle modifiche ai file.
/plan on, lascia che Kimi Code analizzi il progetto, rivedi il piano proposto e approva prima che vengano apportate 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] | — | Apre una conversazione laterale in un sub-Agent derivato |
/usage | — | Mostra l'uso dei token, il consumo del contesto e le 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 | — | Apre il gestore dei plugin |
/version | — | Mostra la versione di Kimi Code CLI |
/feedback | — | Invia feedback sul prodotto |
/exit | /quit, /q | Esce da Kimi Code CLI |
Skills ed estensioni
| Comando | Scopo |
|---|---|
/mcp-config | Configura i server MCP e gestisce l'accesso MCP 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 direttamente da Kimi Code CLI. Gli strumenti in 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 approvazione, salvo che la modalità di autorizzazione scelta li 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 contenuto esatto dei file |
Grep | Consentito automaticamente | Cerca nei contenuti dei file con ripgrep |
Glob | Consentito automaticamente | Trova file tramite 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 | Consentito automaticamente | Entra in Plan Mode |
ExitPlanMode | Consentito automaticamente; l'utente conferma il piano | Esce da Plan Mode e invia il piano |
TodoList | Consentito automaticamente | Gestisce una lista di cose da fare visibile |
Agent | Consentito automaticamente | Avvia un sub-Agent per una sottoattività mirata |
AgentSwarm | Consentito automaticamente in modalità swarm; altrimenti può richiedere approvazione | Avvia subagent basati su elementi o riprende subagent esistenti |
AskUserQuestion | Consentito automaticamente | Pone domande strutturate a scelta multipla |
Skill | Consentito automaticamente | Richiama una Skill inline registrata |
Attività in background e pianificate
| Strumento | Approvazione predefinita | Scopo |
|---|---|---|
TaskList | Consentito automaticamente | Elenca le attività in background |
TaskOutput | Consentito automaticamente | Visualizza l'output di un'attività in background |
TaskStop | Richiede approvazione | Arresta un'attività in background in esecuzione |
CronCreate | Richiede approvazione | Pianifica l'esecuzione futura di un prompt |
CronList | Consentito automaticamente | Elenca le attività pianificate |
CronDelete | Richiede approvazione | Annulla un'attività pianificata |
Scorciatoie da tastiera
Digita /help nella TUI per vedere l'elenco delle scorciatoie disponibili nella tua versione. Per l'elenco upstream completo, consulta il riferimento ufficiale Scorciatoie da tastiera.
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 streaming / compattazione |
Ctrl-C | Interrompi l'output in streaming o svuota la casella di input |
Ctrl-D | Esci quando la casella di input è vuota |
Cambio modalità e modifica
| Scorciatoia | Azione |
|---|---|
Shift-Tab | Attiva/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 | Guida: inserisce 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 |
Pannello di approvazione e popup
| Scorciatoia | Azione |
|---|---|
↑ / ↓ | Spostati tra le opzioni di approvazione o scorri 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 | Espandi o comprimi il diff completo o l'anteprima del file nel pannello di approvazione |
PageUp / PageDown | Scorri un popup di 10 righe alla volta |
q / Q | Chiudi un popup |
Flussi di lavoro comuni
Avvia un nuovo repo
Pianifica un refactor prima di modificare
Esegui un'attività in background
Poi apri /tasks per monitorare il lavoro in background, oppure lascia che Kimi Code ti avvisi al completamento dell'attività.
Riprendi il lavoro di ieri
Se ti serve una sessione specifica, esegui kimi --session oppure usa /sessions nella TUI.
Esporta o esegui il debug di una sessione
Conclusione
Kimi Code CLI dà il meglio quando lo tratti come un compagno di terminale con un contesto di progetto esplicito. Inizia con /init, usa /plan per modifiche ampie o incerte, monitora i lavori lunghi con /tasks, tieni /compact a portata di mano per le sessioni estese 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 dentro la TUI per scegliere una sessione specifica.--yolo salta l'approvazione per le chiamate standard agli strumenti. Usalo solo in workspace affidabili e sotto controllo di versione. Per repository sconosciuti o dati di produzione, mantieni attive le approvazioni./skill:name, /mcp e /mcp-config per scoprirli e configurarli.