Kimi Code: cos'è, il sito ufficiale e come installarlo su Windows e macOS

Il 17 settembre 2026, Moonshot AI ha lanciato la versione desktop di Kimi Code, il suo agente AI per la programmazione. Prima funzionava nel terminale e come plugin per editor; ora è disponibile anche come app autonoma per macOS e Windows, con browser e terminale integrati. I comandi e i piani sono stati verificati sulle pagine ufficiali il 19 settembre 2026.

Documentazione Ailoot: API, chiavi e configurazione.

Che cos'è Kimi Code#

Quanto allo scopo, è un diretto equivalente di Claude Code: apri una cartella di progetto, descrivi un'attività in linguaggio naturale e l'agente esamina la codebase, suggerisce modifiche e le esegue. Scegli tu quanto spesso debba chiederti il permesso. Ho parlato delle differenze nella pratica in Kimi K3 vs Claude Code; questo articolo tratta solo installazione e configurazione.

Kimi Code usa i modelli Moonshot: il modello di punta K3, con una finestra di contesto fino a 1 milione di token, e il modello specializzato K2.7 Code, che dispone di una modalità ad alta velocità fino a 260 token al secondo. Il codice sorgente della CLI è open source con licenza MIT e il repository GitHub ha più di 7.000 stelle.

Sito ufficiale, documentazione e codice sorgente:

• sito del prodotto: kimi.com/code
• documentazione della CLI: kimi.com/code/docs e moonshotai.github.io/kimi-code
• repository: github.com/MoonshotAI/kimi-code

L'11 settembre 2026, Kimi Code ha aggiornato il suo modello per la programmazione; il 17 sono stati lanciati contemporaneamente la versione desktop e la nuova versione principale della CLI, la 2.0; il 18 è stato rilasciato l'aggiornamento 2.0.1. Se hai installato la vecchia versione Python (kimi-cli), non è più supportata: i suoi dati possono essere migrati alla nuova CLI con un solo comando, kimi migrate.

Quanto costa Kimi Code#

L'app e la CLI si scaricano gratuitamente, ma il piano gratuito Adagio non include Kimi Code. Al momento della verifica, la pagina degli abbonamenti kimi.com/membership riportava questi prezzi:

Kimi Code è disponibile in tutti e quattro i piani a pagamento. A settembre 2026, Kimi ha rivisto l'offerta di abbonamento e ha smesso di vendere Kimi Code separatamente; le recensioni più vecchie che riportano nomi di piani diversi non sono aggiornate: controlla la pagina degli abbonamenti prima di acquistare.

L'abbonamento ha due limiti. Tutte le sue funzionalità (chat, Deep Research, siti web, Kimi Code) attingono da un unico pool condiviso di crediti, calcolati in base al numero effettivo di token utilizzati. Kimi Code ha anche un limite specifico: 5 ore a settimana. Non incide sulle altre funzionalità, ma puoi esaurirlo se lavori intensamente.

In alternativa all'abbonamento, puoi pagare i token man mano che li utilizzi: quando accedi alla CLI, scegli «Kimi Platform API key» da platform.kimi.ai. È una soluzione pratica se lavori saltuariamente o vuoi collegare il modello a uno strumento di terze parti. Consulta la pagina della piattaforma per conoscere condizioni e limiti di questa opzione.

Prima di pagare, verifica concretamente che la tua carta funzioni oppure usa l'opzione con chiave API, se è disponibile per te.

Come installare Kimi Code CLI#

La CLI è la forma principale e più completa di Kimi Code. Se hai già lavorato con Claude Code nel terminale, il flusso di lavoro ti sarà familiare. In caso contrario, la guida su come installare Claude Code può aiutarti a orientarti: il flusso di lavoro è lo stesso.

1. Installa la CLI con un solo comando

   Su macOS o Linux, esegui questo comando nel terminale:

   curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash
   

   Su Windows, esegui questo comando in PowerShell:

   irm https://code.kimi.com/kimi-code/install.ps1 | iex
   

   Il programma di installazione scarica la versione più recente, ne verifica il checksum e aggiunge il comando kimi al PATH. Per questa opzione Node.js non è necessario.

   Su Windows c'è un requisito aggiuntivo: installa Git for Windows prima del primo avvio. Kimi Code usa Git Bash come shell di lavoro. Se Git Bash è installato in un percorso non standard, imposta il percorso di bash.exe nella variabile d'ambiente KIMI_SHELL_PATH.

   È disponibile anche un'opzione npm per chi ha già installato Node.js 22.19.0 o versioni successive:

   npm install -g @moonshot-ai/kimi-code
   

2. Verifica l'installazione e avvia

   Nel comando cd your-project, sostituisci your-project con il percorso della cartella del tuo progetto.

   kimi --version
   cd your-project
   kimi
   

   Per eseguire un singolo comando senza modalità interattiva, usa il flag -p:

   kimi -p "Look at the project structure and explain the main directories"
   

   Per riprendere una sessione precedente, usa il flag -c: kimi -c ti riporta alla stessa conversazione.

3. Accedi al tuo account

   Inserisci questo comando nella CLI:

   /login
   

   Compariranno due opzioni. «Kimi Code (OAuth)» consente di accedere tramite il tuo account Kimi: apri il link su qualsiasi dispositivo, accedi e inserisci il codice. Verranno applicati i limiti del tuo abbonamento. «Kimi Platform API key» è una chiave di platform.kimi.ai; paghi i token. Per uscire, usa /logout.

