MoonshotAI/kimi-cli

来源: https://github.com/MoonshotAI/kimi-cli

Kimi CLI

提交活动 (https://github.com/MoonshotAI/kimi-cli/graphs/commit-activity) 检查 (https://github.com/MoonshotAI/kimi-cli/actions) 版本 (https://pypi.org/project/kimi-cli/) 下载量 (https://pypistats.org/packages/kimi-cli) 询问 DeepWiki (https://deepwiki.com/MoonshotAI/kimi-cli)

Kimi Code (https://www.kimi.com/code/) | 文档 (英文) (https://moonshotai.github.io/kimi-cli/en/) | 文档 (中文) (https://moonshotai.github.io/kimi-cli/zh/)

[!重要] Kimi CLI 正在演变为 Kimi Code CLI (https://github.com/MoonshotAI/kimi-code)——这是由同一团队打造的下一代终端 AI 智能体。安装 Kimi Code CLI 将自动迁移您的配置和会话。该项目将逐步下线；文档和现有安装仍可使用。

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

快速开始

请参阅快速开始指南 (https://moonshotai.github.io/kimi-cli/en/guides/getting-started.html) 了解如何安装并开始使用 Kimi CLI。

主要功能

Shell 命令模式

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

[!注意] 内建 Shell 命令（如 cd）暂不支持。

VS Code 扩展

Kimi CLI 可通过 Kimi Code VS Code 扩展 (https://marketplace.visualstudio.com/items?itemName=moonshot-ai.kimi-code) 与 Visual Studio Code (https://code.visualstudio.com/) 集成。

VS Code 扩展

通过 ACP 集成 IDE

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

如需将 Kimi CLI 与 ACP 客户端一起使用，请确保在终端中运行 Kimi CLI，并先发送 /login 完成登录。然后，您可以将 ACP 客户端配置为以 Kimi CLI 作为 ACP 智能体服务器，命令为 kimi acp。

例如，要在 Zed (https://zed.dev/) 或 JetBrains (https://blog.jetbrains.com/ai/2025/12/bring-your-own-ai-agent-to-jetbrains-ides/) 中使用 Kimi CLI，请将以下配置添加到 ~/.config/zed/settings.json 或 ~/.jetbrains/acp.json 文件中：

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

随后，您便可以在 IDE 的智能体面板中创建 Kimi CLI 线程。

Zsh 集成

您可以结合 Zsh 使用 Kimi CLI，以 AI 智能体能力赋能您的 Shell 体验。

通过以下命令安装 zsh-kimi-cli (https://github.com/MoonshotAI/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 CLI 支持 MCP（模型上下文协议）工具。

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

更多功能

请参阅文档 (https://moonshotai.github.io/kimi-cli/en/) 了解更多功能。

开发

要开发 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   # 运行 lint 和类型检查
make test    # 运行所有测试
make test-kimi-cli  # 仅运行 Kimi 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 界面。