Kimi Code — Flags del CLI
Flags de arranque del comando kimi (ejecuta kimi --help para ver la lista integrada). Son flags de shell, no comandos slash de la TUI — la diferencia está explicada en Comandos de terminal.
Sesión
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--session [id] (-S) | Retoma una sesión; con un ID la abre directamente, sin ID abre un selector interactivo | kimi -S 3fa9… |
--continue (-c) | Continúa la sesión más reciente del directorio actual | kimi -c |
--resume (-r) | Alias oculto de --session | kimi -r |
Modelos
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--model <modelo> (-m) | Alias de modelo para este arranque; si no, se usa el default_model de la configuración | kimi -m k3 |
Permisos
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--yolo (-y) | Arranca en modo Ask When Needed: las operaciones rutinarias se ejecutan solas, las arriesgadas siguen preguntando | kimi -y |
--auto | Arranca en modo Never Ask (totalmente desatendido) | kimi --auto |
--yes, --auto-approve | Alias ocultos de --yolo | kimi --yes |
Antes de usarlos, lee los avisos de seguridad de Permisos.
Contexto
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--add-dir <dir> | Directorio de workspace adicional; repetible; las rutas relativas se resuelven desde el directorio actual | kimi --add-dir ../shared-lib |
Salida
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--output-format <formato> | text (por defecto) o stream-json; sólo válido junto con --prompt | kimi -p "…" --output-format stream-json |
Depuración
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--version (-V) | Imprime la versión y sale | kimi -V |
--help (-h) | Muestra la ayuda y sale | kimi -h |
Para diagnósticos más a fondo tienes kimi doctor y kimi export (Comandos de terminal) y la variable de entorno KIMI_LOG_LEVEL (Configuración).
Automatización
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--prompt <prompt> (-p) | Prompt único no interactivo; manda la salida del asistente a stdout; sin TUI | kimi -p "arregla el test que falla" |
--plan | Arranca la sesión nueva en modo plan | kimi --plan |
Detalles del modo no interactivo: el texto del asistente va a stdout, mientras que el razonamiento, el progreso de las herramientas y los avisos de reanudación van a stderr; no hay aprobación humana — se aplica la política de permisos auto, y las reglas estáticas de denegación siguen vigentes; stream-json emite un objeto JSON por línea.
Integraciones
| Flag | Para qué sirve | Ejemplo |
|---|---|---|
--skills-dir <dir> | Sustituye los directorios de skills descubiertos automáticamente en este arranque; repetible | kimi --skills-dir ./team-skills |
--agent <nombre> | Arranca una sesión nueva con un agente con nombre como agente principal | kimi --agent reviewer |
--agent-file <ruta> | Carga un agente propio desde un archivo Markdown para una sesión nueva; no es repetible | kimi --agent-file ./agents/reviewer.md |
Para integrarse con un IDE existe el subcomando kimi acp en lugar de un flag; ver Comandos de terminal.
Reglas de conflicto
Se rechazan al arrancar:
--continuey--sessionson mutuamente excluyentes.--yoloy--autoson mutuamente excluyentes.--promptno se puede combinar con--yolo/--auto/--plan(el modo no interactivo ya usa permisos automáticos por defecto).--output-formatsólo funciona junto a--prompt.--agentno se puede combinar con--session/--continue;--agent-fileno se puede combinar con--agent,--sessionni--continue.
? No se ha podido verificar: si --yolo/--plan se pueden combinar con --continue/--session al retomar una sesión. La referencia del comando kimi dice que al retomar se puede sobrescribir el modo guardado (por ejemplo kimi --continue --auto); la página de overrides afirma que --yolo y --plan no se pueden combinar con --continue/--session fuera del modo prompt. Las dos páginas oficiales se contradicen.
Última verificación: 2026-09-07
Fuentes oficiales:
- https://www.kimi.com/code/docs/en/kimi-code-cli/reference/kimi-command.html
- https://www.kimi.com/code/docs/en/kimi-code-cli/configuration/overrides.html
- https://www.kimi.com/code/docs/en/kimi-code-cli/guides/sessions.html
Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.