CLI · Primi passi
Guida aggiornata del team Kimi Code
Kimi Code CLI è un Agent interattivo nel terminale: legge e modifica codice, esegue comandi shell, cerca file, recupera pagine web e adatta i passi successivi ai risultati. Serve per nuove funzionalità, bug, refactoring, comprensione di progetti e automazione di file, build e test. È scritto in TypeScript, distribuito tramite npm ed eseguito su Node.js.
Installazione
Usa lo script consigliato, senza dover preinstallare Node.js, oppure npm. Per l’interfaccia interattiva scegli un terminale con colori reali e legature, come Kitty o Ghostty.
Script di installazione
Su Windows installa prima Git for Windows: la CLI ne usa Git Bash. Se si trova in un percorso personalizzato, imposta KIMI_SHELL_PATH sul percorso assoluto di bash.exe. Lo script scarica l’ultima versione, verifica il checksum e rende kimi disponibile nel PATH.
Installazione npm
Richiede Node.js 22.19.0 o successivo. Controlla la versione e scegli npm o pnpm:
Primo avvio
Entra nella cartella del progetto e avvia kimi. -p esegue una sola istruzione senza interfaccia interattiva; -c riprende l’ultima sessione.
Accesso
Al primo avvio usa /login. Kimi Code (OAuth) usa un codice dispositivo: apri il link su un dispositivo, accedi e inserisci il codice. Kimi Platform API key accetta una chiave da platform.kimi.com o platform.kimi.ai. /logout cancella le credenziali correnti.
Per Anthropic, OpenAI, Google o altri provider, configura la chiave API in ~/.kimi-code/config.toml. Consulta Provider e modelli, File di configurazione, Variabili d’ambiente e Sovrascritture.
Prima conversazione
La CLI legge e cerca i contenuti prima di rispondere. Le letture sono automatiche per impostazione predefinita; modifiche e comandi shell richiedono conferma. Per un compito concreto:
La CLI pianifica, modifica il codice, esegue test e spiega ogni passo. /help mostra comandi e scorciatoie: naviga con ↑/↓, chiudi con Esc. Per uscire usa /exit, due volte Ctrl-C quando inattiva oppure Ctrl-D con input vuoto.
Comandi e scorciatoie principali
| Comando | Azione |
|---|---|
/new | Nuova sessione e cancellazione del contesto |
/sessions | Sfoglia e riprendi sessioni |
/model | Cambia modello |
/compact | Compatta il contesto |
/fork | Crea una copia indipendente con la cronologia completa; rimani nella sessione corrente |
Esc | Interrompi output o chiudi finestra |
Ctrl-C | Interrompi; premi due volte quando inattiva per uscire |
Shift-Tab | Attiva o disattiva Plan |
Ctrl-S | Inserisci subito il messaggio nel turno in corso |
Ctrl-O | Comprimi o espandi output degli strumenti e riepiloghi di compattazione |
Questo articolo ti è stato utile?