Kimi Code CLI es el agent de IA para programación en terminal de código abierto de Moonshot AI: lee y edita código, ejecuta comandos de shell y planifica el siguiente paso a partir de tus comentarios. Esta referencia rápida reúne los comandos de Kimi Code, comandos slash, atajos de teclado, herramientas integradas y flujos de trabajo diarios que más usan los desarrolladores. Tenla abierta junto a tu terminal y usa /help dentro de Kimi Code o kimi --help en tu shell para ver qué ofrece tu versión actual.
Para ver detalles de origen, consulta las referencias oficiales de comando kimi, comandos slash, herramientas integradas y atajos de teclado.
Instalar Kimi Code CLI
Para la mayoría de los desarrolladores, el script de instalación oficial es la vía más rápida: instala un único binario de Kimi Code y no requiere Node.js. Homebrew, npm y pnpm también están disponibles si se adaptan mejor a tu cadena de herramientas local.
| Plataforma / administrador | Comando |
|---|---|
| Script para macOS / Linux | curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash |
| Homebrew | brew install kimi-code |
| Windows PowerShell | irm https://code.kimi.com/kimi-code/install.ps1 \| iex |
| npm | npm install -g @moonshot-ai/kimi-code |
| pnpm | pnpm add -g @moonshot-ai/kimi-code |
En Windows, instala Git for Windows antes del primer arranque, porque Kimi Code CLI usa Git Bash incluido como entorno de shell. Después de instalarlo, abre una terminal nueva y verifica el binario:
Empieza aquí
Usa este ciclo mínimo cuando entres a un proyecto por primera vez:
Usa --yolo, /yolo y /auto solo en espacios de trabajo de confianza. Reducen la fricción de las aprobaciones, pero también permiten que Kimi Code actúe con más autonomía.
Comandos más usados
Si solo memorizas unos pocos, que sean estos: cubren la mayoría de las sesiones del día a día.
| Comando | Qué hace |
|---|---|
kimi | Inicia una sesión interactiva en el directorio actual |
kimi -C | Continúa aquí la sesión más reciente |
kimi -p "..." | Ejecuta un solo prompt sin abrir la TUI |
/login | Inicia sesión en el primer arranque |
/init | Genera o actualiza AGENTS.md |
/plan on | Entra en el modo de planificación para cambios amplios o riesgosos |
/model | Cambia el modelo para esta sesión |
/compact | Libera contexto cuando la conversación se alarga |
/sessions | Explora y reanuda sesiones anteriores |
/help | Muestra todos los comandos y atajos |
Shift-Tab | Activa o desactiva el modo de planificación |
Inicio y automatización
Opciones principales de CLI
| Comando / indicador | Qué hace |
|---|---|
kimi | Inicia una sesión interactiva en el directorio actual |
kimi --continue, kimi -C | Continúa la sesión más reciente en este directorio |
kimi --session [id], kimi -S [id] | Reanuda una sesión por ID o abre el selector de sesiones sin ID |
kimi -p "...", kimi --prompt "..." | Ejecuta un solo prompt no interactivo sin abrir la TUI |
--output-format stream-json | Emite eventos JSONL para scripts; solo funciona con --prompt |
kimi --model <model>, kimi -m <model> | Inicia con un alias de modelo específico |
kimi --plan | Inicia una sesión nueva en modo de planificación |
kimi --yolo, kimi -y | Aprueba automáticamente las llamadas normales a herramientas; úsalo solo en directorios de confianza |
kimi --auto | Inicia en modo de permisos automático; las aprobaciones se gestionan automáticamente y el Agent no hará preguntas |
--skills-dir <dir> | Carga Skills desde el directorio especificado y reemplaza, para este inicio, los directorios de Skills de usuario y proyecto detectados automáticamente |
Ejemplos no interactivos
Subcomandos de CLI
| Subcomando | Propósito |
|---|---|
kimi login | Inicia el acceso con código de dispositivo OAuth de Kimi Code sin entrar a la TUI |
kimi acp | Ejecuta Kimi Code como servidor Agent Client Protocol para integración con IDE |
kimi server | Ejecuta, instala y administra el servicio local REST/WebSocket/web |
kimi web | Abre la interfaz de navegador de Kimi; equivale a kimi server run --open |
kimi doctor | Valida config.toml y tui.toml |
kimi export [sessionId] | Empaqueta una sesión en un archivo ZIP |
kimi migrate | Migra datos locales desde una instalación antigua de kimi-cli |
kimi upgrade | Busca la versión más reciente y muestra las opciones de actualización |
kimi vis [sessionId] | Abre el visualizador de sesiones en tu navegador |
kimi provider | Administra proveedores desde la terminal |
Comandos útiles del servidor:
Comandos slash
Los comandos slash son controles integrados de la TUI. Escribe / en el cuadro de entrada para abrir el autocompletado de comandos; los alias también se reconocen. Si una entrada con prefijo / no coincide con un comando integrado ni con un comando Skill, se envía al Agent como mensaje normal.
Cuenta y configuración
| Comando | Alias | Propósito |
|---|---|---|
/login | — | Selecciona una cuenta o plataforma e inicia sesión |
/logout | — | Borra las credenciales de la cuenta actual |
/provider | — | Abre el administrador de proveedores para ver, agregar y quitar proveedores configurados |
/model | — | Cambia el modelo LLM usado en la sesión actual |
/settings | /config | Abre el panel de configuración dentro de la TUI |
/experiments | /experimental | Abre el panel de funciones experimentales |
/permission | — | Selecciona un modo de permisos |
/editor | — | Configura el editor externo que se abre con Ctrl-G |
/theme | — | Cambia el tema de color de la interfaz de terminal |
Gestión de sesiones
| Comando | Alias | Propósito |
|---|---|---|
/new | /clear | Inicia una sesión nueva y descarta el contexto actual |
/sessions | /resume | Explora sesiones anteriores y cambia a una de ellas |
/tasks | /task | Explora la lista de tareas en segundo plano |
/fork | — | Bifurca una sesión nueva a partir de la conversación actual |
/title [...] | /rename | Muestra o define el título de la sesión actual |
/compact [...] | — | Compacta el contexto de la conversación; el texto opcional indica qué conservar |
/undo [n] | — | Deshace prompts recientes del contexto activo |
/reload | — | Recarga la sesión y aplica la configuración más reciente de config.toml y tui.toml |
/reload-tui | — | Recarga solo las preferencias de interfaz de tui.toml |
/init | — | Analiza el código base y genera AGENTS.md |
/export-md [...] | /export | Exporta la sesión actual como Markdown |
/export-debug-zip | — | Exporta la sesión actual como archivo ZIP de depuración |
Modos y control de ejecución
| Comando | Alias | Propósito |
|---|---|---|
/yolo [on\|off] | /yes | Activa o desactiva el modo YOLO; cuando está habilitado, omite la aprobación para llamadas normales a herramientas |
/auto [on\|off] | — | Activa o desactiva el modo de permisos automático; las aprobaciones se gestionan automáticamente y se omiten las preguntas |
/plan [on\|off] | — | Activa o desactiva Plan Mode; solo alternarlo no crea un archivo de plan vacío |
/plan clear | — | Borra el plan actual |
/swarm on\|off | — | Activa o desactiva el modo swarm sin enviar un prompt |
/swarm <task> | — | Activa el modo swarm, envía la tarea como prompt y luego desactiva el modo swarm después de un turno normal |
/goal [...] | — | Inicia o gestiona un objetivo autónomo |
Plan Mode está pensado para trabajos amplios, riesgosos o poco claros. Prioriza la exploración y la planificación antes de modificar archivos.
/plan on, deja que Kimi Code inspeccione el proyecto, revisa el plan propuesto y apruébalo antes de que se realicen cambios.Los subcomandos del modo Goal incluyen /goal status, /goal pause, /goal resume, /goal cancel, /goal replace <objective>, /goal next <objective> y /goal next manage.
Información y estado
| Comando | Alias | Propósito |
|---|---|---|
/help | /h, /? | Muestra los atajos de teclado y los comandos disponibles |
/btw [question] | — | Abre una conversación paralela en un sub-Agent bifurcado |
/usage | — | Muestra el uso de token, el consumo de contexto y la información de cuota |
/status | — | Muestra el estado de ejecución: versión, modelo, directorio de trabajo, modo de permisos y más |
/mcp | — | Enumera los servidores MCP y el estado de conexión |
/plugins | — | Abre el gestor de plugins |
/version | — | Muestra la versión de Kimi Code CLI |
/feedback | — | Envía comentarios sobre el producto |
/exit | /quit, /q | Sale de Kimi Code CLI |
Skills y extensiones
| Comando | Propósito |
|---|---|
/mcp-config | Configura servidores MCP y gestiona el inicio de sesión MCP OAuth |
/custom-theme [...] | Crea o edita un tema de color personalizado para la TUI |
/update-config | Inspecciona o edita config.toml y tui.toml |
/import-from-cc-codex | Importa instrucciones, Skills y ajustes de MCP de Claude Code y Codex |
/sub-skill | Descubre y reorganiza el inventario local de Skills |
/skill:name [extra text] | Invoca una Skill externa instalada |
/name [extra text] | Atajo para una Skill externa cuando ningún comando del sistema tiene el mismo nombre |
/parent.child [extra text] | Invoca una sub-skill externa expuesta con un nombre de comando con puntos |
Herramientas integradas
Las herramientas integradas las proporciona el propio Kimi Code CLI. De forma predeterminada, las herramientas de solo lectura como Read, Grep y Glob se permiten automáticamente; las herramientas que escriben archivos, ejecutan comandos, detienen tareas o crean programaciones normalmente requieren aprobación, a menos que tu modo de permisos las permita.
Archivos, shell y web
| Herramienta | Aprobación predeterminada | Propósito |
|---|---|---|
Read | Permitir automáticamente | Lee archivos de texto |
Write | Requiere aprobación | Crea o sobrescribe archivos |
Edit | Requiere aprobación | Reemplaza contenido exacto de archivos |
Grep | Permitir automáticamente | Busca contenido en archivos con ripgrep |
Glob | Permitir automáticamente | Busca archivos por patrón glob |
ReadMediaFile | Permitir automáticamente | Lee un archivo de imagen o video |
Bash | Requiere aprobación | Ejecuta comandos de shell |
WebSearch | Permitir automáticamente | Busca en la web cuando esté disponible |
FetchURL | Permitir automáticamente | Obtiene el contenido de una URL especificada |
Planificación, estado y colaboración
| Herramienta | Aprobación predeterminada | Propósito |
|---|---|---|
EnterPlanMode | Permitir automáticamente | Entrar en Plan Mode |
ExitPlanMode | Permitir automáticamente; el usuario confirma el plan | Salir de Plan Mode y enviar el plan |
TodoList | Permitir automáticamente | Gestiona una lista visible de tareas pendientes |
Agent | Permitir automáticamente | Crea un sub-Agent para una subtarea específica |
AgentSwarm | Permitir automáticamente en modo swarm; de lo contrario, puede requerir aprobación | Inicia subagents basados en elementos o reanuda subagents existentes |
AskUserQuestion | Permitir automáticamente | Formula preguntas estructuradas de opción múltiple |
Skill | Permitir automáticamente | Invoca una Skill inline registrada |
Tareas en segundo plano y programadas
| Herramienta | Aprobación predeterminada | Propósito |
|---|---|---|
TaskList | Permitir automáticamente | Lista tareas en segundo plano |
TaskOutput | Permitir automáticamente | Muestra la salida de una tarea en segundo plano |
TaskStop | Requiere aprobación | Detiene una tarea en segundo plano en ejecución |
CronCreate | Requiere aprobación | Programa un prompt para ejecutarse en el futuro |
CronList | Permitir automáticamente | Lista tareas programadas |
CronDelete | Requiere aprobación | Cancela una tarea programada |
Atajos de teclado
Escribe /help dentro de la TUI para ver la lista de atajos disponible en tu versión actual. Consulta la referencia de atajos de teclado oficial para ver la lista completa upstream.
Entrada general
| Atajo | Acción |
|---|---|
Enter | Enviar la entrada actual |
Shift-Enter / Ctrl-J | Insertar una nueva línea |
↑ / ↓ | Explorar el historial de entradas |
Esc | Cerrar una ventana emergente, cancelar el autocompletado o interrumpir el streaming / la compactación |
Ctrl-C | Interrumpir la salida en streaming o limpiar el cuadro de entrada |
Ctrl-D | Salir cuando el cuadro de entrada esté vacío |
Cambio de modo y edición
| Atajo | Acción |
|---|---|
Shift-Tab | Activar o desactivar Plan Mode |
Ctrl-G | Editar la entrada actual en un editor externo |
Ctrl-V | Pegar una imagen o video desde el portapapeles en Unix / macOS |
Alt-V | Pegar una imagen o video desde el portapapeles en Windows |
Ctrl-- | Deshacer la edición de la entrada |
Durante el streaming y la salida de herramientas
| Atajo | Acción |
|---|---|
Ctrl-S | Dirigir: inyecta la entrada actual en el turno en curso |
Esc | Interrumpir la salida en streaming actual |
Ctrl-C | Interrumpir la salida en streaming actual |
Ctrl-O | Expandir o contraer la salida de la herramienta |
Panel de aprobación y ventanas emergentes
| Atajo | Acción |
|---|---|
↑ / ↓ | Moverse entre opciones de aprobación o desplazarse por una ventana emergente |
Enter | Confirmar la opción de aprobación seleccionada; también cierra ventanas emergentes de ayuda |
1 – 9 | Seleccionar una opción de aprobación por número |
Esc / Ctrl-C / Ctrl-D | Rechazar la solicitud de aprobación actual |
Ctrl-E | Expandir o contraer el diff completo o el contenido de vista previa de archivos en el panel de aprobación |
PageUp / PageDown | Desplazarse por una ventana emergente de 10 líneas en 10 líneas |
q / Q | Cerrar una ventana emergente |
Flujos de trabajo comunes
Iniciar un repo nuevo
Planificar una refactorización antes de editar
Ejecutar una tarea en segundo plano
Luego abre /tasks para supervisar el trabajo en segundo plano, o deja que Kimi Code te avise cuando la tarea termine.
Retomar el trabajo de ayer
Si necesitas una sesión específica, ejecuta kimi --session o usa /sessions dentro de la TUI.
Exportar o depurar una sesión
Conclusión
Kimi Code CLI funciona mejor cuando lo tratas como un compañero de equipo en la terminal, con contexto explícito del proyecto. Empieza con /init, usa /plan para cambios grandes o inciertos, sigue las tareas largas con /tasks, ten /compact a la mano para sesiones extensas y elige un modo de permisos acorde al nivel de confianza del repositorio.
Preguntas frecuentes
kimi --continue en el mismo directorio del proyecto para continuar la sesión más reciente. Usa kimi --session [id] en la shell o /sessions dentro de la TUI para elegir una sesión específica.--yolo omite la aprobación para las llamadas habituales a herramientas. Úsalo solo en espacios de trabajo confiables y con control de versiones. En repositorios desconocidos o con datos de producción, mantén activadas las aprobaciones./skill:name, /mcp y /mcp-config para descubrirlos y configurarlos.