Cómo llevar Kimi K3.1 Pro a Kimi Code CLI: instalación, inicio de sesión y la trampa de Windows

Kimi Code CLI es el agente de programación para terminal de Moonshot, y es el único cliente en el que Kimi K3.1 Pro no es una integración de terceros, sino la opción predeterminada. La configuración es más breve que las rutas de Claude Code o Codex: un script de instalación, un /login, una elección de plataforma, porque el cliente y el modelo son de la misma empresa. La pega depende de la plataforma: en Windows, la CLI se ejecuta dentro de la Git Bash que incluye, y si ese shell no está donde el instalador espera que esté, la herramienta se inicia y luego falla de formas que parecen errores del modelo.

Esta es la secuencia que funciona, verificada con la documentación de Moonshot el 24 de octubre de 2026, con los modos de fallo señalados donde realmente ocurren.

Instalar

macOS y Linux se instalan con una sola línea: curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash. Windows PowerShell también se instala con una sola línea: irm https://code.kimi.com/kimi-code/install.ps1 | iex. El script descarga la última versión, verifica su suma de comprobación y coloca el ejecutable kimi en tu PATH. No se requiere ningún entorno de ejecución de Node.js ni de Python.

Windows tiene un requisito previo que es fácil pasar por alto: instala Git for Windows primero. Kimi Code CLI utiliza el Git Bash incluido como su entorno de shell. Si Git Bash se encuentra en una ubicación no estándar, establece la KIMI_SHELL_PATH variable de entorno en la ruta absoluta de bash.exe antes de iniciarlo; de lo contrario, el agente se inicia pero todos los comandos de shell que intenta ejecutar fallan.

Iniciar sesión con una clave de API

Inicia la CLI dentro del directorio del proyecto en el que quieras trabajar:

• Ejecuta kimi para abrir la interfaz interactiva.

• Escribe /login. Kimi Code CLI abre un selector de plataforma.

• Elija Kimi Platform (API key · platform.kimi.ai). Esta es la opción para una clave creada en la plataforma abierta; las demás corresponden a distintas interfaces de cuenta.

• Pega la clave. Crea una en platform.kimi.ai, en API Keys, si no dispones de ella. La CLI la almacena localmente, así que trata el directorio de configuración como un almacén de credenciales.

Esa es toda la conexión. El selector de modelos dentro de la CLI enumera los modelos actuales de Kimi, y Kimi K3.1 Pro y su variante de alta velocidad son los dos que importan para el trabajo con agentes.

Cambiar una configuración existente y reemplazar una clave

Hay dos migraciones habituales, y ambas pasan por la misma pantalla. Si Kimi Code CLI ya ha iniciado sesión mediante una suscripción en lugar de una clave de API, ejecutar /login de nuevo y seleccionar la plataforma de clave de API lo cambia sin reinstalar. Si estás rotando una clave —porque se filtró o porque un proyecto necesita su propia facturación—, el mismo flujo sustituye la credencial almacenada.

Lo único que no hay que hacer es editar a mano la configuración almacenada mientras la CLI está en ejecución; el proceso lee las credenciales al iniciarse y cualquier edición a mitad de sesión se sobrescribe al salir.

Lo que el agente realmente hace

Kimi Code CLI no es una ventana de chat en una terminal. Lee y edita código, busca en el repositorio, ejecuta comandos y lee los resultados, y puede incorporar contenido web o buscar cuando una tarea necesita algo fuera del proyecto. Moonshot lo describe como un agente de programación que se ejecuta en tu propia máquina con el modelo encargándose de la planificación —la misma forma que Claude Code o Codex, con las mismas implicaciones para los permisos: un agente que puede ejecutar comandos de shell debería iniciarse en un directorio que estés dispuesto a dejar que modifique, y revisarse antes de subir cualquier cosa.

En este cliente confluyen dos modelos de facturación. La app Kimi Code se vende como una suscripción con niveles de plan, y la CLI puede usar esa suscripción o una clave de API de la plataforma abierta. La vía de la clave de API es la que ofrece la economía por token —$2.00 y $10.00 por millón de tokens para K3.1 Pro, $4.00 y $20.00 para la variante de alta velocidad—, mientras que la suscripción es una tarifa plana con cuota. Para un equipo que ya paga por uso de API en otro lugar, la vía de la clave mantiene el gasto en un solo sitio; para una persona que programa todo el día, la suscripción suele ser más barata y la CLI es la misma descarga en ambos casos.

Elegir el modelo y el esfuerzo

Kimi K3.1 Pro siempre razona, y el esfuerzo se establece con un campo de nivel superior que acepta low, high y max, y cuyo valor predeterminado es max. Kimi Code CLI expone el modelo; el valor predeterminado de esfuerzo es el costoso, así que una sesión que se siente lenta suele ser una sesión ejecutándose en max en lugar de una conexión defectuosa. La variante de alta velocidad reduce la latencia a cambio de un mayor precio —$4.00 y $20.00 por millón de tokens en lugar de $2.00 y $10.00— y es la opción predeterminada sensata para el trabajo interactivo, donde el modelo está esperando a una persona de todos modos.

Dos restricciones acompañan al modelo en cualquier cliente: los parámetros de muestreo son fijos (temperatura 1.0, top-p 0.95, n en 1), y cambiar el esfuerzo a mitad de conversación invalida los aciertos de la caché de prefijos. Decide el nivel al inicio de una sesión.

Cómo se compara esta ruta con Claude Code y Codex

Los tres clientes utilizan tres protocolos distintos para llegar al mismo modelo, y la elección depende sobre todo de la interfaz en la que ya trabaja tu equipo. Kimi Code CLI es el que menos configuración requiere: ni bloque de variables de entorno ni archivo TOML, y el proveedor mantiene ambos extremos. Claude Code necesita el endpoint compatible con Anthropic y cuatro variables de nivel de modelo configuradas correctamente, y Codex necesita un bloque de proveedor con wire_api = "responses", pero después ambos funcionan con cualquier proveedor que hable esos protocolos, incluida una pasarela que también sirva modelos de otros proveedores.

La división práctica: usa Kimi Code CLI cuando Kimi sea el único modelo que necesitas y quieras el camino más corto; usa Claude Code o Codex cuando la misma sesión tenga que alternar entre proveedores, o cuando las herramientas, los permisos y las habilidades de tu equipo ya residan en esos clientes.

Un orden de resolución de problemas que ahorra tiempo

• La CLI se inicia pero no se ejecuta ningún comando de shell — comprueba Git Bash y KIMI_SHELL_PATH primero, antes de culpar al modelo.

• Errores de autenticación después de una configuración que funcionaba — vuelve a ejecutar /login y confirma que la opción de plataforma coincida con el lugar donde se creó la clave; las claves de distintas superficies no son intercambiables.

• Sesiones que se sienten lentas — revisa el valor predeterminado de effort antes de cambiar de modelo; max es costoso tanto en latencia como en tokens.

• Modelo no encontrado tras una actualización — la CLI enumera lo que sirve la plataforma; si falta K3.1 Pro, el cliente está apuntando a una superficie que no se ha actualizado.

Kimi K3.1 Pro en la plataforma cuesta $2.00 por millón de tokens de entrada y $10.00 por millón de tokens de salida, con un contexto de 1M de tokens y hasta 943,718 tokens de salida. Si prefieres acceder a él a través de la API que ya usan tus otras herramientas, OrcaRouter ofrece el mismo modelo que kimi/kimi-k3.1-pro al precio de lista del proveedor sin ningún recargo añadido — la configuración para esa ruta se explica en la guía de Claude Code y Codex.