Kimi Code CLI Windows 安装教程：登录、MCP、ACP 与旧 Kimi CLI 迁移

Moonshot AI 正在把旧版 Kimi CLI 迁移到新一代 Kimi Code CLI。新版本是终端 AI 编程 Agent，可读取和修改代码、运行 Shell、搜索文件、访问网页，并支持 MCP、插件、子 Agent、Hooks 和 ACP 编辑器接入。

项目地址：MoonshotAI/kimi-code

Windows 快速安装

先安装 Git for Windows。Kimi Code CLI 在 Windows 上使用 Git Bash 作为 Shell 环境，然后在 PowerShell 执行官方安装脚本：

1

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

关闭并重新打开终端，检查版本：

1

kimi --version

如果 Git Bash 安装在自定义目录，需要把 KIMI_SHELL_PATH 设置为 bash.exe 的绝对路径。

首次登录和运行

进入项目目录后启动：

1
2

cd C:\Work\your-project
kimi

首次运行在交互界面输入 /login，可以选择 Kimi Code OAuth 或 Moonshot AI 开放平台 API Key。登录后先用只读任务验证：

1

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

确认路径识别正确后，再交给它小范围修改任务。

旧 Kimi CLI 怎样迁移

官方说明安装 Kimi Code CLI 会自动迁移旧版配置和会话，旧仓库将逐步停止维护。迁移前仍建议备份原配置目录，并记录自定义 Provider、MCP Server 与工作区路径。

迁移后重点检查：

1. kimi --version 是否指向新版本；
2. /login 状态是否有效；
3. MCP 服务是否仍能连接；
4. 旧会话能否打开；
5. Git Bash 与项目路径是否正确。

MCP 和 ACP 有什么区别

MCP 用来给 Agent 增加外部工具和数据源，新版可以通过 /mcp-config 对话式配置。ACP 则让 Zed、JetBrains 等编辑器直接启动 Kimi Code CLI 会话。

ACP 服务命令是：

1

kimi acp

使用 ACP 前应先在终端完成一次 /login。编辑器配置只负责启动进程，不应把 API Key 明文写进项目仓库。

安装脚本执行前怎样检查

PowerShell 的 irm ... | iex 会直接执行网络返回内容。更稳妥的做法是先在浏览器打开安装脚本或下载后检查，再运行。重点查看：

• 下载来源是否为 code.kimi.com；
• 二进制安装到哪个目录；
• 如何修改 PATH；
• 是否写入 Shell 配置；
• 升级和卸载方式；
• 是否要求管理员权限。

企业电脑还要确认终端安全策略、代理和 Git for Windows 安装来源。不要为了通过安装临时关闭系统防护。

第一次进入项目应该做什么

先从只读任务开始，不要直接要求“修复所有问题”。推荐步骤：

1. 在 Git 仓库根目录运行 kimi；
2. 让它只读取目录结构和项目说明；
3. 确认它识别的工作目录；
4. 要求列出准备读取的文件；
5. 再交给它一个可验证的小改动；
6. 完成后查看 git diff 和测试结果。

一个合适的首个修改任务是修正文档链接、增加单元测试或调整单个组件。依赖升级、数据库迁移和全局格式化不适合作为首次验证。

登录方式如何选择

Kimi Code OAuth

适合个人交互使用，配置简单。要注意账号订阅、调用额度和组织策略是否覆盖 CLI 使用。

Moonshot AI API Key

适合需要独立计费、自动化或团队管理的场景。Key 应放在用户配置或安全环境变量中，不要提交到仓库。

无论哪种方式，迁移后都应执行一次实际请求。界面显示“已登录”不代表模型、地区和配额一定可用。

MCP 配置与验证

新版主推通过 /mcp-config 管理 MCP，而旧 Kimi CLI 还提供 kimi mcp 命令。迁移用户不要混用两套文档；先用 kimi --version 确认当前产品，再查看对应版本帮助。

添加 MCP Server 时按以下顺序：

1. 阅读 Server 仓库与权限说明；
2. 先在测试项目安装；
3. 不传真实生产 Token；
4. 查看它暴露的工具列表；
5. 执行一次只读调用；
6. 确认日志不会输出凭据；
7. 最后才开放写入类工具。

MCP 能扩大 Agent 能力，也会扩大攻击面。文件、浏览器、数据库和云平台 Server 不应默认得到相同信任级别。

在 Zed 或 JetBrains 中使用 ACP

ACP 让编辑器通过标准输入输出启动 Kimi Code CLI。以 Zed 为例，配置结构如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

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

若编辑器提示进程启动失败，先在同一个用户环境的终端执行：

1

kimi acp

常见原因包括编辑器没有继承最新 PATH、kimi 安装在不同用户目录、Git Bash 找不到，或尚未完成 /login。

视频输入适合哪些场景

Kimi Code CLI 支持把屏幕录制或演示视频作为输入。它适合解释难以用文字描述的 UI 行为，例如动画节奏、复现步骤和参考效果。

使用前先裁剪视频，避免上传账号信息、通知、Token、客户数据和无关桌面区域。Agent 能“看懂视频”不代表能自动访问视频中出现的系统，真正修改仍受当前工作区和工具权限限制。

子 Agent 和 Hooks 怎样安全启用

内置 coder、explore 和 plan 子 Agent 可以分离上下文，但多个 Agent 仍可能操作同一工作区。任务中应明确：

• explore 只读；
• plan 不写文件；
• coder 只修改指定目录；
• 删除、安装和 Git 推送必须确认；
• 完成后由主会话统一查看差异。

Lifecycle Hooks 可用于阻止高风险命令、记录工具调用和发送通知。Hook 配置本身也是可执行边界，安装第三方 Hook 前必须审查。

旧版迁移检查表

更新时怎样降低风险

CLI 更新可能改变权限提示、插件接口和配置格式。升级前备份配置，查看 Release 与迁移说明；升级后先在测试仓库执行只读任务。若团队依赖固定工作流，不要所有成员在不同时间自动升级。

排错顺序

Windows 常见问题

提示找不到 kimi

先新开终端，再检查安装目录是否已加入 PATH。不要在旧窗口里反复执行安装脚本。

提示找不到 Bash

确认 Git for Windows 已安装，并检查 KIMI_SHELL_PATH。路径应指向真实的 bash.exe，不是 Git GUI 或 git.exe。

Agent 要执行危险命令怎么办？

不要一次授权整个会话。先查看命令、工作目录和目标路径；涉及删除、覆盖、推送或安装全局软件时单独确认。新版支持生命周期 Hooks，可以进一步拦截高风险工具调用。

安装新版后还能保留旧 Kimi CLI 吗？

两者可能共享命令名和配置。官方方向是迁移到 Kimi Code CLI；需要回退时应依赖迁移前备份和官方卸载说明，不建议长期并存后依靠 PATH 顺序碰运气。

为什么在 PowerShell 能运行，在编辑器里不能？

编辑器通常在安装前就已启动，没有读取更新后的用户环境变量。完全退出并重新打开编辑器，再确认它使用的账户和终端环境。

总结

Windows 安装 Kimi Code CLI 的关键是先准备 Git Bash，再完成 /login 和只读验证。旧 Kimi CLI 用户应尽早迁移，但不要只看“安装成功”，还要逐项核对会话、MCP、Provider 和项目路径。