Integrare Kimi K3.1 Pro in Kimi Code CLI: installazione, accesso e la trappola di Windows

Kimi Code CLI è l'agente di programmazione da terminale di Moonshot, ed è l'unico client in cui Kimi K3.1 Pro non è un'integrazione di terze parti ma è il modello predefinito. La configurazione è più breve rispetto ai percorsi Claude Code o Codex — uno script di installazione, un /login, una scelta della piattaforma — perché il client e il modello provengono dalla stessa azienda. L'inghippo è specifico della piattaforma: su Windows, la CLI viene eseguita all'interno della Git Bash che include, e se quella shell non si trova dove l'installer se l'aspetta, lo strumento si avvia e poi fallisce in modi che sembrano errori del modello.

Questa è la sequenza che funziona, verificata sulla documentazione di Moonshot il 24 ottobre 2026, con le modalità di errore segnalate là dove si verificano effettivamente.

Installa

Per macOS e Linux basta una riga: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Anche Windows PowerShell richiede una riga: irm https://code.kimi.com/kimi-code/install.ps1 | iex. Lo script scarica l'ultima release, ne verifica il checksum e inserisce l'eseguibile kimi nel tuo PATH. Non è richiesto alcun runtime Node.js o Python.

Windows ha un prerequisito facile da trascurare: installare prima Git for Windows. Kimi Code CLI usa il Git Bash incluso come ambiente shell. Se Git Bash si trova in una posizione non standard, impostare la variabile d'ambiente KIMI_SHELL_PATH sul percorso assoluto di bash.exe prima dell'avvio — altrimenti l'agente si avvia ma ogni comando shell che prova a eseguire fallisce.

Accedi con una chiave API

Avvia la CLI all'interno della directory del progetto in cui vuoi lavorare:

• Esegui kimi per aprire l'interfaccia interattiva.

• Digita /login. Kimi Code CLI apre un selettore di piattaforma.

• Scegli Kimi Platform (chiave API · platform.kimi.ai). Questa è l'opzione per una chiave creata sulla piattaforma aperta; le altre corrispondono a diverse superfici dell'account.

• Incolla la chiave. Se non ne hai una, creane una su platform.kimi.ai nella sezione API Keys. La CLI la memorizza localmente, quindi tratta la directory di configurazione come un archivio di credenziali.

Questa è l'intera connessione. Il selettore di modelli all'interno della CLI elenca i modelli Kimi attuali, e Kimi K3.1 Pro e la sua variante ad alta velocità sono i due che contano per il lavoro agentico.

Cambiare una configurazione esistente e sostituire una chiave

Due migrazioni sono comuni ed entrambe passano dalla stessa schermata. Se Kimi Code CLI è già connesso tramite un abbonamento anziché una chiave API, eseguendo /login di nuovo e selezionando la piattaforma con chiave API si effettua il passaggio senza reinstallare. Se stai ruotando una chiave — perché è stata divulgata, o perché un progetto necessita della propria fatturazione — lo stesso flusso sostituisce la credenziale archiviata.

L'unica cosa da non fare è modificare a mano la configurazione salvata mentre la CLI è in esecuzione; il processo legge le credenziali all'avvio e una modifica apportata a metà sessione viene sovrascritta all'uscita.

Che cosa fa effettivamente l'agente

Kimi Code CLI non è una finestra di chat in un terminale. Legge e modifica il codice, cerca nel repository, esegue comandi e ne legge i risultati, e può recuperare contenuti dal web o effettuare ricerche quando un'attività richiede qualcosa al di fuori del progetto. Moonshot lo descrive come un agente di programmazione che gira sulla tua macchina, con il modello che si occupa della pianificazione — la stessa impostazione di Claude Code o Codex, con le stesse implicazioni per i permessi: un agente in grado di eseguire comandi shell dovrebbe essere avviato in una directory che sei disposto a lasciargli modificare, e revisionato prima che qualsiasi cosa venga pubblicata.

