Tutorial de instalación de Kimi Code CLI en Windows: inicio de sesión, MCP, ACP y migración desde el antiguo Kimi CLI

Moonshot AI está migrando la CLI Kimi heredada a la CLI Kimi Code de nueva generación. La nueva versión es un agente de programación de IA terminal que puede leer y modificar código, ejecutar Shell, buscar archivos, acceder a páginas web y admite MCP, complementos, subagentes, ganchos y acceso al editor ACP.

Dirección del proyecto: MoonshotAI/kimi-code

Instalación rápida de Windows

Primero instale Git para Windows. Kimi Code CLI usa Git Bash como entorno de shell en Windows y luego ejecuta el script de instalación oficial en PowerShell:

1

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Cierra y vuelve a abrir la terminal para comprobar la versión:

1

kimi --version

Si Git Bash está instalado en un directorio personalizado, debe configurar KIMI_SHELL_PATH en la ruta absoluta de bash.exe.

Inicie sesión y ejecute por primera vez

Comience después de ingresar al directorio del proyecto:

1
2

cd C:\Work\your-project
kimi

Cuando lo ejecute por primera vez, ingrese /login en la interfaz interactiva y podrá elegir la clave API de plataforma abierta Kimi Code OAuth o Moonshot AI. Después de iniciar sesión, primero use la tarea de solo lectura para verificar:

1

读取这个项目，说明主要目录和启动入口，不要修改文件。

Después de confirmar que la identificación de la ruta es correcta, entréguele la tarea de modificación a pequeña escala.

Cómo migrar la antigua CLI de Kimi

Las instrucciones oficiales indican que la instalación de Kimi Code CLI migrará automáticamente las configuraciones y sesiones antiguas, y el antiguo repositorio dejará de recibir mantenimiento gradualmente. Antes de la migración, aún se recomienda hacer una copia de seguridad del directorio de configuración original y registrar el proveedor personalizado, el servidor MCP y las rutas del espacio de trabajo.

Comprobaciones clave después de la migración:

1. Si kimi --version apunta a la nueva versión;
2. Si el estado /login es válido;
3. Si el servicio MCP aún se puede conectar;
4. Si se puede abrir la sesión anterior;
5. ¿Son correctas las rutas de Git Bash y del proyecto?

¿Cuál es la diferencia entre MCP y ACP?

MCP se utiliza para agregar herramientas externas y fuentes de datos al Agente. La nueva versión se puede configurar de forma conversacional a través de /mcp-config. ACP permite a editores como Zed y JetBrains iniciar directamente sesiones CLI de Kimi Code.

Los comandos de servicio del ACP son:

1

kimi acp

/login debe completarse una vez en la terminal antes de usar ACP. La configuración del editor solo es responsable de iniciar el proceso y no debe escribir la clave API en texto plano en el repositorio del proyecto.

Cómo comprobar antes de ejecutar el script de instalación

irm ... | iex de PowerShell ejecutará directamente el contenido de retorno de la red. Un enfoque más seguro es abrir el script de instalación en un navegador o descargarlo y verificarlo antes de ejecutarlo. Aspectos destacados:

• Si la fuente de descarga es code.kimi.com;
• ¿En qué directorio se debe instalar el binario?
• Cómo modificar PATH;
• Si se escribe la configuración de Shell;
• Métodos de actualización y desinstalación;
• Si se requieren privilegios de administrador.

Las computadoras corporativas también deben confirmar las políticas de seguridad de los terminales, los agentes y las fuentes de instalación de Git para Windows. No desactive temporalmente la protección del sistema para instalarlo.

¿Qué debes hacer al ingresar al proyecto por primera vez?

Comience primero con tareas de solo lectura, no pida directamente “arreglar todo”. Pasos recomendados:

1. Ejecute kimi en el directorio raíz del repositorio de Git;
2. Deje que solo lea la estructura del directorio y la descripción del proyecto;
3. Confirme el directorio de trabajo que identifica;
4. Solicite una lista de los archivos que se van a leer;
5. Dale un cambio pequeño y verificable;
6. Revise git diff y los resultados de la prueba cuando esté completo.

Una buena primera tarea de modificación es corregir enlaces de documentación, agregar pruebas unitarias o modificar componentes individuales. Las actualizaciones de dependencias, las migraciones de bases de datos y los formatos globales no son adecuados para la primera verificación.

Cómo elegir el método de inicio de sesión

Código Kimi OAuth

Adecuado para uso interactivo personal y configuración sencilla. Preste atención a si las suscripciones de cuentas, las cuotas de llamadas y las políticas organizativas cubren el uso de CLI.

Clave API de Moonshot AI

Adecuado para escenarios que requieren facturación independiente, automatización o gestión de equipos. La clave debe colocarse en la configuración del usuario o en las variables del entorno de seguridad y no debe enviarse al repositorio.

De cualquier manera, se debe realizar una solicitud real después de la migración. El hecho de que la interfaz muestre “Iniciado sesión” no significa que el modelo, la región y la cuota estén definitivamente disponibles.

Configuración y verificación de MCP

La nueva versión recomienda principalmente administrar MCP a través de /mcp-config, mientras que la antigua CLI de Kimi también proporciona comandos kimi mcp. No mezcle dos conjuntos de documentos al migrar usuarios; Primero use kimi --version para confirmar el producto actual y luego verifique la ayuda de la versión correspondiente.