4. Assegna la prima attività

   Inizia chiedendo una panoramica del progetto: chiedi all'agente di esaminare le directory principali e spiegare come è organizzato il tutto. Così potrai vedere come legge i file e verificare che l'accesso e il collegamento al modello funzionino.

   Quando esce una nuova versione, puoi aggiornare con il comando kimi upgrade.

Come installare la versione desktop#

La versione desktop è stata rilasciata il 17 settembre 2026 ed è pensata per chi non vuole lavorare esclusivamente nel terminale. Secondo la documentazione di Moonshot AI, un'unica finestra combina una conversazione con l'agente, un browser e un terminale: apri un progetto locale, discuti un'attività e invia le modifiche senza passare da una finestra all'altra. Puoi vedere ogni passaggio dell'agente: chiamate agli strumenti, ragionamento e file modificati; le operazioni sensibili richiedono conferma. Puoi impostare quanto spesso l'agente debba chiedere prima di agire, scegliendo tra tre modalità di autorizzazione: Always Ask, Ask When Needed e Never Ask. Per una prima prova, la prima o la seconda modalità è più sensata.

Sono disponibili due modalità per le attività. Plan crea prima un piano, che puoi esaminare e modificare prima dell'esecuzione. Goal consente all'agente di lavorare autonomamente verso l'obiettivo; puoi inviare un'attività lunga in background, metterla in pausa o interromperla. Il browser integrato si trova nel pannello a destra e fornisce all'agente il contesto della pagina: puoi selezionare un elemento, commentare il testo selezionato o un'area dello screenshot e specificare esattamente cosa correggere.

I programmi di installazione sono disponibili sul sito ufficiale: per macOS, le versioni per Apple Silicon e Intel; per Windows, un programma di installazione x64. Scarica la versione adatta da kimi.com/code, installala, apri una cartella di progetto locale e accedi allo stesso account Kimi. Limiti e fatturazione sono condivisi con la CLI: lo stesso abbonamento e lo stesso pool di crediti.

Come collegare Kimi Code a un editor#

Il modo più semplice per installare l'estensione per VS Code è scaricare «Kimi Code» dal marketplace ufficiale: l'agente comparirà nella barra laterale e potrà completare il codice, modificare file e cercare online. La pagina di download di Kimi elenca anche Cursor, Web, Zed, JetBrains e Paseo.

Gli editor che supportano l'Agent Client Protocol si collegano tramite la CLI. In Zed, aggiungi questo codice a ~/.config/zed/settings.json:

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

A questo punto, una nuova conversazione nel pannello Agent di Zed userà Kimi Code. Devi accedere al tuo account una sola volta nella CLI.

Cosa può fare l'agente fin da subito#

Oltre alle funzionalità standard «leggi, modifica, esegui i test», la CLI offre diverse funzioni:

• Input video: puoi trascinare nella chat una registrazione dello schermo o un video dimostrativo e l'agente lo analizzerà fotogramma per fotogramma; è utile quando è più facile mostrare un bug che descriverlo.
• MCP senza JSON manuale: i server del Model Context Protocol possono essere aggiunti e configurati tramite una conversazione usando /mcp-config. Abbiamo parlato di cos'è MCP e del perché usarlo nell'articolo sui server MCP per Claude Code; il protocollo è condiviso.
• Sottoagenti: i componenti integrati coder, explore e plan svolgono le attività in un contesto isolato, mantenendo i dettagli del loro lavoro fuori dalla conversazione principale.
• Hook del ciclo di vita: comandi personalizzati nelle fasi chiave del flusso di lavoro per controllare le azioni rischiose, inviare notifiche e svolgere verifiche.
• Skill e plugin: pacchetti pronti all'uso dal marketplace o da qualsiasi repository GitHub.

Cosa controllare se qualcosa non funziona#

• kimi --version non risponde: apri una nuova finestra del terminale; PATH viene acquisito dopo il riavvio.
• Su Windows, l'agente termina con un errore quando esegue i comandi: controlla che Git for Windows sia installato e che KIMI_SHELL_PATH sia impostato se Git Bash si trova in un percorso non standard.
• L'accesso non riesce o le attività non vengono eseguite: controlla /login; OAuth funziona solo con un abbonamento a pagamento attivo, mentre la chiave API funziona se il saldo della piattaforma è positivo.
• Tutto funzionava, ma l'agente ha smesso di eseguire le attività: potresti aver esaurito il limite settimanale di 5 ore di Kimi Code o il pool condiviso di crediti; il saldo residuo è indicato nella sezione abbonamenti del sito Kimi.
• La vecchia CLI Python è in conflitto con quella nuova: rimuovi la versione precedente e reinstalla usando il comando di installazione ufficiale.

Cosa fare adesso#

Scegli l'app, la CLI o il plugin e prova un'attività reale del tuo progetto: chiedi all'agente di esaminare la codebase e fare una piccola modifica. Così potrai capire se il suo modo di lavorare fa per te. Ho provato personalmente Kimi K3 su attività reali e alla fine sono tornato a Claude Code: qui ho spiegato cosa non ha funzionato. Un confronto attività per attività è disponibile in Kimi K3 vs Claude Code; tra le opzioni gratuite, considererei la recensione di Qwen Code come alternativa a Claude Code.

Se ti serve accedere alle reti neurali tramite Ailoot, dai un'occhiata ad Ailoot.