Cómo instalar Kimi Code en Linux (Ubuntu, Debian, Fedora)

Respuesta rápida: instala Kimi Code en Linux en una línea

# Script de instalación oficial (recomendado)
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Abre un terminal nuevo y comprueba la instalación
kimi --version

# Arráncalo dentro de un proyecto
cd ~/mi-proyecto
kimi

El script descarga la última versión para tu arquitectura, comprueba el checksum, la instala en ~/.kimi-code/bin y añade esa carpeta a tu PATH en ~/.bashrc, ~/.zshrc o la configuración de fish. Los pasos de instalación y login de esta guía salen de la guía oficial de primeros pasos de Kimi Code.

Requisitos

• Un Linux de 64 bits en x64 o ARM64 con glibc. Eso incluye Ubuntu, Debian, Fedora y la mayoría de distros habituales.
• curl o wget para descargar, y sha256sum (o shasum) para que el script pueda verificar la descarga.
• Bash, Zsh o fish.
• Una cuenta de Kimi si usas un plan de suscripción, o una API key de la plataforma de Kimi si pagas por tokens.

Instalar con npm (y el caso de Alpine)

Si ya gestionas tus herramientas de terminal con Node, Kimi Code está en npm como @moonshot-ai/kimi-code. Ojo con el nombre: el paquete de PyPI llamado kimi-code instala el antiguo kimi-cli de Python, no este.

# Necesita Node.js 22.19.0 o superior
node --version

npm install -g @moonshot-ai/kimi-code
# o bien
pnpm add -g @moonshot-ai/kimi-code

En Alpine y otras distros con musl, npm es la única vía: el script solo trae binarios para glibc y se detiene al detectar musl. Las actualizaciones funcionan igual en los dos casos: ejecuta kimi upgrade, o npm install -g @moonshot-ai/kimi-code@latest si usaste npm.

Primer arranque e inicio de sesión (también por SSH)

• Abre un terminal en la carpeta de un proyecto y escribe kimi.
• Dentro de la sesión, ejecuta /login y elige cómo entrar.
• Cuenta de Kimi: un flujo con código de dispositivo. Kimi Code te muestra un enlace y un código; abre el enlace en cualquier dispositivo, inicia sesión e introduce el código. Como el navegador no tiene que estar en la misma máquina, también funciona en un servidor por SSH.
• API key: pega una clave de platform.kimi.com o platform.kimi.ai si pagas por tokens.

Kimi Code guarda sus datos en ~/.kimi-code/: la configuración en config.toml, los tokens OAuth en credentials/, las sesiones en sessions/ y un log de diagnóstico en logs/kimi-code.log. Para moverlo todo a otra carpeta, usa la variable KIMI_CODE_HOME. Para borrar tus credenciales, ejecuta /logout. La referencia oficial de ubicaciones de datos detalla cada archivo.

Errores comunes en Linux y cómo arreglarlos

• "kimi: command not found" tras instalar: tu shell todavía no ha leído el nuevo PATH. Abre un terminal nuevo o comprueba que tu configuración de shell tiene la línea export PATH="$HOME/.kimi-code/bin:$PATH".
• "Alpine / musl Linux is not currently supported": el script solo trae binarios para glibc. Instala Node.js 22.19 o superior y usa npm install -g @moonshot-ai/kimi-code.
• "curl or wget is required" o "shasum or sha256sum required to verify download": pasa a menudo en contenedores mínimos. Instala curl y coreutils con tu gestor de paquetes y vuelve a lanzar el script.
• "unsupported architecture": el script solo cubre x64 y ARM64. En cualquier otra, prueba con el paquete de npm.
• kimi --version muestra 1.4x: estás usando el antiguo kimi-cli de Python. Kimi Code muestra una versión 0.x. El script renombra el kimi antiguo a kimi-legacy para que se use el nuevo.

Si más adelante una sesión da problemas, mira primero ~/.kimi-code/logs/kimi-code.log. Para los comandos y opciones del día a día, tienes cómo usar Kimi Code.

Varias sesiones de Kimi Code en Linux

Con Kimi Code funcionando, el siguiente límite llega rápido: un terminal solo lleva una tarea a la vez. Le das un trabajo a Kimi y esperas. Abrir más pestañas en GNOME Terminal o en tmux ayuda, hasta que pierdes la cuenta de qué sesión ha terminado, cuál espera tu aprobación y qué ha cambiado cada una.

CodeAgentSwarm es una app de escritorio pensada justo para eso, y ya funciona en Linux como .deb (Ubuntu, Debian y derivadas) o AppImage (Fedora y la mayoría de las demás distros), en x64 y ARM64. Pone varios terminales de Kimi Code uno al lado del otro y añade notificaciones cuando un agente termina o necesita algo, historial buscable de todas las sesiones y un diff en tiempo real de lo que ha cambiado cada terminal. También puedes mezclar agentes: Kimi Code en un terminal y Claude Code o Codex en el de al lado.

Siguiente paso: ejecutar múltiples sesiones de Kimi Code. ¿Vas a instalar Claude Code en la misma máquina? Mira Claude Code en Linux.

Conclusión

En Linux, Kimi Code está a un comando curl, o a un npm install si usas Alpine o prefieres Node. Inicia sesión con /login, que también funciona por SSH, revisa ~/.kimi-code/logs si algo falla, y cuando un solo terminal se te quede corto, CodeAgentSwarm te deja usar varios a la vez.