Kimi Code CLI es el Agente de programación con IA para terminal y de código abierto de Moonshot AI: lee y edita código, ejecuta comandos de shell y planifica su siguiente paso a partir de tus comentarios. Esta referencia rápida reúne los comandos, comandos con barra, atajos de teclado, herramientas integradas y flujos de trabajo diarios de Kimi Code que los desarrolladores usan con mayor frecuencia. Mantenla abierta junto a tu terminal y usa /help dentro de Kimi Code o kimi --help en tu shell para consultar las funciones disponibles en tu versión actual.
Para conocer los detalles de origen, consulta las referencias oficiales de comando kimi, comandos con barra, 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 tus herramientas locales.
| 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 inicio, ya que Kimi Code CLI usa el Git Bash incluido como entorno de shell. Después de instalarlo, abre una terminal nueva y verifica el binario:
Comienza aquí
Usa este ciclo mínimo al ingresar a un proyecto por primera vez:
Usa --yolo, /yolo y /auto solo en espacios de trabajo en los que confíes. Reducen la necesidad de aprobaciones, pero también permiten que Kimi Code actúe con mayor autonomía.
Comandos más usados
Si solo memorizas unos cuantos, que sean estos: cubren la mayoría de las sesiones cotidianas.
| 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 una sola solicitud sin abrir la TUI |
/login | Inicia sesión en la primera ejecución |
/init | Genera o actualiza AGENTS.md |
/plan on | Ingresa al 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 retoma sesiones anteriores |
/help | Enumera todos los comandos y atajos |
Shift-Tab | Activa o desactiva el Modo de planificación |
Inicio y automatización
Opciones principales de la CLI
| Comando / Opción | 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] | Retoma una sesión por ID o abre el selector de sesiones si no se proporciona un ID |
kimi -p "...", kimi --prompt "..." | Ejecuta una sola instrucción no interactiva 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 nueva sesión en modo Plan |
kimi --yolo, kimi -y | Aprueba automáticamente las llamadas habituales a herramientas; úsalo solo en directorios de confianza |
kimi --auto | Inicia en modo de permisos automáticos; las aprobaciones se gestionan automáticamente y el Agente no hará preguntas |
--skills-dir <dir> | Carga Skills desde el directorio especificado, reemplazando los directorios de habilidades de usuario y proyecto detectados automáticamente para este inicio |
Ejemplos no interactivos
Subcomandos de la CLI
| Subcomando | Propósito |
|---|---|
kimi login | Inicia el inicio de sesión mediante código de dispositivo OAuth de Kimi Code sin entrar a la TUI |
kimi acp | Ejecuta Kimi Code como servidor de Agent Client Protocol para la integración con IDE |
kimi doctor | Valida config.toml y tui.toml |
kimi export [sessionId] | Empaqueta una sesión en un archivo ZIP |
kimi rc | Abre la interfaz web mediante Remote Control (alias kimi remote) |
kimi session list | Listar sesiones para scripts |
kimi upgrade | Buscar la versión más reciente y mostrar opciones de actualización |
kimi web | Ejecutar la interfaz web local y el servicio de API REST/WebSocket |
Interfaz web y acceso remoto:
Comandos con barra
Los comandos con barra son controles integrados de la TUI. Escribe / en el cuadro de entrada para abrir la autocompletación de comandos; también se reconocen los alias. Si una entrada que comienza con / no coincide con un comando integrado ni con un comando de Skill, se envía al Agente como un mensaje normal.
Cuenta y configuración
| Comando | Alias | Propósito |
|---|---|---|
/login | — | Iniciar sesión mediante OAuth de kimi.ai / kimi.com o una clave de API |
/logout | — | Borrar las credenciales de la cuenta actual |
/provider | — | Abrir el administrador de proveedores para ver, agregar y eliminar proveedores configurados |
/model | — | Cambiar el modelo LLM usado en la sesión actual |
/effort | — | Cambiar el nivel de esfuerzo de razonamiento (desactivado/bajo/alto/máximo) |
/secondary-model | — | Configurar el grupo de modelos de subagentes |
/settings | /config | Abrir el panel de configuración dentro de la TUI |
/experiments | /experimental | Abrir el panel de funciones experimentales |
/permission | — | Seleccionar un modo de permisos |
/editor | — | Configurar el editor externo que se abre con Ctrl-G |
/theme | — | Cambiar el tema de colores de la interfaz de terminal |
/remote-control | /rc | Acceder de forma remota a una sesión web local |
Gestión de sesiones
| Comando | Alias | Propósito |
|---|---|---|
/new | /clear | Inicia una sesión nueva y descarta el contexto actual |
/sessions | /resume | Explora las sesiones anteriores y cambia a una de ellas |
/tasks | /task | Explora la lista de tareas en segundo plano |
/fork | — | Crea una bifurcación de la sesión actual y permanece en esta sesión |
/title [...] | /rename | Muestra o establece 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 los 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 únicamente las preferencias de la interfaz de usuario de tui.toml |
/init | — | Analiza la base de código y genera AGENTS.md |
/export-md [...] | /export | Exporta la sesión actual como Markdown |
/export-debug-zip | — | Exporta la sesión actual como un archivo ZIP de depuración |
Modos y control de ejecución
| Comando | Alias | Propósito |
|---|---|---|
/yolo | /yes | Cambia al modo Preguntar cuando sea necesario: las acciones rutinarias se ejecutan automáticamente, pero las riesgosas siguen requiriendo confirmación |
/auto | — | Cambia al modo Nunca preguntar: todo se ejecuta automáticamente |
/plan [on\|off] | — | Activa o desactiva el modo Plan; solo alternarlo no crea un archivo de plan vacío |
/plan clear | — | Borra el plan actual |
/tower | — | Orquestación de worktrees con varios agentes (experimental; actívala en /experiments) |
/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 tras un turno normal |
/goal [...] | — | Inicia o administra un objetivo autónomo |
El modo Plan es 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 realizar cambios.Los subcomandos del modo de objetivos 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 subagente 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 | — | Lista los servidores MCP y el estado de conexión |
/plugins | — | Abre el administrador 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
Un solo prompt puede activar varias Skills.
| Comando | Propósito |
|---|---|
/mcp-config | Configura los servidores MCP y gestiona el inicio de sesión de MCP OAuth |
/custom-theme [...] | Crea o edita un tema de colores personalizado para la TUI |
/update-config | Inspecciona o edita config.toml y tui.toml |
/import-from-cc-codex | Importa instrucciones, Skills y configuraciones de MCP de Claude Code y Codex |
/skill:name [extra text] | Invoca un Skill externo instalado |
/name [extra text] | Atajo para un Skill externo cuando ningún comando del sistema tiene el mismo nombre |
/parent.child [extra text] | Invoca una subhabilidad externa expuesta con un nombre de comando con punto |
Herramientas integradas
Las herramientas integradas las proporciona Kimi Code CLI. Las herramientas de solo lectura, como Read, Grep y Glob, se permiten automáticamente de forma predeterminada; las herramientas que escriben archivos, ejecutan comandos, detienen tareas o crean programaciones normalmente requieren aprobación, salvo que tu modo de permisos las permita.
Archivos, shell y web
| Herramienta | Aprobación predeterminada | Propósito |
|---|---|---|
Read | Permitir automáticamente | Leer archivos de texto |
Write | Requiere aprobación | Crear o sobrescribir archivos |
Edit | Requiere aprobación | Reemplazar el contenido exacto de un archivo |
Grep | Permitir automáticamente | Buscar contenido de archivos con ripgrep |
Glob | Permitir automáticamente | Buscar archivos por patrón glob |
ReadMediaFile | Permitir automáticamente | Leer un archivo de imagen o video |
Bash | Requiere aprobación | Ejecutar comandos de shell |
WebSearch | Permitir automáticamente | Buscar en la web cuando esté disponible |
FetchURL | Permitir automáticamente | Obtener el contenido de una URL especificada |
Planificación, estado y colaboración
| Herramienta | Aprobación predeterminada | Propósito |
|---|---|---|
EnterPlanMode | Permitir automáticamente | Entrar al modo de planificación |
ExitPlanMode | Permitir automáticamente; el usuario confirma el plan | Salir del modo de planificación y enviar el plan |
TodoList | Permitir automáticamente | Gestionar una lista visible de tareas pendientes |
Agent | Permitir automáticamente | Crear un sub-Agente para una subtarea específica |
AgentSwarm | Permitir automáticamente en modo swarm; de lo contrario, puede requerir aprobación | Iniciar subagentes basados en elementos o reanudar subagentes existentes |
AskUserQuestion | Permitir automáticamente | Hacer preguntas estructuradas de opción múltiple |
Skill | Permitir automáticamente | Invocar una Skill integrada registrada |
Tareas en segundo plano y programadas
| Herramienta | Aprobación predeterminada | Propósito |
|---|---|---|
TaskList | Permitir automáticamente | Enumerar tareas en segundo plano |
TaskOutput | Permitir automáticamente | Ver el resultado de una tarea en segundo plano |
WaitFor | Permitir automáticamente | Esperar tareas en segundo plano en el turno actual |
TaskStop | Requiere aprobación | Detener una tarea en segundo plano en ejecución |
CronCreate | Requiere aprobación | Programar la ejecución de un prompt en el futuro |
CronList | Permitir automáticamente | Listar tareas programadas |
CronDelete | Requiere aprobación | Cancelar una tarea programada |
Atajos de teclado
Escribe /help en la TUI para ver la lista de atajos disponible en tu versión actual. Consulta la referencia oficial de atajos de teclado para ver la lista completa de origen.
Entrada general
| Atajo | Acción |
|---|---|
Enter | Enviar la entrada actual |
Shift-Enter / Ctrl-J | Insertar un salto de línea |
↑ / ↓ | Explorar el historial de entradas |
Esc | Cerrar una ventana emergente, cancelar la finalización o interrumpir la transmisión / compactación |
Ctrl-C | Interrumpir la salida en transmisión o borrar 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 | Alternar el modo Plan |
Ctrl-G | Editar la entrada actual en un editor externo |
Ctrl-V | Pegar una imagen o un video desde el portapapeles en Unix / macOS |
Alt-V | Pegar una imagen o un video desde el portapapeles en Windows |
Ctrl-- | Deshacer la edición de entrada |
Durante la transmisión y la salida de herramientas
| Atajo | Acción |
|---|---|
Ctrl-S | Dirigir: inyectar la entrada actual en el turno en curso |
Esc | Interrumpir la salida en transmisión actual |
Ctrl-C | Interrumpir la salida en transmisión actual |
Ctrl-O | Expandir o contraer la salida de la herramienta |
Ctrl-B | Mover el comando de shell en ejecución a una tarea en segundo plano |
Panel de aprobación
| Atajo | Acción |
|---|---|
↑ / ↓ | Moverse entre las opciones de aprobación |
Enter | Confirmar la opción de aprobación seleccionada |
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 o la vista previa del archivo en revisión |
Ventanas emergentes y ayuda
| Atajo | Acción |
|---|---|
PageUp / PageDown | Desplazarse 10 líneas a la vez en una ventana emergente |
q / Q | Cerrar una ventana emergente |
Enter | Cerrar una ventana emergente de ayuda |
Flujos de trabajo comunes
Inicia un repositorio nuevo
Planifica una refactorización antes de editar
Ejecuta una tarea en segundo plano
Luego abre /tasks para supervisar el trabajo en segundo plano, o deja que Kimi Code te avise cuando se complete la tarea.
Retoma el trabajo de ayer
Si necesitas una sesión específica, ejecuta kimi --session o usa /sessions dentro de la TUI.
Exporta o depura una sesión
Conclusión
Kimi Code CLI funciona mejor si lo tratas como un compañero de equipo en la terminal y le das un contexto explícito del proyecto. Empieza con /init, usa /plan para cambios grandes o inciertos, supervisa el trabajo de larga duración con /tasks, ten /compact a la mano para sesiones largas y elige un modo de permisos que corresponda 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 el shell o /sessions dentro de la TUI para elegir una sesión específica.--yolo omite la aprobación de las llamadas habituales a herramientas. Úsalo solo en espacios de trabajo confiables y bajo control de versiones. En repositorios desconocidos o con datos de producción, mantén las aprobaciones activadas./skill:name, /mcp y /mcp-config para descubrirlas y configurarlas.