Agentes de IA

Kimi Code CLI

Kimi Code — Comandos de terminal (kimi)

Comandos de terminal vs. comandos slash. Los comandos kimi ... se ejecutan en tu shell, fuera del agente (o para lanzarlo). Los comandos slash como /login o /model se escriben dentro de la TUI interactiva. Algunos conceptos existen en los dos mundos — por ejemplo kimi login (shell) frente a /login (TUI) — pero son interfaces distintas. Los comandos slash están en Comandos slash y los flags de arranque en Flags del CLI.

Uso básico

kimi [opciones]
kimi <subcomando> [opciones]
kimi                            # abre la TUI interactiva
kimi -p "explica este repo"     # prompt único, no interactivo
kimi -c                         # retoma la sesión más reciente de este directorio
kimi --version                  # imprime la versión y sale (-V)
kimi --help                     # muestra la ayuda y sale (-h)

Subcomandos

kimi login

Login OAuth por código de dispositivo, sin interacción. No tiene flags.

kimi login

Sale con código 0 si funciona y 1 si se cancela o falla. Alternativa interactiva: /login en la TUI.

kimi acp

Arranca el modo ACP (Agent Client Protocol) para integrarse con IDEs — JSON-RPC sobre stdio. Normalmente lo lanza el IDE (Zed, JetBrains, Paseo), no tú a mano.

kimi acp

kimi web

Levanta en primer plano un servidor local que expone REST + WebSocket + una interfaz web desde un mismo origen.

kimi web                       # por defecto 127.0.0.1:58627 (si el puerto está ocupado, prueba el siguiente)
kimi web --port 9000 --no-open
kimi web --host                # --host a secas escucha en 0.0.0.0
kimi web rotate-token          # rota el bearer token persistente

Opciones: --port <puerto>, --host [host], --allowed-host <host...>, --log-level <nivel>, --debug-endpoints, --web-title <título>, --no-open y --dangerous-bypass-auth (PELIGRO: desactiva por completo la autenticación bearer). El banner de arranque imprime el bearer token, que se guarda en ~/.kimi-code/server.token. Los esquemas de la API están en GET /openapi.json y GET /asyncapi.json. kimi server … está obsoleto (sale con 1) salvo kimi server kill para servidores en segundo plano anteriores a la 0.28.0.

kimi doctor

Valida config.toml / tui.toml sin arrancar la TUI.

kimi doctor                    # valida los dos archivos
kimi doctor config [ruta]      # valida sólo config.toml
kimi doctor tui [ruta]         # valida sólo tui.toml

Sale con 0 si es válido o si se omite, y con 1 si falta o es inválido.

kimi export

Empaqueta una sesión en un ZIP de depuración (lo mismo que /export-debug-zip en la TUI).

kimi export                          # la sesión más reciente del directorio actual (pide confirmación)
kimi export <sessionId> -o debug.zip -y

Opciones: -o/--output <ruta>, -y/--yes (sin confirmación) y --no-include-global-log.

kimi migrate

Migración interactiva desde el antiguo kimi-cli en Python (datos de ~/.kimi/): configuración, servidores MCP, historial de entrada y sesiones.

kimi migrate

Notas: las credenciales OAuth y las autorizaciones de MCP no se migran (vuelve a ejecutar /login); los datos antiguos nunca se modifican ni se borran; se puede volver a ejecutar; y las sesiones importadas se etiquetan como [imported].

kimi upgrade

Busca e instala actualizaciones. kimi update es un alias.

kimi upgrade

Las instalaciones por npm también se pueden actualizar con npm install -g @moonshot-ai/kimi-code@latest.

kimi vis

Abre un visualizador de sesiones en el navegador.

kimi vis [sessionId] [--port <número>] [--host <host>] [--no-open]

kimi provider

Gestión de proveedores sin interacción.

kimi provider add <url> --api-key <clave>      # importa en bloque desde el api.json de un registro
kimi provider remove <providerId>              # quita el proveedor y sus alias de modelo
kimi provider list [--json]
kimi provider catalog list [providerId] [--filter <subcadena>] [--json]
kimi provider catalog add <providerId> --api-key <clave> [--default-model <modelId>]

Notas: la API key del registro también puede venir de KIMI_REGISTRY_API_KEY; sin conexión, el catálogo recurre a una copia interna; los protocolos no declarados (xai, openrouter) se importan como compatibles con OpenAI; los protocolos propietarios (Bedrock) no se pueden importar; y remove limpia default_model si apuntaba a ese proveedor. Alternativa interactiva: /provider en la TUI.

kimi session list

Lista las sesiones desde la línea de comandos.

kimi session list

Según el changelog se añadió en la 0.40.0; en el momento de la verificación aún no estaba en la página de referencia del comando kimi.


Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.