Cómo ejecutar Kimi Code en Windows: instalador, Git Bash y los bordes ásperos

Respuesta rápida: sí, con dos requisitos previos

# 1. Instala primero Git for Windows (obligatorio, Kimi Code usa Git Bash como shell)
winget install Git.Git

# 2. Instala Kimi Code con el instalador oficial de PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# 3. Abre un terminal NUEVO y verifica
kimi --version

Ese es el camino corto. El orden importa: Git for Windows tiene que estar antes del primer arranque de Kimi Code, no después. Las secciones de abajo explican por qué, cubren la alternativa por npm y repasan el problema de renderizado que ahora mismo es la pega más específica de Windows.

Si Kimi Code en sí te pilla de nuevas, empieza por cómo usar Kimi Code, que además cubre la trampa de los dos CLIs de Moonshot que instalan un binario kimi.

Qué necesitas antes de instalar

• Windows 10 o Windows 11 de 64 bits, y un terminal (Windows Terminal o PowerShell).
• Git for Windows. No es opcional. Kimi Code usa el Git Bash que viene incluido como su entorno de shell, así que debe estar instalado antes del primer arranque. Instálalo desde git-scm.com o con winget install Git.Git.
• Node.js 22.19.0 o superior, pero solo si eliges la vía de npm en vez del instalador de PowerShell. El instalador oficial no necesita Node para nada.
• Una cuenta de Kimi (para los planes de suscripción) o una API key de la plataforma de Moonshot (para pago por token).

Instalación nativa paso a paso

Con Git for Windows en su sitio, el instalador oficial es la vía recomendada porque no necesita runtime:

• Abre PowerShell (sin permisos de administrador).
• Ejecuta irm https://code.kimi.com/kimi-code/install.ps1 | iex. Descarga la última release, verifica el checksum y deja el ejecutable kimi en tu PATH.
• Cierra y vuelve a abrir el terminal para que coja el cambio de PATH.
• Ejecuta kimi --version. Deberías ver una versión 0.x, lo que confirma que tienes el CLI actual en TypeScript y no el kimi-cli legacy en Python.
• Entra en la carpeta de un proyecto, ejecuta kimi e inicia sesión con /login (navegador para suscripciones, API key para pago por token).

¿Prefieres npm? También funciona en Windows, siempre que tengas Node.js 22.19 o superior:

# Comprueba Node primero
node --version

# Instala globalmente
npm install -g @moonshot-ai/kimi-code

# Verifica
kimi --version

Para actualizar más adelante, ejecuta kimi upgrade, o npm install -g @moonshot-ai/kimi-code@latest si instalaste por npm.

El bug de renderizado que debes conocer

Aquí viene la parte que la mayoría de artículos se salta. A fecha de las releases 0.26.x, el repositorio de Kimi Code tiene una issue abierta (#1792) en la que el TUI vuelca secuencias de escape ANSI en crudo en vez de renderizarlas, en Windows Terminal, PowerShell y cmd. Cuando pega, la pantalla se llena de secuencias tipo [38;2;255m en lugar de una interfaz usable.

No muerde en todas las máquinas, y con un ritmo de una versión al día puede estar arreglado cuando leas esto. Pero si lanzas kimi en Windows y la salida parece basura en vez de una UI, no estás haciendo nada mal: es un problema conocido del proyecto. Mira el issue tracker para ver el estado actual antes de perder tiempo con tu configuración.

La vía WSL: el plan B fiable

WSL 2 te da un entorno Linux de verdad dentro de Windows, y ahí Kimi Code se comporta como en Linux: la dependencia de bash es nativa, y la ruta de renderizado es la que la mayoría de sus usuarios ejercita a diario. Si tu proyecto ya depende de herramientas de Linux, o el TUI nativo se porta mal en tu máquina, esta es la vía tranquila.

# Dentro de tu terminal WSL (Linux)
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Y después, desde tu proyecto
kimi

Dos notas prácticas: mantén los archivos del proyecto dentro del sistema de archivos de Linux por rendimiento, y cuando el login OAuth te enseñe un enlace, termínalo en tu navegador de Windows y vuelve al terminal. Todo lo demás funciona igual que en el setup nativo.

Errores típicos de Windows y sus arreglos

• "kimi no se reconoce como comando": no reabriste el terminal tras instalar, o el cambio de PATH del instalador no cuajó. Abre una ventana nueva de PowerShell; si sigue, comprueba que la carpeta bin de Kimi Code está en tu PATH.
• Kimi Code se queja del shell o no consigue ejecutar comandos: falta Git for Windows o Git Bash está en una ruta rara. Instala Git for Windows, o apunta KIMI_SHELL_PATH a tu bash.exe.
• Pantalla llena de códigos de escape en crudo: es la issue #1792 de arriba, no tu configuración. Usa WSL o revisa el issue tracker por si ya hay release con arreglo.
• kimi --version imprime 1.4x: tienes el kimi-cli legacy en Python, no Kimi Code. Instala con el script oficial o el paquete de npm @moonshot-ai/kimi-code; el instalador renombra los shims legacy a kimi-legacy por ti.
• npm falla por la versión de Node: Kimi Code necesita Node 22.19.0 o superior. Actualiza Node, o sáltate npm y usa el instalador de PowerShell, que lo trae todo.

Varias sesiones de Kimi Code en Windows

Cuando Kimi Code ya funciona, el siguiente techo es un terminal, una tarea. Cada sesión de kimi es un proceso independiente, así que nada te impide abrir varios terminales y correr una sesión en cada uno. Lo difícil es no perder el hilo: qué agente terminó, cuál espera una aprobación y qué cambió cada uno.

CodeAgentSwarm es una app de escritorio nativa para Windows y macOS construida para ese problema de supervisión. Kimi Code es un agente soportado en ella, junto a Claude Code, Codex CLI, Antigravity CLI y opencode, y el agente se elige por terminal. Tienes notificaciones de escritorio cuando una sesión termina o necesita algo, historial buscable entre todos los agentes, diffs en vivo por terminal, y un indicador de cuota que lee las ventanas semanal y de 5 horas de Kimi.

Para el flujo en paralelo completo, sigue con ejecutar varias sesiones de Kimi Code y la guía del enjambre de agentes de Kimi Code.