📦 Kimi Code CLI 详细部署与使用教程

Kimi Code CLI 是由月之暗面 (Moonshot AI) 开发的一款终端 AI 编程代理。它能直接在你的终端中运行，具备读写代码、执行 Shell 命令、搜索文件、抓取网页等能力，并能根据反馈自主决策下一步操作。它原生支持月之暗面的 Kimi 模型，也可配置为使用其他兼容的模型提供商。

⚙️ 部署前准备

基础环境：
- 操作系统：macOS、Linux 或 Windows。
- 终端：一个可用的命令行终端（PowerShell、bash、zsh 等）。
- （Windows 必须）Git for Windows：Kimi Code CLI 依赖其捆绑的 Git Bash 作为 Shell 环境。请从 Git 官网安装。如果安装路径非默认，需设置环境变量 KIMI_SHELL_PATH 指向 bash.exe 的绝对路径。
网络与账号：
- 能够访问互联网。
- 一个 Moonshot AI 开放平台 的账号或 Kimi Code 的 OAuth 授权。用于获取后续运行所需的凭证（API Key 或登录授权）。

🚀 安装 Kimi Code CLI

Kimi Code CLI 是一个单二进制文件，安装过程无需 Node.js 环境。根据你的操作系统，选择对应的安装命令。

在 macOS 或 Linux 上安装

打开终端，执行以下命令：

1	curl -fsSL https://code.kimi.com/kimi-code/install.sh \| bash

安装完成后，你需要开启一个新的终端会话，或手动将 Kimi Code CLI 的安装目录（通常为 ~/.local/bin）添加到你的 PATH 环境变量中。

在 Windows 上安装 (PowerShell)

以管理员身份或在普通 PowerShell 中执行：

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

注意：请确保在运行前已安装 Git for Windows，并按要求设置了 KIMI_SHELL_PATH（如果需要）。

验证安装

在新终端中运行以下命令，检查版本信息以确认安装成功：

1	kimi --version

🔐 首次运行与登录验证

启动 Kimi Code CLI
在你的项目目录中，输入 kimi 并回车，即可启动交互式界面（TUI）：
1
2
cd your-project
kimi
执行登录
在 Kimi Code CLI 界面中，输入命令 /login 并按回车。根据提示选择一种登录方式：
- Kimi Code OAuth：通过浏览器进行授权登录。
- Moonshot AI 开放平台 API Key：输入你在 Moonshot AI 开放平台生成的 API Key。

登录成功后，你就可以开始向 Kimi 下达编程任务了。尝试输入：

1	Take a look at this project and explain its main directories.

💻 在编辑器或 IDE 中使用 (ACP 协议)

Kimi Code CLI 支持 Agent Client Protocol (ACP)，这意味着你可以将其集成到支持该协议的编辑器和 IDE（如 Zed、JetBrains 系列）中，让 AI 代理直接在编辑器环境中工作。

以 Zed 编辑器为例

打开 Zed 的配置文件 ~/.config/zed/settings.json。

在其中添加以下配置：

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

保存配置，然后在 Zed 的 Agent 面板中新建一个对话，即可开始使用。

注意：在 IDE 中使用 kimi acp 子命令时，无需再次登录，它会沿用你之前在 CLI 中完成的登录凭证。

🧪 开发与调试 (为开发者)

如果你希望从源码运行或修改 Kimi Code CLI，需要进行以下设置。普通用户可跳过此部分。

安装依赖：
- Node.js (≥ 24.15.0)
- pnpm (10.33.0)

克隆与构建：

1
2
3

git clone https://github.com/MoonshotAI/kimi-code.git
cd kimi-code
pnpm install

常用开发命令：
- pnpm dev:cli：以开发模式运行 CLI。
- pnpm test：运行测试。
- pnpm typecheck：进行 TypeScript 类型检查。
- pnpm build：构建所有包。

❓ 常见问题 (FAQ)

kimi 命令找不到：安装脚本可能未将二进制文件目录添加到 PATH。找到安装目录（如 ~/.local/bin 或 ~/.kimi/bin），手动将其添加到你的 Shell 配置文件（如 .bashrc、.zshrc）中，或重启终端。
Windows 下启动报错：最常见原因是缺少 Git Bash 环境。请确保已安装 Git for Windows，并在设置中启用 “Git from the command line and also from 3rd-party software” 选项。
网络连接问题：Kimi Code CLI 需要与 Moonshot AI 的 API 通信。请确保你的网络环境能正常访问相关服务。如使用代理，可能需要设置 HTTP_PROXY 和 HTTPS_PROXY 环境变量。
升级 Kimi Code CLI：目前官方推荐的升级方式是重新运行安装脚本，它会覆盖旧版本。kimi 命令本身暂不包含内置的 upgrade 子命令。