Cómo usar Kimi Code: instalación, login, comandos y la trampa de kimi-cli

¿Qué es Kimi Code?

Kimi Code es el agente de programación oficial para terminal de Moonshot AI, la empresa detrás de los modelos Kimi. Es open source con licencia MIT, está escrito en TypeScript y se invoca con el comando kimi. Lo ejecutas dentro de la carpeta de un proyecto, le cuentas qué quieres, y planifica, edita archivos y ejecuta comandos de shell con tu aprobación.

Por debajo funciona con Kimi K3, el modelo que Moonshot lanzó el 16 de julio de 2026: un Mixture of Experts de 2,8 billones de parámetros con una ventana de contexto de hasta 1.048.576 tokens y visión nativa. K3 siempre razona antes de responder, lo que lo hace fuerte en trabajo difícil de varios pasos. Si quieres el detalle del modelo y lo que cuesta, la guía de planes y precios entra a fondo en eso.

Si ya usas Claude Code, Kimi Code te resultará familiar a propósito. Sus tools llevan los mismos nombres (Bash, Read, Write, Edit), sigue la convención AGENTS.md para las instrucciones de proyecto, y su configuración de MCP es compatible con el archivo .mcp.json que Claude Code ya lee. La comparativa Kimi Code vs Claude Code cubre exactamente en qué se diferencian.

Antes de instalar: la trampa de los dos kimis

Moonshot ha publicado dos agentes de terminal, y los dos instalan un binario llamado kimi. Equivocarse aquí es la forma número uno de acabar confundido, y la mayoría de posts sobre Kimi Code ni lo mencionan.

• kimi-cli (legacy): el agente original en Python, en el repositorio MoonshotAI/kimi-cli, con sus datos en ~/.kimi/. Está en retirada, pero acumula años de estrellas y de posts apuntándole, así que los buscadores y los asistentes de IA siguen mandando gente allí.
• Kimi Code (actual): el agente en TypeScript del que va esta guía, en el repositorio MoonshotAI/kimi-code, con sus datos en ~/.kimi-code/. Este es el que está en desarrollo activo.

Los nombres de paquete lo empeoran, porque están cruzados. El paquete de PyPI llamado kimi-code es un meta-paquete vacío que instala el agente legacy en Python. El Kimi Code de verdad vive en npm como @moonshot-ai/kimi-code. O sea: instalar "kimi-code" desde pip te da el producto viejo, y el producto nuevo llega por npm o por el script oficial de instalación.

# Comprueba qué kimi tienes en realidad
kimi --version

# 0.x  -> Kimi Code, el CLI actual en TypeScript (esta guía)
# 1.4x -> kimi-cli, el agente legacy en Python

Cómo instalar Kimi Code

El camino recomendado es el script oficial de instalación, que no requiere Node.js. Descarga la última release, verifica el checksum y deja el ejecutable kimi en tu PATH (el binario en sí queda en ~/.kimi-code/bin/).

# macOS y Linux
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows (PowerShell)
irm https://code.kimi.com/kimi-code/install.ps1 | iex

Si prefieres un gestor de paquetes, Kimi Code está en npm. Esta vía necesita Node.js 22.19.0 o superior:

# Comprueba primero tu versión de Node
node --version

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

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

En cualquiera de los dos casos, abre un terminal nuevo después y confirma la instalación con kimi --version. Deberías ver una versión 0.x. Para actualizar más adelante, ejecuta kimi upgrade y el propio CLI busca la última versión, o reinstala con npm install -g @moonshot-ai/kimi-code@latest.

Primer arranque e inicio de sesión

Arranca Kimi Code dentro de la carpeta de un proyecto escribiendo kimi. En el primer arranque, usa el comando /login dentro del TUI. Abre un selector con dos opciones:

• Iniciar sesión con tu cuenta de Kimi: un flujo OAuth de código de dispositivo. Kimi Code te enseña un enlace, confirmas en el navegador y el CLI recoge la sesión. Esta es la vía de los planes de suscripción de Kimi.
• API key: pega una clave de la plataforma de Moonshot si pagas por token en vez de suscribirte.

