Kimi Code CLI

Kimi Code | 文档 | 文档

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

入门

请参阅 入门指南 了解如何安装和开始使用 Kimi Code CLI。

核心功能

Shell 命令模式

Kimi Code CLI 不仅是一个编码代理，也是一个 Shell。您可以通过按 Ctrl-X 切换到 Shell 命令模式。在此模式下，您可以直接运行 Shell 命令，而无需退出 Kimi Code CLI。

[!注意] 目前尚不支持 cd 等内置 Shell 命令。

VS Code 扩展

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

通过 ACP 的 IDE 集成

Kimi Code CLI 开箱即用地支持 Agent Client Protocol。您可以将其与任何兼容 ACP 的编辑器或 IDE 搭配使用。

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

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

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

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

Zsh 集成

您可以将 Kimi Code CLI 与 Zsh 结合使用，借助 AI 代理的能力增强您的 Shell 使用体验。

通过以下方式安装 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 获取安装说明。

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

plugins=(... kimi-cli)

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

MCP 支持

Kimi Code 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 Code 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 Code CLI，请执行以下操作：

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

make prepare  # 准备开发环境

之后您就可以开始对 Kimi Code CLI 进行开发了。

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

uv run kimi  # 运行 Kimi Code CLI

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

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

Kimi Code CLI 快速上手指南

Kimi Code CLI 是一款运行在终端的 AI 智能体，能够协助你完成代码编写、文件编辑、Shell 命令执行及网页搜索等软件开发任务。

环境准备

• 操作系统：支持 Linux、macOS 和 Windows (WSL)。
• Python 版本：建议 Python 3.9 或更高版本。
• 前置依赖：
  • 确保已安装 pip 或 uv（推荐用于更快的包管理）。
  • 若需使用二进制文件，无需额外依赖；若从源码开发，需安装 make 和 Node.js。

安装步骤

方式一：通过 pip 安装（推荐）

使用国内镜像源加速安装：

pip install kimi-cli -i https://pypi.tuna.tsinghua.edu.cn/simple

或者使用 uv 进行安装：

uv pip install kimi-cli

方式二：构建独立二进制文件（可选）

如果你希望获得不依赖 Python 环境的独立可执行文件，可以从源码构建：

git clone https://github.com/MoonshotAI/kimi-cli.git
cd kimi-cli
make prepare
make build-bin

基本使用

1. 登录账号

首次使用前，需要在终端中运行以下命令并完成登录验证：

kimi login

2. 启动交互模式

直接在终端输入 kimi 即可进入交互式对话界面：

kimi

进入后，你可以直接输入自然语言指令，例如：“帮我创建一个计算斐波那契数列的 Python 脚本”。

3. 常用功能快捷键

• 切换 Shell 命令模式：在交互界面中按下 Ctrl-X，可直接在 Kimi 内部执行 Shell 命令（注意：内置命令如 cd 暂不支持）。
• 退出程序：输入 /exit 或按下 Ctrl-D。

4. 进阶：作为 MCP 服务器集成

若需在 Zed 或 JetBrains 等 IDE 中集成 Kimi，可将其作为 ACP/MCP 服务器启动：

kimi acp

配置 IDE 的 agent_servers 指向该命令即可在编辑器侧边栏调用 Kimi 智能体。