辅助软件开发任务和终端操作的命令行代理工具 Kimi CLI

Kimi CLI是能辅助软件开发任务和终端操作的命令行代理工具，提供Shell-like的用户界面，支持直接执行原始Shell命令（用户可通过快捷键切换模式），与Zsh Shell深度集成以赋能AI代理能力，原生支持Agent Client Protocol (ACP)以实现与兼容编辑器或IDE的协同工作，支持MCP配置约定来连接指定的MCP服务器。Kimi CLI作为一个Python包发布，主要支持macOS和Linux系统。

• 支持类 Shell 界面与原生 Shell 命令执行

• 可与 Zsh 集成

• 兼容代理客户端协议（Agent Client Protocol）

• 支持 MCP（多控制协议）

Kimi CLI 安装

适用系统

当前 Kimi CLI 仅支持 macOS 和 Linux 系统，Windows 系统的支持正在开发中。

安装前提

Kimi CLI 以 Python 包形式发布在 PyPI 上，推荐使用 uv 工具进行安装。若尚未安装 uv，需先按照官方指引完成 uv 安装。

安装命令

完成 uv 安装后，执行以下命令安装 Kimi CLI：

uv tool install --python 3.13 kimi-cli

安装完成后，运行 kimi --help 命令，可检查工具是否安装成功。

受 macOS 系统安全检查机制影响，首次运行 kimi 命令时，可能需要 10 秒甚至更长时间，具体耗时取决于系统环境配置。

Kimi CLI 升级

若需将 Kimi CLI 更新到最新版本，执行以下命令即可：

uv tool upgrade kimi-cli --no-cache

Kimi CLI 使用指南

基础启动与配置

在需要操作的目录下运行 kimi 命令，然后发送 /setup 指令完成 Kimi CLI 的初始化配置：

playground -kimi -kimi -kimi-96x26
playground kimi
Welcome to Kimi CLI! Send /help for help information.
Directory: /Users/moonshot/Projects/playground Session: b74d8691-491e-4666-a06c-609e8dd3cf59 Model: not set, send /setup to configure
[moonshot /setup

执行配置指令后，会出现 API 平台选择界面：

1、Kimi For Coding

2、Moonshot AI 开放平台

3、Moonshot AI Open Platform

完成配置后，Kimi CLI 即可正常使用。发送 /help 指令，能获取更多使用相关的信息。

Shell 模式

Kimi CLI 不仅是编码代理工具，还具备 Shell 终端功能。按下 Ctrl-X 键可切换至 Shell 模式，在该模式下，无需退出 Kimi CLI，直接输入并运行 Shell 命令。

目前暂不支持 cd 等内置 Shell 命令。

Zsh 集成

Kimi CLI 可与 Zsh 配合使用，为 Shell 体验增添 AI 代理能力。安装步骤如下：

1、执行以下命令克隆 zsh-kimi-cli 插件：

git clone https://github.com/MoonshotAI/zsh-kimi-cli.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/kimi-cli

若使用 Oh My Zsh 之外的插件管理器，需参考对应插件的 README 文档完成安装。

2、在 ~/.zshrc 文件的 Zsh 插件列表中添加 kimi-cli：

plugins=(..、kimi-cli)

3、重启 Zsh 后，按下 Ctrl-X 键可切换至代理模式。

ACP 支持

Kimi CLI 原生支持代理客户端协议（ACP），可与任何兼容 ACP 的编辑器或 IDE 搭配使用。以 Zed 编辑器为例，配置步骤如下： 在 ~/.config/zed/settings.json 文件中添加以下配置：

{
  "agent_servers": {
    "Kimi CLI": {
      "command": "kimi",
      "args": ["--acp"],
      "env": {}
    }
  }
}

完成配置后，在 Zed 的代理面板中能创建 Kimi CLI 线程。

MCP 工具使用

Kimi CLI 支持成熟的 MCP 配置规范，示例配置如下：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    },
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

运行 kimi 命令时，添加 --mcp-config-file 参数，可连接到指定的 MCP 服务器，命令格式如下：

kimi --mcp-config-file /path/to/mcp.json

Kimi CLI 开发环境搭建

若需参与 Kimi CLI 的开发工作，执行以下命令完成环境搭建：

git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli
make prepare  # 准备开发环境

Kimi CLI常用开发命令

完成代码修改后，可使用以下命令进行后续操作：

• 运行 Kimi CLI：uv run kimi

• 代码格式化：make format

• 代码检查（语法与类型）：make check

• 执行测试：make test

• 查看所有 make 命令：make help