Las credenciales se guardan en local bajo ~/.kimi-code/. Una vez logueado, cada sesión nueva de kimi en cualquier carpeta las reutiliza. Dentro del TUI, /usage te enseña cómo vas de cuota, que en las suscripciones funciona como una asignación semanal más una ventana rodante de 5 horas.

Uso diario: los comandos y flags que importan

En el día a día vivirás dentro de la sesión interactiva, con un puñado de flags para arrancar, retomar y automatizar:

# Arranca una sesión en el proyecto actual
kimi

# Continúa la última sesión de esta carpeta
kimi --continue        # o: kimi -c

# Retoma una sesión concreta por id
kimi --session <id>

# Ejecución headless de un solo tiro (sin TUI), como claude -p
kimi -p "explica qué hace este repo"

# Modos
kimi --plan     # planifica antes de actuar
kimi --auto     # más autonomía, aún con puertas
kimi --yolo     # aprueba todo solo (cuidado)

Algunos detalles de entrada que conviene saber: Enter envía el mensaje, y Ctrl-J o Alt-Enter insertan un salto de línea. /title pone nombre a la sesión actual, lo que facilita mucho encontrarla después. Y si retomas una sesión pasando --yolo, --auto o --plan, el flag sobreescribe el modo con el que la sesión se guardó. El flag --yolo merece su propia conversación sobre riesgos, que es justo para lo que está la guía del modo YOLO de Kimi Code.

Instrucciones de proyecto: AGENTS.md

Kimi Code sigue la convención AGENTS.md. Lee un archivo global en ~/.kimi-code/AGENTS.md, uno compartido en ~/.agents/AGENTS.md y el AGENTS.md de tu proyecto. No existe KIMI.md, y no lee CLAUDE.md de forma nativa, aunque trae un skill de importación que convierte una configuración existente de Claude Code o Codex una sola vez, con tu confirmación.

Los skills se comparten, no se portan

Kimi Code lee skills de forma nativa desde ~/.agents/skills/, la misma carpeta compartida que usan otros agentes CLI, además de su propia ~/.kimi-code/skills/ y las carpetas de skills por proyecto. Si ya mantienes skills para Claude Code o Codex, Kimi Code los recoge sin portar nada. Eso hace que el flujo de compartir skills entre agentes aplique a Kimi tal cual.

Servidores MCP

La configuración de MCP va por archivos. Kimi Code lee un ~/.kimi-code/mcp.json global, después el .mcp.json de tu repositorio en la raíz del git (el mismo archivo que usa Claude Code, así que un solo archivo puede servir a los dos agentes), y después un .kimi-code/mcp.json por proyecto, ganando el archivo más específico. Los nombres de tools siguen el mismo patrón mcp__servidor__tool que Claude Code. No hay flag --mcp-config, la configuración vive solo en archivos. Para automatización más profunda hay además un sistema completo de hooks, configurado en TOML dentro de ~/.kimi-code/config.toml y validado con kimi doctor.

Ejecutar Kimi Code dentro de CodeAgentSwarm

Una sesión de Kimi Code es un proceso trabajando en una tarea. En cuanto quieres una segunda tarea avanzando a la vez, ya estás en varios terminales, y ahí es donde entra CodeAgentSwarm. Es una app de escritorio para macOS y Windows que ejecuta varios terminales de agentes CLI en un espacio de trabajo visual, y Kimi Code es un agente de primera en ella, junto a Claude Code, Codex CLI, Antigravity CLI y opencode.

Eliges el agente por terminal, así que puedes correr tres sesiones de Kimi Code una al lado de otra, o mezclar Kimi con Claude Code en el mismo proyecto y comparar cómo resuelve cada uno su tarea. Encima de los terminales tienes notificaciones de escritorio cuando un agente termina o pide algo, historial de conversaciones buscable entre todos los agentes, diffs en vivo por terminal con lo que cambió cada sesión, un tablero kanban que los agentes actualizan por MCP, y un indicador de cuota que lee las ventanas semanal y de 5 horas de Kimi para que veas venir el muro antes de chocarte con él.

Desde aquí, los siguientes pasos naturales son ejecutar varias sesiones de Kimi Code para la mecánica, y la guía del enjambre de agentes de Kimi Code para el flujo en paralelo completo. Si prefieres quedarte con tu harness de siempre y usar solo el modelo, también puedes ejecutar Kimi K3 dentro de Claude Code.