kimi-cli

Kimi CLI

Kimi Code | Documentation | 文档

[!IMPORTANT] Kimi CLI 正在演进为 Kimi Code CLI——同一团队打造的下一代终端 AI 代理。安装 Kimi Code CLI 会自动迁移你的配置和会话。本项目将逐步下线；文档和已有安装仍可使用。

Kimi CLI 是一个运行在终端中的 AI 代理，帮助你完成软件开发任务和终端操作。它可以读取和编辑代码、执行 shell 命令、搜索和获取网页内容，并在执行过程中自主规划和调整行动。

开始使用

参见开始使用了解如何安装并开始使用 Kimi CLI。

主要功能

Shell 命令模式

Kimi CLI 不仅是一个编码代理，还是一个 shell。你可以通过按 Ctrl-X 切换到 shell 命令模式。在此模式下，你无需离开 Kimi CLI 即可直接运行 shell 命令。

[!NOTE] 内置 shell 命令（如 cd）目前尚不支持。

VS Code 扩展

Kimi CLI 可以通过 Kimi Code VS Code Extension 与 Visual Studio Code 集成。

通过 ACP 的 IDE 集成

Kimi CLI 原生支持 Agent Client Protocol。你可以将其与任何兼容 ACP 的编辑器或 IDE 一起使用。

要使用 Kimi CLI 配合 ACP 客户端，请确保在终端中运行 Kimi CLI 并先发送 /login 完成登录。然后，你可以配置你的 ACP 客户端，使用命令 kimi acp 将 Kimi CLI 启动为 ACP 代理服务器。

例如，要将 Kimi CLI 与 Zed 或 JetBrains 配合使用，将以下配置添加到你的 ~/.config/zed/settings.json 或 ~/.jetbrains/acp.json 文件中：

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

之后你就可以在 IDE 的代理面板中创建 Kimi CLI 线程。

Zsh 集成

你可以将 Kimi CLI 与 Zsh 一起使用，为你的 shell 体验增添 AI 代理能力。

通过以下命令安装 zsh-kimi-cli 插件：

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

[!NOTE] 如果你使用的不是 Oh My Zsh 的插件管理器，可能需要参考该插件的 README 获取安装说明。

然后将 kimi-cli 添加到你的 Zsh 插件列表中（在 ~/.zshrc 中）：

plugins=(... kimi-cli)

重启 Zsh 后，你可以通过按 Ctrl-X 切换到代理模式。

MCP 支持

Kimi CLI 支持 MCP（Model Context Protocol）工具。

kimi mcp 子命令组

你可以使用 kimi mcp 子命令组管理 MCP 服务器。例如：

# 添加流式 HTTP 服务器：
kimi mcp add --transport http context7 https://mcp.context7.com/mcp --header "CONTEXT7_API_KEY: ctx7sk-your-key"

# 添加带有 OAuth 授权的流式 HTTP 服务器：
kimi mcp add --transport http --auth oauth linear https://mcp.linear.app/mcp

# 添加 stdio 服务器：
kimi mcp add --transport stdio chrome-devtools -- npx chrome-devtools-mcp@latest

# 列出已添加的 MCP 服务器：
kimi mcp list

# 移除一个 MCP 服务器：
kimi mcp remove chrome-devtools

# 授权一个 MCP 服务器：
kimi mcp auth linear

临时 MCP 配置

Kimi CLI 还支持通过 CLI 选项进行临时 MCP 服务器配置。

给定一个采用常见 MCP 配置格式的 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"]
    }
  }
}

使用 --mcp-config-file 选项运行 kimi 以连接到指定的 MCP 服务器：

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

更多

在文档中查看更多功能。

开发

要开发 Kimi CLI，请运行：

git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli

make prepare  # 准备开发环境

然后你就可以开始 Kimi CLI 的开发工作了。

做出更改后，请参考以下命令：

uv run kimi  # 运行 Kimi CLI

make format  # 格式化代码
make check  # 运行 linting 和类型检查
make test  # 运行测试
make test-kimi-cli  # 仅运行 Kimi CLI 测试
make test-kosong  # 仅运行 kosong 测试
make test-pykaos  # 仅运行 pykaos 测试
make build-web  # 构建 web UI 并将其同步到包中（需要 Node.js/npm）
make build  # 构建 Python 包
make build-bin  # 构建独立二进制文件
make help  # 显示所有 make 目标

注意：make build 和 make build-bin 会自动运行 make build-web 以嵌入 web UI。