In questo client si incontrano due modelli di fatturazione. L'app Kimi Code viene venduta come abbonamento con livelli di piano, e la CLI può usare tale abbonamento oppure una chiave API dalla piattaforma aperta. Il percorso con chiave API è quello che offre l'economia per token — 2,00 $ e 10,00 $ per milione di token per K3.1 Pro, 4,00 $ e 20,00 $ per la variante ad alta velocità — mentre l'abbonamento è un canone fisso con quota. Per un team che già paga per l'utilizzo delle API altrove, il percorso con chiave mantiene la spesa in un unico posto; per una persona che programma tutto il giorno, l'abbonamento di solito è più economico e la CLI è lo stesso download in entrambi i casi.

Scegliere il modello e l'impegno

Kimi K3.1 Pro ragiona sempre, e l'effort si imposta con un campo di primo livello che accetta low, high e max, con valore predefinito max. Kimi Code CLI espone il modello; il valore predefinito dell'effort è quello costoso, quindi una sessione che sembra lenta è di solito una sessione in esecuzione a max anziché una connessione rotta. La variante ad alta velocità scambia latenza con prezzo — 4,00 $ e 20,00 $ per milione di token invece di 2,00 $ e 10,00 $ — ed è il default sensato per il lavoro interattivo in cui il modello è comunque in attesa di una persona.

Due vincoli seguono il modello in qualsiasi client: i parametri di campionamento sono fissi (temperature 1.0, top-p 0.95, n a 1), e modificare l'effort a metà conversazione invalida i prefix-cache hit. Decidi il livello all'inizio di una sessione.

Come si confronta questo percorso con Claude Code e Codex

I tre client usano tre protocolli diversi per raggiungere lo stesso modello, e la scelta dipende soprattutto dall'interfaccia in cui il tuo team già lavora. Kimi Code CLI è quello che richiede meno configurazione: nessun blocco environment, nessun file TOML, e il fornitore mantiene entrambe le estremità. Claude Code richiede l'endpoint compatibile con Anthropic e quattro variabili model-tier impostate correttamente, e Codex richiede un blocco provider con wire_api = "responses", ma poi entrambi funzionano con qualsiasi provider che parli quei protocolli — incluso un gateway che serve anche i modelli di altri fornitori.

La distinzione pratica: usa Kimi Code CLI quando Kimi è l'unico modello di cui hai bisogno e vuoi la strada più breve; usa Claude Code o Codex quando la stessa sessione deve passare da un fornitore all'altro, oppure quando gli strumenti, i permessi e le competenze del tuo team risiedono già in quei client.

Una procedura di risoluzione dei problemi che fa risparmiare tempo

• La CLI si avvia ma nessun comando shell viene eseguito — controlla Git Bash e KIMI_SHELL_PATH per prima cosa, prima di dare la colpa al modello.

• Errori di autenticazione dopo una configurazione funzionante — rieseguire /login e verificare che l'opzione della piattaforma corrisponda a quella in cui è stata creata la chiave; le chiavi provenienti da interfacce diverse non sono intercambiabili.

• Sessioni che sembrano lente — controlla il valore predefinito di effort prima di cambiare modello; max è costoso sia in latenza che in token.

Modello non trovato dopo un aggiornamento — la CLI elenca ciò che la piattaforma fornisce; se K3.1 Pro è assente, il client punta a una superficie che non è stata aggiornata.

Kimi K3.1 Pro sulla piattaforma costa 2,00 $ per milione di token di input e 10,00 $ per milione di output, con una finestra di contesto da 1M di token e fino a 943.718 token di output. Se preferisci raggiungerlo tramite l'API che i tuoi altri strumenti già utilizzano, OrcaRouter eroga lo stesso modello come kimi/kimi-k3.1-pro al prezzo di listino del provider, senza alcun ricarico aggiunto — la configurazione per quel percorso è illustrata nella guida per Claude Code e Codex.