Siga este orden al agregar el servidor MCP:

1. Lea el repositorio del servidor y la descripción de los permisos;
2. Instale primero en el proyecto de prueba;
3. No transferir el Token de producción real;
4. Ver la lista de herramientas que expone;
5. Ejecute una llamada de solo lectura;
6. Confirme que el registro no generará credenciales;
7. Finalmente, se abren las herramientas de escritura.

MCP puede ampliar las capacidades del agente y también ampliar la superficie de ataque. Los archivos, navegadores, bases de datos y servidores de plataformas en la nube no deben tener por defecto el mismo nivel de confianza.

Usando ACP con Zed o JetBrains

ACP permite al editor iniciar Kimi Code CLI a través de entrada y salida estándar. Tomando a Zed como ejemplo, la estructura de configuración es la siguiente:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
  "agent_servers": {
    "Kimi Code CLI": {
      "type": "custom",
      "command": "kimi",
      "args": ["acp"],
      "env": {}
    }
  }
}

Si el editor indica que el inicio del proceso falló, primero ejecute en la terminal del mismo entorno de usuario:

1

kimi acp

Las razones comunes incluyen que el editor no herede la última versión PATH, que kimi se instale en un directorio de usuario diferente, que no se encuentre Git Bash o que /login no se haya completado aún.

¿Para qué escenarios es adecuada la entrada de vídeo?

Kimi Code CLI admite la realización de grabaciones de pantalla o vídeos de demostración como entrada. Es adecuado para explicar comportamientos de la interfaz de usuario que son difíciles de describir con palabras, como ritmos de animación, pasos de replicación y efectos de referencia.

Recorte el vídeo antes de usarlo para evitar cargar información de la cuenta, notificaciones, tokens, datos de clientes y áreas irrelevantes del escritorio. El hecho de que el Agente pueda “entender el vídeo” no significa que pueda acceder automáticamente al sistema que aparece en el vídeo. Las modificaciones reales aún están limitadas por el espacio de trabajo actual y los permisos de las herramientas.

Cómo habilitar subagentes y ganchos de forma segura

Los subagentes integrados coder, explore y plan pueden separar contextos, pero varios agentes aún pueden operar el mismo espacio de trabajo. La tarea debe especificar:

• explore solo lectura;
• plan no escribe archivos;
• coder solo modifica el directorio especificado;
• Se debe confirmar la eliminación, instalación y Git push;
• Una vez completado, vea las diferencias de manera uniforme desde la sesión principal.

Lifecycle Hooks se puede utilizar para bloquear comandos de alto riesgo, registrar llamadas a herramientas y enviar notificaciones. La configuración de Hook en sí también es un límite ejecutable y debe revisarse antes de instalar Hooks de terceros.

Lista de verificación de migración heredada

Cómo reducir riesgos al actualizar

Las actualizaciones de CLI pueden cambiar las solicitudes de permiso, las interfaces de complementos y los formatos de configuración. Haga una copia de seguridad de la configuración antes de actualizar y consulte las instrucciones de versión y migración; después de la actualización, primero realice tareas de solo lectura en el repositorio de prueba. Si el equipo depende de flujos de trabajo fijos, no haga que todos los miembros actualicen automáticamente en diferentes momentos.

Orden de solución de problemas

Preguntas frecuentes sobre Windows

El mensaje no puede encontrar kimi

Primero abra una nueva terminal y luego verifique si PATH se ha agregado al directorio de instalación. No ejecute el script de instalación repetidamente en la ventana anterior.

Preguntar que no se puede encontrar Bash

Confirme que Git para Windows esté instalado y marque KIMI_SHELL_PATH. La ruta debe apuntar al bash.exe real, no a la GUI de Git o git.exe.

¿Qué debe hacer el Agente si quiere ejecutar comandos peligrosos?

No autorices toda la sesión a la vez. Primero verifique el comando, el directorio de trabajo y la ruta de destino; confirme por separado al eliminar, sobrescribir, insertar o instalar software global. La nueva versión admite Hooks de ciclo de vida, que pueden interceptar aún más llamadas a herramientas de alto riesgo.

¿Puedo conservar la antigua CLI de Kimi después de instalar la nueva versión?

Los dos pueden compartir nombres de comandos y configuraciones. La dirección oficial es migrar a Kimi Code CLI; Cuando necesite revertir, debe confiar en la copia de seguridad previa a la migración y en las instrucciones oficiales de desinstalación. No se recomienda confiar en la secuencia PATH para probar suerte después de una convivencia prolongada.

¿Por qué se puede ejecutar en PowerShell pero no en el editor?

El editor generalmente se inicia antes de la instalación sin leer las variables de entorno del usuario actualizadas. Salga por completo y vuelva a abrir el editor, confirmando la cuenta y el entorno de terminal que está utilizando.

Resumen

La clave para instalar Kimi Code CLI en Windows es preparar Git Bash primero y luego completar /login y la verificación de solo lectura. Los usuarios antiguos de Kimi CLI deben migrar lo antes posible, pero no se limiten a mirar “instalación exitosa”, sino que también verifiquen la sesión, MCP, proveedor y rutas del proyecto, elemento por elemento.